Preservando a configuração do servidor CM

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

  1. 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
  2. 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
  3. 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
  4. Carregue os scripts JACL, que incluem os comandos exportToFile e importFile, no shell de comando do wsadmin: wsadmin> source teamAdminUtils.jacl
  5. 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".

  1. 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
  2. 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
  3. 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.
  4. 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.


Feedback