FileNet P8 Application Engine, Versão 5.0.+              

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.

Consulte o tópico "Removendo Software" no IBM FileNet P8 eForms Installation and Upgrade Guide.

High availability Importante: 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:
  1. Efetue logon no servidor Application Engine:
    Opção Descrição
    UNIX 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. (Upgrades apenas da 3.5) Verifique se o Roteador de Processo foi interrompido.
    Dica: Embora o roteador do Application Engine tenha sido excluído como parte do upgrade do Process Engine, uma instância desconectada local pode estar em execução no seu servidor.
    1. Ative o Gerenciador de Tarefas do Processo em AE_install_path/Router :
      UNIX
      ./routercmd.sh
      Windows
      routercmd.bat
    2. Pare o roteador se ele estiver em execução.

      Esse é o roteador configurado e iniciado como parte da instalação do FileNet P8 Platform 3.5. Para obter mais informações, consulte a tarefa "Iniciar o Roteador de Processo" do Guia de Instalação e Upgrade do IBM FileNet P8 Platform 3.5.

    3. Saia do Gerenciador de Tarefas do Processo.
  3. (Windows) Utilizando o Gerenciador de Tarefas do Windows, verifique se nenhum processo javaw.exe está em execução. Se os aplicativos nas etapas anteriores foram interrompidos corretamente, nenhum processo javaw.exe relacionado ao Application Engine deve estar em execução.
    1. Utilize os Serviços do Windows para parar o Serviço do Gerenciador de Serviços do Application Engine do 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 em execução após a interrupção do Gerenciador de Serviços do Application Engine do Processo, utilize o Gerenciador de Tarefas do Windows para parar quaisquer processos javaw.exe relacionados ao Application Engine.
  4. Faça backup, remova a implementação e remova o aplicativo da Web do Workplace do servidor de aplicativos J2EE.

    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 o 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 o WebLogic Server.
    JBoss Application Server
    1. Pare o 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
  5. 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

  6. High availability Se estiver fazendo upgrade em um ambiente altamente disponível, execute as seguintes etapas de backup adicionais:
    • Faça o 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\.



Feedback

Última atualização: novembro de 2010


© Copyright IBM Corporation 2010.
Este centro de informações foi desenvolvido com a tecnologia Eclipse. (http://www.eclipse.org)