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 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 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 utilizar a nova funcionalidade de comando em
servidores de aplicativo que executam versões de produto anteriores.
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.
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>