WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas Operacionais: AIX, HP-UX, Linux, Solaris, Windows

Utilizando o Comando manageprofiles para Criar e Estender Perfis

Quando o Assistente de Criação de Perfil é utilizado (no modo interativo ou silencioso) para inicialmente criar ou estender um perfil, uma versão da linha de comandos da criação ou extensão de perfil é gravada em um arquivo de log. Você pode extrair essa linha de comandos do arquivo de log, modificá-la e utilizá-la para criar ou estender outros perfis.

Antes de iniciar

Para utilizar manageprofiles com o WebSphere ESB, é preciso que você já tenha utilizado o Assistente de Criação de Perfil (GUI ou arquivos de resposta silenciosos) para criar um novo perfil ou estender um perfil existente com as opções que desejar. (Não utilize manageprofiles para construir inicialmente um comando de extensão ou criação).

Por Que e Quando Desempenhar Esta Tarefa

A linha de comandos resultante da utilização do Assistente de Criação de Perfil ou da instalação silenciosa será capturada em um arquivo de log. Você utilizará o conteúdo desse arquivo de log para criar uma linha de comandos semelhante que será utilizada subseqüentemente em uma criação ou extensão de perfil, utilizando o comando manageprofiles.

Uma linha de comandos capturada que foi utilizada para criar um perfil, conterá o parâmetro -create (normalmente, na forma de manageprofiles -create). Uma linha de comandos capturada que foi utilizada para estender um perfil, conterá o parâmetro -augment (normalmente, na forma de manageprofiles -augment). Não troque esses parâmetros na linha de comandos. Por exemplo, não substitua -create por -augment. Os scripts resultantes não funcionarão porque outros parâmetros e argumentos estarão incorretos.

Nota: O WebSphere ESB não oferece suporte à extensão de um perfil que esteja federado a um gerenciador de implementação. Primeiro, é necessário cancelar a federação desse perfil para poder estendê-lo e, em seguida, executar a ferramenta de linha de comandos addNode para federá-lo novamente.

Etapas para Esta Tarefa

  1. Depois de criar ou estender um perfil utilizando o Assistente de Criação de Perfil ou a instalação silenciosa, abra o arquivo de log que foi gerado. O nome e o caminho de arquivo são: profile_root/logs/pcatLogNNNNNNNNNNNNN.txt, em que profile_root é o diretório no qual o perfil foi criado e NNNNNNNNNNNNN, é um valor de time stamp.
  2. No arquivo de log, procure a linha que começa com "CAPTURED COMMAND LINE" e salve-a (incluindo qualquer texto agrupado abaixo dela) em um novo arquivo.
    1. Selecione o texto começando com "CAPTURED COMMAND LINE", até o final do arquivo.
    2. Copie esse texto em um novo arquivo.
    3. No novo arquivo, remova tudo da cadeia copiada, incluindo as palavras "CAPTURED COMMAND LINE."
    4. Salve o arquivo. (Pode ser utilizado qualquer nome de arquivo válido). Agora, a linha de comandos equivalente à da execução anterior do Assistente de Criação de Perfil está salva neste arquivo.
  3. Modifique a linha de comandos para refletir qualquer alteração. Utilizando um editor de texto, agora é necessário modificar o comando que você salvou, para refletir a nova criação ou extensão de perfil que deseja desempenhar. Os valores a seguir devem ou podem ser modificados.
    Nota: Não altere nenhum outro valor ou inclua nenhum parâmetro extra que já não esteja na linha de comandos ou especificado em Parâmetros manageprofiles.
    Se você for... Então...
    Criar ou Estender um Perfil É necessário substituir as ocorrências da cadeia "MASKED_PARAMETER_VALUE" em qualquer lugar do arquivo por senhas válidas. A cadeia "MASKED_PARAMETER_VALUE" foi inserida no lugar da senha especificada, por motivos de segurança. Será necessário substituir essas cadeias. Consulte Parâmetros manageprofiles para obter informações adicionais.
    Estender um Perfil Existente Os valores dos parâmetros -profileName, -profilePath, -cellName e -nodeName devem corresponder exatamente àqueles do perfil que você deseja estender. Talvez você queira modificar os valores, dependendo da origem da linha de comandos e de qual perfil você modificará.
    Estender um Perfil Existente O gabarito de perfil na linha de comandos precisa ser do mesmo tipo (independente, gerenciador de implementação ou personalizado) do perfil que você deseja estender. A falha no cumprimento dessas instruções poderá produzir resultados incorretos.
    Criar um Novo Perfil Modifique -profileName, -profilePath, -cellName e -nodeName para assegurar que sejam exclusivos.
    Criar um Novo Perfil Especifique novamente as portas que foram definidas no Assistente de Criação de Perfil. A linha de comandos não inclui as portas que foram definidas quando você utilizou originalmente o Assistente de Criação de Perfil. Inclua o parâmetro -portsFile ou -startPort e um valor de porta apropriado no final da linha de comandos. Para obter mais informações sobre como especificar essas portas, consulte as instruções no comando wasprofile no centro de informações do WebSphere Application Server.
    Utilizar essa Linha de Comandos em outra Instalação do WebSphere ESB (no Mesmo Computador em que o Perfil Original Foi Criado, ou em Outro) Se necessário, modifique os valores do nome do caminho para refletir o local da instalação do WebSphere ESB diferente e modificar o caminho completo do local do diretório em que esse arquivo de comandos será localizado.
  4. Utilize o arquivo de linha de comandos modificado para criar ou estender um perfil existente.
    1. Torne o arquivo executável.
      • UNIX platforms LINUX platforms Para sistemas UNIX e Linux, forneça ao arquivo uma extensão .sh e permissão de execução.
      • For 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 exibirá o status, conforme é executado. Aguarde até que seja concluído.

Exemplo

Segue abaixo um exemplo de uma linha de comandos (não-modificada) capturada para a criação de um novo perfil. Neste caso, o comando foi utilizado para criar um novo perfil, conforme indicado pelo parâmetro -create:


(Nov 3, 2005 9:24:08 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
 /opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "ESB01" -profilePath
"/opt/o054 4.12/profiles/ESB01" -templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver"
 -federateLater "true" -hostName  "eexfvt99.rchland.ibm.com" -nodeName "eexfvt99Node28"
 -cellName  "eexfvt99Node26Cell" -dmgrHost  "localhost" -dmgrP ort  "8879" -OS_NAME  "Linux"
-winserviceCheck  "true" -winserviceAccountType  " localsystem" -winserviceUserName  "root"
 -winservicePassword  "MASKED_PARAMETER_ VALUE" -winserviceStartupType  "manual" -dbJDBCClasspath
 "null" -dbType  "CLOUD SCAPE" -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "MASKED_PARAMETER_VALUE"
 -cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  ""
-ce iDbUser  "" -ceiDbPwd  "MASKED_PARAMETER_VALUE" -ceiDbSysUser  ""
 -ceiDbSysPwd "MASKED_PARAMETER_VALUE" -ceiDbJdbcDriverClasspath  ""
-ceiDbJdbcDriverType  "" -ceiDbServerName  "" -ceiDbServerPort  ""
 -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity  "true" -scaSecurityUserId
 "root" -scaSecurityPassword  "MASKED_PARAMETER_VALUE" 

Segue abaixo um exemplo da linha de comandos, agora modificada para remover as informações do cabeçalho do arquivo e substituir as senhas com máscaras. Segue abaixo um exemplo da linha de comandos, agora modificada para remover as informações do cabeçalho do arquivo e substituir as senhas com máscaras.
/opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "myProfile"
 -profilePath "/opt/o054 4.12/profiles/myProfile"
-templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver"
-federateLater "true" -hostName  "eexfvt99.rchland.ibm.com"
 -nodeName "myNodeName" -cellName  "myCellName" -dmgrHost  "localhost"
-dmgrPort  "8879" -OS_NAME  "Linux" -winserviceCheck  "true" -winserviceAccountType
 " localsystem" -winserviceUserName  "root" -winservicePassword  "rootPassword"
-winserviceStartupType  "manual" -dbJDBCClasspath  "null" -dbType  "CLOUD SCAPE"
 -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "myRootPwd"
-cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  ""
-ce iDbUser  "" -ceiDbPwd  "myPassword" -ceiDbSysUser  "" -ceiDbSysPwd "myPassword"
 -ceiDbJdbcDriverClasspath  "" -ceiDbJdbcDriverType  "" -ceiDbServerName  ""
 -ceiDbServerPort  "" -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity
  "true" -scaSecurityUserId  "root" -scaSecurityPassword  "myRootPwd" 

UNIX platforms LINUX platforms O exemplo a seguir mostra o script sendo executado em um sistema Unix. Neste caso, "myCommandline.sh" é o nome do script que foi criado:
/opt/IBM/WebSphere/ESB/bin>myCommandline.sh
INSTCONFSUCCESS: Agora, existe um perfil.
INSTCONFSUCCESS: Extensão de perfil bem-sucedida.
INSTCONFSUCCESS: Extensão de perfil bem-sucedida.

/opt/IBM/WebSphere/ESB/bin>

For Windows platforms O exemplo a seguir mostra o script sendo executado em um sistema Windows. Neste caso, "myComnmandline.bat" é o nome do script que foi criado:
C:\Program Files\IBM\WebSphere\ESB\bin>myCommandline.bat
INSTCONFSUCCESS: Agora, existe um perfil.
INSTCONFSUCCESS: Extensão de perfil bem-sucedida.
INSTCONFSUCCESS: Extensão de perfil bem-sucedida.


C:\Program Files\IBM\WebSphere\ESB\bin>


Task topic

Termos de Uso | Avalie esta página

Timestamp iconÚltima atualização: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\tins_manageprofiles.html

(C) Direitos Autorais IBM Corporation 2005. Todos os Direitos Reservados.
Este centro de informações é desenvolvido em tecnologia Eclipse. (http://www.eclipse.org)