Tipos de Tarefas Administrativas Que Utilizam a Programação de Script wsadmin

Em um ambiente de gerenciamento flexível, é possível utilizar a ferramenta wsadmin para enviar tarefas administrativas ao gerenciador de tarefas. Este tópico fornece informações detalhadas sobre as tarefas administrativas, os parâmetros de tarefas e a sintaxe de comando de amostra.

Em um ambiente de gerenciamento flexível, é possível configurar a agente administrativo e um gerenciador de tarefas para submeter tarefas a diversos destinos e grupos de destinos em sua configuração. Em seguida, você pode enviar tarefas administrativas para enfileirar tarefas no ambiente gerenciado. Cada tarefa administrativa tem um tipo de tarefa correspondente, que define os parâmetros necessários para enviar a tarefa. Você pode usar os comandos do grupo de comandos AdministrativeJobs para enviar tarefas administrativas ao gerenciador de tarefas.

Você pode enviar tarefas administrativas para gerenciar seus aplicativos.

Parâmetros Comuns para Todos os Tipos de Tarefas

Use o comando submitJob para submeter tarefas administrativas. Os envios de tarefas consistem nas seguintes informações:
Parâmetros Requeridos
Cada comando submitJob requer pelo menos o parâmetro jobType. Diversos comandos submitJob também exigem os parâmetros targetList ou jobParams:
Tabela 1. Descrições de Parâmetros Necessários de submitJob. Execute um comando submitJob com seus parâmetros necessários.
Parâmetro Description Tipo
jobType Especifica o tipo de tarefa a ser executado. Muitos tipos de tarefas existem no ambiente de gerenciamento flexível incluindo gerenciamento de aplicativos, manutenção do produto, configuração e tarefas de controle de tempo de execução do servidor de aplicativos. Sequência
targetList Especifique um ou mais destinos gerenciados em que a tarefa é executada. Cadeia
jobParams Especifica informações de configuração além do tipo de tarefa e destino para executar a tarefa. Parâmetros de tarefa são específicos de cada tipo de tarefa. Cadeia
Parâmetros genéricos opcionais
Além dos parâmetros específicos da tarefa, você pode incluir qualquer dos parâmetros adicionais a seguir no envio da tarefa:
Tabela 2. Descrições de Parâmetro Opcional Genérico submitJob. Execute um comando submitJob com seus parâmetros necessários e com parâmetros opcionais apropriados para sua situação.
Parâmetro Description Tipo
group Especifica o nome do grupo de destinos gerenciados em que a tarefa é executada. Cadeia
nome do usuário Especifica o nome de usuário a ser utilizado nos destinos quando a tarefa for executada. Se o nome do usuário e senha não forem especificados e a segurança for ativada, o ID do usuário no gerenciador de tarefa é utilizado. String
senha Especifica a senha para o nome de usuário a ser utilizado nos destinos quando a tarefa for executada. Se o nome do usuário e senha não forem especificados e a segurança for ativada, o ID do usuário no gerenciador de tarefa é utilizado. String
privateKeyFile Especifica o arquivo-chave privado completamente qualificado a ser utilizado nos destinos quando a tarefa for executada. Especifique o caminho completo para o keystore. String
passphrase Especifique a passphase completamente qualificada a ser utilizada nos destinos quando a tarefa for executada. Especifique a passphrase se a keystore exigir uma passphrase. String
useSudo Especifica para ativar o uso de um usuário substituto para executar comandos no host de destino. O padrão é não usar o sudo. A opção de sudo é suportada somente em sistemas operacionais AIX, HP-UX, Linux e Solaris.

Ative useSudo para alterar usuários antes de uma execução da tarefa e, em seguida, especifique o nome de usuário e a senha para o usuário substituto, conforme necessário. sudo significa "substitute user do". Se o host de destino não exigir uma senha, deixe os campos de senha em branco. As seguintes combinações de seleção são válidas:

  • Ativar useSudo e não especificar valores para sudoUsername e sudoPassword. Essas seleções usam o usuário padrão configurado no arquivo /etc/sudoers e usam a senha do usuário da conexão.
  • Ativar useSudo, especificar um valor para sudoUsername e não especificar um valor para sudoPassword. Essas seleções usam o usuário especificado e usam a senha do usuário da conexão.
  • Ativar useSudo, especificar um valor para sudoUsername e especificar um valor para sudoPassword. Estas seleções usam o usuário e a senha sudo especificados.
Booleana
sudoUsername Especifica um nome de usuário para o usuário substituto. Para obter informações sobre quando especificar um valor para sudoUsername, consulte a descrição de useSudo. Sequência de Caracteres
sudoPassword Especifica uma senha para o usuário substituto. Para obter informações sobre quando especificar um valor para sudoPassword, consulte a descrição de useSudo. Sequência de Caracteres
descrição Especifica uma descrição da tarefa. Cadeia
activationDateTime Especifica a data e hora para ativar a tarefa no formato 2006-05-03T10:30:45-0000. A seção -0000 do valor de parâmetro activationDateTime representa o formato RFC 822. Você pode especificar Z como um atalho para GMT (Horário de Greenwich), como 2006-05-03T10:30:45Z. Se você não especificar o fuso horário, o sistema utilizará o fuso horário do gerenciador de tarefas. Cadeia
expirationDateTime Especifica a data de expiração para a tarefa, no formato 2006-05-03T10:30:45-0000. A seção -0000 do valor de parâmetro activationDateTime representa o formato RFC 822. Você pode especificar Z como um atalho para GMT (Horário de Greenwich), como 2006-05-03T10:30:45Z. Se você não especificar o fuso horário, o sistema utilizará o fuso horário do gerenciador de tarefas. Cadeia
executionWindow Especifica o intervalo recorrente, se houver, para a tarefa. Cadeia
executionWindowUnit Especifica a unidade de medida para o intervalo recorrente. Os valores válidos incluem HOURS, DAYS, WEEKS, MONTHS, CONNECT e ONCE. O valor padrão é HOURS. Cadeia
email Especifica o endereço de e-mail ao qual o sistema envia notificações de tarefas. Cadeia

Digite comandos wsadmin a partir do diretório bin do perfil do gerenciador de tarefa. Este tópico mostra exemplos na linguagem de script Jython.

Exemplo de uso:

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp] -email admin@company.com ')

Exemplo de uso no modo interativo:

AdminTask.submitJob('-interactive')

Exemplo de uso de resultado da tarefa

Executar um comando submitJob retorna um token de tarefa, como 124231200726586682. Para obter informações sobre o token de tarefa, execute um comando getJobTargetStatus:

AdminTask.getJobTargetStatus('[-jobToken 124231200726586682]')
Um log de tarefa administrativa resulta no seguinte:
  • O valor NOT_ATTEMPTED especifica que o sistema não tentou concluir a tarefa.
  • O valor DISTRIBUTED especifica que o agente para o destino recebeu a tarefa, mas a tarefa não está concluída.
  • O valor ASYNC_IN_PROGRESS especifica que destino está executando a tarefa simultaneamente com outras tarefas.
  • O valor FAILED especifica que a tarefa falhou.
  • O valor REJECTED especifica que o destino rejeitou a tarefa por causa, por exemplo, do destino não suporta o tipo de tarefa.
  • O valor SUCCEEDED especifica que a tarefa foi concluída com êxito.
  • O valor PARTIALLY_SUCCEEDED especifica que a tarefa foi concluída parcialmente. Por exemplo, o sucesso parcial pode ocorrer quando um destino representar diversos servidores e apenas alguns dos servidores no destino concluírem a tarefa com êxito.

O status da tarefa resulta, geralmente, no progresso de DISTRIBUTED para ASYNC_IN_PROGRESS para SUCCEEDED. Talvez seja necessário executar um comando getJobTargetStatus mais de uma vez, até que o resultado seja FAILED, REJECTED ou SUCCEEDED.

Por padrão, uma tarefa permanece ativa durante 1 dia (24 horas).

Enviar uma Tarefa para Coletar Inventário

A tarefa administrativa do inventário coleta dados do inventário a partir dos destinos. Estes dados do inventário incluem os tipos de tarefa disponíveis e o status dos recursos gerenciados, tais como aplicativos e servidores, para cada destino.

Quando um destino é um host, os dados do inventário incluem informações sobre o host, como o nome do sistema operacional, a versão, o Installation Manager, o grupo de pacotes, os pacotes, perfis e outros recursos.

Se desejar que a tarefa de inventário localize os recursos do Liberty, as variáveis para WLP_WORKING_DIR, WLP_SHARED_DIR ou WLP_ADDITIONAL_DIRS devem ser definidas. Consulte Configurando variáveis para servidores Liberty.

[IBM i]Nota: O gerenciador de instalação centralizado não pode descobrir perfis para o Application Client and Plugin em plataformas IBM i.

Parâmetros da tarefa

Nenhuma.

Exemplo de uso

AdminTask.submitJob('-jobType inventory -targetList [Target1 Target2 Target3]')

Submeta uma tarefa para coletar status do destino

A tarefa administrativa de status coleta dados do status dos destinos. Utilize esta tarefa, em vez da tarefa de inventário, se você quiser apesar atualizar dados nos recursos gerenciados, como aplicativos e servidores, para cada destino.

Quando um servidor Liberty for o destino, essa tarefa atualizará o status do servidor somente dos recursos do servidor Liberty. Isso não descobre novos recursos do servidor ou remove recursos excluídos do servidor. Para descobrir novos recursos do servidor, envie uma tarefa de inventário.

Parâmetros da tarefa

Nenhuma.

Exemplo de uso

AdminTask.submitJob('-jobType status -targetList [Target1 Target2 Target3]')

Submeter tarefas para gerenciar arquivos

É possível usar as tarefas de gerenciamento de arquivo para coletar, distribuir e remover arquivos. Por exemplo, você pode submeter a tarefa collectFile para transferir um arquivo para o gerenciador de tarefa. A tarefa distributeFile transfere um arquivo a partir do gerenciador de tarefas para os destinos para a tarefa. A tarefa removeFile remove um arquivo que foi anteriormente distribuída ao destino:

É possível utilizar as tarefas de gerenciamento de arquivos com destinos de host remotos. Utilize distributeFile para enviar um arquivo para hosts remotos, collectFile para coletar arquivos a partir de hosts remotos e removeFile para excluir arquivos dos hosts remotos.

collectFile

A tarefa administrativa collectFile coleta um arquivo de destino e o transfere para o gerenciador de tarefa. Se o local de origem for um diretório e não um arquivo, a tarefa compactará repetidamente o conteúdo do diretório e transferirá o arquivo zip compactado resultante.

Parâmetros da tarefa

Tabela 3. Descrições do Parâmetro collectFile. Execute um comando submitJob collectFile com pelo menos parâmetros de origem e destino.
Parâmetro Description Tipo
origem Especifica o local de origem do arquivo ou do diretório de interesse. O sistema determina que o local do arquivo é relativo ao diretório profile_root do destino. Cadeia
destination Especifica o local de destino. O valor é relativo a um diretório denominado profile_root/config/temp/JobManagerName/jobToken/targetName. Cadeia
distributionProvider Especifica opcionalmente o nome do provedor de distribuição. Cadeia

Exemplo de uso

O seguinte exemplo executa a tarefa collectFile:
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
 -jobParams [[source logs][destination targetLocationOfFile]]]')

distributeFile

A tarefa administrativa distributeFile transfere um arquivo a partir do gerenciador de tarefas para os destinos para a tarefa. O sistema armazena o arquivo no destino em preparo para tarefas subsequentes que utilizarão o arquivo. As tarefas administrativas installApplication e updateApplication referencia o destino que você fornece para a tarefa distributeFile como o local do conteúdo do aplicativo no destino. Além disso, você pode utilizar essa tarefa para distribuir os arquivos de script e os arquivos de configuração baseados em propriedades.

O arquivo para distribuir a partir do gerenciador de tarefa inicialmente deve estar no diretório /config/temp/JobManager no perfil do gerenciador de tarefa. Em seguida, o sistema move o arquivo para o diretório downloadedContent do perfil do agente administrativo ou do gerenciador de implementação. O parâmetro de destino é relativo ao diretório downloadedContent e pode ser um nome de arquivo ou um nome de caminho relativo. É possível usar um caminho relativo para criar subdiretórios separados no diretório downloadedContent para organizar arquivos transferidos por download.

Evitar Problemas Evitar Problemas: Para enviar a tarefa distributeFile antes de enviar outras tarefas, primeiro você deve colocar o arquivo a ser distribuído no diretório JobManager. Para criar o diretório JobManager manualmente, conclua as etapas a seguir:
  1. Usando um usuário administrativo com as permissões *ALLOBJ e *SECADM, use o prompt de comandos para mudar os diretórios para profile_root/JobManagerName/config/temp.
  2. Insira o seguinte comando: mkdir JobManager
  3. Insira o seguinte comando: chown -R QEJBSVR JobManager
  4. Copie o arquivo a ser distribuído para o diretório JobManager.
  5. No console administrativo, envie a tarefa distributeFile.
gotcha

Parâmetros da tarefa

Tabela 4. Descrições do Parâmetro distributeFile. Execute um comando submitJob distributeFile com pelo menos parâmetros de origem e destino.
Parâmetro Descrição Type
origem Especifica o local de origem do conteúdo a ser distribuído. String
destination Especifica o local de destino no destino em que o sistema salva o conteúdo. Sequência de Caracteres
distributionProvider Especifica opcionalmente o nome do provedor de distribuição. Sequência de Caracteres

Exemplo de uso

AdminTask.submitJob('-jobType distributeFile -targetList [Target1 Target2 Target3]
-jobParams [[source file:/MyApp.ear][destination MyApp.ear]]')

removeFile

A tarefa administrativa removeFile remove um arquivo que foi previamente distribuído ao destino. O parâmetro location é relativo ao diretório downloadedContent e deve ser o mesmo local daquele especificado para o parâmetro destination quando o arquivo foi distribuído.

Parâmetros da tarefa

Tabela 5. Descrições do Parâmetro removeFile. Execute um comando submitJob removeFile com pelo menos um parâmetro de local.
Parâmetro Description Tipo
local Especifique o local do arquivo para remover do destino. Use o valor de destino da tarefa distributeFile. Sequência de Caracteres
distributionProvider Especifica opcionalmente o nome do provedor de distribuição. Sequência de Caracteres

Exemplo de uso

AdminTask.submitJob('-jobType removeFile -targetList [Target1 Target2 Target3] 
 -jobParams [location MyApp.ear]')

Enviar uma Tarefa que Executa um Script wsadmin

É possível enviar uma tarefa para executar um script wsadmin em um destino gerenciado do gerenciador de tarefas. O destino gerenciado pode ser um gerenciador de implementação ou um servidor de aplicativos não federado. Antes de executar um script wsadmin em destino gerenciado, transfira o script wsadmin, e qualquer perfil de script, do gerenciador de tarefa para o destino gerenciado utilizando a tarefa distributeFile. Lembre-se de qualquer valor de destino que for especificado ao distribuir o arquivo. Em seguida, utilize a tarefa a seguir para executar o script wsadmin. Use o valor de destino para o parâmetro scriptFileLocation. Se você especificou um valor de destino do perfil, use, opcionalmente, o valor de destino do perfil do parâmetro profileLocation.

O resultado do status de uma tarefa runWsadminScript depende do código de retorno do script. Quando o código de retorno for zero, a tarefa é marcada como bem-sucedida. Quando o código de retorno for um valor diferente de zero, a tarefa é marcada como com falha.

Parâmetros da tarefa

Tabela 6. Descrição de Parâmetro da Tarefa. Execute um comando submitJob runWsadminScript com pelo menos um parâmetro scriptFileLocation.
Parâmetro Description Tipo
scriptFileLocation Especifica o local do arquivo de script para executar no destino gerenciado. O local é o destino que foi dado quando o arquivo foi distribuído ao destino. String
profileLocation Especifica, opcionalmente, o local do script de perfil a ser executado com o script wsadmin. Esse parâmetro corresponde ao parâmetro -profile de wsadmin. O local é o destino que foi especificado quando o arquivo foi distribuído ao destino. Sequência
scriptParameters Opcionalmente especifica parâmetros para fornecer ao script wsadmin. Sequência de Caracteres

Exemplo de uso

AdminTask.submitJob('[-jobType runWsadminScript -targetList [DmgrManagedNodeName]
 -jobParams [ [scriptFileLocation myScript.py] [profileLocation scriptProfile.py]
 [scriptParameters [param1 param2]] ]]')

Para scripts wsadmin que processam múltiplos pares de valores de palavra-chave para parâmetros de comando, como os parâmetros de comando argv[], use scriptParameters para especificar as palavras-chave e os valores:

AdminTask.submitJob('[-jobType runWsadminScript -targetList [myNode01]
 -jobParams [ [scriptFileLocation myScript.py] [scriptParameters [-keyword1 value1 -keyword2 value2]] ]]')

Enviar Tarefas para Gerenciar Aplicativos

É possível utilizar as tarefas de gerenciamento de aplicativos para distribuir, instalar, atualizar, remover e controlar aplicativos no servidor de aplicativos. Por exemplo, você pode submeter as tarefas distributeFile, installApplication e startApplication para implementar aplicativos em seu ambiente. Para remover aplicativos do seu ambiente, envie as tarefas stopApplication, uninstallApplication e removeFile. Utilize as seguintes tarefas de gerenciamento de aplicativos para administrar suas configurações de aplicativos:

installApplication

A tarefa administrativa installApplication instala e liga um aplicativo ou um elemento de aplicativo no ambiente de destino. Você deve executar a tarefa distributeFile e distribuir o conteúdo implementável para os destinos antes de poder instalar o aplicativo.

A tarefa installApplication não fornece um meio para fornecer informações sobre ligação ou outros atributos de implementação. Se você precisar desse recurso, poderá usar as tarefas runWsadminScript ou configureProperties.

Importante: Antes de poder submeter essa tarefa, o diretório profile_root/downloadedContent deve existir para o gerenciador de implementação ou o agente administrativo. Você deve criar esse diretório, se ele ainda não existir.

Parâmetros da tarefa

Tabela 7. Descrições do Parâmetro installApplication. Execute um comando submitJob installApplication com pelo menos um parâmetro applicationName.
Parâmetro Description Tipo
applicationName Especifica o nome do aplicativo a ser utilizado para identificar o aplicativo a ser instalado. Muitas vezes, esse é o nome do arquivo de base do aplicativo corporativo (por exemplo, MyApp para MyApp.ear), mas é possível escolher qualquer nome. Cadeia
appLocation Especifica opcionalmente o local do arquivo de aplicativo a ser instalado. Por padrão, a tarefa installApplication anexa a notação em formato de arquivo .ear no nome do aplicativo e procura o aplicativo no local de destino padrão.

Assim, se você especificar MyApp para applicationName, pelo padrão o appLocation será downloadedContent/MyApp.ear do destino gerenciado. Se você especificar um valor para appLocation, use o valor de destino que especificou ao distribuir o aplicativo.

Cadeia
serverName Especifica opcionalmente o nome do servidor em que o sistema instala o aplicativo. Sequência
nodeName Opcionalmente, especifique o nó de interesse, o qual especifica o servidor em uma célula do WebSphere Application Server, Network Deployment. Sequência de Caracteres
clusterName Opcionalmente especifica o nome do cluster no qual o aplicativo é instalado. Seqüência de Caracteres

Exemplo de uso

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp]]')

ou:

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

startApplication

A tarefa administrativa startApplication inicie um aplicativo anteriormente instalado no destino. O sistema altera o status do aplicativo para ativo ou RUNNING, carrega o aplicativo no tempo de execução e abre o aplicativo para receber pedidos do cliente. Essa é a última etapa do processo de implementação do aplicativo.

Parâmetros da tarefa

Tabela 8. Descrição do Parâmetro startApplication. Execute um comando submitJob startApplication com um parâmetro applicationName.
Parâmetro Description Tipo
applicationName Especifica o nome do aplicativo a ser iniciado. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

stopApplication

A tarefa administrativa stopApplication para o aplicativo no destino. O sistema altera o status do aplicativo para parado e não recebe mais pedidos do cliente. É possível utilizar a tarefa startApplication para reiniciar o aplicativo. Essa é a primeira etapa do processo de remoção do aplicativo.

Tabela 9. Descrição do Parâmetro stopApplication. Execute um comando submitJob stopApplication com um parâmetro applicationName.
Parâmetro Descrição Tipo
applicationName Especifica o nome do aplicativo a ser parado. Sequência

Exemplo de uso

AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

updateApplication

A tarefa administrativa updateApplication atualiza um aplicativo ou um elemento de aplicativo no ambiente de destino. Você deve executar a tarefa distributeFile e distribuir o conteúdo implementável para os destinos antes de poder atualizar o aplicativo.

Importante: Antes de poder submeter essa tarefa, o diretório profile_root/downloadedContent deve existir para o gerenciador de implementação ou o agente administrativo. Você deve criar esse diretório, se ele ainda não existir.

Parâmetros da tarefa

Tabela 10. Descrições do Parâmetro updateApplication. Execute um comando submitJob updateApplication com pelo menos um parâmetro applicationName.
Parâmetro Description Tipo
applicationName Especifica um nome de aplicativo a ser utilizado para identificar o aplicativo a ser atualizado. Muitas vezes, esse é o nome do arquivo de base do aplicativo corporativo (por exemplo, MyApp para MyApp.ear), mas é possível escolher qualquer nome. Cadeia
appLocation Especifica opcionalmente o local do arquivo de aplicativo a ser instalado. Por padrão, a tarefa updateApplication anexa a notação em formato de arquivo .ear no nome do aplicativo e procura o aplicativo no local de destino padrão.

Assim, se você especificar MyApp para applicationName, pelo padrão o appLocation será downloadedContent/MyApp.ear do destino gerenciado. Se você especificar um valor para appLocation, use o valor de destino que especificou ao distribuir o aplicativo.

Cadeia
serverName Especifica, opcionalmente, o nome do servidor em que o sistema atualiza o aplicativo. Sequência
nodeName Opcionalmente, especifique o nó de interesse, o qual especifica o servidor em uma célula do WebSphere Application Server, Network Deployment. Sequência
clusterName Opcionalmente especifica o nome do cluster no qual o aplicativo é atualizado. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3] 
 -jobParams [[applicationName MyApp]]')

ou:

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3] 
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

uninstallApplication

A tarefa administrativa uninstallApplication desinstala o aplicativo dos destinos.

Parâmetros da tarefa

Tabela 11. Descrição do Parâmetro uninstallApplication. Execute um comando submitJob uninstallApplication com um parâmetro applicationName.
Parâmetro Description Tipo
applicationName Especifica o nome do aplicativo a ser removido. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType uninstallApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

Enviar Tarefas para Gerenciar Servidores

O administrador do sistema pode utilizar as tarefas de configuração do servidor de aplicativos para modificar a configuração de servidores de aplicativos remotos e locais.

createApplicationServer

A tarefa administrativa createApplicationServer cria um servidor de aplicativos no ambiente de destino.

Parâmetros da tarefa

Tabela 12. Descrições do Parâmetro createApplicationServer. Execute um comando submitJob createApplicationServer com pelo menos os parâmetros serverName e nodeName.
Parâmetro Description Tipo
serverName Especifica o nome do servidor de aplicativos a ser criado. O nome do servidor deve ser exclusivo no nó de destino. Cadeia
nodeName Quando o destino for uma célula do WebSphere Application Server, Network Deployment, você deve especificar o nome do nó para indicar em qual nó na célula o servidor deve ser criado. Você não tem que especificar o nome do nó para um nó base. Cadeia
templateName Especifica, opcionalmente, o modelo de servidor. Cadeia
templateLocation Especifica, opcionalmente, o local em que o modelo está armazenado. Use o local padrão definido pelo sistema, a não ser que seja necessário especificar um local de modelo. Sequência de Caracteres
genUniquePorts Especifica, opcionalmente, para gerar portas http exclusivas para um servidor. Por padrão, o produto gera números de portas exclusivos. Booleana
[z/OS]specificShortName [z/OS]Apenas para ambientes z/OS, especifica, opcionalmente, o nome abreviado específico do servidor. Cada servidor deve ter um nome abreviado específico exclusivo. Por padrão, o produto designa um nome abreviado específico exclusivo. O valor deve ter 8 caracteres ou menos e todos em maiúsculas. [z/OS]Cadeia
[z/OS]genericShortName [z/OS]Apenas para ambientes z/OS, especifica, opcionalmente, o nome abreviado genérico do servidor. Todos os membros de um cluster compartilham o mesmo nome abreviado genérico. Servidores individuais devem ter um nome abreviado genérico exclusivo. Por padrão, o produto designa um nome abreviado genérico exclusivo. O valor deve ter 8 caracteres ou menos e todos em maiúsculas. [z/OS]String
[z/OS]bitMode [z/OS]Apenas para ambientes z/OS, especifica, opcionalmente, o modo de bit do servidor. Os valores válidos são 31 e 64 bits. Se nenhum valor for especificado, o produto designará o modo de bit padrão. [z/OS]Integer

Exemplo de uso

AdminTask.submitJob('-jobType createApplicationServer -targetList
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

deleteApplicationServer

A tarefa administrativa deleteApplicationServer remove um servidor de aplicativos do ambiente de destino.

Parâmetros da tarefa

Tabela 13. Descrições do Parâmetro deleteApplicationServer. Execute um comando submitJob deleteApplicationServer com os parâmetros serverName e nodeName.
Parâmetro Descrição Type
serverName Especifica o nome do servidor de aplicativos a ser excluído. String
nodeName Quando o destino for uma célula do WebSphere Application Server, Network Deployment, você deve especificar o nome do nó para indicar a partir de qual nó na célula o servidor deve ser excluído. Você não tem que especificar o nome do nó para um nó base. String

Exemplo de uso

AdminTask.submitJob('-jobType deleteApplicationServer -targetList 
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

createProxyServer

A tarefa administrativa createProxyServer cria um servidor proxy em uma célula de um gerenciador de implementação que é um destino gerenciado de um gerenciador de tarefa.

Parâmetros da tarefa

Tabela 14. Descrições do Parâmetro createProxyServer. Execute um comando submitJob createProxyServer com os parâmetros serverName e nodeName.
Parâmetro Description Tipo
serverName Especifica o nome do servidor proxy a ser criado. Cadeia
nodeName Especifica o nó no qual o servidor proxy residirá. Cadeia

Exemplo de uso

AdminTask.submitJob('[-jobType createProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

deleteProxyServer

O deleteProxyServer exclui um servidor proxy de uma célula de um gerenciador de implementação que é um destino gerenciado de um gerenciador de tarefa.

Parâmetros da tarefa

Tabela 15. Descrições do Parâmetro deleteProxyServer. Execute um comando submitJob deleteProxyServer com os parâmetros serverName e nodeName.
Parâmetro Description Tipo
serverName Especifica o nome do servidor proxy a ser excluído. String
nodeName Especifica o nó no qual o servidor proxy reside. String

Exemplo de uso

AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

createCluster

A tarefa administrativa createCluster cria um cluster. Para criar o cluster em uma célula, é necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas.

Parâmetros da tarefa

Tabela 16. Descrições do Parâmetro createCluster. Execute um comando submitJob createCluster com pelo menos o parâmetro clusterConfig.clusterName.
Parâmetro Description Tipo
clusterConfig.clusterName Especifica o nome do cluster de servidores. Sequência de Caracteres
clusterConfig.preferLocal Possibilita, opcionalmente, a otimização de roteamento com escopo definido no nó do cluster. Sequência de Caracteres
clusterConfig.clusterType Especifica, opcionalmente, o tipo de cluster de servidores. Sequência de Caracteres
[z/OS]clusterConfig.shortName [z/OS]Especifica, opcionalmente, o nome abreviado do cluster de servidores. [z/OS]Sequência de Caracteres
replicationDomain.createDomain Cria, opcionalmente, um domínio de replicação com um nome configurado com o nome do novo cluster. Sequência de Caracteres
convertServer.serverNode Especifica, opcionalmente, o nome do nó do servidor existente a ser convertido no primeiro membro do cluster. Sequência de Caracteres
convertServer.serverName Especifica, opcionalmente, o nome do servidor existente a ser convertido no primeiro membro do cluster. Sequência
convertServer.memberWeight Especifica, opcionalmente, o valor do peso do novo membro de cluster. Sequência
convertServer.nodeGroup Especifica, opcionalmente, o nome do grupo de nós ao qual todos os nós do membro de cluster devem pertencer. Sequência
convertServer.replicatorEntry Especifica, opcionalmente, que uma entrada de replicador para esse membro é criada no domínio de replicação do cluster. A entrada de replicador é utilizada para replicação de dados de sessão HTTP. Sequência

Exemplo de uso

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterConfig.clusterName newCluster1]]')

Se você especificar parâmetros adicionais no comando createCluster, utilize o formato [stepName.parameterName parameterValue] na lista de parâmetros -jobParams.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterConfig.clusterName newCluster1] [clusterConfig.clusterType PROXY_SERVER] ]]')

deleteCluster

A tarefa administrativa deleteCluster exclui um cluster. Para excluir o cluster em uma célula, é necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas.

Parâmetros da tarefa

Tabela 17. Descrições do Parâmetro deleteCluster. Execute um comando submitJob deleteCluster com pelo menos o parâmetro clusterName.
Parâmetro Description Tipo
clusterName Especifica o nome do cluster de servidores a ser excluído. Cadeia
replicationDomain.deleteRepDomain Opcionalmente utilizado para indicar que o domínio de replicação do cluster deve ser excluído quando o cluster for excluído. Cadeia

Exemplo de uso

AdminTask.submitJob('[-jobType deleteCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')

createClusterMember

A tarefa administrativa createClusterMember cria um membro de cluster em um cluster, que está em uma célula. É necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas.

Parâmetros da tarefa

Tabela 18. Descrições do Parâmetro createClusterMember. Execute um comando submitJob createClusterMember com pelos menos os parâmetros clusterName, memberConfig.memberNode e memberConfig.memberName.
Parâmetro Description Tipo
clusterName Especifica o nome do cluster de servidores ao qual o novo membro de cluster pertence. Sequência
memberConfig.memberNode Especifica o nome do nó em que o novo membro de cluster residirá. Sequência
memberConfig.memberName Especifica o nome do novo membro de cluster. Sequência
memberConfig.memberWeight Especifica, opcionalmente, o peso do novo membro de cluster. Sequência
memberConfig.memberUUID Especifica, opcionalmente, o UUID (universal unique identifier) do novo membro de cluster. Sequência
memberConfig.genUniquePorts Especifica, opcionalmente, para gerar números de portas exclusivos para transportes HTTP definidos no servidor. Cadeia
memberConfig.replicatorEntry Especifica, opcionalmente, que uma entrada de replicador para esse membro é criada no domínio de replicação do cluster. A entrada de replicador é utilizada para replicação de dados de sessão HTTP. Sequência
[z/OS]memberConfig.specificShortName [z/OS]Especifica, opcionalmente, o nome abreviado do membro de cluster. [z/OS]Cadeia
firstMember.templateName Especifica, opcionalmente, o nome do modelo de servidor de aplicativos a ser utilizado como modelo para novos membros de cluster. Cadeia
firstMember.templateServerNode Especifica, opcionalmente, o nome do nó de um servidor existente a ser utilizado como modelo para novos membros de cluster. Cadeia
firstMember.templateServerName Especifica, opcionalmente, o nome do servidor a ser utilizado como modelo para novos membros de cluster. Cadeia
firstMember.nodeGroup Especifica, opcionalmente, o nome do grupo de nós ao qual todos os nós do membro de cluster devem pertencer. Sequência de Caracteres
firstMember.coreGroup Especifica, opcionalmente, o nome do grupo principal ao qual todos os membros de cluster devem pertencer. Cadeia

Exemplo de uso

AdminTask.submitJob('[-jobType createClusterMember
 -targetList [DmgrManagedNodeName]
 -jobParams [ [memberConfig.memberName newCluster1mem1]
   [memberConfig.memberNode FederatedNode] [clusterName newCluster1] ]]')

deleteClusterMember

A tarefa administrativa deleteClusterMember exclui um membro de cluster de um cluster, que está em uma célula. É necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas. O cluster deverá ter, no mínimo, um membro de cluster em um nó federado.

Parâmetros da tarefa

Tabela 19. Descrições do Parâmetro deleteClusterMember. Execute um comando submitJob deleteClusterMember com pelo menos os parâmetros clusterName, memberNode e memberName.
Parâmetro Description Tipo
clusterName Especifica o nome de um cluster de servidores ao qual o membro de cluster a ser excluído pertence. Cadeia
memberNode Especifica o nome do nó em que o membro de cluster reside. Cadeia
memberName Especifica o nome do servidor do membro de cluster a ser excluído. Cadeia
replicatorEntry.deleteEntry Especifica, opcionalmente, para excluir a entrada de replicador que tem o nome de servidor desse membro de cluster do domínio de replicação do cluster. Cadeia

Exemplo de uso

AdminTask.submitJob('[-jobType deleteClusterMember -targetList 
 [DmgrManagedNodeName] -jobParams [ [memberName newCluster1mem1]
 [memberNode FederatedNode] [clusterName newCluster1] ]]')

configureProperties

A tarefa administrativa configureProperties aplica um arquivo de propriedades à configuração do servidor de aplicativos. Essa tarefa utiliza o comando applyConfigProperties no grupo de comandos PropertiesBasedConfiguration para o objeto AdminTask para configurar as propriedades para o destino.

Parâmetros da tarefa

Tabela 20. Descrições do Parâmetro configureProperties. Execute um comando submitJob configureProperties com pelo menos o parâmetro propertiesFileLocation.
Parâmetro Description Tipo
propertiesFileLocation Especifica o local do arquivo de propriedades a ser aplicado ao servidor de aplicativos de destino.

O caminho especificado para esse parâmetro é o caminho relativo do diretório profile_root/downloadedContent do gerenciador de implementação. Você deve criar esse diretório, se ele ainda não existir, antes de iniciar a tarefa administrativa configureProperties.

Cadeia
variableMapLocation Opcionalmente especifica o local de um arquivo de mapeamento de variável para incluir com o arquivo de propriedades. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType configureProperties -targetList 
 [Target1 Target2 Target3] -jobParams [propertiesFileLocation  myProperties.props]')

Enviar Tarefas para Gerenciar o Tempo de Execução do Servidor

O administrador do sistema pode utilizar as tarefas de controle de tempo de execução do servidor de aplicativos para iniciar e parar os servidores de aplicativos.

startServer

A tarefa administrativa startServer ativa e inicializa o servidor de aplicativos de interesse.

Parâmetros da tarefa

Tabela 21. Descrições do Parâmetro startServer. Execute um comando submitJob startServer com pelo menos o parâmetro serverName.
Parâmetro Description Tipo
serverName Especifica o servidor de aplicativos a ser iniciado. Sequência
nodeName Se o destino da tarefa for um nó do gerenciador de implementação, especifique o nome no nó federado onde o servidor existe. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

stopServer

A tarefa administrativa stopServer pára o servidor de aplicativos de interesse. Utilize a tarefa startServer para reiniciar o servidor de aplicativos.

Parâmetros da tarefa

Tabela 22. Descrições do Parâmetro stopServer. Execute um comando submitJob stopServer com pelo menos o parâmetro serverName.
Parâmetro Descrição tipo
serverName Especifica o servidor de aplicativos a ser parado. Sequência
nodeName Se o destino da tarefa for um nó do gerenciador de implementação, especifique o nome no nó federado onde o servidor existe. Sequência

Exemplo de uso

AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

startCluster

A tarefa administrativa startCluster inicia um cluster. Para iniciar um cluster em uma célula, é necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas.

Parâmetros da Tarefa

Tabela 23. Descrições do Parâmetro startCluster. Execute um comando submitJob startCluster com pelo menos o parâmetro clusterName.
Parâmetro Description tipo
clusterName Especifica o nome do cluster a ser iniciado. Sequência de Caracteres
rippleStart Especifica, opcionalmente, se o cluster é iniciado em uma reinicialização em cadeia. O valor padrão é false. Sequência

Exemplo de uso

O seguinte exemplo inicia um cluster:

AdminTask.submitJob('[-jobType startCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

O seguinte exemplo reinicializa em cadeia um cluster.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [rippleStart true] ]]')

stopCluster

A tarefa administrativa stopCluster pára um cluster. Para parar um cluster em uma célula, é necessário registrar o gerenciador de implementação da célula com um gerenciador de tarefas.

Parâmetros da tarefa

Tabela 24. Descrição do Parâmetro stopCluster. Execute um comando submitJob stopCluster com o parâmetro clusterName.
Parâmetro Description Tipo
clusterName Especifica o nome do cluster a ser parado. Sequência

Exemplo de uso

AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

Enviar uma tarefa para executar comandos

O administrador do sistema pode usar a tarefa runCommand do gerenciador de tarefa para executar um comando em um host remoto. O comando pode ser um utilitário de linha de comandos como um startServer em um diretório app_server_root/bin, um comando wsadmin ou um comando do sistema operacional.

Parâmetros da tarefa

Tabela 25. Descrições do Parâmetro runCommand. Execute um comando a submitJob runCommand com no mínimo o parâmetro command.
Parâmetro Description Tipo
comando Especifica o nome do comando a ser executado. Cadeia
workingDir Especifica o local do arquivo de comando no host remoto. O valor padrão é o diretórioapp_server_root no host remoto. Sequência

Exemplo de uso

[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command versionInfo.bat]]')
[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "java -version"][workingDir C:/WAS_v800/IBM/WebSphere/AppServer/java/bin]]')

Enviar uma Tarefa para gerenciar perfis

O administrador do sistema pode usar a tarefa manageprofiles do gerenciador de tarefa para criar, aumentar ou excluir um perfil do WebSphere Application Server. Esta tarefa executa o comando administrativo manageprofiles.

Parâmetros da tarefa

Tabela 26. Descrições de Parâmetros manageprofiles. Execute um comando submitJob manageprofiles com no mínimo os parâmetros wasHome e responseFile.
Parâmetro Description Tipo
wasHome Especifica o local da instalação do WebSphere Application Server. Este é o caminho app_server_root no host remoto. Sequência
responseFile Especifica o local do arquivo de resposta manageprofiles que reside no gerenciador de tarefa. Cadeia
nome do usuário Especifica o nome de usuário a ser utilizado nos destinos quando a tarefa for executada. Se o nome do usuário e senha não forem especificados e a segurança for ativada, o ID do usuário no gerenciador de tarefa é utilizado. Cadeia
senha Especifica a senha para o nome de usuário a ser utilizado nos destinos quando a tarefa for executada. Se o nome do usuário e senha não forem especificados e a segurança for ativada, o ID do usuário no gerenciador de tarefa é utilizado. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType manageprofiles -targetList Target1 -username user1 -password *******
 -jobParams [[wasHome /WAS80GA][responseFile /temp/mp1.txt]]')

Enviar tarefas do Installation Manager

O administrador do sistema pode utilizar tarefas do Installation Manager para instalar instâncias do Installation Manager, atualizar o Installation Manager com um repositório, gerenciar ofertas do Installation Manager e instalar produtos do WebSphere Application Server.

Configurações suportadas Configurações suportadas: O IBM Installation Manager 1.4.3 ou mais recente é necessário.sptcfg

installIM

A tarefa administrativa installIM instala uma nova instância do Installation Manager ao enviar um kit de instalação do gerenciador de tarefas para os hosts.

Parâmetros da tarefa

Tabela 27. Descrições do Parâmetro installIM. Execute um comando submitJob installIM com no mínimo o parâmetro kitPath.
Parâmetro Description Tipo
kitPath Especifica o local do kit do Installation Manager. Se não localizar esse parâmetro, a tarefa localizará o kit de instalação IM mais recente a partir do local padrão. Sequência de Caracteres
dataPath Especifica o local dos dados do Installation Manager. Sequência de Caracteres
installPath Especifica o local para instalar o Installation Manager no host de destino. Especifique esse parâmetro apenas se houver vários locais de instalação existentes dentro da célula atual no mesmo host. Cadeia
skipPrereqCheck Ao configurar como true, especifique opcionalmente que nenhuma verificação de pré-requisito seja executada na instalação do Installation Manager e que a verificação de espaço no disco do Installation seja desativada.

O valor padrão é false. A verificação de pré-requisito e de espaço no disco é executada a menos que o valor true seja especificado.

Booleana
acceptLicense Deve ser configurado para true, se esse parâmetro não for especificado, a tarefa falhará. Booleana

Exemplo de uso

AdminTask.submitJob('-jobType installIM -targetList [Host1 Host2 Host3] 
 -jobParams [acceptLicense TRUE] [kitPath /IM/agent.installer.zip] -username user1 -password pw')

Se não especificar o caminho do kit de instalação do IBM Installation Manager, a tarefa installIM procurará pelo kit de instalação do IBM Installation Manager mais recente que seja adequado para a plataforma de destino a partir do repositório do kit de instalação no gerenciador de tarefas. Por padrão, o repositório do kit de instalação é app_server_root/IMKits. É possível alterar o local a partir do gerenciador de tarefas. Clique em Tarefas > Kits de instalação do Installation Manager e altere o Local dos kits de instalação do Installation Manager para um local diferente.

updateIM

A tarefa administrativa updateIM atualiza um Installation Manager existente com um repositório, em vez de enviar um kit de instalação a partir do gerenciador de tarefa. Este comando updateIM exige o Installation Manager Versão 1.4 ou posterior.

Parâmetros da tarefa

Tabela 28. Descrições do Parâmetro updateIM. Execute um comando submitJob updateIM com no mínimo os parâmetros repository e installPath.
Parâmetro Description Tipo
repository Especifique o local do repositório para atualizar o Installation Manager. O caminho pode ser para um arquivo local no computador gerenciador de tarefa ou uma URL que aponte para um arquivo remoto. Sequência
installPath Especifica o local da instalação do Installation Manager. Cadeia
keyringFile Se repositório de oferta que estiver especificado no arquivo de resposta exigir login, especifique o local do arquivo de conjunto de chaves a ser utilizado. Se o repositório não exigir login, então não especifique este parâmetro. Cadeia
keyringPassword Especifique opcionalmente a senha para o arquivo de conjunto de chaves. Se o arquivo de conjunto de chaves não exigir uma senha, então não especifique esse parâmetro. Cadeia
acceptLicense Deve ser configurado para true, se esse parâmetro não for especificado, a tarefa falhará. Booleana

Exemplo de uso

AdminTask.submitJob('-jobType updateIM -targetList [Host1] 
 -jobParams [acceptLicense TRUE][ [repository /IM/repository] [installPath /IM] ]')

manageOfferings

A tarefa administrativa manageOfferings pode instalar, atualizar, modificar, retroceder ou desinstalar ofertas no Installation Manager. Envie uma tarefa que utilize um arquivo de resposta do Installation Manager e, opcionalmente um arquivo de conjunto de chaves, para gerenciar uma oferta utilizando um repositório remoto.

Evitar Problemas Evitar Problemas: Por padrão, a tarefa obriga que o local de dados especificado seja um caminho absoluto.
  • [Windows]Você deve iniciar o caminho com uma letra da unidade.
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]Você deve iniciar o caminho com uma /.
Para remover a restrição, configure a seguinte propriedade Java para true: com.ibm.ws.admin.cimjm.disableDataLocationAbsolutePathCheck=true.gotcha

Parâmetros da tarefa

Tabela 29. Descrições do Parâmetro manageOfferings. Execute um comando submitJob manageOfferings com pelo menos o parâmetro responseFile.
Parâmetro Description Tipo
responseFile Especifica o local do arquivo de resposta para atualizar, modificar, retroceder ou desinstalar ofertas do Installation Manager. O caminho pode ser para um arquivo local no computador gerenciador de tarefa ou uma URL que aponte para um arquivo remoto. Sequência
IMPath Especifica o local da instalação do Installation Manager. Se esse parâmetro não for especificado, a tarefa tenta descobrir e utilizar o caminho do Installation Manager padrão no host de destino. Se nenhum Installation Manager for encontrado ou mais de um Installation Manager for encontrado, a tarefa falhará. Nessa situação, o comando submitJob manageOfferings deve especificar o caminho do Installation Manager. Cadeia
keyringFile Especifica o local do arquivo de conjunto de chaves a ser utilizado se o repositório de oferta especificado no arquivo de resposta exigir login. Se o arquivo de resposta não exigir login, então não especifique esse parâmetro. Cadeia
keyringPassword Especifique opcionalmente a senha para o arquivo de conjunto de chaves. Se o arquivo de conjunto de chaves não exigir uma senha, então não especifique esse parâmetro. Cadeia

Exemplo de uso

AdminTask.submitJob('-jobType manageOfferings -targetList [Host1 Host2 Host3] 
 -jobParams [responseFile /IM/agent.installer.zip] -username user1 -password pw')

findIMDataLocation

A tarefa administrativa findIMDataLocation pode incluir ou procurar por locais de dados do Installation Manager.

Se um caminho contiver um ponto e vírgula (;), inclua o caminho entre aspas duplas ("). Por exemplo: "/opt/my,path";/opt/data1. A tarefa pode detectar os locais de dados gravados no registro do Installation Manager. Em plataformas Unix, o registro padrão para uma instalação não administrativa está localizado em userhome/etc/.ibm/registry. O registro padrão para uma instalação administrativa está localizado em /etc/.ibm/registry. Não é necessário incluir os locais de dados que são gravados no registro padrão. A tarefa executa as seguintes etapas:
  • Valida os locais de dados especificados no campo Locais de dados de IM adicionais e os locais de dados localizados pela tarefa durante a procura (se a procura do sistema estiver configurada como true)
  • Anexa os locais de dados válidos à lista de local de dados existente para uso futuro
  • Remove locais de dados duplicados
  • Executa a tarefa de inventário
Quando a tarefa for concluída, o inventário para o destino será atual.

Parâmetros da tarefa

Tabela 30. Descrições do Parâmetro findIMDataLocation. Execute um comando submitJob findIMDataLocation com pelo menos o parâmetro responseFile. É possível especificar os parâmetros searchSystem e dataLocations simultaneamente.
Parâmetro Descrição Type
targetList Especifica o local dos sistemas de destino na tarefa. Sequência de Caracteres
searchSystem Especifica o CIM para procurar o sistema de destino inteiro para os locais de dados do Installation Manager. Sequência de Caracteres
dataLocations Especifica o local dos dados usáveis do Installation Manager. A tarefa lista apenas os locais de dados do Installation Manager que são utilizáveis para o usuário de destino atual que está registrado no Console Administrativo. Sequência de Caracteres

Exemplo de uso

AdminTask.submitJob ('[-jobType findDataLocation -targetList targetList -jobParams [[searchSystem true] 
[datalocations path_to_data_locations_separated_by_semicolon]  ]]')

Enviar tarefas do Liberty

É possível enviar tarefas para instalar e desinstalar recursos do Liberty e para iniciar e parar servidores Liberty. Um servidor Liberty é um servidor de aplicativos dinâmico e rápido de iniciar, no qual você pode incluir recursos facilmente e administrar editando arquivos de configuração XML.

Uma instalação do Liberty requer um Java Development Kit (JDK) ou um Java Runtime Environment (JRE) para executar tarefas que iniciam ou param o servidor. Configure o local de JDK ou JRE concluindo uma das ações a seguir:
  • Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo server.env. A tarefa lê a propriedade JAVA_HOME e configura-a no ambiente de destino antes de executar o comando para iniciar ou parar o servidor. Entretanto, essa propriedade não será utilizada pelo comando do servidor Liberty, se você iniciar ou parar o servidor manualmente.

    [z/OS]O arquivo server.env deve estar em codificação EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo .bashrc do usuário.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Anexe o caminho de JDK ou JRE à variável de ambiente PATH.
  • [Windows]Configure a propriedade JAVA_HOME para o local de JDK ou JRE como uma variável de ambiente do sistema.
  • [Windows]Anexe o caminho de JDK ou JRE à variável do sistema PATH.

Se JAVA_HOME não estiver especificado em server.env ou no ambiente do usuário, o gerenciador de tarefa procura por JDK ou JRE no caminho de procura de usuário.

installLibertyProfileResources

A tarefa installLibertyProfileResources extrai recursos em uma imagem do Liberty para os diretórios de destino relativos ao diretório-raiz. Antes de executar esta tarefa, as condições a seguir devem existir:

  • Um computador host deve ser registrado com o gerenciador de tarefa.
  • A imagem, um arquivo compactado zip, deve conter recursos do Liberty em uma estrutura de diretório que satisfaz regras do gerenciador de tarefa. Consulte Compactando recursos do Liberty.
  • O diretório raiz para instalar os recursos no host de destino deve ser definido. No mínimo, configure a variável WLP_WORKING_DIR para um diretório válido que está em um host de destino. Para instalar os recursos em um diretório compartilhado no host de destino, é necessário configurar a variável WLP_SHARED_DIR para um diretório válido. Consulte Configurando variáveis para servidores Liberty.

Durante a implementação dos recursos, o produto aplica a substituição de variável ao arquivo bootstrap.properties dentro de cada servidor Liberty.

[z/OS]O arquivo server.env deve estar em codificação EBCDIC.

A tarefa extrai a imagem no host de destino digitando os métodos a seguir na sequência:
  • Use o utilitário unzip no host.
  • Use o utilitário jar no host, incluindo o utilitário jar a partir de um kit de desenvolvimento de software (SDK) que é localizado por uma tarefa de inventário.
  • [Windows]Use o utilitário unzip que é copiado no host remoto pela duração da tarefa, se não desativado especificamente pelo administrador. O utilitário unzip é excluído após a tarefa ser concluída.
  • Descompacte o arquivo zip no gerenciador de tarefa e copie arquivos um por vez no host de destino. Este método somente será aplicado se a imagem do servidor Liberty residir no gerenciador de tarefa.

A tarefa falha sem instalar um recurso se a instância de recurso já existe em um diretório de destino.

Parâmetros da tarefa

Tabela 31. Descrições do Parâmetro installLibertyProfileResources. Execute um comando submitJob installLibertyProfileResources com pelo menos o parâmetro de imagem ou url.
Parâmetro Description Tipo
image Se o arquivo compactado que fornece a imagem do Liberty residir em um host do gerenciador de tarefa, especificará o nome do caminho completo do arquivo compactado; por exemplo:
[AIX][HP-UX][Linux][Solaris]
/resources/my_liberty_server.zip
[Windows]
c:/resources/my_liberty_server.zip
Cadeia
url Se o arquivo compactado que fornece os recursos do Liberty não residir em um host do gerenciador de tarefa, especificará o caminho da URL para o arquivo compactado. Os nomes de esquema suportados para o localizador de recurso universal (URL) incluem http, https, ftp e file.
Restrição: Para especificar um protocolo de URL diferente de file, o host de destino deve ter um utilitário wget. Selecione um protocolo de download remoto http, https ou ftp que o utilitário wget no host de destino suporta. Se o utilitário wget não suportar seu protocolo selecionado, a tarefa não poderá instalar os recursos.

Por exemplo, especifique uma das URLs a seguir para o arquivo de recursos, my_liberty_server.zip.

Se os recursos do servidor Liberty residirem em um servidor HTTP ou HTTPS:

http://www.mycompany.com/resources/my_liberty_server.zip

https://www.mycompany.com/resources/my_liberty_server.zip

Se os recursos residirem em um servidor FTP:

ftp://www.mycompany.com/resources/my_liberty_server.zip

Se os recursos residirem no computador host de destino, a URL poderá usar o esquema do arquivo para descrever o caminho e o nome do arquivo compactado:

[AIX][HP-UX][Linux][Solaris]
file:///resources/my_liberty_server.zip
[Windows]
file://c:/resources/my_liberty_server.zip

Se a URL for protegida por senha, você também deverá especificar valores para urluser e urlpassword.

Cadeia
share Especifica se deve instalar os recursos do Liberty para um diretório compartilhado. Quando configurado como true, os recursos são instalados no local definido pela variável WLP_SHARED_DIR. Se a variável WLP_SHARED_DIR estiver indefinida ou não especificar um diretório válido, o produto retorna um erro e não extrai recursos da imagem.

Quando o valor padrão é configurado como false, a tarefa instala os recursos no local definido pela variável WLP_WORKING_DIR.

Booleana
urluser Especifica um nome de usuário para a URL. Se você especificou uma URL e a URL é protegida por senha, deverá especificar um nome de usuário. Caso contrário, não forneça um valor para urluser. Cadeia
urlpassword Especifica uma senha que ativa o urluser para acessar a URL. Se você especificou uma URL e a URL é protegida por senha, você deverá especificar uma senha. Caso contrário, não forneça um valor para urlpassword. Sequência de Caracteres

Exemplo de uso

O exemplo a seguir possui a imagem no mesmo host do gerenciador de tarefa e instala para WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
O exemplo a seguir possui a imagem no host de destino, especifica um URL de arquivo para a imagem e instala para WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
O exemplo a seguir possui a imagem em um servidor FTP remoto protegido por senha e instala para WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword ftp_pwd] [url ftp://www.mycompany.com/projects/liberty/image-0111003.zip]
     [share FALSE] [urluser ftp_user] ]]')
O exemplo a seguir possui a imagem em um servidor HTTP remoto protegido por senha e instala para WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword http_pwd] [url http://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share FALSE] [urluser http_user] ]]')
O exemplo a seguir possui a imagem em um servidor https remoto protegido por senha e instala para WLP_SHARED_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword http_pwd] [url https://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share TRUE] [urluser http_user] ]]')

uninstallLibertyProfileResources

A tarefa uninstallLibertyProfileResources remove um recurso da administração pelo gerenciador de tarefa. O recurso foi instalado anteriormente em um diretório de destino no host pela tarefa installLibertyProfileResources, ou após a instalação manual ao descompactar o arquivo zip de uma imagem do Liberty, ele foi localizado pela tarefa de inventário.

O produto retornará um erro e não removerá o recurso se qualquer uma das condições a seguir existir:
  • O comando especifica mais de um tipo de recurso para remoção.
  • O nome do recurso resolve para mais de um recurso com o mesmo nome.
  • O recurso não existe em um diretório que o gerenciador de tarefa pode acessar e procurar.
Evitar Problemas Evitar Problemas: Se a tarefa falhar, alguns arquivos poderão ser excluídos. O recurso pode estar em um estado corrompido. Se você alterar manualmente arquivos de recursos para corrigir o problema, após alterar os arquivos, execute uma tarefa de inventário para atualizar o inventário.gotcha

Parâmetros da tarefa

Tabela 32. Descrições do Parâmetro uninstallLibertyProfileResources. Executa um comando submitJob uninstallLibertyProfileResources com apenas um parâmetro que identifica o recurso a ser removido.
Parâmetro Description Tipo
projectName Especifica o nome ou ID do recurso do projeto a ser removido. O produto procura todos os servidores para o projeto. Para cada servidor identificado que estiver em execução, o produto parará o servidor antes de tentar remover o recurso. Cadeia
runtimeName Especifica o ID do nome ou do recurso do tempo de execução do Liberty a ser removido. O produto procura todos os servidores para o tempo de execução. Para cada servidor identificado que estiver em execução, o produto parará o servidor antes de tentar remover o recurso. Cadeia
sdkName Especifica o nome ou ID do recurso do kit de desenvolvimento de software (SDK) a ser removido. Cadeia
serverName Especifica o nome ou ID do recurso do servidor a ser removido. Se o servidor estiver em execução, o produto parará o recurso antes de remover o recurso. Cadeia
applicationBinaryName Especifica o nome ou ID do recurso do binário do aplicativo a ser removido. Cadeia
forceDelete Opcionalmente, especifica se deve excluir recursos, mesmo se que o status não possa ser detectado. O padrão é false para não excluir recursos. Quando o valor é true, os recursos do servidor são excluídos mesmo se o status dos recursos do servidor não possam ser detectados ou os servidores não possam ser parados. Se o status para um status não puder ser detectado, a tarefa uninstallLibertyProfileResources falha, a menos que essa opção forceDelete seja especificada. Booleana

Exemplo de uso

O exemplo a seguir remove o binário do aplicativo DefaultWebApplication.war da administração do gerenciador de tarefa:

AdminTask.submitJob('[-jobType uninstallLibertyProfileResources -targetList [host_name]
 -description uninstallLibertyProfileResources
 -jobParams [ [applicationBinaryName DefaultWebApplication.war] ]]')

startLibertyProfileServer

A tarefa startLibertyProfileServer inicia um ou mais recursos do servidor Liberty. O status dos recursos do servidor muda de Interrompido para Iniciado.

Um servidor Liberty requer um Java Development Kit (JDK) ou um Java Runtime Environment (JRE) para executar essa tarefa. Configure o local de JDK ou JRE concluindo uma das ações a seguir:
  • Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo server.env. A tarefa lê a propriedade JAVA_HOME e a configura no ambiente de destino antes de executar o comando para iniciar o servidor. Entretanto, essa propriedade não é utilizada pelo comando do servidor Liberty se o servidor for iniciado manualmente.

    [z/OS]O arquivo server.env deve estar em codificação EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo .bashrc do usuário.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Anexe o caminho de JDK ou JRE à variável de ambiente PATH.
  • [Windows]Configure a propriedade JAVA_HOME para o local de JDK ou JRE como uma variável de ambiente do sistema.
  • [Windows]Anexe o caminho de JDK ou JRE à variável do sistema PATH.

Parâmetros da tarefa

Tabela 33. Descrições do Parâmetro startLibertyProfileServer. Execute um comando submitJob startLibertyProfileServer com o parâmetro startResource.
Parâmetro Description Tipo
startResource Especifica um nome do caminho do recurso do servidor Liberty a ser iniciado. Cadeia

Exemplo de uso

O exemplo a seguir inicia o recurso do servidor Liberty server1:

AdminTask.submitJob('-jobType startLibertyProfileServer -targetList host_name
 -description startLibertyProfileServer
 -jobParams [[startResource runtime/wlp/liberty_server/server1 ]]')

stopLibertyProfileServer

A tarefa stopLibertyProfileServer para um ou mais recursos do servidor Liberty em execução. O status dos recursos do servidor muda de Iniciado para Interrompido.

Um servidor Liberty requer um Java Development Kit (JDK) ou um Java Runtime Environment (JRE) para executar essa tarefa. Assegure-se de que o local de JDK ou JRE esteja configurado no destino. Para obter informações sobre a configuração do local de JDK ou JRE, consulte startLibertyProfileServer.

Parâmetros da tarefa

Tabela 34. Descrições do Parâmetro stopLibertyProfileServer. Execute um comando submitJob stopLibertyProfileServer com o parâmetro stopResource.
Parâmetro Description Tipo
stopResource Especifica um nome do caminho do recurso do servidor Liberty a ser parado. Cadeia

Exemplo de uso

O exemplo a seguir para o recurso do servidor Liberty:

AdminTask.submitJob('-jobType stopLibertyProfileServer -targetList host_name
 -description stopLibertyProfileServer
 -jobParams [[stopResource project/proj1/runtime/wlp/liberty_server/defaultServer]]')

generateMergedPluginConfigForLibertyProfileServers

A tarefa generateMergedPluginConfigForLibertyProfileServers cria um único arquivo plugin-cfg.xml mesclando todos os arquivos plugin-cfg.xml que foram gerados para o servidor liberty nos hosts de destino.

Para essa tarefa, é possível especificar um servidor Liberty em múltiplos hosts de destino. Após o servidor do Liberty ser localizado, um arquivo plugin-cfg.xml será gerado nesse servidor e, em seguida, copiado de volta no gerenciador de tarefa. Quando todos os arquivos plugin-cfg.xml forem gerados para todos os servidores Liberty de destino, eles serão mesclados em um arquivo plugin-cfg.xml. Esse arquivo mesclado é colocado no diretório do gerenciador de tarefa app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/.

Essa tarefa requer uma conexão Java Management Extensions (JMX) com servidores Liberty nos hosts de destino. É possível configurar a conexão JMX no conector local ou no conector HTTP/REST. Especifique o nome do recurso do conector no arquivo server.xml dos servidores Liberty. O exemplo a seguir mostra os nomes de recursos em um arquivo server.xml para os conectores local e HTTP/REST:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Se você usar o conector HTTP/REST, é necessário especificar um nome de usuário e senha para a conexão JMX ao submeter a tarefa.
A tarefa parará e o produto retornará um erro se qualquer uma das condições a seguir existir:
  • Um servidor Liberty de destino não está em execução.
  • Nenhum conector JMX está configurado para um servidor Liberty de destino.
  • O comando não especificar credenciais válidas para uma conexão JMX.

Parâmetros da tarefa

Tabela 35. Descrições do Parâmetro generateMergedPluginConfigForLibertyProfileServers. Execute um comando submitJob generateMergedPluginConfigForLibertyProfileServers com os parâmetros serverName e de conexão.
Parâmetro Description Tipo
serverName Especifica o nome ou ID do recurso do servidor para o qual gerar os arquivos plugin-cfg.xml nos hosts de destino. O servidor Liberty deve estar em execução nos hosts de destino. Cadeia
jmxuser Especifica o nome de usuário para a conexão JMX. Especifica esse parâmetro se você usar o conector HTTP/REST para uma conexão JMX. Cadeia
jmxpassword Especifica a senha para uma conexão JMX. Especifica esse parâmetro se você usar o conector HTTP/REST para uma conexão JMX. Cadeia

Exemplo de uso

O exemplo a seguir gera um arquivo fundido plugin-cfg.xml para o servidor liberty defaultServer nos hosts de destino, host1 e host2:

AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
 -targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
 -jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]') 

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7jobtypes
Nome do arquivo: rxml_7jobtypes.html