comando manageprofiles

Utilize a ferramenta de linha de comandos manageprofiles para gerenciar os perfis do WebSphere Process Server. O comando pode ser utilizado para criar, excluir, aprimorar, remover aprimoramento, listar ou validar os perfis.

O comando manageprofiles é outro método para a criação ou aprimoramento de perfis além do assistente de Perfil. Ao criar ou aprimorar um perfil utilizando o assistente de Perfil ou silenciosamente, uma versão da linha de comandos da configuração de criação ou aprimoramento de perfil é gravada em um arquivo de log. Os usuários avançados podem extrair essa linha de comandos do arquivo de log, modificar partes específicas cuidadosamente e utilizar com o comando manageprofiles para criar ou aprimorar outros perfis. O comando manageprofiles também permite que funções sejam fornecidas pelo Assistente de Perfil, como cancelar o aprimoramento e, em seguida, excluir um perfil.

Importante: A IBM suporta a criação ou o aprimoramento de um perfil do WebSphere Process Server com o comando manageprofiles apenas se você criar ou aprimorar primeiro um perfil semelhante que utiliza o assistente de Perfil (ou criar um perfil silenciosamente utilizando um arquivo de resposta - aprimoramento de perfil silencioso não é suportado) e, em seguida, utilizar o comando manageprofiles para "copiar" uma criação ou aprimoramento de perfil desse tipo para criar outro que seja muito semelhante.Criando Perfis Utilizando o Comando manageprofiles e Aprimorando Perfis Utilizando o Comando manageprofiles contêm instruções passo a passo para esses procedimentos. Para tarefas que não sejam criar ou aprimorar um perfil do WebSphere Process Server (reduzir, excluir, listar ou validar perfis), o uso de manageprofiles a partir da linha de comandos (sem copiar um arquivo gerado anteriormente) é suportado.

Uso

Para criar ou aprimorar os perfis WebSphere Process Server com o comando manageprofiles, siga as instruções descritas em Criando Perfis Utilizando o Comando manageprofiles e em Aprimorando Perfis Utilizando o Comando manageprofiles. Você também pode utilizar o comando manageprofiles para excluir, inalterar, listar ou validar um perfil diretamente da linha de comandos, conforme mostrado em Sintaxe do Comando manageprofiles.
Restrição:
Não utilize o comando wasprofile para modificar um perfil WebSphere Process Server.

Tipos de Perfis

Gabaritos para cada perfil estão localizados no diretório install_root/profileTemplates. Nesse diretório estão vários diretórios que correspondem a diferentes tipos de perfis. Os diretórios são os caminhos indicados ao utilizar o comando manageprofiles com a opção -templatePath. Também é possível especificar modelos de perfil que ficam fora da raiz da instalação, se existirem. Os modelos a utilizar com o WebSphere Process Server são os seguintes:
  • default.wbiserver: para um perfil independente.
  • dmgr.wbiserver: para um perfil do gerenciador de implementação.
  • managed.wbiserver: para um perfil customizado.

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.

Criação de Log

Cada chamada do comando manageprofiles cria dois logs no diretório install_root/logs/wasprofile.
  • O wasprofile_<modo>_profile_name.log contém os detalhes da ação que foi executada pelo comando manageprofiles.
  • O manageProfiles-<modo>-profile_name.log contém uma descrição muito mais resumida de quais modelos foram aplicados a uma determinada chamada e seus códigos de retorno.
Por exemplo, o comando manageprofiles manageprofiles_create_profile1 cria dois arquivos de registro:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageProfiles-create-profile1.log

Sintaxe do Comando manageprofiles

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.

Tabela 1.
Tarefa Comando
Crie um perfil. Siga as instruções de Criando Perfis Utilizando o Comando manageprofiles.
Aprimore um perfil. Siga as instruções de Aprimorando Perfis Utilizando o Comando manageprofiles.
Liste os perfis existentes.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh -listProfiles
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -listProfiles
Remova o aprimoramento mais recente de um perfil.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh -unaugment
            -profileName profile_name
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -unaugment
            -profileName profile_name
Exclua os perfis.
Nota: Você deve remover todos os aprimoramentos de um perfil antes de excluí-lo. Caso contrário, podem ocorrer resultados inesperados.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh -delete
              -profileName profile_name |
              -profilePath profile_path
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -delete
              -profileName profile_name |
              -profilePath profile_path
Obtenha o nome de um perfil existente de seu caminho.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh -getPath
               -profilePath profile_path
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -getPath
               -profilePath profile_path
Obtenha o nome de um perfil existente de seu nome.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh -getName
               -profileName profile_name
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -getName
               -profileName profile_name
Verifique a integridade do registro do perfil.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh
                 -validateRegistry
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -validateRegistry
Verifique a integridade do registro do perfil, removendo perfis não localizados.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles.sh
               -validateAndUpdateRegistry
               [-backup file_name]
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles
               -validateAndUpdateRegistry
               [-backup file_name]
Obtenha ajuda para o comando.
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX:
    # ./manageprofiles -help
    
    # ./manageprofiles -option_name -help
  • Icon indicating Windows platforms Em plataformas Windows:
    manageprofiles -help
    
    manageprofiles -option_name -help

Parâmetros

Consulte Parâmetros do Comando manageprofiles para obter descrições de parâmetros a utilizar com o comando manageprofiles para o WebSphere Process Server.

Saída de Comando

Na conclusão, o comando imprime uma instrução semelhante a uma das seguintes (o texto exato varia conforme o modo de manageprofiles chamado):
  • INSTCONFSUCCESS: Criação de perfil bem-sucedida.
  • INSTCONFFAILED: Falha na criação de perfil.
  • INSTCONFPARTIALSUCCESS: Algumas ações não críticas de configuração pós-instalação não foram bem-sucedidas.
Em alguns casos, a instrução é impressa mais de uma vez. Por exemplo, a linha INSTCONFSUCCESS é impressa três vezes na linha de comandos.

(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido em tecnologia Eclipse (http://www.eclipse.org)