O comando manageprofiles
cria um perfil, que é o conjunto de arquivos que define o ambiente de tempo de execução
para um gerenciador de implementação, um nó gerenciado ou um servidor independente.
O perfil define o ambiente do tempo de execução
e inclui todos os arquivos que os processos do servidor podem alterar durante o tempo
de execução.
O comando manageprofiles e sua
interface gráfica com o usuário, o Profile Management Tool, são as únicas formas
de criar perfis ou as únicas formas de criar ambientes de tempo de execução.
Você
também pode aumentar perfis e excluir perfis com o comando manageprofiles.
O arquivo de comandos está localizado no diretório raiz_da_instalação/bin.
O arquivo de comando é um script denominado manageprofiles para plataformas i5/OS,
manageprofiles.sh para plataformas Linux®
e UNIX®
ou manageprofiles.bat para
plataformas Windows®.
Os arquivos são denominados conforme a seguir:
- profile_name_create.log
- profile_name_augment.log
- profile_name_delete.log
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.
Utilize os seguintes
modelos com
WebSphere ESB:
- default.esbserver: para um perfil do servidor independente do WebSphere Enterprise Service Bus,
que define um servidor independente.
- dmgr.esbserver: para um perfil do gerenciador de implementação do WebSphere Enterprise Service Bus,
que define um gerenciador de implementação.
- managed.esbserver: para um perfil customizado do WebSphere Enterprise Service Bus,
que, quando associado a um gerenciador de implementação, define um nó
gerenciado.
Sintaxe
O comando
manageprofiles
é utilizado para desempenhar as seguintes tarefas:
- Criar um perfil (parâmetro -create).
Siga as instruções em Criando Perfis Utilizando o Comando manageprofiles.
- Aumentar um perfil (parâmetro -augment).
Siga as instruções em Aprimorando Perfis Utilizando o Comando manageprofiles.
Nota: Utilizar perfis não-aprimorados (parâmetro -unaugment)
não é suportado.
- Excluir um perfil (parâmetro -delete).
Siga as instruções em Excluindo Perfis Utilizando o Comando manageprofiles.
- Excluir todos os perfis (parâmetro -deleteAll)
- Listar todos os perfis (parâmetro -listProfiles)
- Obter o nome de um perfil existente a partir de seu nome (parâmetro -getName)
- Obter o nome de um perfil existente a partir de seu caminho (parâmetro -getPath)
- Validar um registro de perfil (parâmetro -validateRegistry)
- Validar e atualizar um registro de perfil (parâmetro -validateAndUpdateRegistry)
- Obter o nome do perfil padrão (parâmetro -getDefaultName)
- Configurar o nome do perfil padrão (parâmetro -setDefaultName)
- Fazer backup de um perfil (parâmetro -backupProfile)
- Restaurar um perfil (parâmetro -restoreProfile)
- Utilizar um arquivo de resposta contendo as informações necessárias para executar um comando manageprofiles
(parâmetro -response)
Para obter ajuda detalhada, incluindo os parâmetros necessários para cada uma das tarefas realizadas com o comando manageprofiles,
utilize o parâmetro -help. A seguir é apresentado um exemplo de utilização
do parâmetro help com o parâmetro -augment do comando manageprofiles nos sistemas
operacionais Windows:
manageprofiles.bat -augment -help. A saída especifica quais
parâmetros são necessários e quais são opcionais.
Parâmetros
Dependendo da operação que você
deseja desempenhar com o comando manageprofiles,
poderá ser necessário fornecer um ou mais dos parâmetros descritos em Parâmetros manageprofiles. O Profile Management Tool valida se os parâmetros obrigatórios foram fornecidos e se
os valores inseridos para esses parâmetros são válidos. Certifique-se
de digitar o nome dos parâmetros com as letras corretas, porque a linha de comandos
não valida a letra do nome do parâmetro. Resultados incorretos podem
ocorrer quando a letra do parâmetro não é digitada corretamente.
Saída de Comando
Na conclusão, o comando exibe
uma instrução semelhante a uma das seguintes mensagens. (A escrita exata varia dependendo
se você criou, excluiu ou aprimorou um perfil.)
- INSTCONFSUCCESS: Criação de perfil bem-sucedida.
- INSTCONFFAILED: Falha na criação de perfil.
- INSTCONFPARTIALSUCCESS: Algumas ações de configuração pós-instalação
não-críticas não foram bem-sucedidas.
Em
alguns casos, a instrução é exibida mais de uma vez. Por exemplo, a linha INSTCONFSUCCESS
é exibida três vezes na linha de comandos. Para obter informações adicionais,
consulte
Arquivos de Log de Instalação
e de Criação de Perfis