La commande generateURLMappings permet de générer un fichier de mappage initial qui sera utilisé avec l'opération de changement de nom de serveur. La commande generateURLMappings doit être exécutée avec la commande repotools-jts et nécessite que le paramètre repositoryURL pointe vers un serveurJazz Team Server.
Le fichier de mappage généré peut être utilisé comme modèle pour une édition ultérieure. Le fichier de mappage répertorie l'adresse URL publique source existante ainsi qu'une adresse URL cible par défaut pour Jazz Team Server et chaque application JTS enregistrée auprès du serveur Jazz Team Server.
| Attribut | Description | Requis | Valeur par défaut |
|---|---|---|---|
| toFile | Chemin d'accès au fichier de mappage généré. | Oui | N/A |
| adminUserId | ID administrateur permettant de se connecter au référentiel Jazz. | Non | ADMIN |
| adminPassword | Mot de passe administrateur permettant de se connecter au référentiel Jazz. | Non | ADMIN |
| overwrite | Indique si un fichier de mappage existant généré précédemment doit être ou non remplacé. | Non | Non |
| logFile | Chemin vers le fichier journal. | Non | repotools-jts_generateURLMappings.log |
| repositoryURL | URL de connexion du serveur. | Non | https://localhost:9443/jts |
| credentialsFile | Fichier contenant les données d'identification permettant la connexion de l'administrateur. | Non | credentials.properties |
| certificateFile | Fichier contenant le certificat de connexion de l'administrateur. | Non | Aucune |
| smartCard | Alias de connexion à l'aide d'une carte à puce ou ? pour répertorier les alias disponibles. | Non | Aucune |
| additionalURLFile | Fichier contenant les adresses URL supplémentaires trouvées dans le référentiel et qui doivent être révisées pour les mappages supplémentaires. Pour plus de détails, voir ci-dessous. | Non | additionalurl.txt |
Le paramètre additionalURLFile indique l'emplacement dans lequel placer une liste d'adresses URL qu'il peut être potentiellement nécessaire d'ajouter au fichier de mappage avant le changement de nom d'un serveur. Ce fichier répertorie toutes les adresses URL détectées dans le référentiel qui ne sont pas répertoriées dans le fichier de mappage des adresses URL généré.
Par exemple, il peut s'agir d'une adresse URL d'une entrée amie supprimée. Il appartient à l'utilisateur qui renomme le serveur de rechercher dans cette liste les mappages pouvant avoir été omis par le processus automatisé. Les mappages peuvent ensuite être ajoutés manuellement au fichier de mappage avant le changement de nom du serveur proprement dit.
Chaque ligne dans cette liste comporte une URL et un numéro. Le numéro indique le nombre d'instances de l'adresse URL détectées dans le référentiel. La liste est triée par ordre décroissant afin d'afficher en premier les adresses URL potentielles les plus importantes.
Si aucune adresse URL potentielle supplémentaire n'est détectée, ce fichier contient simplement le message Aucune autre URL potentielle n'a été trouvée.
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