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
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
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
Reduzir
install_root/bin manageProfiles.sh -unaugment –profileName profileName
install_root\bin manageProfiles -unaugment –profileName profileName
Excluir
install_root/bin manageProfiles.sh -delete –profileName profileName
install_root\bin manageProfiles -delete –profileName profileName