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.
- Clique em .
- Selecione o aplicativo ou módulo instalado que deseja atualizar.
- Clique em Atualizar.
Aplicativo a ser atualizado
Especifica o nome do aplicativo instalado (ou implementado) selecionado 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:
- 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 você 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. - Se você estiver instalando um aplicativo da Web independente (WAR) ou um módulo Session Initiation Protocol (SIP) (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.
- 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.
- 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. É possível 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 especificado não deve corresponder ao caminho relativo de 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.
- 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 desta 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. O caminho fornece o local do arquivo compactado antes da instalação. Essa opção extrai 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 no 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 no arquivo compactado deve ter um caminho relativo diferente dos arquivos no 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 /.
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.
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.
- 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 usado com um caractere de escape de 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