Commande d'outils de référentiel pour activer une application de Engineering Lifecycle Management pour l'authentification unique de l'architecture de sécurité Jazz

Utilisez la commande 'migrateToJsaSso pour activer l'authentification unique (SSO) de Jazz Security Architecture pour le serveur Jazz® Team ou l'application IBM® Engineering Lifecycle Management spécifiée qui est enregistrée avec le serveur.

Avant de commencer

Important :
  • Avant d'exécuter la commande, vous devez mettre à niveau Jazz Team Server et toutes les applications qui seront activées pour la connexion unique Jazz Security Architecture vers la version 6.0 ou ultérieure. La mise à niveau doit être complète et vérifiée.
  • Cette commande s'applique aux applications de Engineering Lifecycle Management qui ont des scripts de commande " repotools: Jazz Team Server, Change and Configuration Management, Data Collection Component, Global Configuration Management, Engineering Test Management, Engineering Insights et Requirements Management.
  • Le serveur doit être en cours d'exécution lorsque vous exécutez la commande.

La commande 'migrateToJsaSso est l'une des deux commandes des outils du référentiel qui permet l'authentification SSO de l'architecture de sécurité Jazz pour les déploiements de Engineering Lifecycle Management Vous exécutez cette commande après l'exécution de la commande " prepareJsaSsoMigration pour le serveur Jazz Team et toutes les applications de Engineering Lifecycle Management qui seront activées. Les deux commandes doivent être exécutées sur le serveur Jazz Team Server si des applications enregistrées sur le serveur sont activées pour la connexion unique Jazz Security Architecture. Toutes les applications n'ont pas besoin d'être activées en même temps. Cependant, la connexion n'est pas un processus d'authentification unique tant que toutes les applications de Engineering Lifecycle Management enregistrées auprès de Jazz Team Server n'ont pas été activées.

Le fichier de données généré par l'exécution de la commande " prepareJsaSsoMigration pour le serveur Jazz Team doit être disponible lorsque vous exécutez la commande " migrateToJsaSso pour les applications de Engineering Lifecycle Management Si les applications de Engineering Lifecycle Management sont déployées sur des serveurs différents du serveur Jazz Team, le fichier de données du serveur Jazz Team doit être copié sur les serveurs qui hébergent les applications de Engineering Lifecycle Management. Tous les serveurs doivent être arrêtés avant l'exécution des commandes migrateToJsaSso.

But

Vous exécutez la commande " migrateToJsaSso alors que les applications Jazz Team Server et Engineering Lifecycle Management sont hors ligne. La commande requiert un fichier de données qui est généré par la commande prepareJsaSsoMigration.

Paramètres

Attribut Description Requis Valeur par défaut
authServerURL URL racine du serveur d'autorisation Jazz. Oui none
authServerUserID ID administrateur du serveur d'autorisation Jazz. Non
Remarque : ce paramètre est nécessaire si l'utilisateur ADMIN par défaut n'existe pas dans le registre des utilisateurs configuré pour le serveur d'autorisation Jazz.
ADMIN
authServerPassword Mot de passe de l'administrateur du serveur d'autorisation Jazz. Non
Remarque : ce paramètre est nécessaire si l'utilisateur ADMIN par défaut n'existe pas dans le registre des utilisateurs configuré pour le serveur d'autorisation Jazz.
ADMIN
jtsSsoDataFile Chemin d'accès au fichier de données créé par la commande prepareJsaSsoMigration qui a été exécutée pour Jazz Team Server. Non jts-ssoMigrationData.json
appSsoDataFile Chemin d'accès au fichier de données généré par la commande prepareJsaSsoMigration qui a été exécutée pour cette application. Non
Remarque: Ce paramètre ne doit pas être utilisé lorsque la commande est exécutée pour Jazz Team Server.
application-ssoMigrationData.json

application est ccm, dcc, gc, qm, relm ou rm

teamserver.properties Chemin d'accès au fichier teamserver.properties . Non conf/application/teamserver.properties

application est jts, ccm, dcc, gc, qm, relm ou rm

logFile Chemin d'accès au fichier journal.

Non

repotools-application_prepareJsaSsoMigration.log

application est jts, ccm, dcc, gc, qm, relm ou rm

Exemple

L'exemple suivant concerne Jazz Team Server. Pour utiliser cette commande pour une autre application de Engineering Lifecycle Management, utilisez le script " repotools associé à cette application. Le tableau 1 décrit chaque script " repotools et l'application de Engineering Lifecycle Management qu'il gère. Les scripts se trouvent dans le répertoire JazzInstallDir/server .

Tableau 1. Scripts repotools
Script Application de Engineering Lifecycle Management
repotools-ccm Change and Configuration Management
repotools-dcc Data Collection Component
repotools-gc Global Configuration Management
repotools-qm Engineering Test Management
repotools-relm Engineering Insights
repotools-rm Requirements Management

Pour le système d'exploitation Windows Ouvrez une invite de commande et entrez cette commande :

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -migrateToJsaSso authServerURL=https://hostname.example.com:9643/oidc/endpoint/jazzop

Pour les systèmes d'exploitation Unix Ouvrez une ligne de commande et entrez la commande suivante :

cd opt/IBM/JazzTeamServer/server
./repotools-jts.sh -migrateToJsaSso authServerURL=https://hostname.example.com:9643/oidc/endpoint/jazzop