Repository-Tools-Befehl zum Generieren der Zuordnungsdatei für die Serverumbenennung

Mit dem Befehl generateURLMappings können Sie eine erste Zuordnungsdatei mit Quellen- und Ziel-URLs für Ihre Serverumbenennung erstellen.

Zweck

Mit dem Befehl generateURLMappings kann eine erste Zuordnungsdatei für die Serverumbenennung erstellt werden. generateURLMappings muss zusammen mit dem Befehl " repotools-jts ausgeführt werden und erfordert, dass der Parameter " repositoryURL auf einen Jazz® Team Server verweist.

Die generierte Zuordnungsdatei kann als Vorlage genutzt und weiter bearbeitet werden. Die Zuordnungsdatei listet die vorhandene öffentliche Quell URL und eine Standardziel URL für den Jazz Team Server und jede IBM® Engineering Lifecycle Management Anwendung ( Engineering Workflow Management, Engineering Requirements Management DOORS® Next und Engineering Test Management ) auf, die beim Jazz Team Server registriert ist. Es identifiziert auch Quell- und Ziel-URLs für Engineering Lifecycle Management und alle bekannten betroffenen externen Systeme.

Wichtig: Der Server muss aktiv sein, wenn Sie den Befehl ausführen.

Parameter

Attribut Beschreibung Erforderlich Standard
toFile Pfad zur generierten Zuordnungsdatei Ja N/V
adminUserId Benutzer-ID des Administrators zum Anmelden im Jazz-Repository.
Hinweis: Wenn der Jazz Team Server die Datei credentials.properties enthält, wird die in dieser Datei angegebene Benutzer-ID mit Administratorberechtigung verwendet.
Nein ADMIN
adminPassword Kennwort des Administrators zum Anmelden im Jazz-Repository.
Anmerkung: Wenn der Jazz Team Server die Datei credentials.properties enthält, wird das in dieser Datei angegebene Administratorkennwort verwendet.
Nein ADMIN
overwrite Gibt an, ob eine zuvor generierte Zuordnungsdatei überschrieben werden soll Nein Kein
logFile Pfad zur Protokolldatei Nein repotools-jts_generateURLMappings.log
repositoryURL Verbindungs-URL für den Server Nein https://localhost:9443/jts
credentialsFile Datei, die die Berechtigungsnachweise für die Anmeldung des Benutzers mit Administratorberechtigung enthält Nein credentials.properties
certificateFile Die Datei mit dem Anmeldezertifikat des Benutzers mit Administratorberechtigung Nein Keine
smartCard Aliasname für die Anmeldung mit einer Smart Card oder ? für die Auflistung der verfügbaren Aliasnamen. Nein Keine
additionalURLFile Datei mit zusätzlichen URLs im Repository zur Überprüfung weiterer Zuordnungen. Nein additionalurl.txt
kerberos Führen Sie die Authentifizierung mit Windows-Benutzerberechtigungsnachweisen unter Verwendung von Kerberos/SPNEGO durch, indem Sie den Wert auf true setzen. Oder authentifizieren Sie sich mit der integrierten Windows-Authentifizierung, indem Sie windowsfestlegen. Nein Keine

Der Parameter additionalURLFile gibt die Speicherposition für eine Liste von URLs an, die möglicherweise zur Zuordnungsdatei hinzugefügt werden müssen, bevor eine Serverumbenennung durchgeführt wird. In dieser Datei sind alle im Repository gefundenen URLs aufgelistet, die nicht in der generierten URL-Zuordnungsdatei aufgeführt sind.

Ein Beispiel wäre eine URL für die Verbindung zu einem gelöschten Friend-Eintrag. Der Benutzer, der die Serverumbenennung durchführt, muss diese Liste gründlich durchgehen, um festzustellen, ob Zuordnungen angegeben sind, die der automatisierte Prozess nicht erfasst hat. Gegebenenfalls können Zuordnungen dann vor der eigentlichen Serverumbenennung manuell zur Zuordnungsdatei hinzugefügt werden.

In jeder Zeile der Liste sind eine URL und eine Zahl enthalten. Die Zahl zeigt an, wie viele Instanzen der URL im Repository gefunden wurden. Die Liste ist absteigend sortiert, sodass die potenziell wichtigsten URLs ganz oben in der Liste stehen.

Wenn keine weiteren potenziellen URLs gefunden werden, sollte diese Datei einfach die folgende Nachricht enthalten:No additional potential URLs found.

Beispiel

Für Windows-Betriebssysteme Öffnen Sie eine Eingabeaufforderung und geben Sie folgenden Befehl ein:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -generateURLMappings toFile=C:\mappings.txt additionalURLFile=C:\additionalurl.txt kerberos=true

Für Unix-Betriebssysteme Öffnen Sie eine Befehlszeile und geben Sie folgenden Befehl ein:

cd opt/IBM/JazzTeamServer/server
./repotools-jts.sh -generateURLMappings toFile=opt/mappings.txt additionalURLFile=opt/additionalurl.txt