FileNet P8 Workplace XT, Versão 1.1.5              

Atualizando o Software do Workplace XT

Como parte da atualização do software do Workplace XT, você deve fazer backup e remover a implementação da instalação existente. Você poderá então executar o programa de configuração para atualizar o software.

Atenção: Para sites com instalações do IBM® Production Imaging Edition Viewer Pro : Se você quiser atualizar uma configuração do Workplace XT versão 1.1.4 para a versão 1.1.5, incluindo o software do Viewer Pro, deverá desinstalar o software, conforme documentado no Guia de Instalação, antes de executar o instalador do Workplace XT.
Importante: Em um ambiente de servidor com cluster altamente disponível, execute as etapas em todos os nós no seu cluster.
Para atualizar o software do Workplace XT:
  1. Efetue login no servidor de aplicativos no qual o Workplace XT está instalado.
    Opção Descrição
    UNIX Efetue login como um usuário com acesso de gravação ao diretório /bin e acesso de leitura, gravação e execução ao diretório no qual você planeja atualizar o Workplace XT.
    Windows Efetue login como membro do grupo Administradores local ou um usuário com permissões equivalentes.

    O caminho para o diretório de instalação é referido com a variável install_path nessa documentação. O valor padrão dessa variável depende da versão e do sistema operacional do host da instalação do produto:

    Versão 1.1.3.x e liberações anteriores
    UNIX: /opt/FileNet/WebClient
    Windows: C:\Program Files\FileNet\WebClient
    Versão 1.1.4.0 e liberações mais recentes
    UNIX: /opt/IBM/FileNet/WebClient
    Windows: C:\Program Files\IBM\FileNet\WebClient
    Dica: Embora o usuário de instalação do UNIX precise de acesso de gravação ao diretório /bin, o programa de instalação doWorkplace XT não grava nesse diretório.
  2. No Process Task Manager, pare o Component Manager (se estiver executando) e saia do aplicativo Process Task Manager.
  3. (Apenas Windows) No console de serviços do Windows, pare o serviço Process WPXT Services Manager.
  4. (Apenas Windows) Usando o Windows Task Manager, verifique se nenhum processo javaw.exe está em execução.

    Se os aplicativos nas etapas precedentes pararem corretamente, nenhum processo relacionado ao Workplace XT, javaw.exe, estará em execução. Se necessário, use o Windows Task Manager ou alguma outra ferramenta de gerenciamento de processo para parar todos os processos javaw.exe que estejam no caminho de diretório install_path\_WCjvm\bin.

  5. Faça backup, remova a implementação e remova o aplicativo da Web Workplace XT (web_client) do servidor de aplicativos J2EE.
    Opção Descrição
    WebSphere Application Server
    1. Faça backup do diretório de Workplace XT implementado:

      WAS_HOME/profiles/default/installedApps/node_name/WorkplaceXT.ear/application_name.war

    2. Pare o aplicativo Workplace XT do console de administração do WebSphere.
    3. Desinstale o aplicativo do Workplace XT de Enterprise Applications.
    4. Salve as mudanças e pare o servidor WebSphere.
    5. Exclua o diretório temporário de Workplace XT (padrão: WorkplaceXT) de:

      WAS_HOME/profiles/default/temp/node_name/instance/

    6. Exclua todas as pastas do diretório wstemp do seguinte local:

      WAS_HOME/profiles/profile_name/wstemp

    WebLogic Server
    1. A partir do console de administração do WebLogic Server, pare o Workplace XT Web Application Module.
    2. Faça uma cópia de backup da pasta do Workplace XT ou do diretório do Workplace XT implementado:
      • install_path/WorkplaceXT
      • install_path/deploy/application_name.war
      • install_path/deploy/web-client.ear

    3. Exclua o módulo Aplicativo da Web do Workplace XT.
    4. Pare o WebLogic Server.
    5. Exclua o diretório temporário de Workplace XT (padrão: WorkplaceXT ou web_client) de:
      WL_HOME/domain/servers/instance/tmp/_WL_usr
    JBoss Application Server
    1. Pare o servidor JBoss Application Server.
    2. Faça um backup do aplicativo Workplace XT implementado:

      JBOSS_HOME/server/server_name/deploy/application_name.war ou .ear

    3. Exclua o aplicativo Workplace XT do local implementado.
    4. Limpe todos os arquivos e pastas nos seguintes diretórios temporários:

      JBoss_home/server/server_name/tmp/deploy

      JBoss_home/server/server_name/work/jboss.web/localhost

  6. (Para sistemas com a preferência de site do IBM Content Manager OnDemand (CMOD) configurada) Mova o keystore do CMOD e altere o parâmetro de contexto keyStorePath no arquivo web.xml.
    1. Copie o arquivo de armazenamento de chaves do CMOD, cmodKeyStore. O local padrão está no seguinte caminho:

      install_path/WorkplaceXT/WEB-INF

    2. Coloque a cópia do arquivo cmodKeyStore no diretório Config/WebClient, no seguinte caminho:

      install_home/FileNet/Config/WebClient

      O caminho padrão para a variável install_home depende da versão do Workplace XT que você está atualizando e do seu sistema operacional:

      Versão 1.1.3.x e liberações anteriores
      UNIX: /opt
      Windows: C:\Program Files
      Versão 1.1.4.0 e liberações mais recentes
      UNIX: /opt/IBM
      Windows: C:\Program Files\IBM
    3. Altere o valor do parâmetro keyStorePath no arquivo web.xml para corresponder ao novo local do arquivo de armazenamento de chaves:
      <context-param>
      <param-name>keyStorePath</param-name>
      <param-value>install_home/FileNet/Config/WebClient/cmodKeyStore
      </param-value>
      </context-param>
  7. Opcional: Copie os arquivos de configuração existentes.

    Se você tiver feito mudanças customizadas em seus arquivos de configuração no local implementado, faça o seguinte antes de atualizar a instalação existente do Workplace XT.

    Copie os seguintes arquivos:
    • WcmApiConfig.properties
    • web.xml

    da pasta /WEB-INF no diretório do Workplace XT com backup criado na etapa anterior para o seguinte diretório:

    install_path/WorkplaceXT/WEB-INF/

  8. Apenas para atualizações do JBoss 4.x.x para JBoss 5.x.x: Se o Workplace XT tiver sido atualizado em um sistema que foi atualizado do JBoss 4.x.x para JBoss 5.x.x, edite o arquivo web.xml e copie um arquivo para install_path/WorkplaceXT/WEB-INF/ antes da implementação de Workplace XT usando JBoss 5.x.x.
    1. Digite as seguintes linhas no final da seção do listener correspondente do arquivo web.xml:
      <listener>
         <listener-class>com.sun.faces.config.ConfigureListener</listener-class> 
      </listener>
    2. Copie o arquivo jboss-classloading.xml no caminho FileNet/WebClient/jboss5 e coloque a cópia no diretório install_path/WorkplaceXT/WEB-INF/.
  9. Opcional: Instale o arquivo de licença do IBM Production Imaging Edition Viewer Pro. Se tiver adquirido o IBM Production Imaging Edition, o software do Viewer Pro poderá ser instalado quando você executar a instalação do Workplace XT.
    1. Para ativar a instalação do Viewer Pro, execute o instalador de licença antes de atualizar o Workplace XT. Inicie a instalação de licença do IBM Production Imaging Edition Viewer Pro de uma das seguintes formas, dependendo se deseja atualizar interativamente ou silenciosamente:
    Opção Descrição
    Para instalar a licença do IBM Production Imaging Edition Viewer Pro interativamente:
    1. Acesse o pacote de software de instalação de licença do IBM Production Imaging Edition Viewer Pro.
    2. Ative o programa de configuração adequado (PIEProLic-1.1.5.0-operating_system.bin ou .exe) e siga os avisos nas telas do assistente.
    Para instalar a licença do IBM Production Imaging Edition Viewer Pro silenciosamente:
    1. Acesse o pacote de software de instalação de licença do IBM Production Imaging Edition Viewer Pro e copie o arquivo PIEsilent_input.txt para um diretório local.
    2. Consultando os valores de sua planilha, acesse o pacote do IBM Production Imaging Edition Viewer Pro e edite o arquivo de entrada silencioso para refletir as respostas adequadas à sua instalação.

      Mesmo que você aceite todos os padrões no arquivo PIEsilent_input.txt, deve editar o arquivo para aceitar o contrato de licença (-V licenseAccepted="true").

    3. A partir de um prompt de comandos, navegue e execute o instalador:
      UNIX
      ./PIEProLic-1.1.5.0-operating_system.bin -options "path_to_edited_input_file/XT_silent_upgrade.txt" -silent
      Windows
      PIEProLic-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt" -silent

    Visualize o arquivo PIEPro_install_log.txt, localizado em install_path/IBM/FileNet/PIEProLicense. Corrija os erros ou falhas observados no arquivo de log antes de continuar com o upgrade do Workplace XT. Geralmente os problemas são registrados com o termo "ERROR" no início de uma linha.

    Nota: Para obter mais informações sobre o IBM Production Imaging Edition Viewer Pro, consulte Edição de Imagem de Produção no Web site da IBM.
  10. Inicie o processo de upgrade de uma das seguintes formas, dependendo se você deseja atualizar no modo interativo ou silencioso:
    Opção Descrição
    Para atualizar Workplace XT interativamente:
    1. Acesse o pacote de software de instalação do Workplace XT.
    2. Ative o programa de configuração adequado (WorkplaceXT-1.1.5.0-operating_system.bin ou .exe) e siga os avisos nas telas do assistente. O instalador detecta e copia as configurações da instalação anterior do Workplace XT.
    Para atualizar Workplace XT silenciosamente:
    1. Acesse o pacote de software de instalação do Workplace XT e copie o arquivo XT_silent_upgrade.txt para um diretório local.
    2. Siga as instruções no arquivo de entrada silencioso para editar os valores para refletir as respostas apropriadas para sua instalação.

      Mesmo que você aceite todos os padrões no arquivo XT_silent_upgrade.txt, deverá editar o arquivo para aceitar o contrato de licença (-V licenseAccepted="true").

    3. A partir de um prompt de comandos, navegue e execute o instalador:
      UNIX
      ./WorkplaceXT-1.1.5.0-operating_system.bin -options "path_to_edited_input_file/XT_silent_upgrade.txt" -silent
      Windows
      WorkplaceXT-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt" -silent
  11. Quando o programa de atualização estiver concluído, visualize o arquivo web_client_install_log_1.1.5.0.txt localizado em: install_path/FileNet/WebClient.

    Verifique se nenhum erro ou falha foi registrado. Corrija quaisquer erros antes de continuar.

  12. Opcional: Atualize os arquivos para suportar tokens do usuário do Workplace XT.

    Se os tokens do usuário estiverem ativados no sistema antes do upgrade e se você estiver usando a versão 4.5.1, 5.0 ou 5.1 do Content Engine, os arquivos authentication-websphere.jar e log4j-1.2.13.jar deverão ser novamente copiados. Consulte a seção adequada abaixo para configurar tokens do usuário e o local do qual esses arquivos são copiados:

    Opção Descrição
    WebSphere
    1. Copie o arquivo authentication-websphere.jar a partir de:

      install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

      para:

      WAS_home/AppServer/lib/ext

    2. Copie o arquivo log4j-1.2.13.jar a partir de:

      install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib

      para:

      WAS_home/AppServer/lib/ext

    WebLogic
    1. Copie o arquivo authentication-weblogic.jar a partir de:

      install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

      para:

      WL_home/server/lib/mbeantypes

    2. Copie o arquivo log4j-1.2.13.jar a partir de:

      install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib

      para:

      WL_home/server/lib/mbeantypes

    JBoss

    Copie o arquivo authentication-utils.jar a partir de:

    install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

    para:

    JBOSS_home/server/server_name/lib

  13. Apenas para upgrades do WebLogic versão 10.x para 11g: Configure as definições de cookie de sessão do WebLogic.
    1. Vá para o diretório install_path/FileNet/WebClient/WorkplaceXT/WEB-INF.
    2. Faça backup do arquivo weblogic.xml para weblogic.xml.bak.
    3. Copie o arquivo weblogic-11g.xml do diretório WebLogic_install_path/WebClient/weblogicFiles para o diretório WEB-INF no caminho de instalação do Workplace XT.
    4. Renomeie o arquivo weblogic-11g.xml para weblogic.xml. Copiar e renomear o arquivo weblogic-11g.xml para o novo local é necessário antes de implementar o Workplace XT usando o WebLogic 11g.


Feedback

Última atualização: Março de 2013
wxtut003.htm

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