存储库工具指令,以启用 Jazz 安全架构单点登录的Engineering Lifecycle Management
使用 "migrateToJsaSso命令为在服务器上注册的 "Jazz® 团队服务器或指定的 "IBM® Engineering Lifecycle Management应用程序启用 Jazz Security Architecture 单点登录(SSO)身份验证。
开始之前
- 在运行该命令之前,必须将 Jazz Team Server 以及将针对 Jazz 安全体系结构 SSO 启用的任何应用程序升级到 V 6.0 或更高版本。 升级必须完成并通过验证。
- 该命令适用于具有 "repotools命令脚本的Engineering Lifecycle Management:Jazz Team Server、变更和配置管理、数据收集组件、Global Configuration Management、Engineering Test Management、工程洞察和需求管理。
- 运行该命令时,服务器必须处于脱机状态。
migrateToJsaSso命令是两个版本库工具命令之一,可为Engineering Lifecycle Management部署启用 Jazz 安全架构 SSO 身份验证。 在为Jazz Team Server和所有将启用的Engineering Lifecycle Management运行 "prepareJsaSsoMigration命令后运行此命令。 如果为 Jazz 安全体系结构 SSO 启用了向服务器注册的任何应用程序,那么必须在 Jazz Team Server 上运行这两个命令。 并非所有应用程序都必须同时启用。 不过,在启用所有在Jazz Team Server注册的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 Team Server和Engineering Lifecycle Management处于脱机状态时,您运行了 "migrateToJsaSso命令。 此命令需要使用由 prepareJsaSsoMigration 命令生成的数据文件。
参数
| 属性 | 描述 | 必需 | 缺省值 |
|---|---|---|---|
| authServerURL | Jazz授权服务器的 URL。 | 是 | 无 |
| authServerUserID | Jazz Authorization Server的管理员用户标识。 | False 注意:如果为Jazz 授权服务器配置的用户注册表中不存在默认的 ADMIN 用户,则需要使用此参数。
|
ADMIN |
| authServerPassword | Jazz Authorization Server的管理员密码。 | False 注意:如果为Jazz 授权服务器配置的用户注册表中不存在默认的 ADMIN 用户,则需要使用此参数。
|
ADMIN |
| jtsSsoDataFile | 针对 Jazz Team Server运行的 prepareJsaSsoMigration 命令创建的数据文件的路径。 | False | jts-ssoMigrationData.json |
| appSsoDataFile | 对此应用程序运行的 prepareJsaSsoMigration 命令所创建的数据文件的路径。 | False 注: 对 Jazz Team Server运行命令时,不应使用此参数。
|
application-ssoMigrationData.json 其中,application 是 ccm、dcc、gc、qm、relm 或 rm |
| teamserver.properties | teamserver.properties 文件的路径。 | False | conf/application/teamserver.properties 其中,application 是 jts、ccm、dcc、gc、qm、relm 或 rm |
| logFile | 日志文件的路径。 | False |
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 | Data Collection Component |
| 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