Maneiras de Atualizar Arquivos de Aplicativos Corporativos

Você pode atualizar arquivos de aplicativos Java™ Platform, Enterprise Edition (Java EE) implementados em um servidor ou cluster de várias maneiras.

Tabela 1. Maneiras de Atualizar Arquivos de Aplicativos. É possível atualizar arquivos de aplicativos usando o console, wsadmin, programação, ou ferramentas de implementação
Opção Method Comentários Iniciando após a atualização
Assistente de atualização do console administrativo

Consulte o Updating enterprise applications with the console.

Para remover um único arquivo de um aplicativo ou um módulo Java EE, consulte o tópico sobre como remover arquivos corporativos.

Resumidamente, faça o seguinte:
  1. Acesse a página Aplicativos corporativos. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere na árvore de navegação do console.
  2. Selecione o aplicativo para atualização e clique em Atualizar.
  3. Na página Preparando para a Atualização do Aplicativo, identifique o aplicativo, módulo ou arquivos para atualização e clique em Avançar.
  4. Conclua as etapas no assistente de atualização e clique em Concluir.
Na página Preparando para a Atualização do Aplicativo:
  • Utilize Aplicativo Completo para atualizar um arquivo .ear.
  • Use Modulo único para atualizar um arquivo .war, .sar, enterprise bean .jar ou .rar conector.
  • Use Arquivo único para atualizar um arquivo diferente de um .ear, .war, .sar, EJB .jar ou .rar.
  • Utilize Aplicativo Parcial para atualizar ou remover vários arquivos.
Na página Aplicativos corporativos, selecione o aplicativo atualizado e clique em Iniciar.
[AIX Solaris HP-UX Linux Windows][z/OS]Diretório monitorado [AIX Solaris HP-UX Linux Windows][z/OS]Se você instalou um aplicativo ou um módulo incluindo-o em um diretório monitorado, você poderá atualizá-lo incluindo um aplicativo ou um módulo que tenha o mesmo nome de arquivo no diretório monitorado. [AIX Solaris HP-UX Linux Windows][z/OS]Consulte o tópico sobre como instalar arquivos de aplicativos corporativos, incluindo-os em um diretório monitorado. [AIX Solaris HP-UX Linux Windows][z/OS]Após a instalação do aplicativo ou do módulo, o produto inicia-o automaticamente.

Para instalações em um diretório monitorado do gerenciador de implementação, o produto não inicia um aplicativo ou módulo automaticamente se o agente ou servidor do nó não estiver em execução.

[AIX Solaris HP-UX Linux Windows][z/OS]Arquivos de propriedades do aplicativo [AIX Solaris HP-UX Linux Windows][z/OS]Crie um arquivo de propriedades que especifica a atualização de arquivos do aplicativo. Em seguida, execute o comando wsadmin applyConfigProperties de uma das seguinte formas:
  • Em um script
  • Em um prompt de comandos
  • Incluindo o arquivo de propriedades em um diretório monitorado monitoredDeployableApps/ deploymentProperties
[AIX Solaris HP-UX Linux Windows][z/OS]Consulte o tópico sobre a instalação de arquivos de aplicativos corporativos incluindo-os em um diretório monitorado. [AIX Solaris HP-UX Linux Windows][z/OS]Após a instalação do aplicativo ou do módulo, o produto inicia-o automaticamente.

Para instalações em um diretório monitorado do gerenciador de implementação, o produto não inicia um aplicativo ou módulo automaticamente se o agente ou servidor do nó não estiver em execução.

Scripts wsadmin

Consulte o tópico sobre como atualizar aplicativos instalados usando a ferramenta de script wsadmin.

Utilize o comando update ou o comando updateInteractive em um script ou em um prompt de comandos. Para obter informações adicionais sobre os comandos update e updateInteractive, consulte o tópico sobre comandos do objeto AdminApp. O tópico Introdução ao Script wsadmin fornece uma visão geral de wsadmin. Inicie o aplicativo utilizando o comando invoke e o atributo startApplication. Para obter informações adicionais sobre o comando invoke, consulte o tópico sobre comandos do objeto AdminControl.
Interfaces de programação do aplicativo Java

Consulte o tópico sobre como usar programas administrativos (JMX).

Atualize os aplicativos implementados concluindo as etapas do tópico sobre como gerenciar aplicativos por meio de programação. Atualize um aplicativo das seguintes maneiras:
  • Atualize todo o aplicativo
  • Incluir em, substituir ou excluir diversos arquivos em um aplicativo
  • Inclua um módulo a um aplicativo
  • Atualize um módulo em um aplicativo
  • Exclua um módulo em um aplicativo
  • Inclua um arquivo a um aplicativo
  • Atualize um arquivo em um aplicativo
  • Exclua um arquivo em um aplicativo
Chame o método startApplication em um MBean ApplicationManager usando AdminControl.
Ferramentas de implementação rápida

Consulte os tópicos em Implementação Rápida de Aplicativos J2EE.

Resumidamente, faça o seguinte:
  1. Atualize seus arquivos do aplicativo J2EE.
  2. Configure o ambiente de implementação rápida.
  3. Crie um projeto de formato livre.
  4. Ative uma sessão de implementação rápida.
  5. Coloque os arquivos de aplicativo atualizados no projeto de formato livre.
As ferramentas de implementação rápida oferecem as seguintes vantagens:
  • Não é necessário montar seus arquivos de aplicativo J2EE antes da implementação.
  • Não é necessário usar outras ferramentas de instalação mencionadas nesta tabela para implementar os arquivos.
Use qualquer uma das opções anteriores para iniciar o aplicativo. Clicar em Iniciar na página Aplicativos corporativos é a opção mais fácil.
Implementação Automática e Recarregamento Dinâmico Resumidamente, faça o seguinte:
  1. Atualize seu aplicativo (.ear), web module (.war), enterprise bean .jar ou arquivo de configuração de plug-in HTTP.
  2. Siga as instruções em Implementação Rápida e Recarregamento Dinâmico para atualizar seu arquivo.
Se você for iniciante no WebSphere Application Server, utilize o console administrativo para atualizar os aplicativos. Essa opção é a mais fácil.

A implementação rápida e o recarregamento dinâmico são mais difíceis de concluir. É necessário manipular diretamente o aplicativo ou o arquivo de módulo no servidor no qual o aplicativo é implementado.

Em particular, qualquer nova função que usa anotações pode interagir substancialmente com a Implementação Ativa. Veja as informações abaixo em O atributo metadata-complete para obter informações adicionais sobre essas interações ao implementar aplicativos com implementação ativa.

Use qualquer uma das opções anteriores para iniciar o aplicativo. Clicar em Iniciar na página Aplicativos corporativos é a opção mais fácil.

Você pode atualizar arquivos .ear, enterprise bean .jar, módulo da Web .war, archive de Protocolo de Inicialização de Sessão (SIP) (.sar), conector .rar, aplicativo cliente .jar e quaisquer outros arquivos utilizados por um aplicativo instalado.

Se o aplicativo for atualizado enquanto estiver em execução, o WebSphere Application Server parará o aplicativo, atualizará a sua lógica e o reiniciará. Se o aplicativo não for iniciado automaticamente, inicie-o manualmente utilizando uma das opções Starting. Para obter mais informações no restante dos aplicativos atualizados, consulte "Comportamento de reciclagem de baixa granularidade" em IBM® WebSphere Developer Technical Journal: System management for WebSphere Application Server V6 -- Parte 5 Opções flexíveis para atualizar aplicativos implementados de atualização.

Se você atualizar metadados de módulo enquanto um aplicativo estiver em execução, a reinicialização do aplicativo pode não ser suficiente para as mudanças entrarem em vigor. Por exemplo, se você mudar os descritores na execução de aplicativos Java EE 6 que utilizam anotações, você deve reinstalar o aplicativo. Se você alterar classes que introduzem, removem ou alteram hierarquias de classe dentro de um aplicativo, e essas mudanças causarem impacto nas classes anotadas, você também deve reinstalar o aplicativo.

O atributo metadata-complete

Ao atualizar os metadados para um módulo da web, você poderá precisar mudar o atributo metadata-complete.
  • Quando o metadata-complete for falso, dois novos arquivos serão gravados: web_merged.xml, que contém os resultados de uma mesclagem em web.xml com metadados de anotações, mais um novo arquivo, ibm-metadata.xml,, que contém dados relacionados a anotações adicionais, que não podem ser armazenados em web_merged.xml. O arquivo web_merged.xml também contém metadados adicionais que são lidos a partir de web-fragment.xml em arquivos JAR em WEB-INF/lib do WAR.
  • Quando metadata-complete for verdadeiro, web_merged.xml NÃO será gerado e ibm-metadata.xml NÃO será criado. O arquivo ibm-metadata.xml somente será gerado se um arquivo web_merged.xml for gerado.
Nota: O atributo metadata-complete pode ser omitido de web.xml (ou de web-fragment.xml). Quando metadata-complete for omitido, seu valor padrão será false.
O atributo metadata-complete deve ser incluído no arquivo web.xml ou no arquivo web_merged.xml, conforme mostrado abaixo:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2011/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_3.0.xsd" 
version="3.0" metadata-complete="true">
<display-name>TestServlet30</display-name>
</web-app>
Os arquivos web.xml e web_fragment.xml devem ser atualizados, se esses arquivos estiverem conduzindo a atualização da implementação ativa. Se somente web_merged.xml for atualizado, as mudanças na implementação ativa serão perdidas, se for tomada qualquer ação administrativa que cause uma regeneração de web_merged.xml.
Importante: Se metadata-complete for falso em web.xml, você deverá atualizar o web.xml e web_merged.xml na implementação ativa de aplicativos do Servlet (web) 2.5. Se metadata-complete for verdadeiro em web.xml, você deverá atualizar SOMENTE web.xml na implementação ativa de aplicativos do Servlet (web) 2.5.

O processamento de web.xml em um arquivo WAR e ejb-jar.xml em um arquivo EJBJAR é o mesmo, com web_merged.xml criado para um arquivo WAR, se o web.xml estiver ausente ou tiver o metadata-complete configurado como falso, com ejb-jar_merged.xml criado para um arquivo EJBJAR se o ejb-jar.xml estiver ausente ou tiver o metadata-complete configurado como falso.

Em qualquer um dos casos, um ibm-metadata.xml será criado sempre que um XML mesclado for criado. (E somente se o XML mesclado for criado.)

Se a implementação mudar o metadata-complete de falso para verdadeiro, o arquivo XML (web.xml ou ejb-jar.xml) será criado ou substituído, nenhum arquivo XML e nenhum ibm-metadata.xml será criado.

O caso adicional é para o conteúdo EJB em um arquivo WAR (EJB-IN-WAR). Para esse caso, há regras complexas adicionais:
  • A configuração de metadata-complete de web.xml interage com o processamento de EJB-IN-WAR.
  • Quando nenhum conteúdo do EJB estiver presente no arquivo WAR, nenhum processamento de EJB-IN-WAR será executado.
  • A implementação poderá mudar independentemente o metadata-complete de falso para verdadeiro para o web.xml ou o ejb-jar.xml.
  • ibm-metadata.xml será criado quando um dos dois XML mesclado for criado. (E ele não é criado quando nenhum XML mesclado é criado.)

Como no EJB-IN-WAR, as regras a seguir se aplicam:

  • Quando o web.xml tiver o metadata-complete configurado como verdadeiro, e nenhum ejb-jar.xml estiver presente, nenhum processamento de EJB-IN-WAR será executado, mesmo quando as anotações do EJB estiverem presentes no arquivo WAR.
  • Quando o web.xml tiver o metadata-complete configurado como falso (ou quando o web.xml estiver ausente), e quando nenhum ejb-jar.xml estiver presente, o processamento de EJB-IN-WAR será executado somente quando as anotações do EJB estiverem presentes no arquivo WAR.
  • Quando um ejb-jar.xml estiver presente, a configuração do metadata-complete do web.xml não será usada para determinar o processamento do EJB que será executado. Quando um ejb-jar.xml estiver presente, o processamento de EJB-IN-WAR que é executado será determinado pela configuração do metadata-complete do ejb-jar.xml.

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



Í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=crun_app_upgrade
Nome do arquivo: crun_app_upgrade.html