Iniciando o Cliente de Script wsadmin Usando o Script wsadmin

Você pode usar a ferramenta wsadmin para configurar e administrar servidores de aplicativos, implementação de aplicativos e operações de tempo de execução do servidor.

Sobre Esta Tarefa

A ferramenta wsadmin fornece a capacidade de automatizar as tarefas de configuração para seu ambiente executando os scripts. Entretanto, há algumas limitações quanto ao uso da ferramenta wsadmin, incluindo:
  • A ferramenta wsadmin suporta apenas as linguagens de script Jython e Jacl.

    O release Versão 6.1 do WebSphere Application Server representava o início do processo de reprovação da sintaxe Jacl associada à ferramenta wsadmin. A sintaxe Jacl da ferramenta wsadmin permanece no produto e é suportada por pelo menos dois releases principais do produto. Após esse tempo, o suporte à linguagem Jacl pode ser removido da ferramenta wsadmin. A sintaxe Jython da ferramenta wsadmin é a direção estratégica para a automação administrativa do WebSphere Application Server. O servidor de aplicativos fornece funções administrativas significativamente aprimoradas e um conjunto de ferramentas que oferece suporte à automação do produto e ao uso da sintaxe Jython.

    Recurso Reprovado Recurso Reprovado: Jacl foi descontinuado e Jython é a linguagem de script padrão.depfeat
    Evitar Problemas Evitar Problemas: Nem todas as classes de componentes do WebSphere Application Server são empacotadas no mesmo arquivo .jar. Se você pretende usar a ferramenta wsadmin para executar scripts Jython, inclua a propriedade de sistema jython.package.path no comando wsadmin para assegurar-se de que todos os arquivos JAR necessários sejam configurados para o caminho do pacote jython durante a inicialização do wsadmin.
    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar"   

    Se desejar chamar as funções do WebSphere Application Server de diferentes classes do WebSphere Application Server que estão empacotadas nos arquivos .jar diferentes de runtime.jar e admin.jar, será possível incluir diversos arquivos jar no caminho especificado para a propriedade de sistema jython.package.path e separá-los com um ponto e vírgula (;).

    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar;com.ibm.ws.wccm.jar"  

    Se desejar chamar as funções WebSphere Application Server em um script jython usando ws_ant, é possível criar um arquivo de texto .prop, e incluir a seguinte linha nesse arquivo:

    jython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar  

    Em seguida, o arquivo de propriedades deverá ser incluído no arquivo xml de script Ant. Exemplo:

    <taskdef name="wsadmin" classname="com.ibm.websphere.ant.tasks.WsAdmin"/>
    <target name="main">  
        <wsadmin conntype="NONE" lang="jython" failonerror="true"
    properties="/tmp/jython.prop"
                 script="/home/fsgapp/MSTWasBuild/project/scripts/socr/socr/jython/configure.py"> 
        </wsadmin>
    </target>  
    gotcha
  • A ferramenta wsadmin gerencia as operações de instalação, configuração, implementação e tempo de execução para servidores de aplicativos, gerenciadores de implementação, agentes administrativos e gerenciadores de tarefa que executam a mesma versão ou uma versão superior do produto. A ferramenta wsadmin não pode se conectar a um servidor de aplicativos, gerenciador de implementação, agente administrativo ou gerenciador de tarefas que executa uma versão do produto anterior à versão da ferramenta wsadmin. Por exemplo, um cliente wsadmin Versão 7.x não pode se conectar a um servidor de aplicativos da Versão 6.x. No entanto, um cliente wsadmin Versão 6.x pode se conectar a um servidor de aplicativos da Versão 7.x. Essa limitação existe porque a nova funcionalidade foi incluída na ferramenta wsadmin em cada release do produto. Não é possível usar a nova funcionalidade de comando em servidores de aplicativo que executam versões de produto anteriores.
  • A ferramenta wsadmin opera no nível do nó do gerenciador de implementação em um ambiente de célula mista. Não execute a wsadmin no nível do nó do servidor de aplicativo para assegurar que toda a funcionalidade de comando esteja disponível.

[AIX Solaris HP-UX Linux Windows]O ativador wsadmin suporta diversos objetos de script, incluindo objetos AdminConfig, AdminControl, AdminApp, AdminTask e Help. Os scripts utilizam esses objetos para gerenciamento de aplicativos, configuração, controle operacional e para comunicação com MBeans que são executados em processos de produto. É necessário iniciar o cliente de script wsadmin antes de executar qualquer outra tarefa utilizando o script.

[z/OS]Antes de iniciar a ferramenta wsadmin com a segurança ativada, revise as considerações do tópico SSL para os administradores do WebSphere Application Server e o tópico Definindo a segurança SSL para clientes e servidores.

Em um ambiente de gerenciamento flexível, é possível conectar a ferramenta wsadmin a um servidor de aplicativos base, gerenciador de implementação, agente administrativo ou processo do gerenciador de tarefas. Se você não especificar a porta do servidor de aplicativos base ou o nome de perfil designado ao gerenciador de tarefas, a ferramenta wsadmin se conectará automaticamente ao agente administrativo.

Evitar Problemas Evitar Problemas: O design de gerenciamento de aplicativo não permite a instalação de um EAR ou módulo de nível de especificação EE, que é um nível superior do que o do cliente. O código do cliente executado no wsadmin lê o arquivo EAR e usa a introspecção do conteúdo para gerar as opções de configuração de implementação aplicáveis para esse aplicativo. O código do lado do cliente não pode processar um nível de especificação que é maior do que o que o cliente suporta. gotcha

Procedimento

  1. Localize o comando que inicia o cliente de script wsadmin.

    [z/OS]O comando para chamar um processo de script está localizado no diretório app_server_root/bin. Utilize o arquivo wsadmin.sh.

    [AIX Solaris HP-UX Linux Windows][IBM i]Escolha uma das seguintes opções:
    • Chame o processo de script utilizando um perfil específico. O comando QShell para chamar um processo de script está localizado no diretório profile_root/bin. O nome do script QShell é wsadmin. Se você usar esta opção, não será necessário especificar o parâmetro -profileName profile_name.
    • Chame o processo de script utilizando o perfil padrão. O comando wsadmin Qshell está localizado no diretório app_server_root/bin. Se não desejar conectar-se ao perfil padrão, você deverá especificar o parâmetro -profileName profile_name para indicar o perfil que deseja usar.
  2. Em um ambiente de gerenciamento flexível, determine se deve conectar-se a um servidor de aplicativos base, agente administrativo ou processo do gerenciador de tarefas.
    • Conecte-se ao processo do agente administrativo.
      Conecte a ferramenta wsadmin ao agente administrativo para configurar, gerenciar e administrar os servidores. Se você não especificar as opções de conexão, a ferramenta wsadmin se conectará automaticamente ao processo do agente administrativo. Utilize o seguinte comando para conectar-se ao agente administrativo:
      wsadmin -lang jython
    • Conecte-se a um processo do servidor de aplicativos base.
      Conecte a ferramenta wsadmin a um servidor de aplicativos base para gerenciar as configurações de um servidor específico de interesse. Utilize este tipo de conexão ao conectar-se a um nó que contenha um servidor e esteja registrado ao agente administrativo. Use um comando como o seguinte para conectar-se a um servidor de aplicativos base:
      wsadmin -conntype SOAP [-port 4213] -lang jython
    • Conecte-se ao processo do gerenciador de tarefas.
      Conecte a ferramenta wsadmin ao gerenciador de tarefas para enviar, monitorar e gerenciar as tarefas administrativas. Use um comando como o seguinte para conectar-se ao gerenciador de tarefa:
      wsadmin -profileName JobMgr01 -lang jython
  3. Revise as opções adicionais de conexão para a ferramenta wsadmin.
    É possível iniciar o cliente de script wsadmin de várias maneiras diferentes. Para especificar o método para executar scripts, execute uma das seguintes opções da ferramenta wsadmin:
    Execute os comandos de script de forma interativa

    Execute wsadmin com uma opção diferente de -f ou -c ou sem uma opção. A ferramenta wsadmin inicia e exibe um shell interativo com um prompt wsadmin. A partir do prompt do wsadmin, insira qualquer comando Jacl ou Jython. É possível também chamar os comandos utilizando os objetos AdminControl, AdminApp, AdminConfig, AdminTask ou Help do wsadmin. Para sair de uma sessão de script interativa, utilize os comandos quit ou exit. Esses comandos não aceitam nenhum argumento.

    Os exemplos a seguir ativam a ferramenta wsadmin:
    • Ative a ferramenta wsadmin utilizando Jython:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython
      [IBM i]
      wsadmin -lang jython
      [Windows]
      wsadmin.bat -lang jython
    • Ative a ferramenta wsadmin utilizando Jython quando a segurança estiver ativada:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -user user_name -password
      password
      [IBM i]
      wsadmin -lang jython -user user_name -password password
      [Windows]
      wsadmin.bat -lang jython -user user_name -password password
    • Ative a ferramenta wsadmin utilizando Jacl sem opções:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jacl
      [IBM i]
      wsadmin -lang jacl
      [Windows]
      wsadmin.bat -lang jacl
    Execute os comandos de script como comandos individuais

    Run a ferramenta wsadmin com a opção -c.

    [AIX][HP-UX][Linux][Solaris][z/OS]Se você chamar um comando que inclua um caractere símbolo de dólar ($) usando a opção wsadmin -c, a linha de comandos tentará substituir uma variável. Para evitar esse problema, use uma barra invertida em vez do caractere cifrão (\). Por exemplo: wsadmin -c "\$AdminApp install ...".

    Os seguintes exemplos executam os comandos individualmente:
    • Execute o comando list para o objeto AdminApp usando Jython:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -c 'AdminApp.list()'
      [IBM i]
      wsadmin -lang jython -c "AdminApp.list()"
      [Windows]
      wsadmin -lang jython -c "AdminApp.list()"
    • Execute o comando list para o objeto AdminApp usando Jacl:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -c "\$AdminApp list"
      ou
      wsadmin.sh -c '$AdminApp list'
      [IBM i]
      wsadmin -c "$AdminApp list"
      [Windows]
      wsadmin -c "$AdminApp list"
    Execute os comandos de script em um script

    Execute a ferramenta wsadmin com a opção -f e coloque os comandos que deseja executar no arquivo.

    [z/OS]O WebSphere Application Server para z/OS suporta codificação múltipla para os arquivos de comando Jacl e Jython. A codificação padrão para os arquivos de comandos é ASCII. Para executar um arquivo EBCDIC codificado, inclua o seguinte argumento da Java virtual machine (JVM) no arquivo wsadmin.sh por meio do sinalizador -javaoption:
    -Dscript.encoding=Cp1047
    Por exemplo:
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    Como alternativa, é possível possuir duas versões do arquivo wsadmin.sh, uma que referencie a versão ASCII do arquivo e outra que referencie a versão EBCDIC do arquivo. Por exemplo, copie o arquivo wsadmin.sh para o arquivo wsadminE.sh. Então, inclua -Dscript.encoding=Cp1047 no arquivo wsadminE.sh.
    Os seguintes exemplos executam scripts:
    • Execute o script a1.py usando Jython:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -f  al.py
      [IBM i]
      wsadmin -lang jython -f  al.py
      [Windows]
      wsadmin -lang jython -f  al.py

      em que o arquivo a1.py contém os comandos a seguir:

      apps = AdminApp.list()
      print apps
    Execute comandos de script em um script de perfil

    Um script de perfil é um script executado antes do script principal ou antes de entrar no modo interativo. É possível utilizar scripts de perfil para configurar um ambiente de script personalizado para o usuário ou a instalação.

    [z/OS]O WebSphere Application Server para z/OS suporta codificação múltipla para os scripts de perfil Jacl e Jython. A codificação padrão para o arquivo de perfil é ASCII. Para executar um arquivo de script de perfil codificado para EBCDIC, inclua o seguinte argumento JVM (Java virtual machine) no arquivo wsadmin.sh:
    -Dprofile.encoding=Cp1047
    Por exemplo:
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    Como alternativa, é possível possuir duas versões do arquivo wsadmin.sh, uma que referencie a versão ASCII do arquivo e outra que referencie a versão EBCDIC do arquivo. Por exemplo, copie o arquivo wsadmin.sh para o arquivo wsadminE.sh. Em seguida, inclua -Dprofile.encoding=Cp1047 no arquivo wsadminE.sh.
    Por padrão, os arquivos de script de perfil a seguir podem ser configurados para a propriedade de perfis com.ibm.ws.scripting.profiles no arquivo app_server_root/properties/wsadmin.properties:
    • app_server_root/bin/securityProcs.jacl
    • app_server_root/bin/LTPA_LDAPSecurityProcs.jacl

    Por padrão, esses arquivos estão em ASCII. Se você utilizar a opção profile.encoding para executar os scripts de arquivos de perfis codificados EBCDIC, altere a codificação dos arquivos para EBCDIC.

    Para executar comandos de script em um script de perfil, execute a ferramenta wsadmin com a opção -profile e inclua os comandos que deseja executar no script do perfil.

    Para personalizar o ambiente de script, especifique um ou mais scripts de perfil para execução.

    Não utilize parêntese nos nomes dos nós ao criar perfis.

    Os seguintes exemplos executam scripts de perfil:
    • Execute o script a1prof.py usando Jython:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -lang jython -profile alprof.py
      [IBM i]
      wsadmin -lang jython -profile alprof.py
      [Windows]
      wsadmin.bat -lang jython -profile alprof.py

      em que o arquivo a1prof.py contém os seguintes comandos:

      apps = AdminApp.list()
      print "Applications currently installed:\n " + apps
    • Execute o script a1prof.py usando Jacl:
      [AIX][HP-UX][Linux][Solaris][z/OS]
      wsadmin.sh -profile alprof.jacl
      [IBM i]
      wsadmin -profile alprof.jacl
      [Windows]
      wsadmin.bat -profile alprof.jacl

      em que o arquivo a1prof.py contém os seguintes comandos:

      set apps [$AdminApp list]
      puts "Applications currently installed:\n$apps"

Resultados

O wsadmin retorna a saída a seguir ao estabelecer uma conexão com o processo do servidor:

Saída de exemplo de Jython:
Aplicativos atualmente instalados:
 DefaultApplication
ivtApp
consultar
WASX70311: For help, enter: "print Help.help()"
wsadmin>
Saída de exemplo de Jacl:
Aplicativos atualmente instalados:
 DefaultApplication
ivtApp
consultar
WASX70311: For help, enter: "$Help help"
wsadmin>
[z/OS]Se você receber a mensagem:
[ Não é possível localizar um heap Java inicial de 268435456 bytes. ]
[ **Sem memória, interrompendo** ]
[ *** pânico: JVMST016: Não é possível alocar a memória para o heap Java inicial ]
CEE5207E O sinal SIGABRT foi recebido.
não foi possível iniciar o cliente de script wsadmin porque o tamanho da região no seu login não é grande o suficiente para alocar o tamanho mínimo de heap (-Xms ) que está especificado no Java Virtual Machine (JVM) que é criado quando o wsadmin é iniciado. O valor padrão para a opção -Xms, conforme especificado na instrução do arquivo wsadmin.sh file PERF_JVM_OPTIONS="-Xms256m -Xmx256m, é de 256 MB. Para corrigir esse problema, efetue logout do TSO e, em seguida, quando você efetuar login novamente no TSO, tente aumentar o valor do parâmetro Size em sua tela de login. Se não for possível aumentar o valor do parâmetro Size em sua tela de login, verifique se existe qualquer IEFUSI que impeça o aumento do valor desse parâmetro.

[z/OS]Se você estiver efetuando login pelo Telnet para OMVS, o valor usado para determinar o tamanho do espaço de endereço que seu login recebe será especificado no membro parmlib BPXPRMxx. O BPXPRMxx controla o ambiente completo do z/OS UNIX. Portanto, o valor configurado para o parâmetro MAXASSIZE determina o tamanho do espaço de endereço. No entanto, se você estiver usando RACF, o tamanho do endereço também poderá ser configurado para um usuário individual no segmento RACF OMVS respectivo. Nesta situação, o valor especificado para o parâmetro ASSIZEMAX indica, em bytes, o limite de tamanho do espaço de endereço para esse usuário. Por exemplo, uma configuração do ASSIZEMAX=0268435456 indica que o espaço de endereço alocado para esse usuário é de 256 MB.


Ícone que indica o tipo de tópico Tópico de Tarefa



Í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=txml_launchscript
Nome do arquivo: txml_launchscript.html