Aprimorando Perfis Utilizando o Comando manageprofiles

Quando você utiliza o Assistente de Perfil de forma interativa para aprimorar um perfil, uma versão da linha de comandos do aprimoramento do perfil é gravada em um arquivo de log. É possível extrair essa linha de comandos do arquivo de log, modificá-la e utilizá-la para aprimorar outros perfis.

Antes de iniciar

Antes de utilizar este procedimento, certifique-se:
Importante: Não é possível executar o comando manageprofiles em um conjunto de arquivos de produto principais simultaneamente com uma instância do Assistente de Perfil do WebSphere Process Server nem do WebSphere Application Server ou do Assistente de Criação de Perfil do WebSphere Application Server Network Deployment. Tentativas de criação simultânea de perfis irão gerar um aviso. Se um painel de aviso for exibido, determine se há outra ação de criação ou aprimoramento de perfil em andamento.
  • Se houver, você deve aguardar até sua conclusão.
  • Se não houver, exclua o arquivo profileRegistry.xml_LOCK do diretório install_root/properties, se ele existir. Você pode então executar o comando manageprofiles.

Por Que e Quando Desempenhar Esta Tarefa

Para utilizar o comando manageprofiles com o WebSphere Process Server, você já deve ter utilizado o Assistente de Perfil de forma interativa com as opções desejadas. (Não utilize o comando manageprofiles para construir inicialmente um comando augment).O assistente grava a linha de comandos utilizada para aprimorar o perfil em um arquivo de log. É possível modificar esse comando e, em seguida, executá-lo a partir da linha de comandos para aprimorar um perfil semelhante.

Uma linha de comandos capturada que foi utilizada para aprimorar um perfil terá o parâmetro -augment contido nela (geralmente no formato manageprofiles -augment).
Importante: Nunca substitua o parâmetro -augment pelo parâmetro -create. Se fizer isso, os scripts resultantes não funcionarão, pois outros parâmetros e argumentos estarão incorretos.

Etapas para Esta Tarefa

  1. Depois de aprimorar um perfil utilizando o Assistente de Perfil, abra o arquivo de log que foi gerado. O nome e o caminho do arquivo são os seguintes: profile_root/logs/pcatLogNNNNNNNNNNNNN.txt, sendo que profile_root é o diretório no qual o perfil foi aprimorado e NNNNNNNNNNNNN é um valor de registro de data e hora.
  2. No arquivo de log, procure a linha iniciada por "CAPTURED_COMMAND_LINE" e salve-a (incluindo qualquer texto abaixo devido quebra de linha) para o novo arquivo.
    1. Selecione o texto que começa com "CAPTURED_COMMAND_LINE" até o final do arquivo.
    2. Copie este texto para um novo arquivo.
    3. No novo arquivo, remova tudo da cadeia copiada, incluindo as palavras "CAPTURED_COMMAND_LINE."
    4. Salve o arquivo. Qualquer nome de arquivo exclusivo válido pode ser utilizado. Agora você tem o comando manageprofiles utilizado para aprimorar esse perfil.
  3. Utilizando um editor de texto, modifique a linha de comandos salva para refletir o aprimoramento do novo perfil que deseja executar. Não altere quaisquer outros valores nem inclua parâmetros extras que ainda não estejam na linha de comandos ou especificados em Parâmetros do Comando manageprofiles. Podem aparecer alguns parâmetros que não se aplicam a seu sistema operacional. Eles podem permanecer e não resultarão em erros.
    Certifique-se de abordar o seguinte ao modificar a linha de comandos:
    • Modifique os valores dos parâmetros -profileName, -profilePath, -cellName e -nodeName para assegurar que sejam exclusivos.
    • A linha de comandos não inclui as portas que foram definidas quando você utilizou originalmente o Assistente de Perfil. Inclua o parâmetro -portsFile ou -startingPort e um valor de porta apropriado no final da linha de comandos.

      Para obter mais informações sobre como especificar essas portas, consulte o tópico comando wasprofile no centro de informações do WebSphere Application Server Network Deployment, versão 6.0.

    • Por questões de segurança, a cadeia "MASKED_PARAMETER_VALUE" foi inserida em vez de qualquer senha especificada. Você deve substituir todas as instâncias dessa cadeia por senhas válidas. Consulte Parâmetros do Comando manageprofiles para obter informações adicionais.
    • Se for executar esse comando para aprimorar um perfil para uma instalação diferente do WebSphere Process Server, verifique todos os valores de nome de caminho, incluindo o caminho qualificado do arquivo manageprofiles.sh ou manageprofiles.bat e modifique-os se necessário.
  4. Utilize o arquivo da linha de comandos modificado para aprimorar um novo perfil.
    1. Torne o arquivo executável.
      • Icon indicating UNIX platforms Icon indicating Linux platforms Para sistemas UNIX e Linux, forneça ao arquivo uma extensão .sh e permissão de execução.
      • Icon indicating Windows platforms Para sistemas Windows, forneça ao arquivo uma extensão .bat.
    2. Execute o arquivo a partir da linha de comandos. O comando exibe o status enquanto é executado. Aguarde sua conclusão.

Exemplo

Aqui está um exemplo de uma linha de comandos capturada (não modificada) para aprimorar um perfil, conforme indicado pelo parâmetro -augment:
(9 de outubro de 2006 11:16:44 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE_DESC:
A linha a seguir é a linha de comandos equivalente à sua execução do Assistente de Perfil. A diferença dela é que as
portas (-portsFile) que você selecionou não estão incluídas. Além disso, esta linha de comandos não será federada ao perfil.
Os valores de parâmetros que talvez você queria alterar são profileName, profilePath, nodeName, cellName, hostName,
dmgrHost, dmgrPor e qualquer valor de senha que tenha sido mascarado.

(9 de outubro de 2006 11:16:44 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
"/BUILD1/ProcServer01/bin/manageprofiles.sh"  -augment -profileName "AppSrv01"
-profilePath "/BUILD1/ProcServer01/profiles/AppSrv01" -templatePath
"/BUILD1/ProcServer01/profileTemplates/default.wbiserver" -cellName  "mohawkvalleyNode10Cell"
-nodeName  "mohawkvalleyNode04" -hostName  "mohawkvalley.site" -dmgrHost  "localhost"
-dmgrPort  "8879" -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "MASKED_PARAMETER_VALUE"
-ceiSampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  "" -ceiDbUser  ""
-ceiDbPwd  "MASKED_PARAMETER_VALUE" -ceiDbSysUser  "" -ceiDbSysPwd  "MASKED_PARAMETER_VALUE"
-ceiDbJdbcDriverClasspath  "" -ceiDbJdbcDriverType  "" -ceiDbServerName  "" -ceiDbServerPort  ""
-ceiDbStorageGroup  "" -ceiDbNodeName  "" -ceiDbConnectionLocation  "" -ceiDbExecuteScripts  ""
-configureScaSecurity  "" -scaSecurityUserId  "" -scaSecurityPassword  "MASKED_PARAMETER_VALUE"
-dbName  "somedb" -dbType  "CLOUDSCAPE" -dbLocation  "" -dbUserId  ""
-dbPassword  "MASKED_PARAMETER_VALUE" -dbServerPort  "null" -dbHostName  "localhost"
-dbInstance  "ol_" -dbJDBCClasspath  "null" -dbCreateNew  "true" -dbDelayConfig  "false"
-dbStorageGroup  "" -dbConnectionLocation  "" -configureAppScheduler  "true"
-appSchedulerServer  "server1"

(9 de outubro de 2006 11:16:44 AM), Install, com.ibm.ws.install.ni.ismp.actions.ISMPLogSuccessMessageAction,
msg1, INSTCONFSUCCESS

Segue um exemplo da linha de comandos, agora modificada para remover o cabeçalho do arquivo e as informações resultantes. Antes de utilizar, você também pode ter que substituir todos os valores de "MASKED_PARAMETER_VALUE" pelas senhas adequadas para sua configuração:
/BUILD1/ProcServer01/bin/manageprofiles.sh -augment -profileName "AppSrv01"
-profilePath "/BUILD1/ProcServer01/profiles/AppSrv01" -templatePath
"/BUILD1/ProcServer01/profileTemplates/default.wbiserver" -cellName  "mohawkvalleyNode10Cell"
-nodeName  "mohawkvalleyNode04" -hostName  "mohawkvalley.site" -dmgrHost  "localhost"
-dmgrPort  "8879" -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "MASKED_PARAMETER_VALUE"
-ceiSampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  "" -ceiDbUser  ""
-ceiDbPwd  "MASKED_PARAMETER_VALUE" -ceiDbSysUser  "" -ceiDbSysPwd  "MASKED_PARAMETER_VALUE"
-ceiDbJdbcDriverClasspath  "" -ceiDbJdbcDriverType  "" -ceiDbServerName  "" -ceiDbServerPort  ""
-ceiDbStorageGroup  "" -ceiDbNodeName  "" -ceiDbConnectionLocation  "" -ceiDbExecuteScripts  ""
-configureScaSecurity  "" -scaSecurityUserId  "" -scaSecurityPassword  "MASKED_PARAMETER_VALUE"
-dbName  "somedb" -dbType  "CLOUDSCAPE" -dbLocation  "" -dbUserId  ""
-dbPassword  "MASKED_PARAMETER_VALUE" -dbServerPort  "null" -dbHostName  "localhost"
-dbInstance  "ol_" -dbJDBCClasspath  "null" -dbCreateNew  "true" -dbDelayConfig  "false"
-dbStorageGroup  "" -dbConnectionLocation  "" -configureAppScheduler  "true"
-appSchedulerServer  "server1"

Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: O exemplo a seguir mostra tal script sendo executado em um sistema Solaris. Neste caso, "myCommandline.sh" é o nome do script que foi criado. O diretório de instalação padrão mostrado (/opt/IBM/WebSphere/ProcServer/) será diferente, conforme a plataforma.
/opt/IBM/WebSphere/ProcServer/bin>myCommandline.sh
INSTCONFSUCCESS: O perfil agora existe.
INSTCONFSUCCESS: Profile augmentation succeeded.
INSTCONFSUCCESS: Profile augmentation succeeded.

/opt/IBM/WebSphere/ProcServer/bin>

Icon indicating Windows platforms Em plataformas Windows: O exemplo a seguir mostra tal script sendo executado em um sistema Windows. Neste caso, "myCommandline.bat" é o nome do script que foi criado.
C:\Arquivos de Programas\IBM\WebSphere\ProcServer\bin>myCommandline.bat
INSTCONFSUCCESS: O perfil agora existe.
INSTCONFSUCCESS: Profile augmentation succeeded.
INSTCONFSUCCESS: Profile augmentation succeeded.


C:\Arquivos de Programas\IBM\WebSphere\ProcServer\bin>

Tarefas relacionadas

(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido em tecnologia Eclipse (http://www.eclipse.org)