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
- Enviar uma Tarefa para Coletar Inventário
- Submeta uma tarefa para coletar status do destino
- Submeter tarefas para gerenciar arquivos
- Enviar uma Tarefa que Executa um Script wsadmin
- Enviar Tarefas para Gerenciar Aplicativos
- Enviar Tarefas para Gerenciar Servidores
- Enviar Tarefas para Gerenciar o Tempo de Execução do Servidor
- Enviar uma tarefa para executar comandos
- Enviar uma Tarefa para gerenciar perfis
- Enviar tarefas do Installation Manager
- Enviar tarefas do Liberty
Parâmetros Comuns para Todos os Tipos de Tarefas
- 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]')
- 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]](../images/iseries.gif)
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
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
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.

- 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.
- Insira o seguinte comando: mkdir JobManager
- Insira o seguinte comando: chown -R QEJBSVR JobManager
- Copie o arquivo a ser distribuído para o diretório JobManager.
- No console administrativo, envie a tarefa distributeFile.
Parâmetros da tarefa
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
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
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.
Parâmetros da tarefa
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
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.
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.
Parâmetros da tarefa
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
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
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 |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
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
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
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
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
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 |
![]() |
![]() |
![]() |
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
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
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 |
![]() |
![]() |
![]() |
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
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
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
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
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
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
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
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]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command versionInfo.bat]]')
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
![[Windows]](../images/windows.gif)
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
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.

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
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 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
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.

Você deve iniciar o caminho com uma letra da unidade.
Você deve iniciar o caminho com uma /.
Parâmetros da tarefa
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.
- 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
Parâmetros da tarefa
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.
- 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.
O arquivo server.env deve estar em codificação EBCDIC.
Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo .bashrc do usuário.
Anexe o caminho de JDK ou JRE à variável de ambiente PATH.
Configure a propriedade JAVA_HOME para o local de JDK ou JRE como uma variável de ambiente do sistema.
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.
O arquivo server.env deve estar em codificação EBCDIC.
- 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.
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
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:![]() ![]() ![]() ![]()
![]()
|
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:
Se os recursos residirem em um servidor FTP:
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: ![]() ![]() ![]() ![]()
![]()
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
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
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] ]]')
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] ]]')
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 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.

Parâmetros da tarefa
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.
- 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.
O arquivo server.env deve estar em codificação EBCDIC.
Configure a propriedade JAVA_HOME para o local de JDK ou JRE no arquivo .bashrc do usuário.
Anexe o caminho de JDK ou JRE à variável de ambiente PATH.
Configure a propriedade JAVA_HOME para o local de JDK ou JRE como uma variável de ambiente do sistema.
Anexe o caminho de JDK ou JRE à variável do sistema PATH.
Parâmetros da tarefa
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
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/.
<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.- 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
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]]]')