保留 CM Server 配置

在定制 MBean 属性,从 ClearQuest 7.1.x.y 或 8.0.x.y 进行升级,或者重新安装 ClearQuest 7.1.x.y 或 8.0.x.y 时,您需要保留 Change Management (CM) Server MBean 配置。如果不保留此配置,那么您所做的任何定制都将丢失。

关于此任务

如果您的 ClearCase 以及 ClearQuest 7.1.0.x 或 8.0.x.y 安装包含 WAN 支持软件包,那么还将安装 CM Server 组件。要确定是否已安装 WAN 支持软件包,请检查 CM 子目录是否已安装在 Rational 公共目录中:
  • 在 Windows 上:%RATIONAL_INSTALL%\%RATIONAL_COMMON%\
  • 在 UNIX 系统和 Linux 上:$RATIONAL_INSTALL/$RATIONAL_COMMON/
其中变量的含义如下:
  • RATIONAL_INSTALL:Rational 软件的安装目录
  • RATIONAL_COMMON:Rational 公共目录
注: 升级或重新安装 ClearQuest 7.1.x.y 之前,必须保留 CM Server MBean 配置,因为安装程序不会保留此配置。如果在升级或重新安装之前未执行此任务,将丢失全部定制。

另一个好办法是先导出 MBean 配置,然后再使用已安装的 CM Server 组件中随附的 wsadmin 脚本来修改任何 CM Server MBean 属性。如果新设置生成意外的结果,以上操作允许您将 MBean 值恢复为已知的正常工作配置。

当 CM Server 组件(包括 WebSphere Application Server)正在运行时,必须运行 wsadmin 脚本。请注意,您可以通过在 Windows 上创建 AT 作业或在 UNIX 系统或 Linux 上创建定时作业来定期地自动捕获 CM Server MBean 配置。

以下是 CM Server wsadmin 实用程序脚本的缺省位置:
  • 在 Windows 上:C:\Program Files\IBM\RationalSDLC\common\CM\scripts
  • 在 UNIX 系统和 Linux 上:/opt/rational/common/CM/scripts
注: 如果只安装了 ClearCase 或只安装了 ClearQuest,那么必须遵循下一节“手动保留 MBean 配置设置的过程”中的指示信息,而不要使用本节中的指示信息。

过程

导出和导入 MBean 配置设置的过程

  1. 在命令提示符窗口中,将缺省目录设置为 CM Server wsadmin 实用程序脚本的位置。例如:
    • 在 Windows 上: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
    • 在 UNIX 系统和 Linux 上:# cd /opt/rational/common/CM/scripts
  2. 通过使用与您的 shell 对应的语法来设置 wsadmin 实用程序的路径。例如:
    • 在 Windows 上:# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
    • 在 UNIX 系统和 Linux 上:# WAS_BIN=/opt/rational/common/eWAS/bin
  3. 通过指定 CM Server 概要文件名称来启动 wsadmin 实用程序。缺省情况下,CM Server 概要文件名称为 cmprofile。例如:
    • 在 Windows 上:# %WAS_BIN%\wsadmin -profileName cmprofile
    • 在 UNIX 系统和 Linux 上:# $WAS_BIN/wsadmin.sh -profileName cmprofile
  4. 将包括 exportToFile 和 importFile 命令的 JACL 脚本装入 wsadmin 命令 shell: wsadmin> source teamAdminUtils.jacl
  5. 将 MBean 配置导出到不在 CM Server 安装目录结构中的文件。
    注: 在 Windows 上,当您从 wsadmin 命令 shell 运行 JACL 脚本时,在传递到 JACL 脚本的路径规范中可以使用正斜杠“/ ”。或者,如果您选择使用反斜杠“\”,那么必须使用额外的反斜杠以对每个反斜杠字符进行转义。例如:
    • 在 Windows 上:wsadmin> exportToFile C:/temp/CmServer_backups/MBean.bck
    • 在 UNIX 系统和 Linux上:wsadmin> exportToFile /tmp/CmServer_backups/MBean.bck
    您可以使用 importFile 命令来复原已保存的 MBean 配置。升级或重新安装 CM Server 组件后,或对 MBean 配置进行更改后,如果想要回滚到先前的配置,请使用该命令。

手动保留 MBean 配置设置的过程

如果只安装了 ClearCase 或只安装了 ClearQuest,那么必须遵循本节中的指示信息。否则,如果同时安装了 ClearCase 和 ClearQuest,请使用前一节“导出和导入 MBean 配置设置的过程”中的指示信息。

  1. 在命令提示符窗口中,将缺省目录设置为以下位置,根据需要替换以下变量:
    • 如果不使用缺省概要文件名称,请替换 cmprofile
    • 使用单元名称和节点名替换 <computer-name>CMProfileNode01Cell, dfltCell,<computer-name>CMProfileNode01dfltNode
    例如:
    • 在 Windows 上: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\config\cells\ <computer-name>CMProfileNode01Cell\nodes\<computer-name>CMProfileNode01\servers\server1\stp"
    • 在 UNIX 系统和 Linux 上:# cd /opt/rational/common/CM/profiles/cmprofile/config/ cells/dfltCell/nodes/dfltNode/servers/server1/stp
  2. 将所有 .dat 文件从缺省目录复制到 CM Server 安装目录结构外的临时目录。 例如:
    • 在 Windows 上:# copy *.dat C:\temp\CmServer_mbean_config_files
    • 在 UNIX 系统和 Linux 上: # cp *.dat /tmp/CmServer_mbean_config_files
  3. 升级 ClearCase 和 ClearQuest 后,确保 CM Server 组件未运行。按照启动、停止和重新启动 CM Server 主题中的指示信息来停止 CM Server 组件。
  4. 打开命令提示符窗口。作为 root 用户,将缺省目录设置为步骤 6 中描述的位置。然后将步骤 7 中使用的临时目录中保存的 .dat 文件复制到缺省目录。例如:
    • 在 Windows 上:# copy C:\temp\CmServer_mbean_config_files\*.dat
    • 在 UNIX 系统和 Linux 上:# cp /tmp/CmServer_mbean_config_files/*.dat
    当 CM Server 组件启动时,使用复原的 .dat 文件中的数据来初始化 MBean 属性。


反馈