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:
- 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.
- Desligue todos os servidores associados ao perfil que você planeja aprimorar.
- Se você planeja aprimorar um servidor independente ou customizar um perfil, determine se ele já foi federado em um gerenciador de implementação:
- Se o perfil que você deseja aprimorar já foi federado para um gerenciador de implementação, você não poderá aprimorá-lo para um perfil do WebSphere Process Server utilizando o comando manageprofiles. É necessário aprimorá-lo manualmente seguindo o procedimento
em Aprimorando Manualmente um Perfil Federado.
- Se o perfil que você deseja aprimorar ainda não foi federado em um gerenciador de implementação, ao federá-lo através do comando addNode posteriormente, o seguinte deve ser verdadeiro em relação ao gerenciador de implementação com o qual ele é federado para que o aprimoramento seja concluído com êxito.
- Ele deve estar em execução.
- Ele deve utilizar o tipo de conector SOAP JMX padrão e o conector deve estar ativado.
- Já deve ter sido aprimorado em um perfil do WebSphere Process Server.
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
- 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.
- 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.
- Selecione o texto que começa com "CAPTURED_COMMAND_LINE"
até o final do arquivo.
- Copie este texto para um novo arquivo.
- No novo arquivo, remova tudo da cadeia copiada, incluindo
as palavras "CAPTURED_COMMAND_LINE."
- Salve o arquivo. Qualquer nome de arquivo exclusivo válido pode ser utilizado. Agora você tem o comando manageprofiles utilizado para aprimorar esse perfil.
- 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:
- Utilize o arquivo da linha de comandos modificado para aprimorar um novo perfil.
- Torne o arquivo executável.
Para sistemas UNIX e Linux, forneça ao arquivo uma extensão .sh e permissão de execução.
Para sistemas Windows, forneça ao arquivo uma extensão .bat.
- 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"
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>
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>