Preparando as Definições de Atualização do Aplicativo

Utilize esta página para atualizar aplicativos corporativos, módulos ou arquivos já instalados em um servidor.

Para visualizar esta página do console administrativo, faça o seguinte:
  1. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere.
  2. Selecione o aplicativo ou módulo instalado que deseja atualizar.
  3. Clique em Atualizar.
Clicar em Atualizar exibe uma página que ajuda a atualizar os arquivos do aplicativo implementados na célula. É possível atualizar todo o aplicativo, um único módulo, um único arquivo ou parte do aplicativo. Se um novo arquivo ou módulo tiver o mesmo caminho relativo que um arquivo ou módulo já existente no servidor, o novo arquivo ou módulo substituirá o arquivo ou módulo existente. Se o novo arquivo ou módulo não existir no servidor, ele será incluído no aplicativo implementado.
Aplicativo a ser atualizado

Especifica o nome do aplicativo instalado (ou implementado) que você selecionou na página Aplicativos Corporativos.

Substituir o aplicativo inteiro

Em Opções de Atualização do Aplicativo, especifica para substituir o aplicativo já instalado no servidor por um novo arquivo .ear (atualizado) de aplicativo corporativo.

Após selecionar essa opção, faça o seguinte:

  1. Especifique se o arquivo .ear está em um sistema de arquivos local ou remoto e o nome do caminho completo do aplicativo. O caminho fornece o local do arquivo .ear atualizado antes da instalação.

    Utilize Sistema de Arquivos Local se o navegador e os arquivos atualizados ou módulos estiverem na mesma máquina, independentemente de o servidor também estar nessa máquina. Sistema de Arquivos Local está disponível para todas as opções de atualização.

    Utilize Sistema de Arquivo Remoto se o arquivo de aplicativo residir em qualquer nó no contexto da célula atual.

    Em instalações com vários servidores, usando Sistema de arquivos remoto, é possível procurar o sistema de arquivos inteiro de um nó se o agente do nó ou o gerenciador de implementação estiver em execução nesse nó selecionado. Apenas os arquivos .ear, .jar, .sar ou .war são mostrados durante a procura.

    Utilize também a opção Sistema de Arquivos Remoto para especificar um arquivo de aplicativo já residente na máquina que está executando o servidor de aplicativos. Por exemplo, o valor do campo pode ser app_server_install_root/installableApps/test.ear. Se estiver instalando um módulo WAR independente, especifique também a raiz de contexto.

    Dica: Durante a instalação do aplicativo, os arquivos de aplicativo geralmente são transferidos por upload de uma máquina cliente que está executando o navegador para a máquina servidor que está executando o console administrativo, na qual eles são implementados. Nesses casos, utilize o navegador da Web que está executando o console administrativo para selecionar módulos para fazer upload para a máquina servidor. No entanto, em alguns casos, os arquivos do aplicativo residirão no sistema de arquivos de qualquer um dos nós em uma célula. Para que o servidor de aplicativos instale estes arquivos, utilize a opção Sistema de Arquivos Remoto.
  2. Se estiver instalando um aplicativo da Web independente (WAR) ou um módulo SIP (Session Initiation Protocol) (SAR), especifique a raiz de contexto do arquivo WAR ou SAR.

    A raiz de contexto é combinada com o mapeamento de servlet definido (do arquivo WAR) para compor a URL completa que os usuários digitam para acessar o servlet. Por exemplo, se a raiz de contexto for /gettingstarted e o mapeamento de servlet for MySession, a URL será http://host:port/gettingstarted/MySession.

  3. Clique em Avançar para exibir um assistente para atualizar os arquivos de aplicativos. O assistente de atualização, que é semelhante ao assistente de instalação, fornece campos para a especificação ou edição de informações sobre ligação de aplicativo. Conclua as etapas no assistente de atualização conforme necessário.

Quando todo o aplicativo estiver atualizado, o aplicativo antigo será desinstalado e o novo aplicativo será instalado. Quando as alterações na configuração forem salvas e, em seguida, sincronizadas, os arquivos de aplicativo serão expandidos no nó em que o aplicativo for executado. Se o aplicativo estiver em execução no nó durante sua atualização, o aplicativo será parado, os arquivos de aplicativo serão atualizados e o aplicativo será iniciado.

Substituir ou incluir um único módulo

Em Opções de Atualização do Aplicativo, especifica para substituir um módulo ou incluí-lo em um aplicativo instalado.

O módulo pode ser um módulo da Web (arquivo .war), módulo enterprise bean (arquivo .jar EJB), módulo SIP (arquivo .sar) ou módulo do adaptador de recursos (arquivo .rar do conector).

Depois de selecionar esta opção, especifique se o módulo está em um sistema de arquivos local ou remoto e o nome completo do caminho do módulo. O caminho fornece o local do módulo atualizado antes da instalação. Para obter informações sobre Sistema de Arquivos Local e Sistema de Arquivos Remoto, consulte a descrição anterior de Substituir o aplicativo inteiro.

Para substituir um módulo, o caminho relativo especificado (URI do módulo) deve corresponder ao caminho do módulo a ser atualizado no aplicativo instalado.

Para incluir um novo módulo no aplicativo instalado, o caminho relativo especificado não deve corresponder ao caminho de um módulo no aplicativo instalado. O valor especifica o caminho desejado para o novo módulo.

Se você estiver instalando um módulo da Web ou SIP independente, especifique um valor para Raiz de contexto. A raiz de contexto é combinada com o mapeamento de servlet definido (no arquivo .war) para compor a URL completa que os usuários digitam para acessar o servlet. Por exemplo, se a raiz de contexto for /gettingstarted e o mapeamento de servlet for MySession, a URL será http://host:port/gettingstarted/MySession.

Em seguida, especifique se serão mostradas somente as opções de instalação que requerem o fornecimento de informações ou todas as opções de instalação.

Depois de especificar as informações requeridas no módulo, clique em Avançar para exibir um assistente para atualizar os arquivos de aplicativo. O assistente de instalação, que é semelhante ao assistente de instalação, fornece campos para especificação ou edição de informações de ligação do módulo. Conclua as etapas no assistente de atualização conforme necessário.

Depois que um único módulo for incluído ou atualizado, quando as alterações na configuração forem salvas, o módulo novo ou atualizado será armazenado no aplicativo implementado no repositório de configuração do produto. Quando estas alterações forem sincronizadas com o nó, o módulo será incluído ou atualizado no sistema de arquivos do nó. Se o aplicativo estiver em execução no nó quando o módulo for incluído ou atualizado, ocorrerá uma das seguintes situações:
  • Para atualizações em um módulo da Web, o módulo da Web em execução será parado, os arquivos de módulo da Web serão atualizados e, em seguida, o módulo da Web será iniciado.
  • Para inclusões de módulos, o módulo incluído será iniciado nos servidores de aplicativos nos quais o aplicativo está em execução, após sua expansão no nó. Não é necessário reiniciar um aplicativo.
  • Se a Política do Carregador de Classe para o aplicativo estiver definida como Única para que todos os módulos compartilhem um carregador de classes, todo o aplicativo será parado e reiniciado para as alterações de nível do módulo.
  • Se o provedor de segurança configurado com o produto não suportar atualizações dinâmicas, todo o aplicativo será parado e reiniciado para as alterações de nível do módulo.
  • Para todas as demais atualizações em um módulo, todo o aplicativo será parado, os arquivos do módulo serão atualizados e, em seguida, todo o aplicativo será iniciado.
Substituir ou incluir um único arquivo

Em Opções de Atualização do Aplicativo, especifica para substituir um arquivo ou incluí-lo em um aplicativo instalado.

Utilize essa opção para atualizar um arquivo utilizado pelo aplicativo que não seja um arquivo .ear, .war, .sar, .rar ou, em alguns casos, .jar. Você pode utilizar essa opção para incluir ou atualizar arquivos .jar que não são definidos como módulos no aplicativo. Para atualizar um arquivo .ear, utilize a opção Substituir o aplicativo inteiro Para atualizar um arquivo .war, .sar, .rar ou .jar definido como um módulo no aplicativo, utilize a opção Substituir ou incluir um único módulo.

Depois de selecionar esta opção, especifique se o arquivo está em um sistema de arquivos local ou remoto e o nome completo do caminho do arquivo. O caminho fornece o local do arquivo atualizado antes da instalação. Para obter informações sobre Sistema de Arquivos Local e Sistema de Arquivos Remoto, consulte a descrição de Substituir o aplicativo inteiro.

Para o caminho relativo (módulo URI), especifique um caminho relativo para o arquivo que inicia a partir da raiz do arquivo .ear. Por exemplo, se o arquivo estiver localizado em com/company/greeting.class no módulo hello.jar, especifique um caminho relativo de hello.jar.

Para substituir um arquivo, o caminho relativo deve corresponder ao caminho relativo do arquivo a ser atualizado no aplicativo instalado.

Para incluir um novo arquivo no aplicativo instalado, o caminho relativo não deve corresponder a um arquivo já existente no aplicativo instalado. O valor especifica o caminho desejado para o novo arquivo.

Após você especificar o sistema de arquivos e os caminhos relativos, clique em Avançar.

Depois que um único arquivo for incluído ou atualizado, quando as alterações na configuração forem salvas, o arquivo novo ou atualizado será armazenado no aplicativo implementado no repositório de configuração do produto. Quando estas alterações forem sincronizadas com o nó, o arquivo será incluído ou atualizado no sistema de arquivos do nó. Se o aplicativo estiver em execução no nó quando o arquivo for incluído ou atualizado, ocorrerá uma das seguintes situações:
  • Quando os arquivos forem incluídos no escopo de metadados do aplicativo (diretório META-INF) ou atualizados no escopo de qualquer aplicativo ou em módulos não-Web, todo o aplicativo será parado, o arquivo será incluído ou atualizado e, em seguida, todo o aplicativo será reiniciado.
  • Quando os arquivos forem incluídos no escopo de não-metadados do aplicativo (fora do diretório META-INF mas não em qualquer módulo), as alterações serão salvas no sistema de arquivos sem reiniciar o aplicativo em execução.
  • Quando os arquivos forem incluídos ou atualizados para metadados do módulo da Web (diretório META-INF ou WEB-INF), o módulo da Web em execução será parado, o arquivo do módulo da Web será incluído ou atualizado e, em seguida, o módulo da Web será iniciado.
  • Para todos os demais arquivos em módulos da Web, o arquivo será incluído ou atualizado no sistema de arquivos do nó, sem parar o aplicativo ou qualquer um de seus componentes.
Substituir, incluir ou excluir vários arquivos

Em Opções de Atualização do Aplicativo, especifica para atualizar vários arquivos de um aplicativo instalando fazendo upload de um arquivo compactado. Dependendo do conteúdo do arquivo compactado, uma única utilização dessa opção pode substituir arquivos, incluir novos arquivos e excluir arquivos do aplicativo instalado. Cada entrada no arquivo compactado é tratada como um único arquivo e o caminho do arquivo na raiz do arquivo compactado é tratado como o caminho relativo do arquivo no aplicativo instalado.

Depois de selecionar esta opção, especifique se o arquivo compactado está em um sistema de arquivos local ou remoto e o nome completo do caminho do arquivo compactado. Provavelmente, você utilizará Sistema de arquivos local porque está fazendo upload de um arquivo compactado e a procura remota funciona apenas para arquivos .ear, .sar, .war ou .jar. Especifique um formato de arquivo compactado válido, como .zip ou .gzip. O caminho fornece o local do arquivo compactado antes da instalação. Essa opção descompacta o arquivo compactado no diretório do aplicativo instalado.

Utilize Sistema de Arquivos Local se o navegador e os arquivos atualizados ou módulos estiverem na mesma máquina, independentemente de o servidor também estar nessa máquina. Sistema de Arquivos Local está disponível para todas as opções de atualização.

Para substituir um arquivo, um arquivo do arquivo compactado deve ter o mesmo caminho relativo que o arquivo a ser atualizado no aplicativo instalado.

Para incluir um novo arquivo no aplicativo instalado, um arquivo do arquivo compactado deve ter um caminho relativo diferente do que os arquivos do aplicativo instalado.

O caminho relativo para um arquivo no aplicativo instalado é formado pela concatenação do caminho relativo do módulo (se o arquivo estiver dentro de um módulo) e o caminho relativo do arquivo da raiz do módulo separado por /.

Para remover um arquivo do aplicativo instalado, especifique os metadados no arquivo compactado utilizando um arquivo denominado META-INF/ibm-partialapp-delete.props em qualquer escopo de archive. O arquivo ibm-partialapp-delete.props deve ser um arquivo ASCII que lista arquivos a serem excluídos desse archive com uma entrada para cada linha. A entrada pode conter um padrão de cadeia, como uma expressão regular que identifica vários arquivos. Os caminhos de arquivo para os arquivos a serem excluídos devem ser relativos ao caminho do archive que tem o arquivo META-INF/ibm-partialapp-delete.props.
Nível de Arquivos a Serem Excluídos Arquivo .props de metadados a ser incluído no arquivo compactado
Aplicativo Inclua META-INF/ibm-partialapp-delete.props no arquivo compactado. No arquivo .props de metadados, liste arquivos a serem excluídos. Os caminhos de arquivos são relativos ao local do arquivo META-INF/ibm-partialapp-delete.props.

Por exemplo, para excluir um arquivo denominado utils/config.xmi da raiz do arquivo my.ear, inclua a linha utils/config.xmi no arquivo META-INF/ibm-partialapp-delete.props.

Módulo Inclua module_uri/META-INF/ibm-partialapp-delete.props no arquivo compactado.

Para excluir um arquivo de um módulo, inclua o caminho de arquivo no módulo no arquivo de metadados .props. Por exemplo, para excluir a/b/c.jsp do módulo my.jar, inclua a/b/c.jsp no arquivo my.jar/META-INF/ibm-partialapp-delete.props, no arquivo compactado.

Para excluir vários arquivos em um módulo, liste os arquivos a serem excluídos no arquivo de metadados .props com uma entrada em cada linha. Por exemplo, para excluir todos os JavaServer Pages (arquivos .jsp) do arquivo my.war, inclua a linha .*jsp no arquivo my.war/META-INF/ibm-partialapp-delete.props. A linha utiliza uma expressão comum, .*jsp, para identificar todos os arquivos .jsp em my.war.

É possível utilizar um único arquivo de aplicativo parcial para incluir, excluir e atualizar vários arquivos.

Após especificar um caminho do sistema de arquivos, clique em Avançar.

Após uma atualização de aplicativo parcial, quando as alterações de configuração forem salvas, o arquivo de aplicativo novo ou atualizado é armazenado no aplicativo implementado no repositório de configuração do WebSphere Application Server. Quando estas alterações forem sincronizadas com o nó, os arquivos serão incluídos ou atualizados no sistema de arquivos do nó. Como a opção de aplicativo parcial atualiza vários arquivos, os componentes de aplicativo reiniciados serão determinados utilizando utilizando arquivos individuais no aplicativo parcial.

Exemplo

Um exemplo de entradas em um arquivo compactado de aplicativo parcial é apresentado a seguir:

util.jar
META-INF/ibm-partialapp-delete.props
foo.jar/com/mycomp/xyz.class
xyz.war/welcome.jsp
xyz.war/WEB-INF/web.xml
webmod.war/META-INF/ibm-partialapp-delete.props

Para este exemplo, o arquivo META-INF/ibm-partialapp-delete.props contém os arquivos .*.dat e tools/test.jar. O arquivo webmod.war/META-INF/ibm-partialapp-delete.props contém os arquivos com/test/.*.jsp e WEB-INF/test.xmi.

A opção de atualização de aplicativo parcial faz o seguinte:
  • Inclui ou substitui util.jar no aplicativo implementado.
  • Inclui ou substitui com/mycomp/xyz.class no arquivo foo.jar do aplicativo implementado.
  • Exclui arquivos *.dat do aplicativo, mas não exclui de nenhum dos módulos.
  • Exclui tools/test.jar do aplicativo.
  • Inclui ou substitui welcome.jsp no módulo xyz.war do aplicativo implementado.
  • Substitui WEB-INF/web.xml no módulo xyz.war do aplicativo implementado.
  • Exclui com/test/*.jsp do módulo webmod.war.
  • Exclui WEB-INF/test.xmi do módulo webmod.war.

Escape os metacaracteres de expressão regular no arquivo META-INF/ibm-partialapp-delete.props. Por exemplo, para excluir classes internas de uma classe chamada Abc, use a expressão regular Abc\$.*, em que $ é um metacaractere de expressão regular que é escapado com uma barra invertida (\).

Um arquivo META-INF/ibm-partialapp-delete.props pode conter o seguinte texto:

.*.dat

webmod.war/META-INF/ibm-partialapp-delete.props:
com/test/.*.jsp
WEB-INF/test.xmi



Links marcados (on-line) requerem acesso à Internet.

Conceitos relacionados
Tarefas relacionadas
Referências relacionadas
Coleção de Aplicativos Corporativos


Nome do arquivo: urun_rapp_update.html