A ferramenta de Script do Weblogic (do Inglês WebLogic Scripting Tool -WLST) é uma interface baseada em linha de comando (não tem interface gráfica) que os administradores e operadores podem utilizar para monitorar e gerenciar os servidores (JMV) em seus domínios. Ele é baseado em um interpretador de scripts Java (Jython).
Através do WLST é possível construir vários scripts que irão servir para automatizar muitas funcionalidades de forma simples e prática. Ele está disponível para execução através do seguinte comando:
Linux
WLS_HOME/ wlserver_12.1/common/bin/wlst.sh
Windows
WLS_HOME\ wlserver_12.1\common\bin\wlst.cmd
Execute o comando acima. Então o script irá inicializar e, quando terminar, irá mostrar as seguintes mensagens:
Initializing WebLogic Scripting Tool (WLST) ...
Jython scans all the jar files it can find at first startup. Depending on the system, this process may take a few minutes to complete, and WLST may not return a prompt right away.
Welcome to WebLogic Server Administration Scripting Shell
Type help() for help on available commands
wls:/offline>
Com este comando foi acessamos o console do WLST que, por padrão, entra em modo “off line”. Neste modo podemos:
· Criar ou estender um domínio;
· Alterar configurações persistidas (são aquelas que estão na pasta “config”, conforme visto em “Estrutura de diretórios de um Domínio”);
· Verificar todas as configurações existentes;
Para um exemplo do que é possível realizar, digite o comando “help()”:
wls:/offline> help()
WLST is a command line scripting tool to configure and administer WebLogic Server. Try:
help('all') List all WLST commands available.
help('browse') List commands for browsing the hierarchy.
help('common') List the most commonly used commands.
help('control') List commands for controlling the domain/server.
help('deployment') List commands for deploying applications.
help('diagnostics') List commands for performing diagnostics.
help('editing') List commands for editing the configuration.
help('information') List commands for displaying information.
help('lifecycle') List commands for managing life cycle.
help('nodemanager') List commands for using Node Manager.
help('offline') List all offline commands available.
help('online') List all online commands available.
help('storeadmin') List all store admin commands.
help('trees') List commands use to navigate MBean hierarchy.
help('variables') List all global variables available.
* Para executar o console do WLST não é necessário que o AdminServer esteja em execução.
O real poder do WLST é obtido através do modo online, onde podemos controlar tudo que existe no Weblogic, desde configurações, parar e iniciar qualquer recurso, alterar parâmetros em tempo de execução e, principalmente, executar scripts que irão automatizar as mais variadas atividades.
Para iniciar uma sessão online do WLST utilize o comando “connect()”. Com ele podemos efetuar a conexão para um “AdminServer” ou Gerenciador de Nó (NodeManager). Certifique-se de que o “AdminServer” esteja em execução, caso contrário faça isto seguindo o que foi explicado em “Iniciando o console administrativo (Admin Server)”. Agora basta digitar o comando:
wls:/offline> connect()
Feito isto será requisitado o usuário de conexão, utilize o mesmo do “AdminServer”:
Please enter your username :weblogic
Agora sera requisitado uma senha, que é a mesma do “AdminServer”, no entanto ela não será exibida:
Please enter your password :
Digite o endereço do servidor que é composto por um hostname ou IP mais a porta, o comando “connect()” irá exibir o caminho padrão entre chaves, neste caso apenas tecle enter:
Please enter your server URL [t3://localhost:7001] :
Feito isto o WLST irá se conectar ao “AdminServer”, mostrará as seguintes mensagens:
Connecting to t3://localhost:7001 with userid weblogic ...
Successfully connected to Admin Server 'AdminServer' that belongs to domain 'base_domain'.
Warning: An insecure protocol was used to connect to the
server. To ensure on-the-wire security, the SSL port or
Admin port should be used instead.
wls:/base_domain/serverConfig>
Veja que, ao final irá mostrar o nome do domínio e a pasta de configuração, indicando que conseguiu efetuar a conexão com sucesso. Que agora será possível executar quaisquer comandos necessários:
wls:/base_domain/serverConfig>
O objetivo deste manual é mostrar que o recurso WLST existe no Weblogic e que tem um poder muito grande na administração de ambientes simples ou complexos. Pois seria necessário um livro exclusivo de WLST para mostrar todo o seu potencial. Será apresentado alguns comandos, para mostrar algumas das possiblidades que este ambiente permite.
Como já estamos conectados ao “AdminSErver”, é possível navegar em uma estrutura semelhante ao de diretórios e arquivos que contém todas as configurações do seu domínio. Veremos a seguir alguns comandos básicos:
· ls(): mostra o conteúdo do diretório atual;
· pwd(): mostra o diretório atual;
· cd(“diretório”): muda de diretório atual para outro, conforme desejado;
· edit(): muda para a árvore de edição, onde será possível alterar qualquer configuração;
· startEdit ativa o modo de edição, semelhante ao botão “Bloquear e Editar”;
· save(): salva todas as configurações feitas, mas não ativa, ou seja não terão validade até que sejam ativadas;
· activate():ativa as alterações, semelhante ao botão “Ativar Alterações”, caso não tenha sido salvas, salvará automaticamente;
· undo(): desfaz todas as configurações realizadas antes da ativação;
· execfile(“nome do arquivo”): executa um arquivo contento um script simples, com um único comando, até um que seja bem complexo, com dezenas de linhas. Geralmente estes arquivos (scipts) tem a extensão “.py”;
· exit(): sai da console WLST.
O Weblogic permite gravar, em forma de script, todas as operações realizadas no console administrativo. Para isto basta:
· Clicar no botão “Bloquear e Editar”;
· No lado direito da tela, clique em “Registro”:
Figura (clique para ampliar)
Todos os comandos dados no console serão gravados no arquivo:
C:\Oracle\product\Middleware\user_projects\domains\base_domain\Script1355002874441.py
Este arquivo pode ser utilizado como aprendizado, estudando os comandos que foram gravados. Pode ser alterados e executados. Para isto podemos realizar a execução de duas formas:
1. Através do console, utilizado o comando:
execfile(“Script1355002874441.py.”)
2. Através da execução direta:
wslt.sh Script1355002874441.py
Caso haja dúvidas sobre algum comando, basta utilizar o comando “help()”, passando com parâmetro o comando no qual se deseja ajuda. Gostaria de saber mais sobre o comando “edit()”:
wls:/base_domain/edit !> help("edit")
Description:
Navigates to the last MBean to which you navigated in the edit Configuration MBean hierarchy or to the root of the hierarchy, DomainMBean. This writeable hierarchy stores all of the configuration MBeans that represent your current domain.
Note that to edit configuration beans, you must be connected to an Administration Server. If you connect to a Managed Server, WLST functionality is limited to browsing the configuration bean hierarchy. While you cannot use WLST to change the values of MBeans on Managed ecommends that you change only the values of Configuration . Oracle MBeans on the Administration Server. Changing the values of MBeans on Managed Servers can lead to an inconsistent domain configuration.
In the event of an error, the command returns a WLSTException.
For more information about editing configuration beans, see "Editing Configuration MBeans" in "WebLogic Scripting Tool" at http://www.oracle.com/technology/products/weblogic/index.html.
Syntax:
edit()
Example:
wls:/myserver/serverConfig> edit()
Location changed to edit tree. This is a writeable tree with DomainMBean as the root.
For more help, use help('edit')
wls:/myserver/edit !>
wls:/myserver/edit !> ls()
dr-- AppDeployments
dr-- BridgeDestinations
dr-- Clusters
dr-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
...
wls:/myserver/edit !>
Infelizmente toda a ajuda é descrita em língua Inglesa.