Anpassungen mit der Konfigurationsdatei bereitstellen

Servigistics InService ermöglicht es Ihnen, alle Anpassungen unter Verwendung der XML-Konfigurationsdatei custom.conf.xml bereitzustellen. Der Zweck der Anpassungsbereitstellung unter Verwendung der vordefinierten Konfigurationsdatei ist, Dateien automatisch zu verschieben, zu kopieren oder zu löschen und dieselbe Konfiguration auf mehrere Umgebungen (Entwicklung, Test, Produktion usw.) anzuwenden. Dadurch müssen diese Operationen nicht auf jede Umgebung manuell angewendet werden, und der Prozess ist weniger fehleranfällig.

Es wird empfohlen, Anpassungen mit der Datei custom.conf.xml bereitzustellen, wenn Sie einen Satz benutzerdefinierter Dateien von einer Umgebung programmgesteuert in eine andere verschieben möchten. Wenn Sie beispielsweise dieselbe Anpassung auf eine aktualisierte Umgebung anwenden oder von einer Umgebung in eine andere wechseln (beispielsweise von Entwicklung zu Test oder von Test zu Produktion).

Sie können Anpassungen bereitstellen, wenn Sie Servigistics InService installieren oder aktualisieren. Stellen Sie beim Bereitstellen von Anpassungen sicher, dass die Konfigurationen, die Sie in der Konfigurationsdatei angeben, die Standardkonfigurationen nicht überschreiben.

• Sie dürfen diesen Setup-Prozess der Anpassungsbereitstellung mit der Konfigurationsdatei nur verwenden, um einen beliebigen Schritt in den Anpassungsspezifikationen zu ersetzen, die das Kopieren von Dateien von einem Ort an einen anderen erfordern. Für alle anderen Aktionen wie das Kompilieren von Dateien oder Schritte nach dem Setup müssen Sie die erforderlichen Schritte befolgen, selbst wenn Sie diese Setup-Option verwenden.

• Sie müssen eine Sicherung jedes Verzeichnisses oder jeder Datei erstellen, bevor Sie diese anpassen, da Sie die Änderungen nicht wiederherstellen können.

• Bereitstellung der Anpassungen ohne Aktualisierung von Servigistics InService. Beim Anpassen ohne Upgrade müssen Sie das Installationspaket verwenden, das bereits bereitgestellt wurde.

Weitere Informationen zum Installieren oder Aktualisieren von Servigistics InService finden Sie unter Servigistics InService für Installationen im Hintergrund konfigurieren.

Für die Offline-Installation müssen Sie denselben Prozess wie für die Installation im Hintergrund verwenden. Sie können sie nur nicht über die Benutzeroberfläche deaktivieren. Das heißt, bei der Offline-Installation haben die vom OEM angegebenen Anpassungsanweisungen in der Konfigurationsdatei immer Vorrang.

Eine Beispielkonfigurationsdatei custom.conf.xml.example steht im Verzeichnis <Installation_Home>\media\PTC_Servigistics_InService_Delivery_Base\Setup\Base\SystemCommon\Home\CONFIG\System\Config zur Verfügung, wobei <Installation_Home> das Verzeichnis ist, in das Sie die Dateien aus dem Servigistics InService Installationspaket extrahiert haben.

Standardmäßig ist der Dateiname custom.conf.xml.example. Wenn Sie jedoch Anpassungen mit dieser Datei bereitstellen, müssen Sie sie in custom.conf.xml umbenennen.

<?xml version="1.0"?>
<customization customizationVersion="7.501">
<file op="copy" from="web.xml" to="{bin.home}\\Applications\\Windchill.ear\\Deployment.war\\WEB-INF"> </file>
<file op="copy" from="testFile.txt" to="{bin.home}\\Applications"> </file>
<file op="copy" from="testDirectory" to="{bin.home}\\Applications"> </file>
<file op="delete" from="{bin.home}\\Applications\\testFile.txt"> </file>
</customization>

{bin.home} stellt den Pfad relativ zum Verzeichnis <INS_HOME>\\InS_SW dar, wobei <INS_HOME> das Verzeichnis ist, in dem Sie Servigistics InService installiert haben.

Sie müssen den folgenden Inhalt in der Datei custom.conf.xml.example konfigurieren, um die neueste Version und die benutzerdefinierten Dateien zu bestimmen, die für das Bereitstellen von Anpassungen verwendet werden:

• Ändern Sie den Versionswert im Attribut customizationVersion des Elements customization in einem numerischen Wert, der höher als die aktuell installierte Version ist. Wenn Sie die Version nicht erhöhen, wird der Anpassungsbereitstellungsprozess nicht abgeschlossen.

• Geben Sie eine sequentielle Liste von file-Elementen entweder mit der Operation copy oder delete an, die auf benutzerdefinierte Dateien angewendet werden soll. Weitere Informationen zur Verwendung von Dateioperationen finden Sie unter Benutzerdefinierte Dateioperationen angeben.

◦ Verwenden Sie für das Windows-Setup zwei umgekehrte Schrägstriche \\, um Komponenten des Pfads für den Quell- oder Zielspeicherort zu trennen.

◦ Verwenden Sie für das Linux-Setup einen Schrägstrich /, um Komponenten des Pfads für den Quell- oder Zielspeicherort zu trennen.

Nachdem Sie die Datei custom.conf.xml.example konfiguriert haben, müssen Sie sie als Datei custom.conf.xml im selben Verzeichnis speichern.

Wenn Sie Anpassungen zum ersten Mal bereitstellen, können Sie den Standardwert des Attributs customizationVersion verwenden, das in der Datei custom.conf.xml.example angegeben ist. Wenn Sie die Anpassung jedoch wieder ändern, müssen Sie die Anpassungsversion auf den höheren Wert aktualisieren. Beispielsweise lautet der Standardwert der Anpassungsversion 7.501. Wenn Sie die Anpassung erneut ändern, ändern Sie den Wert in 7.502 oder höher.

Geben Sie eine der folgenden Operationen für benutzerdefinierte Dateien im Element file in der Datei custom.conf.xml.example an:

• copy: Kopiert die angegebene benutzerdefinierte Datei vom Quellort zum Zielort, wobei Duplikate der Datei an jedem Speicherort verbleiben. Der Quell- und der Zielort werden in den Attributen from und to des Elements file angegeben.

Beispielsweise können Sie diesen Konfigurationsdateieintrag in die Datei custom.conf.xml.example einschließen, um die Datei web.xml vom Quellort zum Zielort zu kopieren, wie in der folgenden Liste angegeben:

◦ Quellort: PTC_Servigistics_InService_Delivery_Base\Setup\Base\SystemCommon\Home\CONFIG\System\Config\CustomizationFiles

◦ Konfigurationsdateieintrag: <file op="copy" from="web.xml" to="<INS_HOME>\\InS_SW\\SW\\Applications\\Windchill.ear\\Deployment.war\\WEB-INF"> </file>

In diesem Beispiel wird die Datei web.xml am selben Speicherort abgelegt wie die Datei custom.conf.xml.example. Aus diesem Grund wird nur der Dateiname im Attribut to des Elements file angegeben.

• delete: Löscht die angegebene benutzerdefinierte Datei aus dem Zielort, nachdem Sie Servigistics InService installiert haben. Der Zielort wird im Attribut to des Elements file angegeben.

Beispielsweise können Sie diesen Konfigurationsdateieintrag in die Datei custom.conf.xml.example einschließen, um die Datei testFile.txt aus dem Zielort zu löschen, wie in der folgenden Liste angegeben: