Jazzセキュリティ・アーキテクチャー・シングルサインオン用のEngineering Lifecycle Managementアプリケーションを有効にするためのリポジトリツールコマンド
migrateToJsaSsoコマンドを使用して、Jazz® Team Serverまたはサーバーに登録されている指定のIBM® Engineering Lifecycle Managementアプリケーションの Jazz Security Architecture シングルサインオン (SSO) 認証を有効にします。
始める前に
- このコマンドを実行する前に、 Jazz Team Server と、Jazz Security Architecture SSO を使用可能にするすべてのアプリケーションを、バージョン 6.0 以降にアップグレードする必要があります。 アップグレードは完了および確認済みである必要があります。
- このコマンドは、'repotoolsコマンドスクリプトを持つEngineering Lifecycle Managementアプリケーションに適用されます：Jazz Team Server、Change and Configuration Management、Data Collection Component、Global Configuration Management、Engineering Test Management、Engineering Insights、Requirements Management。
- コマンドを実行する場合は、サーバーがオフラインである必要があります。
migrateToJsaSsoコマンドは、Engineering Lifecycle ManagementデプロイメントでJazz Security Architecture SSO認証を有効にする2つのリポジトリツールコマンドのうちの1つです。 このコマンドは、'prepareJsaSsoMigrationコマンドをJazz Team Serverと有効になるすべてのEngineering Lifecycle Managementアプリケーションに対して実行した後に実行します。 サーバーに登録されているいずれかのアプリケーションで Jazz Security Architecture SSO が使用可能になっている場合は、両方のコマンドを Jazz Team Server で実行する必要があります。 すべてのアプリケーションで同時に使用可能にする必要はありません。 しかし、Jazz TeamServerに登録されているすべてのEngineering Lifecycle Managementアプリケーションが有効になるまでは、ログインエクスペリエンスはシングルサインオンプロセスではありません。
Jazz Team Server用の 'prepareJsaSsoMigrationコマンドを実行して生成されたデータファイルは、Engineering Lifecycle Managementアプリケーション用の 'migrateToJsaSsoコマンドを実行するときに利用可能でなければなりません。 Engineering Lifecycle ManagementアプリケーションがJazz Team Serverとは異なるサーバーにデプロイされている場合、Jazz Team Serverのデータファイルは、Engineering Lifecycle Managementアプリケーションをホストするサーバーにコピーする必要があります。 migrateToJsaSso コマンドを実行する前には、すべてのサーバーを停止する必要があります。
目的
Jazz TeamServerとEngineering Lifecycle Managementアプリケーションがオフラインの状態で、'migrateToJsaSsoコマンドを実行します。 このコマンドには、prepareJsaSsoMigration コマンドによって生成されたデータ・ファイルが必要です。
パラメーター
| 属性 | 説明 | 必須 | Default |
|---|---|---|---|
| authServerURL | Jazz認証サーバーの URL。 | はい | なし |
| authServerUserID | Jazz 認証サーバーの管理者ユーザー ID。 | なし 注意：このパラメータは、Jazz認証サーバーに設定されているユーザーレジストリにデフォルトのADMINユーザーが存在しない場合に必要となります。
|
ADMIN |
| authServerPassword | Jazz 認証サーバーの管理者パスワード。 | なし 注意：このパラメータは、Jazz認証サーバーに設定されているユーザーレジストリにデフォルトのADMINユーザーが存在しない場合に必要となります。
|
ADMIN |
| jtsSsoDataFile | Jazz Team Serverに対して実行された prepareJsaSsoMigration コマンドによって作成されたデータ・ファイルへのパス。 | なし | jts-ssoMigrationData.json |
| appSsoDataFile | このアプリケーションに対して実行された prepareJsaSsoMigration コマンドによって作成されたデータ・ファイルのパス。 | なし 注: Jazz Team Serverに対してこのコマンドを実行する場合は、このパラメーターを使用しないでください。
|
application-ssoMigrationData.json application は ccm、dcc、gc、qm、relm、rm のいずれかになります。 |
| teamserver.properties | teamserver.properties ファイルへのパス。 | なし | conf/application/teamserver.properties application は jts、ccm、dcc、gc、qm、relm、rm のいずれかになります。 |
| logFile | ログ・ファイルへのパス。 | なし |
repotools-application_prepareJsaSsoMigration.log application は jts、ccm、dcc、gc、qm、relm、rm のいずれかになります。 |
例
以下に、 Jazz Team Serverの例を示します。 このコマンドを別のEngineering Lifecycle Managementアプリケーションに使用するには、そのアプリケーションに関連付けられた「repotoolsスクリプトを使用する。 表1に、各「repotoolsスクリプトと、それが管理する関連するEngineering Lifecycle Managementアプリケーションを示す。 スクリプトは JazzInstallDir/server ディレクトリーにあります。
| スクリプト | Engineering Lifecycle Managementアプリケーション |
|---|---|
| repotools-ccm | 変更管理と構成管理 |
| repotools-dcc | データ収集コンポーネント |
| repotools-gc | Global Configuration Management |
| repotools-qm | Engineering Test Management |
| repotools-relm | Engineering Insights |
| repotools-rm | 要求管理 |
コマンド・プロンプトを開き、以下のコマンドを入力します。
cd C:\Program Files\IBM\JazzTeamServer\server\ repotools-jts.bat -migrateToJsaSso authServerURL=https://hostname.example.com:9643/oidc/endpoint/jazzop
コマンド行を開き、以下のコマンドを入力します。
cd opt/IBM/JazzTeamServer/server ./repotools-jts.sh -migrateToJsaSso authServerURL=https://hostname.example.com:9643/oidc/endpoint/jazzop