Publicando, Testando e Depurando Aplicativos Utilizando o IBM Agent Controller

O produto interage com o Agent Controller para publicar, testar, definir perfil e depurar os aplicativos Java e WAS (WebSphere Application Server) nos servidores remotos suportados.

Configuração do Servidor de Publicação J2EE

Antes de publicar ou executar seu aplicativo, é necessário primeiro, configurar seu servidor.
  1. Crie uma instância do servidor em seu servidor WAS. Por exemplo, se estiver utilizando o WAS Express Edition Versão 5.0:
    1. Efetue logon no servidor iSeries.
    2. Na linha de comandos, digite:
      qsh
      cd /QIBM/ProdData/WebASE/ASE5/bin
      crtwasinst -instance myinstancename -portblock 43210
      Em que myinstancename é o nome dado à instância do WAS. Observe que o comando cima atribui um número da porta à instância do WAS; anote esse número.
  2. Abra o workbench, se ainda não estiver aberto.
  3. Alterne para a perspectiva Server, clicando em Window > Open Perspective > Server.
  4. Com seu cursor na visualização Configuração do Servidor, clique com o botão direito do mouse e selecione New > Server and Server Configuration.
  5. Digite o nome da instância do servidor WAS no campo Server name.
  6. Na área Server type, expanda o WebSphere Versão 5.0, 5.1 ou 6.0 e selecione o servidor correto (por exemplo, Express Server). Clique em Next.
  7. Na janela New Server and Server Configuration, insira o nome do servidor ou o endereço IP do servidor iSeries no campo Server.
  8. As informações do diretório do WebSphere são obtidas a partir do servidor iSeries, através do Remote Access Controller.
  9. Digite o nome da instância do WAS criada com o comando crtwasinst (na Etapa 2). Clique em Next.
  10. Selecione ftp (ou seu mecanismo de transferência de cópias) e clique em Next.
  11. Se você selecionou ftp, insira seu diretório de destino remoto. Por exemplo, para o WAS Express Versão 5.0 deve ser: /QIBM/UserData/WebASE/ASE5/myinstancename. Para a Versão 5.0 padrão do WAS, esse deve ser: /QIBM/UserData/WebASE/BASE/myinstancename.
  12. Insira seu nome do usuário e senha do ftp. Clique em Next.
  13. Selecione o botão de opções consecutive port numbers.
  14. Insira o número de portblock. Nesse exercício, utilizamos o seguinte número: 43210.
  15. Clique em Finish.
Nota: Para o Remote Server Configurations funcionar, é necessário que as cópias do WAS (WebSphere Application Server) local e remoto sejam correspondentes. Nomeadamente, a versão do Ambiente de Teste do WAS utilizada precisa ser correspondente à versão real do WAS no servidor iSeries. Se você fosse publicar arquivos no Express Server remoto, então, acharia que os arquivos estão incorretamente publicados em: /qibm/userdata/webase/ase5/toshwasexp/installedApps/DefaultNode e o local correto seria algo como: /qibm/userdata/webase/ase5/toshwasexp/installedApps/HOSTNAME_myinstancename.
Para assegurar que os aplicativos estão publicados no local correto:
  1. Mapeie uma letra de unidade de rede para o diretório raiz IFS do iSeries, supondo que você tenha definido uma raiz nomeada de compartilhamento. Caso contrário, substitua "root" por qualquer nome que tenha definido.
  2. Selecione File > Import > Server Configuration no menu do workbench. Esta ação importa a configuração para uma configuração do servidor temporária, por exemplo, toshtemp. Utilize a unidade de rede para especificar o nome do caminho do local exato da configuração do servidor, por exemplo, x:\QIBM\UserData\WebASE5\myinstancename\config. Uma nova configuração aparecerá na visualização Navigator na perspectiva Server. Nesse caso, ela aparecerá como toshtemp.wsc.
  3. Vá para a visualização Server configuration, na perspectiva Server, e clique com o botão direito do mouse na instância do servidor, por exemplo, toshwasexp5. No menu pop-up, selecione Switch configuration e selecione a configuração temporária do servidor que você criou na etapa anterior, por exemplo, toshtemp.wsc.

Publicando os Arquivos para um Servidor Remoto

Você pode executar ações de publicação em oposição ao servidor remoto a partir da perspectiva Server do workbench. Clique com o botão direito do mouse na configuração do servidor remoto e selecione Publish. Essa ação publica a configuração do novo servidor, assim como todos os aplicativos da Web em seu projeto.
Atenção: Sua primeira publicação pode levar alguns minutos. As publicações subseqüentes são mais rápidas.

Executando seus Aplicativos

Você pode executar vários aplicativos da Web e Java com o Agent Controller. Para executar um aplicativo:
  1. Na visualização Navigator, selecione o item que deseja executar (um arquivo EAR, WAR, .jsp e assim por diante).
  2. Clique com o botão direito do mouse no item e selecione Run para publicar e, em seguida, executar seu aplicativo.
Isso publica seu Unit Test Controller e a configuração do servidor e, em seguida, inicia o servidor Agent Controller e abre uma janela do navegador para exibir seu aplicativo.

Depurando e Definindo o Perfil dos Aplicativos

Você pode depurar e definir o perfil de vários aplicativos da Web e Java com o Agent Controller. Para definir o perfil de aplicativos, clique com o botão direito do mouse no item ao qual deseja definir o perfil e selecione Profile on server. Para depurar um aplicativo, é necessário, primeiro, certificar-se de que o servidor Remote Agent está no modo de depuração. Se não estiver, pare e inicie o servidor para assegurar-se de que a Java Virtual Machine foi iniciada com a opções de depuração necessárias. É necessário, também, alterar algumas preferências antes de depurar:
  1. A partir da barra de menus do workbench, clique em Window > Preferences.
  2. Expanda Java e selecione Debug.
  3. Altere o valor no campo Debugger Timeout para 60000.
  4. Clicar em OK.
  5. Agora, para depurar seu arquivo, vá para a visualização Navegador, clique com o botão direito do mouse no arquivo que deseja depurar e selecione Debug on server.