存储库工具指令,以启用 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 ManagementJazz Team Server、变更和配置管理、数据收集组件Global Configuration ManagementEngineering 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 ServerEngineering 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

其中,applicationccmdccgcqmrelmrm

teamserver.properties teamserver.properties 文件的路径。 False conf/application/teamserver.properties

其中,applicationjtsccmdccgcqmrelmrm

logFile 日志文件的路径。

False

repotools-application_prepareJsaSsoMigration.log

其中,applicationjtsccmdccgcqmrelmrm

示例

以下示例适用于 Jazz Team Server。 要在不同的Engineering Lifecycle Management中使用该命令,请使用与该应用程序相关联的 "repotools脚本。 表1介绍了每个 "repotools脚本及其管理的相关Engineering Lifecycle Management。 这些脚本位于 JazzInstallDir/server 目录中。

表 1。 repotools 脚本
脚本 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 需求管理

用于 Windows 操作系统 打开命令提示符并输入以下命令:

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

用于 UNIX 操作系统 打开命令行并输入以下命令:

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