[AIX Solaris HP-UX Linux Windows][z/OS]

Instalando Arquivos de Aplicativos Corporativos Incluindo-os em um Diretório Monitorado

Você pode instalar um arquivo do aplicativo corporativo em um servidor de aplicativos ou cluster arrastando ou copiando um enterprise archive (EAR), web application archive (WAR), Java™ archive (JAR), ou Session Initiation Protocol (SIP) archive (SAR) para um diretório monitorado. Um arquivo de aplicativo corporativo deve estar em conformidade com a especificação Java Platform, Enterprise Edition (Java EE).

Antes de Iniciar

Desenvolver e montar o arquivo EAR, JAR, WAR ou SAR. É possível usar uma ferramenta de montagem suportada, como um produto IBM® Rational Application Developer para WebSphere Software para especificar ligações e montar o arquivo.

Instalar um arquivo EAR, JAR, WAR ou SAR incluindo-o em um diretório monitorado não altera ligações existentes da Java Naming and Directory (JNDI) e de outros aplicativos. Se você precisar definir valores de ligação durante a implementação, instale o arquivo utilizando o assistente de instalação do aplicativo do console administrativo, um wsadmin ou um arquivo de propriedade que define as ligações. Consulte Instalando arquivos de aplicativos corporativos incluindo os arquivos de propriedades em um diretório monitorado.

Por padrão, a implementação de diretório monitorado não fica ativada. Antes de usar a implementação de diretório monitorado, você deve ativá-la. Consulte Configurando Valores de Implementação do Diretório Monitorado.

Restrição: A instalação de um arquivo EAR, JAR, WAR ou SAR incluindo-o em um diretório monitorado está disponível apenas em sistemas operacionais distribuídos e z/OS. Não é suportado em sistemas operacionais IBM i.
Evitar Problemas Evitar Problemas: Não use implementação do diretório monitorado em um ambiente de produção no qual o aplicativo deve permanecer continuamente disponível. Em vez disso, em ambientes de produção, use um processo automatizado que coordena atualizações de aplicativos para cada servidor de aplicativos drenando primeiro solicitações de cada servidor, atualizando o aplicativo e, em seguida, reiniciando o servidor. Para obter informações sobre este processo automatizado, consulte IBM WebSphere Developer Technical Journal: Manter disponibilidade contínua durante atualização dos aplicativos corporativos do WebSphere Application Server.gotcha

Sobre Esta Tarefa

É possível implementar um arquivo EAR, JAR, WAR ou SAR em um servidor de aplicativos ou cluster arrastando ou copiando o arquivo para um diretório monitorado.

Para servidores de aplicativos de base (independentes), o diretório monitorado é o diretório monitoredDeployableApps/servers/server_name do perfil do servidor de aplicativos.

Para gerenciadores de implementação, os diretórios monitorados são os diretórios monitoredDeployableApps/servers/server_name, monitoredDeployableApps/nodes/node_name/servers/server_name e monitoredDeployableApps/clusters/cluster_name do perfil de gerenciador de implementação.

O produto varre um diretório monitorado em busca de novos aplicativos numa frequência não maior do que a cada cinco segundos, por padrão. Após localizar um novo arquivo EAR, JAR, WAR, ou SAR em um diretório monitorado, o produto instala o arquivo no servidor de aplicativos ou cluster e inicia o aplicativo ou módulo.

Após incluir um arquivo EAR em um diretório monitorado, o produto cria uma cópia temporária do arquivo EAR em outro diretório e instala o arquivo no servidor. Depois de incluir um arquivo JAR, WAR ou SAR em um diretório monitorado, o produto cria uma cópia temporária do archive em outro diretório, quebra o archive em um arquivo EAR denominado archive_extension.ear, e instala o novo arquivo EAR. Por exemplo, simpleApp.war é instalado como simpleApp_war.ear. O archive original incluído no diretório monitorado não é alterado.

É possível atualizar arquivos de aplicativo da mesma maneira. Se você posteriormente incluir um arquivo atualizado EAR, JAR, WAR ou SAR no mesmo diretório monitorado, o produto para o aplicativo implementado anteriormente, instala o arquivo atualizado no servidor de aplicativos ou cluster, e inicia o arquivo ou modulo atualizado. Por exemplo, suponha que você implementou anteriormente my_app.ear arrastando-o para um diretório monitorado. Se, posteriormente, você arrastar um arquivo denominado my_app.ear até o diretório monitorado, o produto substituirá o arquivo EAR implementado anteriormente pelo arquivo EAR atualizado que tem o mesmo nome. O servidor ou cluster deve estar executando para o produto perceber as mudanças nos arquivos em seu diretório monitorado.

É possível usar um navegador de arquivo gráfico para arrastar e copiar o arquivo EAR, JAR, WAR ou SAR. Alternativamente, é possível usar os comandos do sistema operacional para copiar um arquivo em um subdiretório monitoredDeployableApps monitorado.

Procedimento

  1. Certifique-se de que o servidor de aplicativos ou membro de cluster no qual deseja instalar o aplicativo corporativo esteja executando.
  2. Certifique-se de que a implementação do diretório monitorado esteja ativada.

    Consulte Configurando valores de implementação do diretório monitorado.

  3. Navegue na estrutura do arquivo do computador e localize ou crie o diretório monitorado.
    Para servidores de aplicativos base (independentes), o diretório monitorado está sob o perfil do servidor de aplicativos. O caminho do diretório é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/application_server_profile_name/monitoredDeployableApps/servers/server_name
    • [z/OS]app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server_name
    Para servidores independentes, o produto cria um diretório server_name monitorado automaticamente.
    Para servidores de aplicativos em um nó gerenciado (federado) de um gerenciador de implementação, crie um diretório monitorado sob o perfil de gerenciador de implementação. O caminho do diretório é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/servers/server_name
    • [z/OS]app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server_name
    Para servidores de aplicativos em um nó federado, você deve criar o diretório server_name monitorado. O nome do diretório deve corresponder ao nome de um servidor existente.
    Se vários servidores do mesmo nome estiverem em nós federados diferentes, e você deseja que somente um dos servidores seja um diretório monitorado, pode especificar o nó e o servidor para o diretório monitorado. Crie os diretórios /nodes/node_name/servers/server_name sob o perfil de gerenciador de implementação. O caminho do diretório é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/nodes/node_name/servers/server_name
    • [z/OS]app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/node_name/servers/server_name
    Você deve criar diretórios para o nó e o servidor. O nome de diretório node_name deve corresponder ao nome de um nó existente. O nome de diretório server_name deve corresponder ao nome de um servidor existente no nó.
    Para clusters, crie o diretório monitorado sob o perfil de gerenciador de implementação. O caminho do diretório é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/clusters/cluster_name
    • [z/OS]app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/cluster_name
    Você deve criar o diretório cluster_name monitorado. O nome de diretório deve corresponder ao nome de um cluster existente.
  4. Copie o arquivo EAR, JAR, WAR ou SAR que deseja implementar para o diretório monitorado.

    Escolha um arquivo que ainda não esteja implementado para o diretório monitorado de destino, a menos que deseje atualizar um arquivo implementado atualmente.

    Se um arquivo já estiver implementado em um diretório monitorado de um gerenciador de implementação e você deseja implementar o arquivo em um diretório monitorado diferente do gerenciador de implementação, remova o arquivo do diretório monitorado de destino atual antes de incluir o arquivo no novo diretório monitorado de destino. Para esse release, um arquivo de aplicativo deve existir em somente um diretório monitorado de um gerenciador de implementação.

Resultados

O produto inclui um diretório que tem o mesmo nome que o arquivo no diretório installedApps/cell_name do perfil.

Além disso, o produto grava mensagens sobre a implementação do aplicativo no arquivo SystemOut.log no diretório app_server_root/logs/server_name. As mensagens são iniciadas com a chave de mensagem CWLDD.

As mensagens indicam que o produto implementou o arquivo de aplicativo e que o aplicativo está executando.

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

Para instalações em um diretório monitorado de gerenciador de implementação, o produto não inicia um aplicativo ou módulo automaticamente se o agente do nó ou servidor não estiver executando. Se um agente do nó estiver parado, o produto instala o aplicativo ou módulo no nível do gerenciador de implementação, mas não sincroniza as mudanças com o nó e não inicia o aplicativo ou módulo. As mudanças ocorrerão no nó na próxima vez que o agente estiver executando e ocorrer uma sincronização de nós Se o servidor estiver parado, mas o agente do nó estiver em execução, o produto instalará o aplicativo ou módulo e sincronizará as mudanças com o nó, mas não iniciará o servidor.

Exemplo

Suponha que você deseje instalar o arquivo DynaCacheEsi.ear de amostra copiando o arquivo EAR para um diretório monitorado. É possível localizar o arquivo EAR de amostra no diretório app_server_root/installableApps.

Implementando um arquivo EAR em um servidor de aplicativos independente
  1. Certifique-se de que o servidor de aplicativos no qual deseja instalar o arquivo DynaCacheEsi.ear esteja executando.

    Para ver se o servidor está executando, é possível usar o comando serverStatus -all. Para iniciar o servidor, é possível usar o comando startServer server_name.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, suponha que o servidor de aplicativos independente tenha um nome do perfil de AppSrv02. Execute o comando serverStatus a partir de um prompt de comandos no diretório app_server_root/profiles/AppSrv02/bin:
    serverStatus -all

    Se o servidor não estiver em execução, inicie o servidor.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, para iniciar um servidor de aplicativos denominado server1 em AppSrv02, execute o comando startServer a partir de um prompt de comandos no diretório app_server_root/profiles/AppSrv02/bin:
    startServer server1
    A mensagem Servidor server1 aberto para e-business indica que o servidor está em execução.
  2. Localize o diretório monitorado.

    [AIX Solaris HP-UX Linux Windows]Para o perfil AppSrv02 independente, o diretório monitorado é app_server_root/profiles/AppSrv02/monitoredDeployableApps/servers/server1.

  3. Copie o arquivo DynaCacheEsi.ear no diretório app_server_root/installableApps para o diretório monitorado.
  4. Verifique se o diretório para aplicativos instalados existe.
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/AppSrv02/installedApps/cell_name/DynaCacheEsi.ear
    • [z/OS]app_server_root/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
  5. Verifique se DynaCacheEsi.ear está na lista de aplicativos corporativos instalados e em execução.
Implementando um arquivo EAR em um nó federado de um gerenciador de implementação
  1. Certifique-se de que o servidor de aplicativos do nó federado no qual deseja instalar o arquivo DynaCacheEsi.ear esteja executando.

    Para ver se o servidor está executando, é possível usar o comando serverStatus -all. Para iniciar o servidor, é possível usar o comando startServer server_name.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, suponha que o servidor de aplicativos server1 esteja em um nó que possui um nome do perfil de AppSrv01. Execute o comando serverStatus a partir de um prompt de comandos no diretório app_server_root/profiles/AppSrv01/bin:
    serverStatus -all

    Se o servidor não estiver em execução, inicie o servidor.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, execute o comando startServer a partir de um prompt de comandos em um diretório app_server_root/profiles/AppSrv01/bin:
    startServer server1
  2. Certifique-se de que o arquivo DynaCacheEsi.ear não exista em um diretório monitorado do gerenciador de implementação.

    Inclua um arquivo de aplicativo em apenas um diretório monitorado de um gerenciador de implementação. Se um arquivo de aplicativo já existir em um diretório monitorado do gerenciador de implementação e você incluir um arquivo de aplicativo que tenha o mesmo nome do arquivo em um diretório monitorado de gerenciador de implementação diferente, o produto desinstala o arquivo de aplicativo do destino anterior e o instala no novo destino. Entretanto, o novo destino não é sincronizado com a implementação porque o arquivo ainda existe no diretório monitorado de destino anterior. Para evitar problemas com a sincronização, você deve remover DynaCacheEsi.ear de todos os diretórios monitorados antes de incluir DynaCacheEsi.ear no novo diretório de destino.

  3. Crie o diretório monitorado.

    Para nós federados, você deve criar um diretório monitorado sob o perfil de gerenciador de implementação, a menos que o diretório do servidor de destino já exista.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, suponha que o perfil de gerenciador de implementação seja Dmgr01 e o servidor de aplicativos seja server1.

    1. Vá para o diretório /monitoredDeployableApps/servers:
      • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/Dmgr01/monitoredDeployableApps/servers
      • [z/OS]app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers
    2. Se um diretório denominado server1 existe no diretório servidores, então vá para a próxima etapa.

      Se o diretório server1 não existe, crie um diretório denominado server1 no diretório /monitoredDeployableApps/servers.

    O diretório monitorado é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/Dmgr01/monitoredDeployableApps/servers/server1
    • [z/OS]app_server_root/AppServer/profiles/default/monitoredDeployableApps/servers/server1
  4. Copie o arquivo DynaCacheEsi.ear no diretório app_server_root/installableApps para o diretório monitorado server1
  5. Verifique se o diretório para aplicativos instalados existe.
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/AppSrv01/installedApps/cell_name/DynaCacheEsi.ear
    • [z/OS]app_server_root/AppServer/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
  6. Verifique se DynaCacheEsi.ear está na lista de aplicativos corporativos instalados no servidor e se está executando.
Dica: Se vários servidores do mesmo nome estiverem em nós federados diferentes, e você deseja que somente um dos servidores seja um diretório monitorado, pode especificar o nó e o servidor para o diretório monitorado. Crie os diretórios /nodes/node_name/servers/server_name sob o perfil de gerenciador de implementação. Por exemplo, se desejar que o diretório monitorado seja o servidor de aplicativos server1 no nó myNode01, o caminho do diretório será:
  • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/Dmgr01/monitoredDeployableApps/nodes/myNode01/servers/server1
  • [z/OS]app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/myNode01/servers/server1
Somente especifique o nó para um diretório monitorado se mais de um servidor tiver o mesmo nome.
Implementando um arquivo EAR em um cluster de um gerenciador de implementação
  1. Certifique-se de que os membros de cluster do cluster no qual você deseja instalar o arquivo DynaCacheEsi.ear esteja executando. Para este exemplo, o cluster myCluster01 tem um membro, myClusterMember01.
  2. Para ver se o cluster está executando, é possível usar o comando serverStatus -all. Para iniciar o membro de cluster, é possível usar o comando startServer myClusterMember01.
    [AIX Solaris HP-UX Linux Windows]Por exemplo, suponha que myClusterMember01 esteja no perfil AppSrv01. Execute o comando serverStatus a partir de um prompt de comandos no diretório app_server_root/profiles/AppSrv01/bin:
    serverStatus -all
    Se o membro de cluster não estiver executando, execute o comando startServer a partir de um prompt de comandos no diretório app_server_root/profiles/AppSrv01/bin:
    startServer myClusterMember01
  3. Certifique-se de que o arquivo DynaCacheEsi.ear não exista em um diretório monitorado do gerenciador de implementação.
  4. Crie o diretório monitorado.

    Para clusters, você deve criar um diretório monitorado sob o perfil de gerenciador de implementação, a menos que o diretório para um membro de cluster de destino já exista.

    [AIX Solaris HP-UX Linux Windows]Por exemplo, suponha que o perfil de gerenciador de implementação seja Dmgr01:
    1. Vá para app_server_root/profiles/Dmgr01/monitoredDeployableApps/clusters.
    2. Se um diretório denominado myCluster01 existe no diretório /clusters, então vá para a próxima etapa.

      Se o diretório myCluster01 não existir, crie um diretório denominado myCluster01 no diretório /clusters.

    O diretório monitorado é:
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/Dmgr01/monitoredDeployableApps/clusters/myCluster01
    • [z/OS]app_server_root/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/myCluster01
  5. Copie o arquivo DynaCacheEsi.ear no diretório app_server_root/installableApps para o diretório monitorado myCluster01.
  6. Verifique se o diretório para aplicativos instalados existe.
    • [AIX Solaris HP-UX Linux Windows]app_server_root/profiles/AppSrv01/installedApps/cell_name/DynaCacheEsi.ear
    • [z/OS]app_server_root/AppServer/profiles/default/installedApps/cell_name/DynaCacheEsi.ear
  7. Verifique se DynaCacheEsi.ear está na lista de aplicativos corporativos instalados no membro de cluster e se está executando.

O que Fazer Depois

Teste o aplicativo ou o módulo implementado. Por exemplo, aponte para um navegador da Web na URL de um aplicativo implementado e examine o desempenho do aplicativo.

Se a implementação não for bem-sucedida, leia as mensagens do arquivo SystemOut.log, corrija a condição de erro e inclua o aplicativo ou o módulo no diretório monitorado novamente.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_install_dragdrop
Nome do arquivo: trun_app_install_dragdrop.html