Etapas Manuais para Configuração de Failover do Essbase no Nó Principal (Host 1)

Dica: para a Versão 21.5.2 ou posterior, ignore essas instruções e use as instruções em Configurar um Ambiente de Failover do Essbase Usando o Script de Configuração de Failover.

Configure o nó principal do Essbase para failover. Você executará o assistente de configuração do Fusion Middleware, editará arquivos de script, adicionará propriedades de configuração do Essbase, configurará servidores na Console do WebLogic, executará o utilitário de ferramentas TLS, compactará a configuração do domínio e a copiará para o segundo nó.

Antes de começar, verifique Configurar TLS para Failover do Essbase para saber como configurar o arquivo de propriedades do TLS.

O Host 1 é o nó principal do Essbase e tem todos os serviços não agrupados (como AdminServer).

  1. SSH para o Host 1 e interrompa a instância do Essbase:

    No Linux:

    <Domain Home>/esstools/bin/stop.sh

    No Windows:

    <Domain Home>\esstools\bin\stop.cmd

  2. Inicie o assistente de configuração do Fusion Middleware e atualize a configuração no Host 1:

    No Linux:

    <Oracle Home>/oracle_common/common/bin/config.sh

    No Windows:

    <Oracle Home>\oracle_common\common\bin\config.cmd

    1. Na tela Criar Domínio, selecione Atualizar um domínio existente. Certifique-se de que a localização correta do domínio esteja especificada no campo Local do Domínio e clique em Próximo.

    2. Na tela Modelos, aceite os padrões e clique em Próximo.

    3. Na tela Tipo de Configuração do Banco de Dados, altere a seleção de Dados da RCU para Configuração Manual e clique em Próximo.

    4. Na tela Origens de Dados do Componente, aceite os padrões e clique em Próximo.

    5. Na tela Teste JDBC, aceite os padrões e clique em Próximo.

    6. Na tela Configuração Avançada, selecione Topologia e clique em Próximo.

    7. Na tela Servidores Gerenciados, clique em Adicionar e informe os detalhes do Host 2.

      • Informe as portas do servidor gerenciado para essbase_server2.

      • Marque a caixa de seleção Ativar SSL se precisar atualizar a Porta de Listening SSL.

      • Para atualizar a Porta do Listener SSL, clique na caixa de entrada Porta do Listener. Selecione os grupos de servidores como ESSBASE-MAN-SVR e clique em Próximo.

    8. Aceite os padrões e clique em Próximo nas seguintes telas:
      • Clusters
      • Modelos de Servidor
      • Servidores Dinâmicos
      • Designar Servidores aos Clusters
      • Aplicativos Proxy HTTP
      • Clusters do Coherence

    9. Na tela Máquinas, clique em Adicionar e adicione uma nova máquina, m2. Informe o nome do host do Host 2 e os valores da porta do Gerenciador de Nós. Você pode escolher a porta do Gerenciador de Nós, 9556. Clique em Próximo.

    10. Na tela Atribuir Servidores a Máquinas, selecione m2 no painel direito. Selecione o servidor recém-criado, essbase_server2 no painel esquerdo e adicione-o ao m2. Depois de adicioná-lo, essbase_server2 é exibido em m2. Clique em Avançar.

    11. Aceite os padrões e clique em Próximo nas seguintes telas:

      • Alvos Virtuais
      • Partições

    12. Na tela Resumo da Configuração, clique em Atualizar.

    13. Quando a atualização estiver concluída, clique em Próximo e, na última tela, clique em Finalizar para concluir as alterações de configuração.

  3. No Host 1, edite o arquivo <Domain Home>/bin/setDomainEnv.sh (no Linux) ou <Domain Home>\bin\setDomainEnv.cmd (no Windows).

    Atenção:

    A plataforma Essbase inclui scripts no <DOMAIN HOME>/bin que podem personalizar o ambiente e os comportamentos da funcionalidade do Essbase. No entanto, fazer alterações nesses scripts de ambiente de domínio ou inicialização pode ter efeitos indesejados, incluindo falha na inicialização. A Oracle recomenda fazer alterações em um ambiente de teste primeiro. Antes de editar esses scripts, sempre:

    1. Interrompa os servidores gerenciados do Essbase, usando <DOMAIN HOME>/esstools/bin/stop.sh (no Linux) ou <DOMAIN HOME>\esstools\bin\stop.cmd (no Windows).

    2. No <DOMAIN HOME>/bin, faça uma cópia de backup do arquivo que você deseja editar. Por exemplo,

      No Linux

      cp setStartupEnv.sh setStartupEnv_bak.sh

      No Windows

      copy setStartupEnv.cmd setStartupEnv_bak.cmd

    3. Edite cuidadosamente, usando apenas as instruções documentadas da Oracle ou trabalhando com o Suporte Técnico da Oracle.

    4. Reinicie o Essbase, usando <DOMAIN HOME>/esstools/bin/start.sh (no Linux) ou <DOMAIN HOME>\esstools\bin\start.cmd (no Windows). Verifique se a inicialização foi concluída normalmente.

    1. Procure a string EXTRA_JAVA_PROPERTIES.

      Importante: procure EXTRA_JAVA_PROPERTIES, não JAVA_PROPERTIES.

    2. Adicione a seguinte definição -D após a linha EXTRA_JAVA_PROPERTIES de exportação existente:

      No Linux:

      EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}-Dweblogic.security.SSL.ignoreHostnameVerification=true" export EXTRA_JAVA_PROPERTIES

      No Windows:

      set EXTRA_JAVA_PROPERTIES=-Dweblogic.security.SSL.ignoreHostnameVerification=true %EXTRA_JAVA_PROPERTIES%

      Observação:

      Esta etapa não será necessária se todos os certificados TLS forem importados corretamente. No caso de certificados autoassinados ou se o servidor gerenciado falhar posteriormente ao iniciar com erros SSL, essa etapa será obrigatória.

  4. Edite o arquivo, <Domain Home>/config/fmwconfig/essconfig/essbase/essbase.cfg, e adicione as seguintes linhas:

    FALHAMENTO verdadeiro

    #Opcional

    TEMPO DE RENOVAÇÃO DO AGENTE 10

    #Opcional

    AGENTLEASEEXPIRATIONTIME 20

  5. Inicie o AdminServer no Host 1.

    No Linux:

    <Domain Home>/esstools/bin/start.sh -i AdminServer

    No Windows:

    <Domain Home>\esstools\bin\start.cmd -i AdminServer

  6. Descubra o IP público das máquinas Host 1 e Host 2, por exemplo, usando o comando ping do outro host. Se ambas as máquinas estiverem protegidas pelo firewall, certifique-se de saber os IPs com os quais o Host 1 e o Host 2 podem se comunicar.

  7. Configure o AdminServer e os servidores gerenciados usando a Console do WebLogic:

    1. Faça logon no console AdminServer do WebLogic usando as credenciais administrativas do WebLogic. A porta default do AdminServer é 7001.

      Exemplo: http(s)://host:7001/console

    2. Clique em Bloquear & Editar no Painel esquerdo. Navegue até <Nome do Domínio> -> Ambiente -> Servidores -> AdminServer. Na guia Configuração, clique em Geral e expanda a seção Avançado. Informe o endereço IP público do Host 1 na propriedade Endereço de Listening Externo.

      Importante: informe o IP do Host 1 conforme visto pelo Host 2.

    3. Clique em Salvar.

    4. Repita as etapas a, b e c diretamente acima para atualizar o Endereço de Listening Externo para essbase_server1 com o IP Público do Host 1.

    5. Remova essbase_cluster da associação de cluster do Coherence padrão.

      1. Navegue até <Nome do Domínio> -> Ambiente -> Clusters do Coherence.

      2. Clique em defaultCoherenceCluster. Clique na guia Membros. Desmarque essbase_cluster.

      3. Clique em Salvar.

    6. Navegue até <Nome do Domínio> -> guia Segurança->guia Ldap Incorporado. Selecione a Primeira Opção Principal e clique em Salvar.

    7. Navegue até <Nome do Domínio> -> Ambiente -> Servidores. Clique no servidor recém-adicionado essbase_server2.

    8. Na guia Configuração, navegue até a guia Geral, expanda a seção Avançado e informe o endereço IP público do Host 2 no campo Endereço de Listening Externo. Certifique-se de obter esse IP Público fazendo ping no Host 2 do Host 1. Clique em Salvar.

    9. Na guia Configuração, navegue até a guia Geral, remova o valor do campo Endereço de Listening e clique em Salvar.

    10. Navegue até <Nome do Domínio> -> Ambiente -> Servidores. Clique em essbase_server1. Na guia Configuração, navegue até a guia Geral e remova o valor do campo Endereço de Listening. Clique em Salvar.

    11. No painel à esquerda, clique em Ativar Alterações.

    12. Desligue o WebLogic no Host 1 usando stop.sh (no Linux) ou stop.cmd (no Windows).

      No Linux:

      <Domain Home>/esstools/bin/stop.sh

      No Windows:

      <Domain Home>\esstools\bin\stop.cmd

  8. Execute tlsTools.jar para atualizar certificados, conforme descrito em Configurar TLS para Failover do Essbase.

  9. No Host 1, empacote a configuração completa do domínio executando o comando a seguir e exporte-o como um arquivo jar. Isso pode levar alguns minutos.

    No Linux:

    <Oracle home>/oracle_common/common/bin/pack.sh -domain=<DOMAIN_HOME> -template=<user specified path>/essbase_ha.jar -template_name=essbase_domain -managed=true

    Exemplo do Linux:

    ./Oracle/Middleware/Oracle_Home/oracle_common/common/bin/pack.sh -domain=./Oracle/Middleware/Oracle_Home/domains/essbase_domain -template=./essbase_ha.jar -template_name=essbase_domain -managed=true

    No Windows:

    <Oracle home>\oracle_common\common\bin\pack.cmd -domain=<DOMAIN_HOME> -template=<user specified path>/essbase_ha.jar -template_name=essbase_domain -managed=true

    Exemplo do Windows:

    c:\>\Oracle_Home\oracle_common\common\bin\pack.cmd -domain=C:\Oracle_Home\domains\essbase_domain -template=essbase_ha.jar -template_name=essbase_domain -managed=true
  10. Transfira o jar gerado, <user specified path>/essbase_ha.jar, para uma pasta no nó secundário.
    • No Linux, use cópia de rede ou ftp:
      cp /network path of Host 1/<Host 1 Essbase Installation>/essbase_ha.jar <Host 2>/<some dir>/essbase_ha.jar
    • No Windows, copie o essbase_ha.jar para o segundo nó compartilhando a pasta entre os dois nós.