本主题描述如何使用服务器重命名功能通过实际生产数据来准备登台环境。登台环境是与生产环境隔离的测试沙箱。可以使用登台环境利用实际数据来试用新的功能特性或功能,而不会影响生产数据库。
服务器重命名功能使用映射文件来确定应重命名的 URL。提供了 repotools 命令为您生成初始映射文件。此映射文件包含 Jazz™ Team Server 和所有应用程序的“源/目标”对以及应用程序提供的任何其他 URL。有关此映射文件的更多详细信息,请参阅了解服务器重命名所使用的映射文件。请参阅用于设置测试登台环境的拓扑和映射文件,以获取样本拓扑图和映射文件。
规划登台环境时,您需要特别谨慎,请勿破坏生产数据,反之亦然。这可以通过两种方式来实现:一种方式是将条目添加至 hosts 文件(如果您所在环境允许这样做);另一种方式是创建映射以屏蔽您的登台环境中不存在的服务器。务必将任何其他可能已连接至生产服务器的 CLM 服务器或者非 CLM 产品包括在此映射中。有关详细信息,请参阅步骤 3.c 以及登台环境的伪映射。
例如,您可能在一个生产服务器中安装了“变更和配置管理”(CCM) 应用程序,此应用程序链接至另一个生产服务器中的 CCM,并且还链接至另一个生产服务器中的“质量管理”(QM)。此外,您可能与非 CLM 产品(例如,Rational® ClearQuest®)进行了集成。在这种情况下,您首先应屏蔽另外的 CCM 服务器和 QM 服务器的 URL,并确保还要屏蔽 Rational ClearQuest 的 URL 或者将此 URL 映射至已登台的 Rational ClearQuest 网关服务器。
下图显示使用服务器重命名来设置登台环境时需要执行的主要步骤。假定已经安装了最新版本的 CLM (V4) 和 RRDI (V2)。

务必为此映射文件中任何受影响的 URL 创建伪映射。这样做是为了避免登台环境与生产环境之间进行交叉链接。有关详细信息,请参阅登台环境的伪映射。
完成准备阶段之后,最终结果是在原始的源 Jazz Team Server 上生成一个映射文件。在仔细复查和编辑此映射文件之后,将其复制到登台环境中的目标 Jazz Team Server 上的 JazzInstallDir\server 目录。
因为您在执行这些步骤时需要停止生产服务器,所以务必选择在方便的时间执行备份,在设置登台环境之前可能更合适。在您继续真正进行重命名之前,如果对生产环境进行了任何更改,那么您在将此映射文件导入到登台服务器之前需要重新生成此映射文件。在服务器已当机的情况下,用户将无法创建或遍历与任何已与要重命名的 CLM 部署进行集成的外部系统的链接。
针对 Linux 服务器提供了下列示例,并且假定已通过网络安装方式来安装登台计算机的驱动器。如果您所在环境不可能通过网络安装方式进行安装,请使用其他文件传输方法来确保已复制文件。
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties TargetJazzInstallDir/server/conf/ccm
cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties TargetJazzInstallDir/server/conf/qm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/rm/fronting.properties TargetJazzInstallDir/server/conf/rm
cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf TargetJazzInstallDir/server/conf/rm
此处的目标是将主机名解析为生产环境中的任何 CLM 服务器都未使用的假 IP 地址。因此,如果登台环境中的服务器试图与生产服务器建立连接,那么连接将失败。
生成映射文件中出现的所有相异主机名的列表。这些主机名可能是源 URL,也可能是受影响的 URL。对于每个单独的主机名,请在 hosts 文件中创建一个将此主机名映射至某个假 IP 地址的条目。您需要编辑登台环境中的所有服务器(其中包括第三方服务器和客户机工作站)的 hosts 文件。以下 hosts 文件显示了登台服务器的样本条目:
# 10.10.10.10 refers to an IP address that does not host a clm application.
10.10.10.10 ProductionServerP1
10.10.10.10 ProductionServerP2
10.10.10.10 ProductionServerP3
repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
重新启动服务器之前,在 Jazz Team Server 上将开始以脱机方式进行重命名。
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
最后,按如下所示在添加 serverConfFile= 参数的情况下继续运行 repotools-jts -importURLMappings 命令。
repotools-jts.bat
-importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"
repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
然后,将 server/conf/jts/.mappingEvent 文件复制到远程应用程序配置目录 (server/conf/application_name),即 ccm、qm 和 rm。您必须在导入映射文件之后(但是要在启动服务器之前)复制 .mappingEvent 文件。
.mappingEvent 文件中包含应用程序在其新位置与 Jazz Team Server 联系时所需要的信息。对于所给定的 Jazz Team Server 及其已注册的应用程序,.mappingEvent 文件的内容相同。
通过检查控制台输出和 server/repotools-jts_importURLMappings.log 文件来确认已成功进行重命名。如果显示了任何错误,或者您认识到自己在映射文件中犯错,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。
此时,CLM 应用程序将与 Jazz Team Server 同步,以应用 URL 映射并更新这些 CLM 应用程序的数据仓库数据。对于小型数据集,完成此操作可能要耗用 5 分钟;而对于非常大的数据集,可能要耗用多达 30 分钟甚至更长时间。
一直等到所有应用程序重命名都已完成,并且“完成服务器重命名”步骤也已完成。请确认显示了以下消息:已成功完成服务器重命名。Jazz Team Server 和应用程序完全可运行。您可以立即开始使用服务器,无需重新启动。
如果显示了任何错误,请参阅对服务器重命名进行故障诊断以准确找出问题并加以解决。