Ferramenta de Script wsadmin
A ferramenta wsadmin executa scripts. Você pode utilizar a ferramenta wsadmin para gerenciar servidores de aplicativos assim como a configuração, a implementação do aplicativo e as operações de tempo de execução do servidor.
Você pode executar comandos wsadmin a partir do WebSphere Application Server em uma plataforma distribuída e utilizar esse comando distribuído para administrar o WebSphere Application Server em um sistema operacional z/OS.
Utilizar perfis específicos para autoridades de usuário distintas.
Utilize uma instalação separada para autoridades de usuário distintas.
- O mesmo usuário deve executar todos os comandos em um perfil.
- Certifique-se de que todos os usuários de um perfil específico pertencem ao mesmo grupo. Além disso, certifique-se de que cada usuário de um grupo tenha autoridade de leitura e gravação para os arquivos criados por outros membros no mesmo perfil.

- Você deve inserir os comandos wsadmin no shell interativo wsadmin em uma linha. Ou seja, digite o comando continuamente e não divida o comando em diversas linhas. A divisão de um comando wsadmin longo em diversas linhas não é suportada. A tentativa de executar comandos wsadmin que estão divididos em diversas linhas na shell interativa resulta em um erro de sintaxe.
- A ferramenta wsadmin remove todo espaço em branco à esquerda e à direita incluindo \n, \r, \t, \f e o espaço ao analisar uma sequência para evitar erros do usuário. Por exemplo, alguém pode pressionar acidentalmente a tecla barra de espaço ou a tecla Tab e incluir algum espaço em branco na sequência de comando. Este espaço em branco pode fazer com que o comando ou o script falhe. Se for necessário incluir espaço em branco em um comando, use a sintaxe de lista em vez da sintaxe de sequência ou coloque a sequência que contém o espaço em branco entre [ ] (colchetes).
Utilize a seguinte sintaxe de chamada de linha de comandos para o cliente de script wsadmin:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
wsadmin [-h(help)]
![[z/OS]](../images/ngzos.gif)
wsadmin.sh [-h(help)]
[-?]
[-c comando]
[-p nome_do_arquivo_de_propriedades]
[-profile nome_do_script_de_perfis]
[-profileName nome_do_perfil]
[-f nome_do_arquivo_de_script]
[-javaoption opção_java]
[-lang idioma
[-wsadmin_classpath caminho de classe]
[-conntype SOAP [-host host_name] [-port port_number] [-user userid] [-password password]
[-conntype RMI [-host host_name] [-port port_number] [-user userid] [-password password]
[-conntype JSR160RMI [-host host_name] [-port port_number] [-user userid] [-password password]
[-conntype IPC [-ipchost host_name] [-port port_number] [-user userid] [-password password]
[-jobid jobid_string]
[-tracefile trace_file]
[-appendtrace true/false]
[script parameters]
O elemento script parameters representa qualquer elemento diferente dos anteriormente listados. A variável argc contém o número de argumentos, e a variável argv contém uma lista de argumentos na ordem em que eles forma codificados.
Opções
- -c
- Especifica para executar um comando simples. A opção -c deve ser seguida por um comando. Várias opções -c podem existir na
linha de comandos. Elas são executadas na ordem designada.
Se você chamar a ferramenta wsadmin com a opção -c, todas as mudanças que você fez na configuração são então salvas automaticamente. Se você fizer alterações na configuração e não estiver usando a opção -c, deverá usar o comando save do objeto AdminConfig para salvar as alterações. Leia sobre como salvar alterações na configuração com a ferramenta wsadmin para mais informações.
- -Dwsadmin.script.libraries=dir1;dir2;...
- Especifica o caminho da procura para scripts Jython que utilizam pacotes. dir1 e dir2 representam os caminhos de procura de diretório para bibliotecas contendo os pacotes Jython.
- -f
- Especifica um script para executar. A opção -f deve ser seguida por um nome do arquivo.
Somente uma opção -f pode existir na linha de comandos.
Você pode usar a opção -f para executar scripts que contêm scripts Jython aninhados. No seguinte exemplo, o script test2 importa o script test1:#test1.py def listServer(): print AdminConfig.list("Server")
#test2.py import test1 test1.listServer()
Para executar o script responsável pela chamada, execute o comando a seguir a partir do diretório app_server_root/bin:wsadmin -lang jython -f test2.py
Depois que os scripts forem executados, o sistema retornará a seguinte saída do comando de amostra:server1(cells/myCell/nodes/myNode/servers/myServer|server.xml#Server_1183122130078)
- -javaoption
- Especifica uma opção Java padrão ou fora do padrão válida. Várias opções -javaoption
podem existir na linha de comandos.
wsadmin -javaoption java_option -javaoption java_option
wsadmin.sh -javaoption java_option -javaoption java_option
Para encurtar o comprimento do comando, é possível digitá-lo da seguinte maneira:
wsadmin -javaoption "java_option java_option"
wsadmin.sh -javaoption "java_option java_option"
transição: Você não pode utilizar o comando abreviado wsadmin -javaoption "java_option java_option". Você deve utilizar o formato wsadmin.sh -javaoption java_option -javaoption java_option mais longo. Diferentemente das versões anteriores, o produto da Versão 8 não suporta diversas opções Java juntas em uma opção -javaoption em sistemas operacionais Windows.
Nos sistemas operacionais Windows, se a opção contiver um sinal de igual (=) ou ponto-e-vírgula (;), você deve colocar a opção entre aspas duplas (") como, por exemplo:
Os sistemas operacionais Windows tratam o sinal de igual (=) ou o ponto-e-vírgula (;) em argumentos de linha de comandos como um espaço em branco. A ferramenta wsadmin exige que os argumentos que tenham um espaço em branco sejam colocados entre aspas duplas.wsadmin -javaoption "-Da.b.c=3"
Para Usuários de Transição: Para o WebSphere Application Server Versão 8.5, o %javaoption% no wsadmin.bat e o $javaOption no wsadmin.sh estão localizados no final dos argumentos JAVA_EXE. Isso permite substituir as propriedades de sistema Java, como por exemplo, as propriedades CLIENTSOAP e CLIENTSAS.trns
- -lang
- Especifica a linguagem do arquivo de script, do comando ou de um shell
interativo. As linguagens possíveis incluem: Jacl e Jython.
Essas opções de linguagens são expressas como jacl e jython.
Essa opção substitui as determinações de linguagem com base no nome de um arquivo de script, no nome de um arquivo de script de perfil ou na propriedade com.ibm.ws.scripting.defaultLang. O argumento -lang não tem nenhum valor padrão. Se o idioma especificado no argumento -lang não corresponder ao idioma determinado no argumento -f script_file_name, a ferramenta wsadmin determinará o idioma com base no nome do arquivo script.
Se você não especificar o argumento -lang, mas tiver o argumento -f script_file_name especificado, a ferramenta wsadmin determinará a linguagem com base no nome do arquivo de script de destino. Se você não especificar o argumento -lang e o argumento -f, a ferramenta wsadmin determinará a linguagem com base no nome de um arquivo de script de perfil se o argumento -profile profile_script_name for especificado. Se a linha de comandos ou a propriedade não fornecer a linguagem de script e a ferramenta wsadmin não puder determiná-la, uma mensagem de erro será gerada.
- -p
- Especifica um arquivo de propriedades. A opção -p deve ser seguida por um nome de arquivo.O arquivo listado depois de -p representa um arquivo de propriedades Java que o processo de script lê. Três níveis de arquivos de propriedades padrão são carregados antes do arquivo de propriedades que você especificou na linha de comandos:
- O primeiro nível é o padrão da instalação, wsadmin.properties, que está localizado no diretório de propriedades do produto.
- O segundo nível é o padrão do usuário, wsadmin.properties, que está localizado em seu diretório inicial.
- O terceiro nível é o arquivo de propriedades ao qual a variável de ambiente WSADMIN_PROPERTIES se refere.
Várias opções -p podem existir na linha de comandos. Essas opções chamam a ordem na qual você as fornece.
Também é possível usar a propriedade customizada com.ibm.ws.scripting.noechoParamNo com esta opção. Utilize essa propriedade customizada para especificar parâmetros de script que você não deseja que sejam exibidos em um arquivo de rastreio ou uma saída padrão. Para ativar esta propriedade customizada, crie um arquivo de texto, como noecho.prop. Nesse arquivo de texto, especifique as posições dentro de seu comando wsadmin que contêm dados sensíveis, como senhas, que você não deseja que sejam exibidos em um arquivo de rastreio ou uma saída padrão. O arquivo de texto pode conter um único número ou vários números de parâmetros que são separados por uma vírgula. Por exemplo, o arquivo de texto pode conter as seguintes informações:
Quando você referencia esse arquivo de texto em seu comando wsadmin, o terceiro e o quinto valores de parâmetro não são exibidos em um arquivo de rastreio ou uma saída padrão. Para usar a propriedade customizada, execute o comando wsadmin e transmita o arquivo de texto com a opção -p. Exemplo:com.ibm.ws.scripting.noechoParamNo=3,5
Utilizando Jacl:wsadmin -f script_file script_arguments -p text_file
Utilizando Jython:wsadmin -lang jython -f script_file script_arguments -p text_file
Exemplo:
wsadmin -f text.py server1 dbuser dbpassword user1 userpassword -p noecho.prop
wsadmin -f c:/text.py server1 dbuser dbpassword user1 userpassword -p c:/noecho.prop
wsadmin.sh -f text.py server1 dbuser dbpassword user1 userpassword -p noecho.prop
dbpassword e userpassword são o terceiro e o quinto parâmetros que não são exibidos em um arquivo de rastreio ou uma saída padrão.
- -profile
- Especifica um script de perfil.
O script de perfil é executado antes de outros comandos ou scripts. Se você especifica -c, o script de perfil é executado antes de o comando ser chamado. Se você especifica -f, o script de perfil é executado antes de o script ser executado. No modo interativo, você pode utilizar o script do perfil para realizar qualquer inicialização padrão que desejar. Você pode especificar diversas opções -profile na linha de comandos e elas são chamadas na ordem que forem especificadas.
- -profileName
- Especifica o perfil do qual a ferramenta wsadmin é executada. Especifique essa opção se um dos motivos a seguir se aplicar:
- Você executa a ferramenta wsadmin a partir do diretório app_server_root/bin, e não ter um perfil padrão, ou deseja executar em um perfil diferente do perfil padrão.
- Você está no momento em um diretório bin do perfil mas deseja
executar a ferramenta wsadmin a partir de um perfil a diferente.
Importante: O WebSphere Application Server executando em sistemas operacionais z/OS não suporta perfis criados pelo usuário (apenas o perfil padrão é utilizado).
- -?
- Fornece ajuda da sintaxe.
- -help
- Fornece ajuda da sintaxe.
- -conntype
- Especifica o tipo de conexão a ser utilizada.
Esse argumento consiste em uma cadeia que determina o tipo, por exemplo, SOAP, e as opções específicas para o tipo de conexão. Os tipos possíveis incluem: SOAP, RMI, JSR160RMI, IPC e NONE. Para cada tipo de conexão, você pode especificar atributos adicionais sobre a conexão.
Para o tipo de conexão SOAP, você pode especificar os seguintes atributos:Tabela 1. Descrições do Atributo de Tipo de Conexão -conntype SOAP. Use esse atributo para especificar um tipo de conexão SOAP. Atributo Descrição [-host host_name] Especifica o nome do host para a conexão. O padrão é o host local. [-port port_number] Especifica o número da porta para a conexão. [-user userid] Especifica o ID do usuário para estabelecer a conexão. [-password password] Especifica a senha para usar para estabelecer a conexão. Para o tipo de conexão RMI, você pode especificar os seguintes atributos:Tabela 2. Descrições do Atributo de Tipo de Conexão -conntype RMI. Use esse atributo para especificar um tipo de conexão RMI. Atributo Descrição [-host host_name] Especifica o nome do host para a conexão. O padrão é o host local. [-port port_number] Especifica o número da porta para a conexão. [-user userid] Especifica o ID do usuário para estabelecer a conexão. [-password password] Especifica a senha para usar para estabelecer a conexão. Para o tipo de conexão JSR160RMI, você pode especificar os seguintes atributos:Tabela 3. Descrições do Atributo de Tipo de Conexão -conntype JSR160RMI. Use esse atributo para especificar um tipo de conexão JSR160RMI. Atributo Descrição [-host host_name] Especifica o nome do host para a conexão. [-port port_number] Especifica o número da porta para a conexão. [-user userid] Especifica o ID do usuário para estabelecer a conexão. [-password password] Especifica a senha para usar para estabelecer a conexão. Para o tipo de conexão IPC, você pode especificar os seguintes atributos:Tabela 4. Descrições do Atributo de Tipo de Conexão -conntype IPC. Use esse atributo para especificar um tipo de conexão IPC. Atributo Descrição [-ipchost host_name] Especifica o nome do host para a conexão. Este atributo substitui o nome do host especificado para a propriedade com.ibm.ws.scripting.ipchost no arquivo de propriedades wsadmin.properties. [-port port_number] Especifica o número da porta para a conexão. [-user userid] Especifica o ID do usuário para estabelecer a conexão. [-password password] Especifica a senha para usar para estabelecer a conexão. Use a opção -conntype NONE para executar em um modo local. O resultado é que o cliente de script não está conectado a um servidor em execução. Você pode gerenciar a configuração do servidor, a instalação e a desinstalação dos aplicativos sem o servidor de aplicativos estar sendo executado.
Nota: Você deverá, eventualmente, alternar do conector RMI (Remote Method Invocation) para o conector JSR160RMI, pois o suporte para o conector RMI é reprovado. - -wsadmin_classpath
- Utilize essa opção para disponibilizar classes adicionais para o processo de script.
Use a seguinte opção com uma cadeia do caminho de classe:
/MyDir/Myjar.jar;/yourdir/yourdir.jar
/home/MyDir/Myjar.jar;/yourdir/yourdir.jar
c:/MyDir/Myjar.jar;d:/yourdir/yourdir.jar
O caminho da classe é, então, adicionado ao carregador de classes para o processo de script.
Você também pode especificar essa opção em um arquivo de propriedades que é utilizado pela ferramenta wsadmin. A propriedade é com.ibm.ws.scripting.classpath. Se você especificar -wsadmin_classpath na linha de comandos, o valor dessa propriedade substituirá qualquer valor especificado em um arquivo de propriedades. A propriedade class path e as opções da linha de comandos não são concatenadas.
- -host
- Especifique um nome de host ao qual wsadmin tenta se conectar. O arquivo wsadmin.properties padrão, localizado no diretório de propriedades de cada perfil, fornece localhost como o valor de propriedade do host, se essa opção não for especificada.
- -password
- Especifique uma senha a ser usada pelo conector para se conectar ao servidor, se a segurança estiver ativada no servidor.Atenção: Em sistemas UNIX, o uso da opção -password pode resultar em exposição de segurança porque as informações de senha são exibidas no programa de status do sistema. Por exemplo, essas informações podem ser expostas quando você utilizar o comando ps, que pode ser chamado por outro usuário para exibir todos os processos em execução. Não utilize essa opção, se a exposição da segurança for um problema. Para evitar tal exposição, você pode:
- Especifique as informações de usuário e senha no arquivo soap.client.props para o conector SOAP, no arquivo sas.client.props para o conector JSR160RMI ou o conector RMI (Remote Method Invocation), ou no arquivo ipc.client.props para o conector IPC (Inter-Process Communications). Os arquivos soap.client.props, sas.client.props e ipc.client.props estão localizados no diretório de propriedades do seu perfil do servidor de aplicativos.
- Aguarde até que a ferramenta wsadmin solicite ao usuário as informações de login em vez de fornecer as informações de login dentro de um arquivo de propriedades.
- -user ou -username
- Especifica um nome de usuário a ser usado pelo conector para se conectar ao servidor, se a segurança estiver ativada no servidor.
- -port
- Especifica uma porta a ser usada pelo conector. O arquivo wsadmin.properties padrão, localizado no diretório de propriedades de cada perfil do servidor de aplicativos, fornece um valor na propriedade de porta para se conectar ao servidor local.
- -jobid
- Especifica uma sequência de ID da tarefa para que você possa manter o controle de cada chamada da ferramenta wsadmin para propósitos de auditoria. A sequência de ID da tarefa (jobID=xxxx) é exibida no início do arquivo de log do wsadmin.
- -tracefile
- Especifica o nome do arquivo de log e o local em que a saída do registro está direcionada. Essa opção substitui a propriedade com.ibm.ws.scripting.traceFile no arquivo wsadmin.properties.
- -appendtrace
- Determina se um rastreio será anexado ou se substituirá o final do arquivo de registro
existente. Especifique true para anexar o rastreio ao final de um arquivo de log
ou especificar false para substituir o arquivo de log para cada chamada de wsadmin. O valor padrão é false.
O exemplo a seguir especifica a opção de ID da tarefa, o local do log e anexa o rastreio ao arquivo de log.
wsadmin -jobid wsadmin_test_1 -tracefile /temp/wsadmin_test_1.log -appendtrace true
wsadmin -jobid wsadmin_test_1 -tracefile c:/temp/wsadmin_test_1.log -appendtrace true
wsadmin.sh -jobid wsadmin_test_1 -tracefile /temp/wsadmin_test_1.log -appendtrace true
Nos seguintes exemplos de sintaxe, mymachine é o nome do host no arquivo wsadmin.properties que é especificado pela propriedade com.ibm.ws.scripting.port:
- Conexão SOAP com o host local
- Utilize as opções definidas no arquivo wsadmin.properties.
- Conexão SOAP com o host mymachine
- Usando Jacl, digite o seguinte código de exemplo:
wsadmin -f test1.jacl -profile setup.jacl -conntype SOAP -port mymachine_soap_portnumber -host mymachine
wsadmin.sh -f test1.jacl -profile setup.jacl -conntype SOAP -port mymachine_soap_portnumber -host mymachine
Utilizando Jython:
wsadmin -lang jython -f test1.py -profile setup.py -conntype SOAP -port mymachine_soap_portnumber -host mymachine
wsadmin.sh -lang jython -f test1.py -profile setup.py -conntype SOAP -port mymachine_soap_portnumber -host mymachine
- Altere o tamanho de heap Java inicial e máximo
Utilizando Jacl:
wsadmin -javaoption -Xms128m -javaoption -Xmx256m -f test.jacl
Especifique múltiplas opções Java juntas ou separadamente:
ouwsadmin -javaoption "-Xms128m -Xmx256m" -f test.jacl
wsadmin -javaoption -Xms128m -javaoption -Xmx256m -f test.jacl
wsadmin.sh -javaoption "-Xms128m -Xmx256m" -f test.jacl
Utilizando Jython:
wsadmin -lang jython -javaoption -Xms128m -javaoption -Xmx256m -f test.py
Especifique múltiplas opções Java juntas ou separadamente:
ouwsadmin -lang jython -javaoption "-Xms128m -Xmx256m" -f test.py
wsadmin -lang jython -javaoption -Xms128m -javaoption -Xmx256m -f test.py
wsadmin.sh -lang jython -javaoption "-Xms128m -Xmx256m" -f test.py
- Altere o valor da propriedade de sistema
- Utilizando Jacl:
wsadmin -javaoption "-Dcom.ibm.websphere.management.application.client.jspReloadEnabled=true"
wsadmin.sh -javaoption "-Dcom.ibm.websphere.management.application.client.jspReloadEnabled=true"
Utilizando Jython:
wsadmin -lang jython -javaoption "-Dcom.ibm.websphere.management.application.client.jspReloadEnabled=true"
wsadmin.sh -lang jython -javaoption "-Dcom.ibm.websphere.management.application.client.jspReloadEnabled=true"
Coloque a propriedade de sistema Java entre aspas duplas ("").
Coloque as opções Java entre aspas duplas (""), como por exemplo:
wsadmin -javaoption "-Dcom.ibm.websphere.management.application.client.jspReloadEnabled=true -Dcom.ibm.websphere.management.application.enableDistribution=true"
- Conexão JSR160RMI com segurança
- Utilizando Jacl:
wsadmin -conntype JSR160RMI -port JSR160rmiportnumber -user userid -password password
wsadmin.sh -conntype JSR160RMI -port JSR160rmiportnumber -user userid -password password
Utilizando Jython:
wsadmin -lang jython -conntype JSR160RMI -port JSR160portnumber -user userid -password password
wsadmin.sh -lang jython -conntype JSR160 -port JSR160rmiportnumber -user userid -password password
O elemento, rmiportnumber, para sua conexão é exibido no console administrativo como BOOTSTRAP_ADDRESS.
Atenção: Em subsistemas UNIX, o uso da opção -password pode resultar na exposição da segurança, pois as informações de senha tornam-se visíveis ao programa de status do sistema, como o comando ps, que pode ser chamado por outro usuário para exibir todos os processos em execução. Não utilize essa opção, se a exposição da segurança for um problema. Para evitar tal exposição, você pode:- Especifique as informações de usuário e senha no arquivo soap.client.props para o conector SOAP, no arquivo sas.client.props para o conector JSR160RMI ou o conector RMI (Remote Method Invocation), ou no arquivo ipc.client.props para o conector IPC (Inter-Process Communications). Os arquivos soap.client.props, sas.client.props e ipc.client.props estão localizados no diretório de propriedades do seu perfil do servidor de aplicativos.
- Aguarde até que a ferramenta wsadmin solicite ao usuário as informações de login em vez de fornecer as informações de login dentro de um arquivo de propriedades.
- Conexão RMI com segurança
- Utilizando Jacl:
wsadmin -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -conntype RMI -port rmiportnumber -user userid -password password
Utilizando Jython:
wsadmin -lang jython -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -lang jython -conntype RMI -port rmiportnumber -user userid -password password
O elemento, rmiportnumber, para sua conexão é exibido no console administrativo como BOOTSTRAP_ADDRESS.
Atenção: Em subsistemas UNIX, o uso da opção -password pode resultar na exposição da segurança, pois as informações de senha tornam-se visíveis ao programa de status do sistema, como o comando ps, que pode ser chamado por outro usuário para exibir todos os processos em execução. Não utilize essa opção, se a exposição da segurança for um problema. Para evitar tal exposição, você pode:- Especifique as informações de usuário e senha no arquivo soap.client.props para o conector SOAP, no arquivo sas.client.props para o conector JSR160RMI ou o conector RMI (Remote Method Invocation), ou no arquivo ipc.client.props para o conector IPC (Inter-Process Communications). Os arquivos soap.client.props, sas.client.props e ipc.client.props estão localizados no diretório de propriedades do seu perfil do servidor de aplicativos.
- Aguarde até que a ferramenta wsadmin solicite ao usuário as informações de login em vez de fornecer as informações de login dentro de um arquivo de propriedades.
- Modo local de operação para executar um único comando
- Utilizando Jacl:
wsadmin -conntype NONE -c "$AdminApp uninstall app"
ouwsadmin.sh -conntype NONE -c "\$AdminApp uninstall app"
wsadmin.sh -conntype NONE -c '$AdminApp uninstall app'
Utilizando Jython:
wsadmin -lang jython -conntype NONE -c "AdminApp.uninstall('app')"
ouwsadmin.sh -lang jython -conntype NONE -c "\AdminApp.uninstall('app')"
wsadmin.sh -lang jython -conntype NONE -c 'AdminApp.uninstall('app')'