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: Jacl foi descontinuado e
Jython é a linguagem de script padrão.
depfeat
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.
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.
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: 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
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]](../images/ngzos.gif)
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.
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.