Ab Version 4.0 der Produkte für die Rational-Lösung für CLM (Collaborative Lifecycle Management) können Administratoren die öffentliche URI einer Jazz Team Server- oder Rational-Lösung für die CLM-Anwendung nach der Implementierung ändern, indem sie die Serverumbenennungsoperation verwenden. Für solche Änderungen sind die entsprechenden Aktualisierungen für die Rational-Lösung für CLM-Ressourcen, die auf der URI basieren, erforderlich. Für ClearQuest Bridge sind diese Artefaktlinks für die Rational-Lösung für CLM-Produktressourcen (IBM Rational Team Concert, IBM Rational Quality Manager und IBM Rational DOORS Next Generation) in ClearQuest-Web-Server-Konfigurationsdateien und in OSLCLinks-Datensätzen in der ClearQuest-Benutzerdatenbank gespeichert.
ClearQuest stellt das Tool clm_server_rename.pl bereit, mit dem strukturelle URI-Links, die in ClearQuest-Webkonfigurationsdateien und in OSLCLinks-Datensätzen gespeichert sind, erneut zugeordnet werden. Verwenden Sie das Tool, um das Protokoll, den Hostnamen, die Portnummer und den Anwendungskontext struktureller Links neu zuzuordnen.
Tool ausführen
Sie müssen über Administratorberechtigungen und über ClearQuest-Superuser-Berechtigungen verfügen, um das Tool clm_server_rename.pl ausführen zu können.
Das Tool befindet sich im folgenden Verzeichnis in der Datei cqweb.war:
Das Programm cqperl.exe befindet sich in dem Verzeichnis, in dem ClearQuest installiert ist.
Bevor Sie das Tool clm_server_rename.pl ausführen, ist es ein bewährtes Verfahren, für die Umgebungsvariable TEMP ein Verzeichnis festzulegen, auf das Sie Schreibzugriff haben. Stellen Sie andernfalls sicher, dass Sie über Schreibzugriff auf das Verzeichnis verfügen, in dem Sie das Tool ausführen.
Sie müssen das Tool mehrmals ausführen.
Wenn z. B. ClearQuest in IBM Rational Team Concert und IBM Rational Quality Manager integriert ist und sowohl der Jazz Team Server für Rational Team Concert als auch der Rational Quality Manager-Server umbenannt werden, müssen Sie das Tool zwei Mal mit der Option -remapconfigfiles ausführen: einmal, um die URIs für die Rational Team Concert-Artefaktlinks neu zuzuordnen, und einmal, um die URIs für die Rational Quality Manager-Artefaktlinks neu zuzuordnen.
Wenn z. B. ClearQuest in IBM Rational Team Concert und IBM Rational Quality Manager integriert ist und sowohl der Jazz Team Server für Rational Team Concert als auch der Rational Quality Manager-Server umbenannt werden, müssen Sie das Tool zwei Mal mit der Option -update ausführen: einmal, um die URIs für die Rational Team Concert-Artefaktlinks neu zuzuordnen, und einmal, um die URIs für die Rational Quality Manager-Artefaktlinks neu zuzuordnen.
Unter dem Abschnitt zum Thema URIs nach Umbenennung eines CLM-Servers neu zuordnen finden Sie die ausführlichen Informationen zu dieser Prozedur.
Im Abschnitt Optionen und Argumente finden Sie eine Beschreibung der Befehlszeilenoptionen.
Das Tool clm_server_rename.pl ordnet nur strukturelle Links erneut zu, die in ClearQuest-Web-Server-Konfigurationsdateien und in OSLCLinks-Datensätzen gespeichert sind. Das Tool ordnet keine integrierten Links, die in ClearQuest-Datensätzen gespeichert sind, neu zu. Solche integrierten Ankerlinks können in Datensatzanhänge oder in Felder wie Beschreibungen oder Hinweise eingeschlossen werden. Je nach Schema werden diese Felder möglicherweise nach dem Senden oder nach dem Hinzufügen eines Hinweises schreibgeschützt. Das bedeutet, dass die integrierten Ankerlinks nach dem Ausführen des Tools defekt bleiben. Sie können ggf. Code schreiben, um diese Links zu korrigieren.
Ein Beispiel für einen integrierten Ankerlink, der nach dem Ausführen des Tools defekt bleibt, betrifft die Rational-Lösung für CLM-Integration zwischen Rational ClearQuest und Rational Quality Manager. Wenn ein Rational Quality Manager-Artefakt mit einem ClearQuest-Datensatz verlinkt wird, fügt Rational Quality Manager einen URI-Link zum Artefakt in das Feld für die Datensatzbeschreibung ein.
Dieses Tool ordnet öffentliche Jazz Team Server-URI-Artefaktlinks für die Rational-Lösung für CLM (Collaborative Lifecycle Management) neu zu. Namentlich ordnet die Option die URIs, die in ClearQuest-Web-Server-Konfigurationsdateien gespeichert sind, neu zu. Das Tool erstellt eine Kopie der Konfigurationsdateien, bevor es die URIs neu zuordnet.
Nach dem Ausführen des Tools mit dieser Option müssen Sie den ClearQuest-Web-Server neu starten. Dann wird die Kommunikation zwischen Servern auf dem Web-Server neu konfiguriert und die Benutzer können neue URI-Links zur Rational-Lösung für CLM-Artefakte erstellen. Allerdings funktionieren vorhandene Links zur Rational-Lösung für CLM-Artefakte erst dann, wenn Sie das Tool erneut mit der Option -update ausführen.
Wenn das Tool mit dieser Option ausgeführt wird, erfasst es die Änderungen an OSLCLinks-Datensätzen in einer Protokolldatei. Wenn die Umgebungsvariable TEMP festgelegt ist, wird die Protokolldatei in das angegebene Verzeichnis geschrieben; andernfalls wird die Protokolldatei in das Verzeichnis geschrieben, von dem aus Sie das Tool ausführen, vorausgesetzt, Sie verfügen über Schreibzugriff. Die folgende Dateibenennungskonvention wird für die Protokolldatei verwendet:
Dabei gilt Folgendes:
Beispiel: clm_server_rename_20120405_211711.
C:\WAS-Profile\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl
clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL
-oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/
-remapconfigfiles
Started: Remapping URIs in config file friendsconfig.rdf.
Completed: Remapping URIs in config file friendsconfig.rdf.
Started: Remapping URIs in config file project-area-links.rdf.
Completed: Remapping URIs in config file project-area-links.rdf.
Started: Remapping URIs in config file oauth-consumers.rdf.
Completed: Remapping URIs in config file oauth-consumers.rdf.
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0
-dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix
https://servername.com:9443/ccm/ -preview 5
cqperl clm_server_rename.pl -username
admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix
http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/
cqperl
clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL
-oldprefix http://servername.com:9443/jazz/ -newprefix
https://neuer_servername.com:9443/jazz/