Conteúdo


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

Comments

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_DIRAmpliar a figura
    Verificando se o console de administração do WebSphere Application Server no ambiente de GQ inclui a variável WORKLIGHT_INSTALL_DIRAmpliar a figura
    Verificando se o console de administração do WebSphere Application Server no ambiente de GQ inclui a variável WORKLIGHT_INSTALL_DIRAmpliar 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
    Verificando se o aplicativo de Worklight customizado está no console de administração do WebSphere Application Server no ambiente de GQAmpliar a figura
    Verificando se o aplicativo de Worklight customizado está no console de administração do WebSphere Application Server no ambiente de GQAmpliar 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
    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
    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
Console do IBM Worklight para o servidor Worklight customizado acessível no WebSphere Application Server
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 para download


Temas relacionados


Comentários

Acesse ou registre-se para adicionar e acompanhar os comentários.

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