Commande des outils de référentiel pour générer le fichier de mappage de changement de nom de serveur

La commande generateURLMappings permet de générer un fichier de mappage initial des adresses URL source-cible qui pourra être utilisé par une opération de changement de nom de serveur.

Objet

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.

Remarque : Le serveur doit être démarré lors de l'exécution de la commande.

Paramètres

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.

Exemple

Windows :
cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -generateURLMappings toFile=C:\mappings.txt additionalURLFile=C:\additionalurl.txt
Linux :
cd opt/IBM/JazzTeamServer/server
./repotools-jts.sh -generateURLMappings toFile=opt/mappings.txt additionalURLFile=opt/additionalurl.txt

Commentaires