Você precisa preservar a configuração de MBean do servidor Change Management
(CM) antes de customizar atributos MBean, atualizar ou reinstalar o ClearQuest
7.1.x.y ou 8.0.x.y. Se a configuração não for preservada, toda configuração feita será
perdida.
Sobre Esta Tarefa
Se a sua instalação do ClearCase e ClearQuest 7.1.0.x ou 8.0.x.y incluir os
pacotes de suporte WAN, os componentes do servidor CM também serão instalados. Para
determinar se os pacotes de suporte WAN estão instalados, verifique se o subdiretório do
CM está instalado no diretório comum do Rational:
- No Windows: %RATIONAL_INSTALL%\%RATIONAL_COMMON%\
- No sistema UNIX e Linux: $RATIONAL_INSTALL/$RATIONAL_COMMON/
em
que as variáveis têm os significados a seguir:
- RATIONAL_INSTALL: Diretório no qual o software Rational está instalado
- RATIONAL_COMMON: Diretório comum do Rational
Nota: Antes de atualizar o
reinstalar o ClearQuest 7.1.x.y, é necessário preservar a configuração de MBean do
servidor CM porque o instalador não faz isso. Se você não executar essa tarefa antes do
upgrade ou da reinstalação, toda customização será perdida.
É também uma boa prática exportar a configuração de MBean antes de modificar qualquer
atributo MBean do servidor CM usando os scripts wsadmin incluídos nos
componentes do servidor CM instalados. Isso permite restaurar os valores de MBean para
uma configuração de trabalho conhecida se as novas configurações produzirem resultados
indesejáveis.
Você deve executar os scripts wsadmin enquanto os componentes do servidor
CM, incluindo o WebSphere Application Server, estão em execução. Observe que é possível
automatizar o procedimento de captura da configuração de MBean do servidor CM
periodicamente, criando uma tarefa AT no Windows ou uma tarefa cron no sistema UNIX ou
Linux.
Veja a seguir o local padrão dos scripts do utilitário wsadmin do
servidor CM:
- No Windows: C:\Program Files\IBM\RationalSDLC\common\CM\scripts
- No sistema UNIX e Linux: /opt/rational/common/CM/scripts
Nota: Se apenas o
ClearCase ou o ClearQuest estiver instalado, você deverá seguir as instruções na próxima
seção "Procedimento para preservar manualmente as definições de configuração de MBean" em
vez de usar as instruções nesta seção.
Procedimento
Procedimento para exportar e importar definições de configuração de MBean
- Em uma janela de prompt de comandos, configure o diretório padrão como o local dos
scripts do utilitário wsadmin do servidor CM. Por exemplo:
- No Windows: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
- No sistema UNIX e Linux: # cd /opt/rational/common/CM/scripts
- Configure o caminho para o utilitário wsadmin usando a sintaxe apropriada para o shell. Por exemplo:
- No Windows: # set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
- No sistema UNIX e Linux: # WAS_BIN=/opt/rational/common/eWAS/bin
- Inicie o utilitário wsadmin especificando o nome do perfil do servidor CM. Por
padrão, o nome do perfil do servidor CM é cmprofile. Por exemplo:
- No Windows: # %WAS_BIN%\wsadmin -profileName cmprofile
- No sistema UNIX e Linux: # $WAS_BIN/wsadmin.sh -profileName
cmprofile
- Carregue os scripts JACL, que incluem os comandos exportToFile e importFile, no
shell de comando do wsadmin: wsadmin>
source teamAdminUtils.jacl
- Exporte a configuração de MBean para um arquivo que está fora da estrutura do
diretório de instalação do servidor CM.
Nota: No Windows, quando você executa um script JACL no shell de comando do wsadmin, é
possível usar barras '/' na especificação do caminho transmitido ao script JACL. Como
alternativa, se você optar por usar barras invertidas '\', deverá escapar cada caractere
de barra invertida com uma barra invertida adicional.
Por exemplo:
- No Windows: wsadmin> exportToFile C:/temp/CmServer_backups/MBean.bck
- No sistema UNIX e Linux: wsadmin> exportToFile /tmp/CmServer_backups/MBean.bck
É possível usar o comando importFile para restaurar uma
configuração de MBean salva. Use esse comando depois de atualizar ou reinstalar os
componentes do servidor CM ou se, depois de fazer mudanças na configuração de MBean, você
desejar retroceder para uma configuração anterior.
Procedimento para preservar manualmente as definições de configuração de
MBean
Se apenas o ClearCase ou o ClearQuest estiver instalado, você deverá seguir
as instruções nesta seção. Caso contrário, se o ClearCase e o ClearQuest estiverem
instalados, use as instruções na seção anterior "Procedimento para exportar e importar
definições de configuração de MBean".
- Em uma janela de prompt de comandos, configure o diretório padrão como o local a
seguir, substituindo as variáveis a seguir, conforme apropriado:
- Substitua cmprofile se o nome do perfil padrão não for usado
- Substitua <computer-name>CMProfileNode01Cell,
dfltCell,<computer-name>CMProfileNode01 ou dfltNode pelo
nome da célula e o nome do nó
Por exemplo:
- No Windows: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\config\cells\ <computer-name>CMProfileNode01Cell\nodes\<computer-name>CMProfileNode01\servers\server1\stp"
- No sistema UNIX e Linux: # cd /opt/rational/common/CM/profiles/cmprofile/config/
cells/dfltCell/nodes/dfltNode/servers/server1/stp
- Copie todos os arquivos .dat do diretório padrão para um diretório temporário fora
da estrutura de diretório de instalação do servidor CM.
Por exemplo:
- No Windows: # copy *.dat C:\temp\CmServer_mbean_config_files
- No sistema UNIX e Linux: # cp *.dat /tmp/CmServer_mbean_config_files
- Após o upgrade do ClearCase e do ClearQuest, assegure-se de que os componentes do
servidor CM não estejam em execução. Siga as instruções no tópico
Iniciando,
parando e reiniciando o servidor CM para parar os componentes do servidor CM.
- Abra uma janela de prompt de comandos. Como usuário raiz, configure o diretório
padrão como o local descrito na etapa 6. Em seguida, copie os arquivos .dat salvos do
diretório temporário usado na etapa 7 para o diretório padrão. Por exemplo:
- No Windows: # copy C:\temp\CmServer_mbean_config_files\*.dat
- No sistema UNIX e Linux: # cp /tmp/CmServer_mbean_config_files/*.dat
Quando
os componentes do servidor CM forem iniciados, os dados dos arquivos .dat restaurados
serão usados para inicializar os atributos MBean.