Mit dem Befehl generateURLMappings kann eine erste Zuordnungsdatei für die Serverumbenennung generiert werden. Sie müssen generateURLMappings mit dem Befehl repotools-jts ausführen. Der Parameter repositoryURL muss auf einen Jazz Team Server verweisen.
Die generierte Zuordnungsdatei kann als Schablone genutzt und weiter bearbeitet werden. In der Zuordnungsdatei sind der vorhandene öffentliche Quellen-URL und ein Standardziel-URL für Jazz Team Server und für jede bei Jazz Team Server registrierte JTS-Anwendung aufgelistet.
| Attribut | Beschreibung | Erforderlich | Standardwert |
|---|---|---|---|
| toFile | Pfad zur generierten Zuordnungsdatei. | Ja | Nicht zutreffend |
| adminUserId | ID des Benutzers mit Administratorberechtigung für die Anmeldung beim Jazz-Repository. | Nein | ADMIN |
| adminPassword | Kennwort des Benutzers mit Administratorberechtigung für die Anmeldung beim Jazz-Repository. | Nein | ADMIN |
| overwrite | Gibt an, ob eine zuvor generierte Zuordnungsdatei überschrieben werden soll. | Nein | no |
| logFile | Pfad zur Protokolldatei. | Nein | repotools-jts_generateURLMappings.log |
| repositoryURL | Verbindungs-URL für den Server. | Nein | https://localhost:9443/jts |
| credentialsFile | Die Datei, die die Berechtigungsnachweise für die Anmeldung des Benutzers mit Administratorberechtigung enthält. | Nein | credentials.properties |
| certificateFile | Datei mit dem Anmeldezertifikat des Benutzers mit Administratorberechtigung. | Nein | Keiner |
| smartCard | Aliasname für die Anmeldung mit einer Smart Card oder ? für die Auflistung der verfügbaren Aliasnamen. | Nein | Keiner |
| additionalURLFile | Datei mit zusätzlichen URLs im Repository zur Überprüfung weiterer Zuordnungen. Weitere Einzelheiten hierzu finden Sie nachstehend. | Nein | additionalurl.txt |
Der Parameter additionalURLFile benennt die Position, an die eine Liste der URLs gestellt werden soll, die vor einer Serverumbenennung möglicherweise zur Zuordnungsdatei hinzugefügt werden müssen. In dieser Datei sind alle im Repository gefundenen URLs aufgelistet, die nicht in der generierten URL-Zuordnungsdatei aufgeführt sind.
Ein Beispiel wäre ein 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 ein URL und eine Zahl enthalten. Die Zahl zeigt an, wie viele Instanzen des URL im Repository gefunden wurden. Die Liste ist absteigend sortiert, sodass die potenziell wichtigsten URLs ganz oben in der Liste stehen.
Falls keine weiteren potenziellen URLs gefunden werden, dürfte die Datei nur die Nachricht No additional potential URLs found enthalten.
cd C:\Program Files\IBM\JazzTeamServer\server\ repotools-jts.bat -generateURLMappings toFile=C:\mappings.txt additionalURLFile=C:\additionalurl.txtLinux:
cd opt/IBM/JazzTeamServer/server ./repotools-jts.sh -generateURLMappings toFile=opt/mappings.txt additionalURLFile=opt/additionalurl.txt