Criando Perfis Utilizando o Comando manageprofiles

Ao utilizar o Assistente de Perfil (de forma interativa ou silenciosa) para criar um perfil inicialmente, uma versão da linha de comandos da criação 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 criar outros perfis.

Antes de iniciar

Antes de utilizar esse procedimento, assegure-se de que tenha revisado a lista de pré-requisitos para criar ou aprimorar um perfil em Pré-requisitos para a Criação ou Aprimoramentos de Perfis.
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 ou silenciosa para criar um novo perfil com as opções desejadas. (Não utilize o comando manageprofiles para construir inicialmente um comando create). O assistente grava a linha de comandos utilizada para criar o perfil em um arquivo de log. É possível modificar esse comando e, em seguida, executá-lo a partir da linha de comandos para criar um perfil semelhante.
Uma linha de comandos capturada que foi utilizada para criar um perfil terá o parâmetro -create contido nela (geralmente no formato manageprofiles -create).
Importante: Nunca substitua o parâmetro -create pelo parâmetro -augment. Se fizer isso, os scripts resultantes não funcionarão, pois outros parâmetros e argumentos estarão incorretos.

Etapas para Esta Tarefa

  1. Após ter criado um perfil utilizando o Assistente de Perfil ou de forma silenciosa com arquivos de resposta, abra o arquivo de log gerado. O caminho do arquivo e o nome são os seguintes: profile_root/logs/pcatLogNNNNNNNNNNNNN.txt, sendo que profile_root é o diretório no qual o perfil foi criado e NNNNNNNNNNNNN é o 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 criar esse perfil.
  3. Utilizando um editor de texto, modifique a linha de comandos salva para refletir a criação 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 criar 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 criar um novo perfil.
    1. Torne o arquivo executável.
      • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: Dê ao arquivo uma extensão .sh e permissões de execução.
      • Icon indicating Windows platforms Em plataformas Windows: Dê 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 criar um novo perfil, conforme indicado pelo parâmetro -create:


(12 de outubro de 2006 9:42:58 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, dmgrPort e qualquer valor de senha que tenha sido mascarado.


(12 de outubro de 2006 9:42:58 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
"/BUILD1/ProcServer01/bin/manageprofiles.sh" -create -profileName "ProcSrv02"
-profilePath "/BUILD1/ProcServer01/profiles/ProcSrv02" -templatePath
"/BUILD1/ProcServer01/profileTemplates/default.wbiserver" -hostName "mohawkvalley.site"
-nodeName "mohawkvalleyNode09" -cellName "mohawkvalleyNode16Cell" -dmgrHost "localhost"
-dmgrPort "8879" -OS_NAME "Linux" -winserviceCheck "true" -winserviceAccountType "localsystem" 
-winserviceUserName "root" -winservicePassword "MASKED_PARAMETER_VALUE"
-winserviceStartupType "manual" -dbJDBCClasspath "null" -dbType "CLOUDSCAPE"
-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 "true"
-scaSecurityUserId "root" -scaSecurityPassword "MASKED_PARAMETER_VALUE" -bpcadminUsers "root"
-bpcmqUser "root" -bpcmqPwd "MASKED_PARAMETER_VALUE" -dbName "WPRCSDB01" -dbLocation ""
-dbUserId "" -dbPassword "MASKED_PARAMETER_VALUE" -dbServerPort "null" -dbHostName "localhost" 
-dbInstance "ol_" -dbCreateNew "true" -dbDelayConfig "false" -dbStorageGroup ""
-dbConnectionLocation "" -configureAppScheduler  "true" -appSchedulerServer  "server1" 
(Oct 12, 2006 9:42:58 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 -create -profileName "ProcSrv02"
-profilePath "/BUILD1/ProcServer01/profiles/ProcSrv02" -templatePath
"/BUILD1/ProcServer01/profileTemplates/default.wbiserver" -hostName "mohawkvalley.site"
-nodeName "mohawkvalleyNode09" -cellName "mohawkvalleyNode16Cell" -dmgrHost "localhost"
-dmgrPort "8879" -OS_NAME "Linux" -winserviceCheck "true" -winserviceAccountType "localsystem" 
-winserviceUserName "root" -winservicePassword "MASKED_PARAMETER_VALUE"
-winserviceStartupType "manual" -dbJDBCClasspath "null" -dbType "CLOUDSCAPE"
-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 "true"
-scaSecurityUserId "root" -scaSecurityPassword "MASKED_PARAMETER_VALUE" -bpcadminUsers "root"
-bpcmqUser "root" -bpcmqPwd "MASKED_PARAMETER_VALUE" -dbName "WPRCSDB01" -dbLocation ""
-dbUserId "" -dbPassword "MASKED_PARAMETER_VALUE" -dbServerPort "null" -dbHostName "localhost" 
-dbInstance "ol_" -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: Criação de perfil bem-sucedida.
INSTCONFSUCCESS: Criação de perfil bem-sucedida.

/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: Criação de perfil bem-sucedida.
INSTCONFSUCCESS: Criação de perfil bem-sucedida.


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)