FileNet P8 Content Engine, Versão 5.0.+              

Configurando Instâncias com Upgrade Utilizando a Linha de Comandos

É possível configurar uma instância do Content Engine com upgrade em um servidor de aplicativo da Web utilizando a versão de linha de comandos do Configuration Manager.

Certifique-se de ter as contas necessárias e as permissões apropriadas antes de começar.

Para configurar a instância do Content Engine com upgrade:

  1. Efetue logon na máquina onde o Content Engine está instalado como config_mgr_user, que é o usuário do Configuration Manager.
  2. Altere o diretório atual para ce_install_path/tools/configure, em que ce_install_path é o caminho onde você instalou o Content Engine.

    Por exemplo, ce_install_path pode ser /opt/FileNet/ContentEngine.

  3. Em um prompt de comandos, execute o comando generateupgrade para gerar o perfil do upgrade. Insira o comando em uma linha sem quebras de linha.
    configmgr_cl generateupgrade [-appserver
    app_server_type] -server
    server_name
     [-deploy deploy_type] -profile
    myprofile [-silent] [-force] [-help]

    Em que:

    -appserver appserver_type
    O parâmetro -appserver appserver_type só será necessário se o arquivo ce_install_path/Servers.xml não existir ou não contiver nenhum servidor. Esse parâmetro especifica o tipo de servidor de aplicativos e deve ter um dos seguintes valores: WebSphere, WebLogic ou JBoss.
    -server server_name
    O parâmetro -server server_name indica o servidor para o qual criar o perfil de upgrade. Utilize o comando listservers para exibir uma lista de valores válidos de server_name antes de você executar o comando generateupgrade.
    -deploy deploy_type
    O parâmetro -deploy deploy_type só será necessário se o arquivo ce_install_path/Servers.xml não existir ou não contiver o tipo de implementação para o servidor selecionado. Esse parâmetro especifica o tipo de implementação do Content Engine. Se um valor para o tipo de implementação existir no arquivo Servers.xml para o servidor selecionado, o valor do arquivo Servers.xml será utilizado no lugar do valor que você especificar na linha de comandos.

    Selecione um dos seguintes valores: standard, cluster ou netdeploy (implementação de rede).

    Especifique standard se estiver implementando o Content Engine em um WebSphere Application Server, Oracle WebLogic Server ou JBoss Application Server independente (ou seja, um servidor que não é gerenciado e nem armazenado em cluster).

    Especifique cluster se estiver implementando o Content Engine em um cluster WebSphere Application Server, Oracle WebLogic Server ou JBoss Application Server

    Especifique netdeploy se estiver implementando o Content Engine em uma instância do WebSphere Application Server gerenciada. Ou seja, você está utilizando o Network Deployment para gerenciar servidores individuais que não estão necessariamente em um cluster.

    -profile myprofile
    O parâmetro -profile myprofile especifica o perfil a ser utilizado. O valor de myprofile pode ser um dos seguintes itens:
    • O nome do perfil, como ce_was_tiv_db2. O perfil deve estar localizado no diretório ce_install_path/tools/configure/profiles, em que ce_install_path é o local em que o software Content Engine está instalado.
    • O caminho absoluto para o diretório de perfil, tais como "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" ou opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2.
    • O caminho absoluto para o arquivo de entrada do perfil, como "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" ou opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfg.
    Lembre-se: Se o caminho incluir um nome de diretório com espaços, coloque o caminho inteiro entre aspas. Por exemplo, insira "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg".
    -silent
    O parâmetro -silent é opcional. Quando -silent é especificado, nenhum prompt ou mensagem informativa é exibido no console, mas os erros são gravados no log. Mensagens de falha e mensagens de erro de validação são exibidas conforme necessário, como mensagens sobre ausência de senhas ou números de porta inválidos. Se você executar o comando execute para executar todas as tarefas em um perfil, e especificar o parâmetro -silent, você também deverá especificar o parâmetro -force.
    -help
    O parâmetro -help é opcional e exibe uma pequena mensagem na sintaxe de comando em vez de executar o comando.

    O arquivo upgrade.xml e um diretório nomeado para cada instância do Content Engine existente são criados no diretório de perfil.

    Importante: Se o comando generateupgrade retornar uma mensagem informando que um perfil de upgrade já existe, vá para 4.
  4. (Apenas IBM® WebSphere Application Server ou Oracle WebLogic Server) Configure as propriedades de administrador do servidor de aplicativos:
    1. Navegue para o diretório myprofile/mycontent_engine_instance.
    2. Abra o arquivo applicationserver.xml em um editor de texto.
    3. Configure o valor para a propriedade ApplicationServerAdminUsername.
      <propertyname="ApplicationServerAdminUsername">
      	<value>administrator_user_name
      </value>
      </property>
    4. Salve suas mudanças e feche o arquivo.
    5. Execute o comando storepasswords, que solicita que você (respondendo com yes ou no) escolha se deseja criptografar e armazenar a senha do administrador do servidor de aplicativo da Web para o arquivo applicationserver.xml. Se você optar por não salvar a senha, será necessário editar applicationserver.xml especificando o texto não criptografado da senha para a propriedade ApplicationServerAdminPassword.
      configmgr_cl storepasswords -profile
      myprofile
      Dica: Se o comando storepasswords solicitar que você armazene senhas nos arquivos de configuração no disco, deverá responder a sim ou não (em vez de s ou n).
    6. Repita essa etapa conforme necessário para editar as propriedades do servidor de aplicativos para cada diretório de instâncias do Content Engine que foi criado.
  5. (Apenas WebSphere) Se você estiver fazendo upgrade do Content Engine a partir da versão 4.0.1 ou 4.5.0, em um prompt de comandos, execute o comando execute para configurar os módulos de login:
    configmgr_cl generateconfig -appserver
    app_server_type
     -repositorytype  ldap_repository_type -task
    configureloginmodules
     -profile myprofile

    Em que:

    -repositorytype ldap_repository_type
    WebSphere Application Server apenas. O parâmetro -repositorytype ldap_repository_type especifica o tipo de repositório LDAP a ser utilizado, que deve ser standalone ou federated.
  6. (Apenas JBoss) Se você estiver fazendo upgrade do Content Engine a partir da versão 4.0.1, 4.5.0 ou 4.5.1, em um prompt de comandos, execute o comando execute para configurar os módulos de login:
    configmgr_cl execute -task configureloginmodules
    -profile myprofile
  7. Em um prompt de comandos, execute o comando execute para configurar as propriedades de autoinicialização.
    configmgr_cl execute -task configurebootstrap -profile
    myprofile
    Mensagens de status são exibidas no console.
  8. Opcional: Em um prompt de comandos, verifique o status de conclusão da tarefa executando o comando checkStatus .
    configmgr checkStatus -task configurebootstrap -profile
    myprofile


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)