Automatize a implementação de um arquivo WAR de customização do IBM Worklight no IBM WebSphere Application Server

Como usar Rational Automation Framework para automatizar implementações WAR de Worklight customizadas

Saiba como automatizar a implementação de um arquivo WAR do IBM Worklight® customizado para o IBM WebSphere® Application Server usando o Rational® Automation Framework. Este artigo fornece detalhes sobre as etapas para usar a interface da linha de comandos do Rational Automation Framework ou sua UI rich client para aplicar o mesmo conjunto de alterações de configuração a vários ambientes do WebSphere Application Server e, em seguida, implementar WAR de customização do Worklight nesses ambientes.

Leigh Williamson, Distinguished Engineer, Software Group , IBM

author photoLeigh Williamson é IBM Distinguished Engineer que trabalha no laboratório de Austin, Texas, desde 1988, contribuindo para grandes projetos de software da IBM, incluindo o OS/2, DB2, AIX, Java, WebSphere Application Server, e o portfólio IBM Rational de soluções. Atualmente, ele é membro da equipe do Chief Technology Officer, influenciando a direção estratégica de produtos que tratam das necessidades das equipes de desenvolvimento de software. O foco primário de Leigh são as ferramentas e melhores práticas para o desenvolvimento de aplicativos remotos. Visite seu blog sobre tópicos de desenvolvimento remoto e siga-o no Twitter em @leighawilli. Leigh é bacharel em ciência da computação pela Universidade Nova e possui mestrado em engenharia da computação pela Universidade do Texas.



Amol M. Gade, Software Engineer, IBM

author photo - amal gadeAmol Gade é Advisory Software Engineer e trabalha no IBM India Software Lab, contribuindo para o Rational Automation Framework para WebSphere desde 2010. Ele é profissional em Java com conhecimento em projeto e desenvolvimento de software para automação de gerenciamento de middleware com base no WebSphere. Ele também contribui para as iniciativas remotas e DevOps do laboratório IBM Rational India. Ele é bacharel em engenharia de tecnologia da computação pela Universidade Nagpur, na Índia.



08/Jul/2013

Introdução

Obtenha o IBM Worklight

O Worklight é uma plataforma abrangente para a criação e implementação de aplicativos remotos nativos, em HTML5 e híbridos. Download gratuito do IBM Worklight Developer Edition.

Ao instalar o IBM Worklight 5.0.0.3 (ou posterior) no WebSphere Application Server, todas as etapas da configuração do banco de dados e do servidor relacionados ao Worklight serão automatizadas. Mas posteriormente pode ser necessário incorporar customização específica do projeto ou do ambiente no arquivo WAR de Worklight padrão, conforme explicado no Guia de Administração do IBM Worklight Server (consulte Recursos para obter um link).

Para implementar um arquivo WAR customizado (chamado de WAR de customização do Worklight), é necessário executar algumas etapas de configuração manual no console de administração do WebSphere Application Server. É possível usar o Rational Automation Framework para executar essas etapas de configuração e, depois, automatizar a implementação do WAR de customização. Este artigo fornece instruções passo a passo para esse processo, usando um cenário hipotético.

Obtém-se dois benefícios de usar o Rational Automation Framework para automatizar a implementação do WAR de customização. Primeiro, seu modo de promoção permite aplicar facilmente customizações que você configurar para o ambiente do WebSphere Application Server a outros. Por exemplo, é possível aplicar customizações feitas em um WAR de Worklight para um ambiente WebSphere Application Server de desenvolvimento a um ambiente de garantia de qualidade (GQ) ou até de produção. Um segundo benefício é poder montar as etapas deste artigo em um plano de automação no Rational Automation Framework. Um plano de automação é útil quando é necessário implementar um WAR de customização do Worklight com frequência. Consulte Recursos para obter mais informações sobre o modo de promoção e planos de automação.


Cenário de automação

Este artigo usa um cenário hipotético para mostrar como configurar um ambiente de desenvolvimento do WebSphere Application Server para usar um WAR de customização do Worklight, aplicar a mesma configuração a um ambiente de GQ e, em seguida, implementar o WAR de customização em ambos os ambientes.

A Tabela 1 descreve todos os valores de propriedade do ambiente do Rational Automation Framework usados neste cenário:

Tabela 1. Valores de propriedade do ambiente do Rational Automation Framework (RAF)
Valores de propriedade do ambiente do RAFDescrição
worklight_was80_dev_envAmbiente RAF correspondente à configuração de desenvolvimento do WebSphere Application Server
worklight_was80_qa_envAmbiente RAF correspondente à configuração de GQ do WebSphere Application Server
worklight_was80_dev_cellNome da célula da configuração de desenvolvimento do WebSphere Application Server
worklight_was80_qa_cellNome da célula da configuração de GQ do WebSphere Application Server
worklight_was80_dev_nodeNome do nó que serve de host para o servidor Worklight na configuração de desenvolvimento do WebSphere Application Server
worklight_was80_qa_nodeNome do nó que serve de host para o servidor Worklight na configuração de GQ do WebSphere Application Server
worklight_was80_dev_serverNome do servidor Worklight na configuração de desenvolvimento do WebSphere Application Server
worklight_was80_qa_serverNome do servidor Worklight na configuração de GQ do WebSphere Application Server
worklight.warNome do WAR de Worklight padrão (não customizado)
worklight_custom.warNome do WAR de Worklight customizado. Também pode ser worklight.war, mas lhe demos um nome diferente aqui para evitar confusão.
/opt/IBM/RAFServer/rafw/bin/rafw.shA localização padrão do script rafw. Pode variar dependendo da escolha do usuário do diretório de instalação do servidor do RAF.


É possível chamar todas as ações do Rational Automation Framework diretamente por uma interface da linha de comandos ou usando uma UI rich-client; cada etapa indica as ações apropriadas para cada tipo de interface. Observação: os usuários de interface da linha de comandos em servidor do Rational Automation Framework baseado em Windows devem alterar a extensão do script .sh mostrada na Tabela 1 e nas etapas abaixo para .bat.


Etapas de configuração

  1. Desinstale o arquivo WAR do Worklight implementado automaticamente durante a instalação do Worklight dos ambientes de desenvolvimento e de GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute as seguintes ações no Rational Automation Framework:

    1. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -execute was_common_deploy_uninstall_app -app worklight.war
    2. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_qa_env -cell worklight_was80_qa_cell -node worklight_was80_qa_node -server worklight_was80_qa_server -execute was_common_deploy_uninstall_app -app worklight.war

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_deploy_uninstall_app .
    3. Na área de janela Action Inputs , configure Mode como Execute, insira worklight.war como app na seção Parameters e execute a ação.
    4. Repita as três etapas anteriores com worklight_was80_qa_server.
  2. Importe as variáveis de ambiente do WebSphere definidas para o ambiente de desenvolvimento do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    1. Execute a seguinte ação no Rational Automation Framework:

      /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -import was_common_configure_variables
    2. Edite o arquivo variables.xml criado no escopo do servidor no ambiente do Rational Automation Framework para anexar uma nova variável WORKLIGHT_INSTALL_DIR à lista de variáveis existentes. Configure o diretório de instalação do Worklight — por exemplo, /opt/IBM/Worklight— como seu valor.

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_configure_variables .
    3. Na área de janela Action Inputs , configure Mode como Import e execute a ação.
    4. Na visualização Configuration Workspace , clique duas vezes em worklight_was80_dev_server> Variables
    5. No Variables Editor, clique em Create Variables Substitution Entry na área de janela Actions .
    6. Crie uma variável chamada WORKLIGHT_INSTALL_DIR e configure seu valor como o diretório de instalação do Worklight — por exemplo, /opt/IBM/Worklight.
    7. Salve a configuração e clique com o botão direito do mouse em worklight_was80_dev_server > Variables na visualização Configuration Workspace .
    8. Selecione Team > Synchronize with Server.
  3. Aplique (promote) as mudanças na configuração do ambiente de desenvolvimento do WebSphere Application Server ao ambiente de GQ.

    Usuários de interface da linha de comandos do RAF

    Execute a seguinte ação no Rational Automation Framework:

    /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -promote was_common_configure_variables -opt "source.env=worklight_was80_qa_env" -opt "source.cell=worklight_was80_qa_cell" -opt "source.node=worklight_was80_qa_node" -opt "source.server=worklight_was80_qa_server"


    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_configure_variables .
    3. Na área de janela Action Inputs , configure Mode como Promote.
    4. Configure source.env como worklight_was80_qa_env; source.cell como worklight_was80_qa_cell; source.node como worklight_was80_qa_node; e source.server como worklight_was80_qa_server.
    5. Execute a ação.
  4. Aplique as mudanças na configuração aos ambientes de desenvolvimento e GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute as seguintes ações no Rational Automation Framework:

    1. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -execute was_common_configure_variables
    2. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_qa_env -cell worklight_was80_qa_cell -node worklight_was80_qa_node -server worklight_was80_qa_server -execute was_common_configure_variables

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_configure_variables .
    3. Na área de janela Action Inputs, configure Mode como Execute e execute a ação.
    4. Repita as três etapas anteriores com worklight_was80_qa_server.

    Como opção, verifique se o console de administração do WebSphere Application Server no ambiente de GQ alista a variável WORKLIGHT_INSTALL_DIR , como mostra a Figura 1:

    Figura 1. Verificando se o console de administração do WebSphere Application Server no ambiente de GQ inclui a variável WORKLIGHT_INSTALL_DIR
    Ampliar a figura

Etapas de implementação

Agora, estamos prontos para implementar o WAR de customização do Worklight em ambos os ambientes doWebSphere Application Server.

  1. Execute as seguintes ações a partir da linha de comandos para incluir os arquivos worklight_custom.war e worklight_custom.war.properties no ambiente do Rational Automation Framework:
    1. /opt/IBM/RAFServer/rafw/user/environments worklight_was80_dev_env/cells/worklight_was80_dev_cell/nodes worklight_was80_dev_node/servers/worklight_was80_dev_server/apps/media/worklight_custom.war
    2. /opt/IBM/RAFServer/rafw/user/environments worklight_was80_dev_env/cells worklight_was80_dev_cell/nodes/worklight_was80_dev_node/servers worklight_was80_dev_server/apps/properties/worklight_custom.war.properties

    No arquivo worklight_custom.war.properties, certifique-se de que:

    • A Worklight Platform Library seja configurada como biblioteca compartilhada de referência para a propriedade options.multi.1.MapSharedLibForMod .
    • Uma raiz de contexto exclusiva seja configurada para a propriedade options.multi.1.CtxRootForWebMod .
    • A opção CLASS_LOADER_MODE esteja configurada como PARENT_LAST.
  2. Promova as mudanças feitas na etapa 1 para o ambiente de GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute a seguinte ação no Rational Automation Framework:

    /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -promote was_common_deploy_install_app -opt "source.env=worklight_was80_qa_env" -opt "source.cell=worklight_was80_qa_cell" -opt "source.node=worklight_was80_qa_node" -opt "source.server=worklight_was80_qa_server"


    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_deploy_install_app .
    3. Na área de janela Action Inputs , configure Mode como Promote.
    4. Configure source.env como worklight_was80_qa_env; source.cell como worklight_was80_qa_cell; source.node to worklight_was80_qa_node; e source.server como worklight_was80_qa_server.
    5. Execute a ação.
  3. Implemente o arquivo WAR de customização para o WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute as seguintes ações no Rational Automation Framework:

    1. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -execute was_common_deploy_install_app -app worklight_custom.war
    2. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_qa_env -cell worklight_was80_qa_cell -node worklight_was80_qa_node -server worklight_was80_qa_server -execute was_common_deploy_install_app -app worklight_custom.war

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_deploy_install_app .
    3. Na área de janela Action Inputs , configure Mode como execute, insira worklight_custom.war como app na seção Parameters e execute a ação.
    4. Repita as três etapas anteriores com worklight_was80_qa_server.

    Como opção, verifique se o aplicativo de Worklight customizado está alistado na seção Enterprise Applications do console de administração do WebSphere Application Server no ambiente de GQ, como mostrado na Figura 2:

    Figura 2. Verificando se o aplicativo de Worklight customizado está no console de administração do WebSphere Application Server no ambiente de GQ
    Ampliar a figura
  4. Importe a política de carregador de classes do servidor Worklight para o ambiente de desenvolvimento do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    1. Execute a seguinte ação:

      /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -import was_common_configure_server_application_server.
    2. Edite o arquivo server.xml criado no escopo do servidor no ambiente do Rational Automation Framework para alterar o valor do atributo applicationClassLoadingMode para PARENT_LAST.

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, , selecione a ação was_common_configure_server_application_server .
    3. Na área de janela Action Inputs , configure Mode como Import e execute a ação.
    4. Na visualização Configuration Workspace , clique duas vezes em worklight_was80_dev_server > Server Settings.
    5. No Server Editor, clique em worklight_was80_dev_server e configure Application class loading mode como PARENT_LAST.
    6. Salve a configuração e clique com o botão direito do mouse em worklight_was80_dev_server> Server Settings na visualização Configuration Workspace .
    7. Selecione Team > Synchronize with Server.
  5. Promova as mudanças feitas na etapa 4 para o ambiente de GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute a seguinte ação no Rational Automation Framework:

    /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -promote was_common_configure_server_application_server -opt "source.env=worklight_was80_qa_env" -opt "source.cell=worklight_was80_qa_cell" -opt "source.node=worklight_was80_qa_node" -opt "source.server=worklight_was80_qa_server"

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, , selecione a ação was_common_configure_server_application_server .
    3. Na área de janela Action Inputs , configure Mode como Promote.
    4. Configure source.env como worklight_was80_qa_env, source.cell como worklight_was80_qa_cell, source.node to worklight_was80_qa_node e source.server como worklight_was80_qa_server.
    5. Execute a ação.
  6. Aplique as mudanças aos ambientes de desenvolvimento e GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute as seguintes ações no Rational Automation Framework:

    1. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -execute was_common_configure_server_application_server .
    2. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_qa_env -cell worklight_was80_qa_cell -node worklight_was80_qa_node -server worklight_was80_qa_server -execute was_common_configure_server_application_server.

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_configure_server_application_server .
    3. Na área de janela Action Inputs , configure Mode como execute e execute a ação.
    4. Repita as três etapas anteriores com worklight_was80_qa_server.

    Como opção, verifique se o console de administração do WebSphere Application Server no ambiente de GQ exibe as configurações do aplicativo específicas do servidor, como mostra a Figura 3:

    Figura 3. Verificando se o console de administração do WebSphere Application Server no ambiente de GQ mostra as configurações do aplicativo específicas do servidor
    Ampliar a figura
  7. Inicie o aplicativo Worklight nos ambientes de desenvolvimento e GQ do WebSphere Application Server.

    Usuários de interface da linha de comandos do RAF

    Execute as seguintes ações no Rational Automation Framework:

    1. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_dev_env -cell worklight_was80_dev_cell -node worklight_was80_dev_node -server worklight_was80_dev_server -execute was_common_deploy_start_app -app worklight_custom.war .
    2. /opt/IBM/RAFServer/rafw/bin/rafw.sh -env worklight_was80_qa_env -cell worklight_was80_qa_cell -node worklight_was80_qa_node -server worklight_was80_qa_server -execute was_common_deploy_start_app -app worklight_custom.war.

    Usuários do cliente do RAF

    1. Na visualização Configuration Explorer , clique duas vezes em worklight_was80_dev_server.
    2. No Dynamic Action Editor, selecione a ação was_common_deploy_start_app .
    3. Na área de janela Action Inputs , configure Mode como execute, insira worklight_custom.war como app na seção Parameters e execute a ação.
    4. Repita as três etapas anteriores com worklight_was80_qa_server.

O console de administração do servidor Worklight customizado deve estar acessível agora, como mostra a Figura 4:

Figura 4. Console do IBM Worklight para o servidor Worklight customizado acessível no WebSphere Application Server

Conclusão

Executando as etapas neste artigo — usando a interface da linha de comandos ou de rich client do Rational Automation Framework — é possível configurar um ambiente de origem no WebSphere Application Server para a implementação do WAR de customização do Worklight e aplicar (promover) as mesmas definições de configuração a um ou mais ambientes de destino no WebSphere Application Server. Os usuários da interface rich client do Rational Automation Framework também podem desenvolver um plano de automação que contenha essas ações e reutilizar o plano para fazer futuras mudanças na configuração do WebSphere Application Server para a implementação do WAR de customização do Worklight.

Recursos

Aprender

Obter produtos e tecnologias

  • Worklight Developer Edition: faça o download e instale a plataforma de servidor e desenvolvimento remoto da IBM para aplicativos de smartphone e tablet.
  • WebSphere Application Server: faça o download do produto completo do IBM WebSphere Application Server for Developers.
  • Rational Automation Framework: automatiza a criação de ambientes de middleware, o gerenciamento de configuração e as implementações de aplicativo.

Discutir

  • The Mobile Frontier: acompanhe o blog de Leigh Williamson sobre tópicos de desenvolvimento remoto.

Comentários

developerWorks: Conecte-se

Los campos obligatorios están marcados con un asterisco (*).


Precisa de um ID IBM?
Esqueceu seu ID IBM?


Esqueceu sua senha?
Alterar sua senha

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


A primeira vez que você entrar no developerWorks, um perfil é criado para você. Informações no seu perfil (seu nome, país / região, e nome da empresa) é apresentado ao público e vai acompanhar qualquer conteúdo que você postar, a menos que você opte por esconder o nome da empresa. Você pode atualizar sua conta IBM a qualquer momento.

Todas as informações enviadas são seguras.

Elija su nombre para mostrar



Ao se conectar ao developerWorks pela primeira vez, é criado um perfil para você e é necessário selecionar um nome de exibição. O nome de exibição acompanhará o conteúdo que você postar no developerWorks.

Escolha um nome de exibição de 3 - 31 caracteres. Seu nome de exibição deve ser exclusivo na comunidade do developerWorks e não deve ser o seu endereço de email por motivo de privacidade.

Los campos obligatorios están marcados con un asterisco (*).

(Escolha um nome de exibição de 3 - 31 caracteres.)

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


Todas as informações enviadas são seguras.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Desenvolvimento móvel, WebSphere, Rational
ArticleID=936317
ArticleTitle=Automatize a implementação de um arquivo WAR de customização do IBM Worklight no IBM WebSphere Application Server
publish-date=07082013