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

Comando manageprofiles

A ferramenta de linha de comandos manageprofiles pode ser utilizada para criar todos os ambientes de tempo de execução do WebSphere ESB, como uma alternativa para o Assistente de Criação de Perfil gráfico. O comando cria perfis, que são conjuntos de arquivos que definem o ambiente de tempo de execução de um gerenciador de implementação, um perfil personalizado ou um perfil de servidor independente. O comando pode ser utilizado para criar, excluir, estender, reduzir, listar ou validar os perfis.

O Assistente de Criação de Perfil é um aplicativo InstallShield para Multiplataformas. É possível utilizar o assistente para inserir a maioria dos parâmetros que são descritos neste tópico. No entanto, alguns parâmetros requerem a utilização do comando manageprofiles. Você precisa utilizar o comando manageprofiles para excluir ou reduzir um perfil, por exemplo, porque o Assistente de Criação de Perfil não fornece uma função de exclusão.

No entanto, o Assistente de Criação de Perfil também desempenha tarefas que o comando manageprofiles não desempenha. Por exemplo, o assistente pode criar um serviço do Windows para cada perfil que ele criar. Ele também pode designar portas não-conflitantes com base em designações de portas anteriores.

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 cuidadosamente e utilizá-la para criar ou estender outros perfis.

Importante: Para criar um novo perfil do WebSphere ESB ou estender um perfil existente do WebSphere Application Server com êxito, você deve primeiro utilizar o Assistente de Criação de Perfil ou o processo de instalação silenciosa e utilizar o comando manageprofiles somente para "clonar" esse perfil ou criar um que seja muito semelhante. Utilizando o Comando manageprofiles para Criar e Estender Perfis contém instruções passo a passo para este procedimento.
Consulte as seguintes seções para obter mais informações:

Tipos de Perfis

Gabaritos para cada perfil estão localizados no diretório install_root/profileTemplates.

Dentro desse diretório, há vários diretórios que correspondem a tipos de perfis diferentes. Esses diretórios são os caminhos que você indica para o comando manageprofiles com a opção -templatePath. Você também pode especificar gabaritos de perfil que ficam fora da raiz da instalação, se tiver algum.

O comando manageprofiles no WebSphere ESB pode criar os seguintes tipos de perfis ESB:
  • O perfil de servidor independente utiliza o gabarito install_root/profileTemplates/default.esbserver.
  • O perfil de gerenciador de implementação utiliza o gabarito install_root/profileTemplates/dmgr.esbserver.
  • O perfil personalizado utiliza o gabarito install_root/profileTemplates/managed.esbserver.

Localização do Arquivo de Comandos

O arquivo de comandos está localizado no diretório raiz_da_instalação/bin. O arquivo de comandos é um script denominado manageprofiles.sh para plataformas Linux e UNIX ou manageprofiles.bat para plataformas Windows.

O Assistente para Criação de Perfil é a interface gráfica com o usuário para a ferramenta de linha de comandos. O nome do arquivo do comando que chama o Assistente para Criação de Perfil varia por plataforma de sistema operacional.

Registro em log

Cada chamada do manageprofiles criará dois logs no diretório install_root/logs/wasprofile.
  • O wasprofile_<mode>_profile_name.log conterá detalhes das ações que foram chamadas pelo comando manageprofiles.
  • O manageprofile_<mode>_profile_name.log conterá uma descrição muito menor de quais gabaritos foram aplicados para uma determinada chamada e de seus códigos de retorno.
Por exemplo, quando o comando manageprofiles é utilizado para criar um perfil chamado profile1, são criados dois arquivos de log:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageprofile-create-profile1.log
LINUX platforms UNIX platforms

Sintaxe de Comando manageprofiles.sh

Utilize a sintaxe e os parâmetros a seguir com o comando manageprofiles para obter informações sobre seus perfis, como excluir perfis ou reduzir perfis. Para criar ou estender um perfil com o manageprofiles, siga as instruções em Utilizando o Comando manageprofiles para Criar e Estender Perfis.

Listar perfis existentes:
# ./manageprofiles.sh -listProfiles
                 
Remover o aumento mais recente para um perfil:
# ./manageprofiles.sh -unaugment
              -profileName profile_name
Excluir perfis:
Nota: É necessário remover todas as extensões de um perfil antes de excluí-lo. Emita o comando unaugment duas vezes, antes de emitir o comando delete para perfis do WebSphere ESB. Isso assegura que o perfil e todos seus artefatos relacionados sejam excluídos. Depois de excluir um perfil, exclua manualmente o conteúdo do diretório profile_root, antes de tentar recriar o perfil.
# ./manageprofiles.sh -unaugment
              -profileName profile_name
# ./manageprofiles.sh -unaugment
              -profileName profile_name
# ./manageprofiles.sh -delete
                -profileName profile_name | -profilePath profile_path
                
Obtenha o nome de um perfil existente a partir do caminho:
# ./manageprofiles.sh -getName 
                 -profilePath profile_path
                
Obtenha o caminho de um perfil existente a partir do nome:
# ./manageprofiles.sh -getPath 
                 -profileName profile_name
                
Verificar a integridade do registro do perfil:
# ./manageprofiles.sh -validateRegistry
                
Verificar a integridade do registro do perfil, removendo perfis que não foram localizados:
# ./manageprofiles.sh -validateAndUpdateRegistry
                 [-backup file_name]
                
Obter ajuda para o comando:
# ./manageprofiles.sh -help

# ./manageprofiles.sh -option_name -help
For Windows platforms

Sintaxe de Comando manageprofiles.bat

Listar perfis existentes:
manageprofiles -listProfiles
             
Remover o aumento mais recente para um perfil:
manageprofiles -unaugment
               -profileName profile_name
Excluir perfis:
Nota: É necessário remover todas as extensões de um perfil antes de excluí-lo. Emita o comando unaugment duas vezes, antes de emitir o comando delete. Isso assegura que o perfil e todos seus artefatos relacionados sejam excluídos. Depois de excluir um perfil, exclua manualmente o conteúdo do diretório profile_root, antes de tentar recriar o perfil.
manageprofiles -unaugment
               -profileName  profile_name
manageprofiles -unaugment
               -profileName  profile_name
manageprofiles -delete
              -profileName profile_name | -profilePath profile_path
            
Obtenha o nome de um perfil existente a partir do caminho:
manageprofiles -getName
               -profilePath fully_qualified_profile_path
             
Obtenha o caminho de um perfil existente a partir do nome:
manageprofiles -getPath
               -profileName profile_name
             
Verificar a integridade do registro do perfil:
manageprofiles -validateRegistry
             
Verificar a integridade do registro do perfil, removendo qualquer perfil não localizado:
manageprofiles -validateAndUpdateRegistry
             [-backup file_name]
             
Obter ajuda para o comando:
manageprofiles -help

manageprofiles -option_name -help

Executar Como

O comando manageprofiles do WebSphere ESB tem o mesmo conjunto de parâmetros que o comando manageprofiles do WebSphere Process Server.

Consulte Parâmetros manageprofiles para obter uma lista e descrições de parâmetros que podem ser utilizados com o comando manageprofiles para o WebSphere ESB.

Saída de Comando

Quando um comando de criação ou extensão for concluído, serão impressas as seguintes instruções na linha de comandos (os termos exatos irão variar, dependendo de qual modo do manageprofiles foi chamado):
  • INSTCONFSUCCESS: criação de perfil concluída com êxito.
  • INSTCONFFAILED: falha na criação do perfil.
  • INSTCONFPARTIALSUCCESS: não houve êxito em algumas ações de configuração não-críticas após a instalação.
Em alguns casos, a instrução é impressa mais de uma vez. Por exemplo, para um perfil do WebSphere ESB, a linha INSTCONFSUCCESS é impressa 3 vezes na linha de comandos.

Exemplos

ReduzirLINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -unaugment –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -unaugment –profileName profileName
ExcluirLINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -delete –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -delete –profileName profileName
Referências relacionadas
Parâmetros manageprofiles

Reference 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\ref\rwesb_manageprofile.html

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