FileNet P8 Application Engine, Versão 5.2.1              

Preparando-se para o Upgrade do Application Engine

Antes de fazer o upgrade da instalação do Application Engine, você deve preparar sua configuração existente para o upgrade. Essa preparação inclui o backup de arquivos existentes e a remoção da implementação do seu aplicativo da Web.

Sobre Esta Tarefa

  • Revise os detalhes do Application Engine do guia Plan and Prepare Your Environment for IBM FileNet P8.
  • Revise as etapas necessárias para reter a configuração do Application Engine 3.5 ou 4.0.1. Você vai precisar dessas informações se, por algum motivo, quiser retornar dessa instalação.
  • Verifique se você registrou todas as configurações necessárias.

    (Melhores práticas para backup) Se quiser reter suas configurações existentes do Application Engine, você deverá registrar todas as configurações necessárias antes de iniciar a instalação do upgrade.

    • Como parte do upgrade, você vai criar cópias de backup de todos os arquivos de configuração importantes da 3.5 ou 4.0.1.
    • Durante o upgrade, inúmeros arquivos de configuração existentes serão movidos para o diretório AE_install_path/Config/AE recém criado. High availabilityEm ambientes altamente disponíveis, é necessário copiar esses arquivos de configuração para o diretório de configuração compartilhado, se estiver usando um.
    • Como parte do upgrade, o programa de instalação cria automaticamente um backup dos arquivos de configuração existentes do Application Engine 3.5 ou 4.0.1, anexando o sufixo .old aos nomes dos arquivos.
    • Os arquivos Actions.xml e web.xml da versão 3.5 ou 4.0.1 existente serão mesclados com as versões 4.0.2 durante o upgrade.
    • Além disso, todos os comentários incluídos no arquivo Actions.xml serão perdidos durante a mesclagem.
  • Se você tiver o produto de expansão IBM® FileNet P8 eForms instalado, desinstale-o.

Consulte o tópico sobre a remoção do software no IBM FileNet P8 eForms Installation and Upgrade Guide.

High availabilityImportante: Em um ambiente de servidor com cluster altamente disponível, é necessário executar as etapas em todos os nós no seu cluster.
Para se preparar para o upgrade do Application Engine:

Procedimento

  1. Efetue logon no servidor Application Engine:
    Opção Descrição
    AIX, HPUX, Linux, Linux em System z, Solaris Efetue logon como um usuário com acesso de leitura, gravação e execução no diretório em que planeja instalar o Application Engine.
    Windows Efetue logon como um membro do Grupo de administradores locais ou como um usuário com permissões equivalentes.
  2. (Windows) Usando o Windows Task Manager, verifique se nenhum processo javaw.exe está sendo executado. Se os aplicativos nas etapas anteriores foram interrompidos corretamente, nenhum processo javaw.exe relacionado ao Application Engine deve estar em execução.
    1. Use os Serviços do Windows para parar o Servidor do Gerenciador de Serviços Application Engine de Processo. Selecione Iniciar > Programas > Ferramentas Administrativas > Serviços. Se o status do Gerenciador de Serviços do Application Engine do Processo for iniciado, clique com o botão direito do mouse no item e clique em Parar.
    2. Se ainda houver processos javaw.exe sendo executados depois de parar o Gerenciador de Serviços do Application Engine de Processo, use o Windows Task Manager para parar qualquer processo javaw.exe relacionado ao Application Engine.
  3. Faça backup, remova a implementação e remova o aplicativo da web Workplace do servidor de aplicativo Java™ EE.

    Durante essa etapa, você vai criar uma cópia de backup do aplicativo da Web implementado contendo todos os arquivos customizados e todos os arquivos de configuração armazenados no diretório WEB-INF.

    Mesmo que o instalador crie automaticamente um backup dos seus arquivos de configuração existentes do Application Engine 3.5 ou 4.0.1, a melhor prática é fazer backup dos seguintes diretórios para se obter um backup completo do sistema implementado. Talvez você precise desses arquivos em etapas posteriores para reter suas configurações da 3.5 ou 4.0.1. Por exemplo, quando você copiar arquivos modificados no diretório do Workplace instalado e executar o upgrade e a configuração do Application Engine,

    Opção Descrição
    WebSphere Application Server
    1. Faça uma cópia de backup do diretório do Workplace implementado (deploy_backup): WAS_HOME/profiles/default/installedApps/node_name/app_engine_war.ear/app_engine.war

      Seu caminho pode variar se você criou um novo perfil ou renomeou seu arquivo WAR.

    2. Pare o aplicativo Workplace a partir do console administrativo do WebSphere.
    3. Desinstale o aplicativo do Workplace de Enterprise Applications.
    4. Salve as mudanças e pare a instância do WebSphere Application Server.
    5. Exclua o diretório temporário do Workplace (padrão: app_engine_war) de: WAS_HOME/profiles/default/temp/node_name/instance/app_engine.war
    WebLogic Server
    1. No Console Administrativo do WebLogic Server, pare o módulo do aplicativo da Web do Workplace.
    2. Faça uma cópia de backup da pasta do Workplace (deploy_backup): AE_install_path/Workplace
    3. Exclua o módulo Aplicativo da Web do Workplace.
    4. Pare a instância do WebLogic Server.
    JBoss Application Server
    1. Pare a instância do JBoss Application Server.
    2. Faça uma cópia de backup do diretório do Workplace implementado (deploy_backup): JBoss_HOME/server/default/deploy/Workplace.war
    3. Exclua o diretório do Workplace implementado: JBoss_HOME/server/default/deploy/Workplace.war
    4. Exclua o diretório do Workplace temporário para JBoss: JBoss_HOME/server/default/work/jboss.web/localhost/Workplace
  4. Copie os arquivos modificados no diretório do Workplace instalado. Durante o upgrade, os arquivos de configuração serão movidos para o seguinte diretório:

    AE_install_path/Workplace/WEB-INF

    para

    AE_install_path/Config/AE

    Se você tiver feito modificações em qualquer um desses arquivos diretamente no diretório do Workplace implementado (app_engine.war para WebSphere Application Server ou Workplace.war para JBoss) no ambiente 3.5. ou 4.0.1, será necessário copiar a versão modificada desses arquivos do diretório deploy_backup no diretório instalado AE_install_path/Workplace/WEB-INF antes de você executar o instalador.
    • actions.xml
    • bootstrap.properties
    • ClassFilter.xml
    • ConfigurableLabels.xml
    • containericons.properties
    • content_redir.properties
    • customobjecticons.properties
    • download_redir.properties
    • fnsoap.xml
    • icons.properties
    • InfoPages.xml
    • PagingConfiguration.xml
    • PolicyProcessors.xml
    • PrimaryViews.xml
    • PropertiesPages.xml
    • SimpleSearch.xml
    • SystemsPropertiesView.xml
    Como parte do upgrade, o programa de instalação cria automaticamente um backup dos arquivos de configuração existentes do Application Engine 3.5 ou 4.0.1, anexando o sufixo .old aos nomes dos arquivos.
    • actions.xml.old
    • ClassFilter.xml.old
    • ConfigurableLabels.xml.old
    • containericons.properties.old
    • content_redir.properties.old
    • icons.properties.old
    • SystemsPropertiesView.xml.old
    • UpdateActions.xml.old
    • UpdateClassFilter.xml.old
    • UpdateConfigurableLabels.xml.old
    • UpdateProps.xml.old
    • UpdateSystemPropertiesView.xml.old
    • UpdateWeb.xml.old
    • web.xml.old

    Os arquivos de backup estão localizados em: AE_install_path/backup-4_0_2

  5. High availabilitySe estiver fazendo upgrade em um ambiente de alta disponibilidade, execute as seguintes etapas de backup adicionais:
    • Faça backup do arquivo bootstrap.properties compartilhado no local de rede compartilhado.
    • Copie todos os arquivos de configuração para o diretório de configuração compartilhado, se estiver usando um.
    • (Somente upgrades do Application Engine 3.5) Um diretório de configuração compartilhado será criado abaixo do local original do arquivo bootstrap.

      Exemplo: Se o seu local de autoinicialização compartilhado do 3.5.x era Z: o diretório de configuração compartilhado recentemente criado seráZ:\AE\.



Última atualização: Outubro de 2015
p8pup068.htm

© Copyright IBM Corporation 2013, 2015.