Comandos para o objeto AdminApp usando o script wsadmin

Utilize o objeto AdminApp para instalar, modificar e administrar aplicativos.

O objeto AdminApp interage com os serviço de gerenciamento e configuração do WebSphere Application Server para fazer consultas do aplicativo e mudanças. Esta interação inclui a instalação e a desinstalação de aplicativos, listagem de módulos, exportação, etc.

Você pode iniciar o cliente de script quando nenhum servidor estiver em execução se você quiser utilizar somente operações locais. Para executar no modo local, utilize a opção -conntype NONE para iniciar o cliente de script. Você recebe uma mensagem de que está executando no modo local. Não é recomendado executar o objeto AdminApp em modo local quando um servidor está atualmente em execução. Isso ocorre porque qualquer alteração na configuração feita em modo local não será refletida na configuração do servidor em execução, e vice-versa. Se você salvar uma configuração conflitante, pode corromper a configuração.

[AIX Solaris HP-UX Linux Windows]Importante: Se você estiver implementando um aplicativo no modo local usando wsadmin -conntype NONE, deverá modificar o arquivo de comando wsadmin.bat ou wsadmin.sh no diretório install_root/bin. Execute as seguintes etapas:
  1. Faça uma cópia de backup do arquivo install_root/bin/wsadmin.bat ou install_dir/bin/wsadmin.bat.
  2. Inclua as linhas de código a seguir no arquivo wsadmin logo após a chamada para o arquivo setupCmdLine.bat ou setupCmdLine.sh:
    [AIX]
    LIBPATH="$WAS_LIBPATH":$LIBPATH
    export LIBPATH EXTSHM
    [HP-UX]
    SHLIB_PATH="$WAS_LIBPATH":$SHLIB_PATH
    export SHLIB_PATH
    [Linux][Solaris]
    LD_LIBRARY_PATH="$WAS_LIBPATH":$LD_LIBRARY_PATH
    export LD_LIBRARY_PATH
    [Windows]
    SET PATH=%WAS_PATH%
    Evitar Problemas Evitar Problemas: Não especifique LD_LIBRARY_PATH_64 no lugar de LD_LIBRARY_PATH na instrução de exportação anterior. Especificar LD_LIBRARY_PATH_64 nessa instrução de exportação substitui qualquer valor LD_LIBRARY_PATH existente nos outros scripts.gotcha
  3. Salve o arquivo wsadmin.bat ou wsadmin.sh atualizado.
  4. Implemente o aplicativo.

Em um ambiente de gerenciador de implementação, as atualizações de configuração estão disponíveis apenas se um cliente de script estiver conectado a um gerenciador de implementação.

Quando conectado a um agente do nó ou a um servidor de aplicativos gerenciado, você não poderá atualizar a configuração, porque a configuração desses processos do servidor são cópias da configuração principal que reside no gerenciador de implementação. As cópias são criadas em uma máquina de nó quando uma sincronização da configuração ocorre entre o gerenciador de implementação e o agente do nó. Faça alterações na configuração dos processos do servidor conectando um cliente de script a um gerenciador de implementação. Por esse motivo, para alterar uma configuração, não execute um cliente de definição de script em modo local em uma máquina de nó. Essa configuração não é suportada.

A seguinte nota aplica-se a referências de arquivos xmi neste tópico:
Configurações suportadas Configurações suportadas: Para arquivos de extensão e de ligação IBM®, a extensão do nome do arquivo .xmi ou .xml é diferente dependendo de você estar utilizando um aplicativo pré-Java EE 5 ou um módulo ou um aplicativo ou módulo Java™ EE 5 ou posterior. Um arquivo de extensão ou de ligação IBM é denominado ibm-*-ext.xmi ou ibm-*-bnd.xmi em que * é o tipo de arquivo de extensão ou de ligação como app, aplicativo, ejb-jar ou web. As seguintes condições se aplicam:
  • Para um aplicativo ou módulo que usa um Java EE versão anterior à versão 5, a extensão do arquivo deverá ser .xmi.
  • Para um aplicativo ou módulo que usa Java EE 5 ou posterior, a extensão do arquivo deve ser .xml. Se os arquivos .xmi forem incluídos no aplicativo ou módulo, o produto ignorará os arquivos .xmi.

No entanto, um módulo Java EE 5 ou posterior pode existir dentro de um aplicativo que inclui arquivos pré-Java EE 5 e usa a extensão do nome do arquivo .xmi.

Os arquivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, e ibm-portlet-ext.xmi continuam a usar as extensões de arquivo .xmi.

sptcfg

deleteUserAndGroupEntries

Utilize o comando deleteUserAndGroupEntries para excluir usuários ou grupos de todas as funções, e para excluir IDs de usuário e senhas de todas as funções RunAs definidas no aplicativo.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    $AdminApp deleteUserAndGroupEntries myapp
  • Utilizando a cadeia Jython:
    print AdminApp.deleteUserAndGroupEntries('myapp')
  • Utilizando a lista Jython:
    print AdminApp.deleteUserAndGroupEntries(['myapp'])

editar

Utilize o comando edit para editar um aplicativo ou módulo em modo em lote. O comando edit altera o aplicativo especificado pelo argumento application name utilizando as opções especificadas pelo argumento options. Nenhuma opção é obrigatória para o comando edit.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.
options
Especifica as opções a serem aplicadas na configuração do aplicativo ou do módulo.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    $AdminApp edit "JavaMail Sample" {-MapWebModToVH {{"JavaMail Sample WebApp" mtcomps.war,WEB-INF/web.xml newVH}}}
  • Utilizando a cadeia Jython:
    print AdminApp.edit("JavaMail Sample", '[-MapWebModToVH [["JavaMail 32 Sample WebApp" 
    mtcomps.war,WEB-INF/web.xml newVH]]]')
  • Utilizando a lista Jython:
    option = [["JavaMail 32 Sample WebApp", "mtcomps.war,WEB-INF/web.xml", "newVH"]] 
    mapVHOption = ["-MapWebModToVH", option]
    print AdminApp.edit("JavaMail Sample", mapVHOption)

editInteractive

Utilize o comando editInteractive para editar um aplicativo ou módulo em modo interativo. O comando editInteractive altera a implementação do aplicativo. Especifique essas alterações no parâmetro opções. Nenhuma opção é obrigatória para o comando editInteractive.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.
options
Especifica as opções a serem aplicadas na configuração do aplicativo ou do módulo.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    $AdminApp editInteractive ivtApp 
  • Utilizando a cadeia Jython:
    AdminApp.editInteractive('ivtApp')

exportar

Utilize o comando export para exportar o parâmetro application name para um arquivo que você especifica pelo nome do arquivo.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.
file name
Especifica o nome do arquivo para o qual exportar o nome do aplicativo.

Parâmetros Opcionais

exportToLocal
Especifica que o sistema deve exportar o aplicativo de interesse para o nome de arquivo especificado na máquina cliente local.

Exemplos

  • Utilizando Jacl:
    $AdminApp export DefaultApplication c:/temp/export.ear {-exportToLocal}
  • Utilizando Jython:
    AdminApp.export('DefaultApplication', 'c:/temp/export.ear', '[-exportToLocal]')

exportDDL

Utilize o comando exportDDL para extrair a DLL (Data Definition Language) do parâmetro de nome de aplicativo para o parâmetro de nome de diretório que um diretório especifica. O parâmetro options é opcional.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.
directory name
Especifica o nome do diretório para o qual exportar o nome do aplicativo.

Parâmetros Opcionais

options
Especifica as opções a serem transmitidas para o nome de aplicativo especificado.

Exemplos

  • Utilizando Jacl:
    $AdminApp exportDDL "My App" /usr/me/DDL {-ddlprefix myApp}
  • Utilizando a cadeia Jython:
    print AdminApp.exportDDL("My App", '/usr/me/DDL', '[-ddlprefix myApp]')

exportFile

Utilize o comando exportFile para exportar o conteúdo de um único arquivo especificado pelo URI (Identificador Uniforme de Recursos) do aplicativo de interesse.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.
URI
Especifica o único arquivo a ser exportado. Especifique o URI dentro do contexto de um aplicativo, conforme exibido pelo seguinte exemplo: META-INF/application.xml. Para especificar arquivos em um módulo, o URI começa com um URI de módulo, conforme exibido pelo seguinte exemplo: foo.war/WEB-INF/web.xml.
filename
Especifica o caminho completo e o nome do arquivo para o qual exportar.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    $AdminApp exportFile "My App" myapp/components.jar/META-INF/ibm-ejb-jar-bnd.xml
     META-INF/ibm-ejb-jar-bnd.xml 
  • Utilizando a cadeia Jython:
    AdminApp.exportFile('My App', 'myapp/components.jar/META-INF/ibm-ejb-jar-bnd.xml', 
    'META-INF/ibm-ejb-jar-bnd.xml')

getDeployStatus

Utilize o comando getDeployStatus para exibir o status de implementação do aplicativo. Depois de instalar ou atualizar um aplicativo grande, utilize esse comando para exibir informações de status detalhadas para expansão de arquivos binários de aplicativos. Não é possível iniciar o aplicativo até que o sistema extraia os binários do aplicativo.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo de interesse.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    $AdminApp getDeployStatus myApplication
  • Utilizando Jython:
    print AdminApp.getDeployStatus('myApplication')

Executar o comando getDeployStatus, em que myApplication é DefaultApplication, resulta em informações de status sobre DefaultApplication, assemelhando-se ao seguinte:

ADMA5071I: verificação de status de distribuição iniciada para o aplicativo DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown
ADMA5011I: A limpeza do diretório temp para o aplicativo DefaultApplication está concluída.
ADMA5072I: Verificação de status de distribuição concluída para o aplicativo DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown

help

Utilize o comando help para exibir informações gerais da ajuda sobre o objeto AdminApp.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

Nenhuma.

Parâmetros Opcionais

nome da operação
Especifique essa opção para exibir a ajuda de um comando AdminApp ou uma opção de instalação.

Saída de amostra

A saída a seguir será retornada se você não especificar um argumento:
WASX7095I: o objeto AdminApp permite que objetos de aplicativos sejam manipulados incluindo a instalação, 
a desinstalação, a edição e a listagem.  A maioria dos comandos suportados pelo AdminApp operam em dois modos: 
o modo padrão é um em que o AdminApp se comunica com o servidor de aplicativos para realizar suas tarefas 
.  Um modo local também é possível, no qual nenhuma comunicação do servidor ocorre.  O modo local da 
operação é chamado incluindo o sinalizador "-conntype NONE" na sequência de opções fornecida para o comando.

Os comandos a seguir são suportados por AdminApp; informações mais detalhadas sobre cada um desses comandos 
são disponibilizadas utilizando o comando "help" de AdminApp e fornecendo o nome do comando como um argumento.

edit            Edita as propriedades de um aplicativo
editInteractive Edita as propriedades de um aplicativo interativamente
export          Exporta o aplicativo para um arquivo
exportDDL       Extrai a DDL do aplicativo para um diretório
help            Mostra informações da ajuda
install         Instala um aplicativo, fornecendo um nome do arquivo e uma cadeia de opções.
installInteractive
                Instala um aplicativo no modo interativo, dados um nome de arquivo e uma
                cadeia de opções.
list            Lista todos os aplicativos instalados
listModules     Lista os módulos em um aplicativo especificado 
options         Mostra	as opções disponíveis para um arquivo especificado ou em geral.
taskInfo        Mostra informações detalhadas referentes a uma determinada
                tarefa da instalação para um determinado arquivo
uninstall Desinstala um aplicativo, fornecendo um nome do aplicativo e uma cadeia de opções
A seguinte saída será retornada se você especificar uninstall como o argumento operation name:
WASX7102I: Method: uninstall
Argumentos: nome do aplicativo, options
Descrição: Desinstala o aplicativo denominado "nome do aplicativo" utilizando as opções fornecidas pela Cadeia 2.
Método: uninstall
Argumentos: nome do aplicativo
Descrição: Desinstala o aplicativo especificado por "application name" utilizando as opções padrão.

Exemplos

Utilizando Jacl:
  • O seguinte exemplo não especifica nenhum argumento:
    $AdminApp help
  • O exemplo a seguir especifica o argumento de nome da operação:
    $AdminApp help uninstall
Utilizando Jython:
  • O exemplo a seguir não especifica nenhum argumento:
    print AdminApp.help()
  • O exemplo a seguir especifica o argumento de nome da operação:
    print AdminApp.help('uninstall')

instalar

Utilize o comando install para instalar um aplicativo no modo não interativo, considerando um nome de arquivo completo e uma cadeia de opções de instalação. O parâmetro options é opcional.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

Arquivo ear
Especifique o caminho do arquivo .ear para a instalação.

Parâmetros Opcionais

options
Especifique as opções de instalação para o comando.

Exemplos

  • Utilizando Jacl:
    $AdminApp install c:/apps/myapp.ear
  • Utilizando Jython:
    print AdminApp.install('c:/apps/myapp.ear')
Muitas opções estão disponíveis para esse comando. É possível obter uma lista de opções válidas para um arquivo archive corporativo (EAR) com o comando a seguir:

Utilizando Jacl:

$AdminApp options myApp.ear
Utilizando Jython:
print AdminApp.options('myApp.ear')
Você também pode obter ajudar para cada objeto com o seguinte comando:

Utilizando Jacl:

$AdminApp help MapModulesToServers
Utilizando Jython:
print AdminApp.help('MapModulesToServers')

installInteractive

Utilize o comando installInteractive para instalar um aplicativo no modo interativo, considerando um nome de arquivo completo e uma cadeia de opções de instalação. O parâmetro options é opcional.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

ear file
Especifique o caminho do arquivo .ear para a instalação.

Parâmetros Opcionais

options
Especifique as opções de instalação do comando.

Exemplos

  • Utilizando Jacl:
    $AdminApp installInteractive c:/websphere/appserver/installableApps/jmsample.ear
  • Utilizando Jython:
    print AdminApp.installInteractive('c:/websphere/appserver/installableApps/jmsample.ear')

isAppReady

Utilize o comando isAppReady para determinar se o aplicativo especificado foi distribuído e está pronto para ser executado. Retorna um valor true se o aplicativo estiver pronto ou um valor false se o aplicativo não estiver pronto. Um script que chama isAppReady normalmente instala ou atualiza um aplicativo e, em seguida, permanece em loop em torno da chamada até que a chamada retorne um valor true antes de iniciar o aplicativo. Este comando não é suportado quando a ferramenta wsadmin não está conectada a um servidor.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo de interesse.

Parâmetros Opcionais

ignoreUnknownState
Testa se o aplicativo especificado foi distribuído e está pronto para ser executado. Os valores válidos para o parâmetro ignoreUnknownState incluem true e false. Se você especificar um valor true, os nós e servidores com um estado desconhecido não serão incluídos no retorno final pronto. O comando retorna um valor true se o aplicativo estiver pronto um valor false se o aplicativo não estiver pronto. Este comando não é suportado quando a ferramenta wsadmin não está conectada a um servidor.

Saída de amostra

A saída de amostra a seguir será retornada se você especificar o parâmetro application name:
ADMA5071I: Verificação do status de distribuição iniciada para o aplicativo 
           DefaultApplication.WebSphere:cell=Node03Cell,node=myNode,distribution=true
ADMA5011I: A limpeza do diretório temp para o aplicativo DefaultApplication está concluída.
ADMA5072I: Verificação do status de distribuição concluída para o aplicativo DefaultApplication.true
A saída de amostra a seguir será retornada se você especificar os parâmetros application name e ignoreUnknownState:
ADMA5071I: verificação de status de distribuição iniciada para o aplicativo TEST.WebSphere:cell=myCell,node=myNode,
					distribution=unknown
ADMA5011I: A limpeza do diretório temp para o aplicativo TEST está concluída.
ADMA5072I: Verificação do status de distribuição concluída para o aplicativo TEST.false

Exemplos

Os exemplos a seguir especificam somente o parâmetro application name:
  • Utilizando Jacl:
    set result [$AdminApp isAppReady 
    DefaultApplication]
    while {$result == "false"} {
       ### Wait 5 seconds before checking again
       after 5000   
    set result [$AdminApp isAppReady DefaultApplication]
    }
    puts "Starting application..."
  • Utilizando Jython:
    import time
    result = AdminApp.isAppReady('DefaultApplication')
    while (result == "false")
    :   ### Wait 5 seconds before checking again
        time.sleep(5)   
        result = AdminApp.isAppReady
    ('DefaultApplication')
    print("Starting application...")
Os exemplos a seguir especificam os parâmetros application name e ignoreUnknownState:
  • Utilizando Jacl:
    set result [$AdminApp isAppReady
    DefaultApplication]
    while {$result == "false"} {
       ### Wait 5 seconds before checking again
       after 5000   
       set result [$AdminApp isAppReady
    DefaultApplication]
    }
    puts "Starting application..."
  • Utilizando Jython:
    import time
    result = AdminApp.isAppReady
    ('DefaultApplication')
    while (result == "false"):
       ### Wait 5 seconds before checking again
       time.sleep(5)   
       result = AdminApp.isAppReady
    ('DefaultApplication')
    print("Starting application...")

list

Utilize o comando list para listar os aplicativos instalados na configuração.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

Nenhuma.

Parâmetros Opcionais

target
Lista os aplicativos instalados num determinado escopo de destino na configuração.

Saída de amostra

adminconsole 
DefaultApplication 
ivtApp

Exemplos

  • Utilizando Jacl:
    $AdminApp list
  • Utilizando Jython:
    print AdminApp.list()
Os exemplos a seguir especificam um valor para o parâmetro de destino:
  • Utilizando Jacl:
    $AdminApp list WebSphere:cell=myCell,node=myNode,server=myServer
  • Utilizando Jython:
    print AdminApp.list("WebSphere:cell=myCell,node=myNode,server=myServer")

listModules

Utilize o comando listModules para listar os módulos em um aplicativo.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o aplicativo de interesse.

Parâmetros Opcionais

options
Especifica a lista de servidores de aplicativos em que os módulos estão instalados. O parâmetro options é opcional. A opção válida é -server.

Saída de amostra

O exemplo a seguir é a concatenação de appname, #, URI do módulo, + e DD URI. Você pode transmitir essa cadeia para os comandos edit e editInteractive do AdminApp.
ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
ivtApp#ivt_app.war+WEB-INF/web.xml

Exemplos

  • Utilizando Jacl:
    $AdminApp listModules ivtApp
  • Utilizando Jython:
    print AdminApp.listModules('ivtApp')

options

Use o comando options para exibir uma lista de opções para instalar um arquivo archive corporativo (EAR).

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

Nenhuma.

Parâmetros Opcionais

Arquivo EAR
Especifica o arquivo EAR de interesse.
nome do aplicativo
Especifica o aplicativo para o qual exibir uma lista de opções para editar um arquivo existente.
application module name
Especifica o nome do módulo para o qual exibir uma lista de opções para editar um módulo em um aplicativo existente. Esse parâmetro requer o mesmo formato de nome do módulo que a saída retornada pelo comando listModules.
file, operations
Exibe uma lista de opções para instalar ou atualizar um aplicativo ou um arquivo do módulo aplicativo. Especifique um dos seguintes valores válidos:
  • installapp - Utilize essa opção para instalar o arquivo especificado.
  • updateapp - Utilize essa opção para atualizar um aplicativo existente com o arquivo especificado.
  • addmodule - Utilize essa opção para incluir o arquivo de módulo especificado para um aplicativo existente.
  • updatemodule - Utilize essa opção para atualizar um módulo existente em um aplicativo com o arquivo de módulo especificado.

Saída de amostra

WASX7112I: As opções a seguir são válidas para "ivtApp"
MapRolesToUsers
BindJndiForEJBNonMessageBinding
MapEJBRefToEJB
MapWebModToVH
MapModulesToServers
distributeApp
nodistributeApp
useMetaDataFromBinary
nouseMetaDataFromBinary
createMBeansForResources
nocreateMBeansForResources
reloadEnabled
noreloadEnabled
detalhado
installed.ear.destination
reloadInterval

Exemplos

O comando options de exemplo a seguir retorna as opções válidas para um arquivo EAR:
  • Utilizando Jacl:
    $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear
  • Utilizando Jython:
    print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear')
O comando options de exemplo a seguir retorna as opções válidas para um aplicativo:
  • Utilizando Jacl:
    $AdminApp options ivtApp
  • Utilizando Jython:
    print AdminApp.options('ivtApp')
O comando options de exemplo a seguir retorna as opções válidas para um módulo aplicativo:
  • Utilizando Jacl:
    $AdminApp options ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
  • Utilizando Jython:
    print AdminApp.options('ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml')
O comando options de exemplo a seguir retorna as opções válidas para a operação que é solicitada com o arquivo de entrada:
  • Utilizando Jacl:
    $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear updateapp
  • Utilizando Jython:
    print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear', 'updateapp')

publishWSDL

Utilize o comando publishWSDL para publicar arquivos WSDL (Web Services Description Language) do aplicativo especificado no parâmetro application name para o arquivo que é especificado no parâmetro file name.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

file name
Especifica o arquivo de interesse.
nome do aplicativo
Especifica o aplicativo de interesse.

Parâmetros Opcionais

Prefixos do endereço SOAP
Especifica os prefixos do endereço SOAP a serem utilizados.

Saída de amostra

O comando publishWSDL não retorna uma saída.

Exemplos

O comando publishWSDL de exemplo a seguir especifica os parâmetros application name e file name:
  • Utilizando Jacl:
    $AdminApp publishWSDL JAXRPCHandlerServer c:/temp/a.zip
  • Utilizando Jython:
    print AdminApp.publishWSDL('JAXRPCHandlerServer', 'c:/temp/a.zip')
O comando publishWSDL do exemplo a seguir especifica o nome do aplicativo, o nome do arquivo e os valores de parâmetro de prefixos de endereço do SOAP:
  • Utilizando Jacl:
    $AdminApp publishWSDL JAXRPCHandlersServer c:/temp/a.zip {{JAXRPCHandlersServerApp.war 
    {{http http://localhost:9080}}}}
  • Utilizando Jython:
    print AdminApp.publishWSDL('JAXRPCHandlersServer', 'c:/temp/a.zip', '[[JAXRPCHandlersServerApp.war
     [[http http://localhost:9080]]]]')

searchJNDIReferences

Utilize o comando searchJNDIReferences para lista aplicativos que se referem ao nome de JNDI (Java Naming and Directory Interface) em um nó específico.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

node configuration ID
Especifica o ID de configuração do nó de interesse.

Parâmetros Opcionais

options
Especifica as opções a serem utilizadas.

Saída de amostra

WASX7410W: Esta operação pode demorar um pouco, dependendo do número de aplicativos instalados em seu sistema.
MyApp
MapResRefToEJB :ejb-jar-ic.jar : [eis/J2CCF1]

Exemplos

O exemplo a seguir supõe que um aplicativo instalado denominado MyApp tenha um nome de JNDI de eis/J2CCF1:
  • Utilizando Jacl:
    $AdminApp searchJNDIReferences $node {-JNDIName eis/J2CCF1 -verbose}
  • Utilizando Jython:
    print AdminApp.searchJNDIReferences(node, '[-JNDIName eis/J2CCF1 -verbose]')

taskInfo

Use o comando taskInfo para fornecer informações sobre uma determinada opção de tarefa para um arquivo de aplicativo. Muitos nomes da tarefa alterados entre V5.x e V6.x para uma operação semelhante ou exatamente a mesma operação. Poderá ser necessário atualizar os scripts existentes ser você estiver migrando da V5.x para a V6.x.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

Arquivo EAR
Especifica o arquivo EAR de interesse.
task name
Especifica a tarefa para a qual solicitar as informações.

Parâmetros Opcionais

Nenhuma.

Saída de amostra

MapWebModToVH: Selecionando hosts virtuais para módulos da web
Especifique o host virtual em que deseja instalar os módulos da Web que estão contidos em
seu aplicativo. Os módulos da Web podem ser instalados no mesmo host virtual ou dispersos entre diversos hosts.
Cada elemento da tarefa MapWebModToVH consiste nos três seguintes
campos: "webModule", "uri", "virtualHost".
Desses campos, os seguintes poderão ser designados com novos valores: "virtualHost" e o seguinte são 
necessários: "virtualHost"

O conteúdo atual da tarefa depois de executar ligações padrão é:
webModule: JavaMail Sample WebApp
uri: mtcomps.war,WEB-INF/web.xml
virtualHost: default_host

Exemplos

  • Utilizando Jacl:
    $AdminApp taskInfo c:/websphere/appserver/installableApps/jmsample.ear MapWebModToVH
  • Utilizando Jython:
    print AdminApp.taskInfo('c:/websphere/appserver/installableApps/jmsample.ear', 'MapWebModToVH')

desinstalar

Utilize o comando uninstall para desinstalar um aplicativo existente.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo a ser desinstalado.

Parâmetros Opcionais

options
Especifica as opções de desinstalação.

Saída de amostra

ADMA5017I: desinstalação de myapp iniciada.
ADMA5104I: A entrada de índice do servidor para myCellManager foi atualizada com êxito.
ADMA5102I: A exclusão dos dados de configuração para myapp a partir do repositório de configuração 
foi concluída com êxito.
ADMA5011I: A limpeza do diretório temp do aplicativo myapp foi concluída.
ADMA5106I: O aplicativo myapp foi desinstalado com êxito.

Exemplos

  • Utilizando Jacl:
    $AdminApp uninstall myApp
  • Utilizando Jython:
    print AdminApp.uninstall('myApp')

update

Utilize o comando update para atualizar um aplicativo em modo não interativo. Esse comando suporta a inclusão, a remoção e a atualização de subcomponentes do aplicativo ou o aplicativo inteiro. Forneça o nome do aplicativo, o tipo de conteúdo e as opções de atualização.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo a ser atualizado.
content type
Utilize o parâmetro content type para indicar se deseja atualizar parte do aplicativo ou o aplicativo inteiro. A lista a seguir inclui os valores válidos do tipo de conteúdo para o comando update:
  • app - Indica que você deseja atualizar todo o aplicativo. Essa opção faz o mesmo que indicar a opção update com o comando install. Com o valor app como o tipo de conteúdo, você deve especificar a opção operation com update como valor. Forneça o novo arquivo archive corporativo (EAR) usando a opção de conteúdo. Você também pode especificar informações sobre ligação e opções do aplicativo. Por padrão, as informações sobre ligação para os módulos instalados são mescladas com as informações sobre ligação para os módulos atualizados. Para alterar esse comportamento padrão, especifique as opções update.ignore.old ou update.ignore.new.
  • file - Indica que você deseja atualizar um único arquivo. É possível incluir, remover ou atualizar arquivos individuais em qualquer escopo no aplicativo implementado. Com o valor file como o tipo de conteúdo, você deve executar operações no arquivo utilizando a opção operation. Dependendo do tipo de operação, opções adicionais são requeridas. Para inclusões e atualizações de arquivos, você deve fornecer o conteúdo do arquivo e o URI do arquivo relativo à raiz do arquivo EAR que está utilizando as opções contents e contenturi. Para exclusão do arquivo, você deve fornecer o URI do arquivo relativo à raiz do arquivo EAR, utilizando a opção contenturi que é a única entrada requerida. Qualquer outra opção fornecida é ignorada.
  • modulefile - Indica que você deseja atualizar um módulo. É possível incluir, remover ou atualizar um módulo de aplicativo individual. Se você especificar o valor modulefile como o tipo de conteúdo, você deve indicar a operação que deseja executar no módulo, utilizando a opção operation. Dependendo do tipo de operação, outras opções são requeridas. Para instalar novos módulos ou atualizar os módulos existentes de um aplicativo, você deve indicar o conteúdo do arquivo e o URI do arquivo relativo à raiz do arquivo EAR que está utilizando as opções contents e contenturi. Você também pode especificar informações sobre ligação e opções do aplicativo referentes aos módulos novos ou atualizados. Para atualizações do módulo, as informações sobre ligação do módulo instalado são mescladas com as informações sobre ligação do módulo de entrada por padrão. Para alterar o comportamento padrão, especifique as opções update.ignore.old ou update.ignore.new. Para excluir um módulo, indique o URI do arquivo relativo à raiz do arquivo EAR.
    Restrição: Geralmente, não é possível incluir ou atualizar um módulo se ele depender de outras classes fora do módulo, como classes dentro de um pacote ou de biblioteca opcional. O processamento do lado do cliente envolve a análise das classes de módulo de entrada e das classes que podem não serem carregadas com êxito, a menos que as dependências dessas classes sejam resolvidas. É possível incluir ou atualizar um módulo se você disponibilizar as classes necessárias em um sistema de arquivos que seja acessível através do script wsadmin. Através do script wsadmin, é possível modificar a propriedade com.ibm.ws.scripting.classpath no arquivo profile_root/properties/wsadmin.properties para incluir essas classes para que o carregador de classes possa resovê-los.
  • partialapp - Indica que você deseja atualizar um aplicativo parcial. Ao usar um subconjunto de componentes de aplicativo fornecidos no formato de arquivo .zip compactado é possível atualizar, incluir e excluir arquivos e módulos. O arquivo compactado não é uma plataforma Java 2 válida, arquivo Enterprise Edition (J2EE). Em vez disso, ele contém artefatos de aplicativos na mesma estrutura hierárquica em que são exibidos em um arquivo EAR. Para obter informações adicionais sobre como construir o arquivo compactado de aplicação parcial, consulte a seção Java API. Se você indicar o valor partialapp como o tipo de conteúdo, use a opção de conteúdo para especificar o local do arquivo compactado. Quando um aplicativo parcial é fornecido como uma entrada de atualização, as informações sobre ligação e as opções do aplicativo não podem ser especificadas e são ignoradas se fornecidas.

Parâmetros Opcionais

options
Há muitas opções disponíveis para o comando update. Para obter uma lista de cada opção válida para o comando update, consulte Opções para os comandos AdminApp object install, installInteractive, edit, editInteractive, update e updateInteractive usando o script wsadmin.

Saída de amostra

A atualização de singleFile foi iniciada.
ADMA5009I: Archive de aplicativo extraído em C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext
Arquivos incluídos a partir de ear parcial: [] 
performFileOperation: source=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext,
dest=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg, uri= META-INF/web.xml, op= add
Copiando arquivo de C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext/META-INF/web.xml para 
C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg\META-INF\web.xml
Lista de redução é: []
FileMergeTask concluído com êxito
ADMA5005I: Aplicativo singleFile configurado no repositório do WebSphere
delFiles: []
delM: null
addM: null
Padrão para remover loose e mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
arquivo raiz a ser copiado: META-INF/web.xml para 
C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear\deployments\singleFile/META-INF/web.xml
ADMA5005I: Aplicativo singleFile configurado no repositório xmlDoc do WebSphere: [#document: null]
root element: [app-delta: null]
****** nome do arquivo delta: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear/deltas/delta-1079548405564
ADMA5005I: Aplicativo singleFile configurado no repositório do WebSphere
ADMA6011I: Excluindo a árvore de diretórios C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0
ADMA5011I: Limpeza do diretório temp do aplicativo singleFile foi concluída.
A atualização de singleFile foi concluída.

Exemplos

  • Utilizando Jacl:
    [AIX Solaris HP-UX Linux Windows]
    $AdminApp update myApp file {-operation add -contents c:/apps/myApp/web.xml 
    -contenturi META-INF/web.xml}
    [z/OS]
    $AdminApp update myApp file {-operation add -contents /apps/myApp/web.xml 
    -contenturi META-INF/web.xml}
  • Utilizando Jython:
    [AIX Solaris HP-UX Linux Windows]
    print AdminApp.update('myApp', 'file', '[-operation add -contents c:/apps/myApp/web.xml 
    -contenturi META-INF/web.xml]')
    [z/OS]
    print AdminApp.update('myApp', 'file', '[-operation add -contents /apps/myApp/web.xml 
    -contenturi META-INF/web.xml]')
  • Utilizando a lista Jython:
    [AIX Solaris HP-UX Linux Windows]
    print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', 'c:/apps/myApp/web.xml',
     '-contenturi',  'META-INF/web.xml'])
    [z/OS]
    print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', '/apps/myApp/web.xml', 
    '-contenturi',  'META-INF/web.xml'])

updateAccessIDs

Utilize o comando updateAccessIDs para atualizar as informações de ID de acesso para usuários e grupos aos quais são designadas várias funções que são definidas no aplicativo. O sistema lê os IDs de acesso do registro do usuário e salva os IDs nas ligações de aplicativos. Essa operação melhora o desempenho do tempo de execução do aplicativo. Utilize esse comando depois de instalar um aplicativo ou depois de editar informações específicas da função de segurança para um aplicativo instalado. Esse método não pode ser chamado quando a opção -conntype da ferramenta wsadmin está configurada para NONE. Você deve estar conectado a um servidor para chamar esse comando.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo de interesse.
bALL
O parâmetro booleano bALL recupera e salva todos os IDs de acesso para usuários e grupos nas ligações de aplicativos. Especifique false para recuperar os IDs de acesso para usuários ou grupos que não possuem um ID de acesso nas ligações de aplicativos.

Exemplos

  • Usando Jacl ou true:
    $AdminApp updateAccessIDs myapp true
  • Usando Jacl para false:
    $AdminApp updateAccessIDs myapp false
  • Usando Jython para true:
    print AdminApp.updateAccessIDs('myapp', 1)
  • Usando Jython para false:
    print AdminApp.updateAccessIDs('myapp', 0)

updateInteractive

Utilize o comando updateInteractive para incluir, remover e atualizar subcomponentes de aplicativo ou um aplicativo inteiro. Ao atualizar um módulo de aplicativo ou um aplicativo inteiro utilizando o modo interativo, as etapas utilizadas para configurar as informações sobre ligação são semelhantes àquelas aplicadas ao comando installInteractive. Se você atualizar um arquivo ou um aplicativo parcial, as etapas utilizadas para configurar as informações sobre ligação não estarão disponíveis. Nesse caso, as etapas são as mesmas que as utilizadas com o comando update.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

nome do aplicativo
Especifica o nome do aplicativo a ser atualizado.
content type
Utilize o parâmetro content type para indicar se deseja atualizar parte do aplicativo ou o aplicativo inteiro. A lista a seguir inclui os valores válidos do tipo de conteúdo para o comando updateInteractive:
  • app - Indica que você deseja atualizar todo o aplicativo. Essa opção faz o mesmo que indicar a opção update com o comando install. Com o valor app como o tipo de conteúdo, você deve especificar a opção operation com update como valor. Forneça o novo arquivo archive corporativo (EAR) usando a opção de conteúdo. Você também pode especificar informações sobre ligação e opções do aplicativo. Por padrão, as informações sobre ligação para os módulos instalados são mescladas com as informações sobre ligação para os módulos atualizados. Para alterar esse comportamento padrão, especifique as opções update.ignore.old ou update.ignore.new.
  • file - Indica que você deseja atualizar um único arquivo. É possível incluir, remover ou atualizar arquivos individuais em qualquer escopo no aplicativo implementado. Com o valor file como o tipo de conteúdo, você deve executar operações no arquivo utilizando a opção operation. Dependendo do tipo de operação, opções adicionais são requeridas. Para inclusões e atualizações de arquivos, você deve fornecer o conteúdo do arquivo e o URI do arquivo relativo à raiz do arquivo EAR que está utilizando as opções contents e contenturi. Para exclusão do arquivo, você deve fornecer o URI do arquivo relativo à raiz do arquivo EAR, utilizando a opção contenturi que é a única entrada requerida. Qualquer outra opção fornecida é ignorada.
  • modulefile - Indica que você deseja atualizar um módulo. É possível incluir, remover ou atualizar um módulo de aplicativo individual. Se você especificar o valor modulefile como o tipo de conteúdo, você deve indicar a operação que deseja executar no módulo, utilizando a opção operation. Dependendo do tipo de operação, outras opções são requeridas. Para instalar novos módulos ou atualizar os módulos existentes de um aplicativo, você deve indicar o conteúdo do arquivo e o URI do arquivo relativo à raiz do arquivo EAR que está utilizando as opções contents e contenturi. Você também pode especificar informações sobre ligação e opções do aplicativo referentes aos módulos novos ou atualizados. Para atualizações do módulo, as informações sobre ligação do módulo instalado são mescladas com as informações sobre ligação do módulo de entrada por padrão. Para alterar o comportamento padrão, especifique as opções update.ignore.old ou update.ignore.new. Para excluir um módulo, indique o URI do arquivo relativo à raiz do arquivo EAR.
    Restrição: Geralmente, não é possível incluir ou atualizar um módulo se ele depender de outras classes fora do módulo, como classes dentro de um pacote ou de biblioteca opcional. O processamento do lado do cliente envolve a análise das classes de módulo de entrada e das classes que podem não serem carregadas com êxito, a menos que as dependências dessas classes sejam resolvidas. É possível incluir ou atualizar um módulo se você disponibilizar as classes necessárias em um sistema de arquivos que seja acessível através do script wsadmin. Através do script wsadmin, é possível modificar a propriedade com.ibm.ws.scripting.classpath no arquivo profile_root/properties/wsadmin.properties para incluir essas classes para que o carregador de classes possa resolvê-los.
  • partialapp - Indica que você deseja atualizar um aplicativo parcial. Ao usar um subconjunto de componentes de aplicativo fornecidos no formato de arquivo .zip compactado é possível atualizar, incluir e excluir arquivos e módulos. O arquivo compactado não é uma plataforma Java 2 válida, arquivo Enterprise Edition (J2EE). Em vez disso, ele contém artefatos de aplicativos na mesma estrutura hierárquica em que são exibidos em um arquivo EAR. Para obter informações adicionais sobre como construir o arquivo compactado de aplicação parcial, consulte a seção Java API. Se você indicar o valor partialapp como o tipo de conteúdo, use a opção de conteúdo para especificar o local do arquivo compactado. Quando um aplicativo parcial é fornecido como uma entrada de atualização, as informações sobre ligação e as opções do aplicativo não podem ser especificadas e são ignoradas se fornecidas.

Parâmetros Opcionais

options
Há muitas opções disponíveis para o comando updateInteractive. Para obter uma lista de cada opção válida para o comando updateInteractive, consulte Opções para os comandos AdminApp object install, installInteractive, edit, editInteractive, update e updateInteractive usando o script wsadmin.

Saída de amostra

Obtendo tarefas para: myApp
WASX7266I: Existe um arquivo was.policy para este aplicativo; gostaria de exibi-lo? [No]

Tarefa[4]: Ligando enterprise beans a nomes de JNDI
Cada enterprise bean não orientado a mensagens em seu aplicativo ou módulo deve ser ligado a um nome JNDI.
Módulo EJB:  Incrementar o módulo EJB
EJB: Incrementar
URI: Increment.jar,META-INF/ejb-jar.xml
Nome de JNDI: [Inc]:

Task[10]: Especificando a origem de dados padrão para 
módulos EJB 2.x
Especifique a origem de dados padrão para 
o Módulo EJB 2.x que contém beans CMP 2.x.

WASX7349I: O valor possível para autorização de recurso é contêiner ou por connection factory
Módulo EJB:  Incrementar o módulo EJB
URI: Increment.jar,META-INF/ejb-jar.xml
Nome de JNDI: [DefaultDatasource]:
Autorização de Recurso:  [Por connection factory]:

Tarefa[12]: Especificando origens de dados para beans CMP 2.x individuais
Especifique uma origem de dados opcional para cada bean CMP 2.x. O mapeamento de uma origem de dados específica para um bean CMP substitui a 
origem de dados padrão do módulo que contém o enterprise bean.

WASX7349I: O valor possível para autorização de recurso é contêiner ou por connection factory
Módulo EJB:  Incrementar o módulo EJB
EJB: Incrementar
URI: Increment.jar,META-INF/ejb-jar.xml
Nome de JNDI: [DefaultDatasource]:
Autorização de Recurso:  [Por connection factory]: contêiner
Definindo "Autorização do Recurso" para "cmpBinding.container"

Tarefa[14]: Selecionando Servidores de Aplicativos
Especifique o servidor de aplicativos em que deseja instalar os módulos contidos em seu aplicativo. 
Os módulos podem ser instalados no mesmo servidor ou dispersos entre diversos servidores.
Módulo:  Incrementar o módulo EJB
URI: Increment.jar,META-INF/ejb-jar.xml
Servidor: [WebSphere:cell=myCell,node=myNode,server=server1]:

Tarefa[16]: Selecionar proteções de método para métodos não protegidos para EJB 2.x
Especifique se deseja designar função de segurança para o método não protegido, incluir o método na lista de exclusões ou marcar 
o método como não verificado.
Módulo EJB:  Incrementar o módulo EJB
URI: Increment.jar,META-INF/ejb-jar.xml
Tipo de Proteção: [methodProtection.uncheck]:
Tarefa[18]: Selecionando ID de backend
Especifique a seleção para o BackendID
Módulo EJB:  Incrementar o módulo EJB
URI: Increment.jar,META-INF/ejb-jar.xml
Lista BackendId: CLOUDSCAPE_V50_1
CurrentBackendId: [CLOUDSCAPE_V50_1]:

Tarefa[21]: Especificando opções do aplicativo
Especifique as várias opções disponíveis para preparar e instalar seu aplicativo.
Pré-compilar JSP:  [No]:
Implementar EJBs:  [No]:
Implementar WebServices:  [No]:

Tarefa[22]: Especificando opções de implementação de EJB
Especifique as opções para implementar o EJB.
....A opção Implementar EJB não está ativada.

Tarefa[24]: Copiar arquivos WSDL
Copiar arquivos WSDL
....Essa tarefa não requer nenhuma entrada do usuário

Tarefa[25]: Especificar opções para implementação de serviços da Web
Especifique opções para implementação de serviços da Web
....A opção de implementação de serviços da Web não está ativada.
A atualização de myApp foi iniciada.

ADMA5009I: Archive de aplicativo extraído em C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969\ext/Increment.jar
FileMergeTask concluído com êxito
ADMA5005I: Aplicativo myApp configurado no repositório do WebSphere
delFiles: []
delM: null
addM: [Increment.jar, ]
Padrão para remover loose e mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
arquivo raiz a ser copiado: 
META-INF/application.xml para C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/META-INF/application.xml
excluir arquivos da inclusão/atualização de módulo completo: []
ADMA6017I: Documento salvo C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ejb-jar.xml
ADMA6016I: Incluir no espaço de trabalho Increment.jar/META-INF/ejb-jar.xml
ADMA6017I: Documento salvo C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/MANIFEST.MF
ADMA6016I: Incluir no espaço de trabalho Increment.jar/META-INF/MANIFEST.MF
ADMA6017I: Documento salvo C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-bnd.xmi
ADMA6016I: Incluir no espaço de trabalho Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi
ADMA6017I: Documento salvo C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/Table.ddl
ADMA6016I: Incluir no espaço de trabalho Increment.jar/META-INF/Table.ddl
ADMA6017I: Documento salvo C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-ext.xmi
ADMA6016I: Incluir no espaço de trabalho Increment.jar/META-INF/ibm-ejb-jar-ext.xmi
incluir arquivos para inclusão/atualização completa do módulo: [Increment.jar/META-INF/ejb-jar.xml, Increment.jar/META-INF/MANIFEST.MF, 
Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi, 
Increment.jar/META-INF/Table.ddl, Increment.jar/META-INF/ibm-ejb-jar-ext.xmi]
ADMA5005I: Aplicativo myApp configurado no repositório do WebSphere
xmlDoc: [#document: null]
root element: [app-delta: null]
****** nome do arquivo delta: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear/deltas/delta-1079551520393
ADMA5005I: Aplicativo myApp configurado no repositório do WebSphere
ADMA6011I: Excluindo a árvore de diretórios C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969
ADMA5011I: A limpeza do diretório temp do aplicativo myApp foi concluída.
A atualização de myApp foi finalizada.

Exemplos

  • Utilizando Jacl:
    [AIX Solaris HP-UX Linux Windows]
    $AdminApp updateInteractive myApp modulefile {-operation add -contents c:/apps/myApp/Increment.jar 
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment EJB module" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}
    [z/OS]
    $AdminApp updateInteractive myApp modulefile {-operation add -contents /apps/myApp/Increment.jar 
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment EJB module" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}
  • Utilizando Jython:
    [AIX Solaris HP-UX Linux Windows]
    print AdminApp.updateInteractive('myApp', 'modulefile', '[-operation add -contents c:/apps/myApp/Increment.jar 
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment EJB module" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]')
    [z/OS]
    print AdminApp.updateInteractive('myApp', 'modulefile', '[-operation add -contents /apps/myApp/Increment.jar 
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment EJB module" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]')
  • Utilizando a lista Jython:
    [AIX Solaris HP-UX Linux Windows]
    bindJndiForEJBValue = [["Increment EJB module", "Increment","Increment.jar,META-INF/ejb-jar.xml", "Inc"]]
    
    print AdminApp.updateInteractive('myApp', 'modulefile', ['-operation', 'add',
     '-contents', 'c:/apps/myApp/Increment.jar', '-contenturi', 'Increment.jar', '-nodeployejb',
     '-BindJndiForEJBNonMessageBinding', bindJndiForEJBValue])
    [z/OS]
    bindJndiForEJBValue = [["Increment EJB module", "Increment", "Increment.jar,META-INF/ejb-jar.xml", "Inc"]]
    
    print AdminApp.updateInteractive('myApp', 'modulefile', ['-operation', 'add',
     '-contents',  '/apps/myApp/Increment.jar', '-contenturi', 'Increment.jar', '-nodeployejb',
     '-BindJndiForEJBNonMessageBinding', bindJndiForEJBValue])

view

Utilize o comando view para visualizar a tarefa especificada pelo parâmetro task name do aplicativo ou módulo que é especificado pelo parâmetro application name. Utilize -tasknames como a opção para obter uma lista de nomes de tarefas válidos para o aplicativo. Caso contrário, especifique um ou mais nomes de tarefas como opção.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

name
Especifica o nome do aplicativo ou módulo a ser visualizado.

Parâmetros Opcionais

bALL
O parâmetro booleano bALL recupera e salva todos os IDs de acesso para usuários e grupos nas ligações de aplicativos. Especifique false para recuperar os IDs de acesso para usuários ou grupos que não possuem um ID de acesso nas ligações de aplicativos.
-buildVersion
Especifica se a versão de construção do aplicativo de interesse deve ser exibida.

Saída de amostra

O comando retornará as informações a seguir se você especificar o valor taskoptions para o parâmetro task name:
MapModulesToServers
MapWebModToVH
MapRolesToUsers
O comando retornará as informações a seguir se você especificar a tarefa mapModulesToServers para o parâmetro task name:
MapModulesToServers: Selecionando Servidores de Aplicativos

Especifique o servidor de aplicativos em que você deseja instalar os módulos que estão contidos no 
aplicativo. Os módulos podem ser instalados no mesmo servidor ou dispersos entre diversos servidores:   

Módulo:  adminconsole
URI:  adminconsole.war,WEB-INF/web.xml
Servidor:  WebSphere:cell=juniartiNetwork,
node=juniartiManager,server=dmgr

Exemplos

O seguinte exemplo de comando view lista cada nome de tarefa disponível:
  • Utilizando Jacl:
    $AdminApp view DefaultApplication {-tasknames}
  • Utilizando Jython:
    print AdminApp.view('DefaultApplication', ['-tasknames'])
O seguinte exemplo de comando view retorna informações para a tarefa mapModulesToServer:
  • Utilizando Jacl:
    $AdminApp view DefaultApplication {-MapModulesToServers}
  • Utilizando Jython:
    print AdminApp.view('DefaultApplication', ['-MapModulesToServers'])
O exemplo de comando view a seguir retorna informações para a tarefa AppDeploymentOptions:
  • Utilizando Jacl:
    $AdminApp view DefaultApplication {-AppDeploymentOptions}
  • Utilizando Jython:
    print AdminApp.view('DefaultApplication', '-AppDeploymentOptions')
O exemplo de comando view a seguir retorna a versão de construção do aplicativo DefaultApplication:
  • Utilizando Jacl:
    $AdminApp view DefaultApplication {-buildVersion}
  • Utilizando Jython:
    print AdminApp.view('DefaultApplication', '-buildVersion')

Í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_adminapp
Nome do arquivo: rxml_adminapp.html