Configurar um Ambiente de Failover do Essbase Usando o Script de Configuração de Failover

A partir da Versão 21.5.2, você pode usar o Script de Configuração de Failover do Essbase para automatizar os seguintes workflows que, em versões anteriores, precisavam ser feitos manualmente:

Em vez de seguir as etapas manuais, use o workflow a seguir para automatizar a configuração de failover na Versão 21.5.2 e posterior.

Conceitos Básicos

  1. Siga as etapas em Pré-requisitos de Failover do Essbase.
  2. Faça log-in no nó primário, abra um prompt de comando ou terminal e faça ping no nó secundário (failover). Anote o IP público.
    Exemplo 
    ping secondaryhost.example.com
  3. Faça log-in no nó secundário (failover), abra um prompt de comando ou terminal e faça ping no nó principal. Anote o IP público.
    Exemplo 
    ping primaryhost.example.com

Configurar o Nó Principal (Host 1)

  1. No nó principal (host 1), abra o arquivo de configuração do Essbase Server e adicione a propriedade de configuração: FAILOVERMODE TRUE. Consulte Definir Propriedades de Configuração no Nível do Servidor.
  2. No nó principal (host 1), navegue até o Script de Configuração de Failover do Essbase no <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.

    Se você não souber onde está o <Essbase Product Home>, consulte Locais de Ambiente na Plataforma Essbase para obter detalhes.

    Exemplo do Linux

    cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
    Exemplo do Windows
    chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
  3. Obrigatório somente para Linux: No nó principal (host 1), altere as permissões de acesso para tornar o Script de Configuração de Failover do Essbase executável.

    Exemplo

    chmod +x essbaseFailoverSetup.sh

  4. No nó principal (host 1), execute o Script de Configuração de Failover do Essbase para configurar a configuração principal. A sintaxe de uso do script é a seguinte: 

    essbaseFailoverSetup.sh [-primaryconfig] [-failoverconfig] [-listnodes] [-deletenode]
-primaryconfig  - For  primary node configuration
-failoverconfig - For failover node configuration
-listnodes - For listing failover nodes  
-deletenode - For removing the failover node from the cluster

    Exemplo de sessão de script

    1. Execute o script com a opção -primaryconfig.
      Exemplo do Linux
      ./essbaseFailoverSetup.sh –primaryconfig

      Exemplo do Windows

      .\essbaseFailoverSetup.cmd –primaryconfig

    2. Se houver vários domínios configurados no sistema WebLogic, o script exibirá todos os homes do domínio e você será solicitado a escolher o home do domínio. Se houver um único home de domínio, o sistema usará esse domínio sem um prompt.

      Exemplo:

      Identified multiple domains, listed as below: 
Choose the Essbase domain home path(<DOMAIN_HOME>) from the list:  
../domains/esscs
../domains/esscs2

      No prompt, informe o caminho da rede compartilhada para o Essbase <Application Directory>. Deve ser o mesmo caminho de rede informado na etapa 1 dos Pré-requisitos de Failover do Essbase.

      Exemplo do Linux
      /u01/essbase_data
      Exemplo do Windows
      z:\essbase_mount

      Observação:

      Em um ambiente configurado para failover, o diretório do aplicativo deve ser uma montagem de rede compartilhada acessível por ambos os hosts.

    3. No prompt, informe o nome do nó de failover. Se o TLS tiver sido ativado, informe a Porta Segura do Servidor Gerenciado. Se o TLS não tiver sido ativado, informe a porta do Servidor Gerenciado. Informe a porta do Gerenciador de Nós.

      Exemplos
      essbase_domain2 
9001 
9555

      Se você inseriu uma porta segura, também deverá concluir a configuração do TLS para failover do Essbase.

    4. Nos prompts, informe os endereços IP públicos de failover e nós principais que você obteve nas etapas anteriores.
      Exemplos 
      100.x.x.01 
100.x.x.02

      Depois que você tiver fornecido todas as entradas ao script, ele terminará de configurar o failover para o nó principal. Agora você pode passar para a configuração de nó secundário.

Configurar o Nó Secundário (Host 2)

  1. SSH para o nó secundário, Host 2.
  2. Navegue até o Script de Configuração de Failover do Essbase no <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.

    Se você não souber onde está o <Essbase Product Home>, consulte Locais de Ambiente na Plataforma Essbase para obter detalhes.

    Exemplo do Linux 
    cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
    Exemplo do Windows
    chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
  3. Obrigatório somente para Linux: No nó secundário/de failover (host 2), altere as permissões de acesso para tornar o Script de Configuração de Failover do Essbase executável.
    Exemplo 
    chmod +x essbaseFailoverSetup.sh
  4. No nó secundário/de failover (host 2), execute o Script de Configuração de Failover do Essbase para configurar a configuração do nó de failover.

    A sintaxe de uso do script é a seguinte:

    essbaseFailoverSetup.sh [-primaryconfig] [-failoverconfig] [-listnodes] [-deletenode]
-primaryconfig  - For  primary node configuration
-failoverconfig - For failover node configuration
-listnodes - For listing failover nodes  
-deletenode - For removing the failover node from the cluster

    Exemplo de sessão de script

    1. Execute o script com a opção -failoverconfig.
      Exemplo do Linux 
      ./essbaseFailoverSetup.sh –failoverconfig
      Exemplo do Windows 
      .\essbaseFailoverSetup.cmd –failoverconfig
    2. No prompt, informe o caminho da rede compartilhada para o Essbase <Application Directory>. Se você não souber onde está o <Application Directory>, consulte Locais de Ambiente na Plataforma Essbase para obter detalhes.
      Exemplo do Linux
      /u01/essbase_data
      Exemplo do Windows
      z:\essbase_mount

      Observação:

      Em um ambiente configurado para failover, o diretório do aplicativo deve ser uma montagem de rede compartilhada acessível por ambos os hosts.
    3. No prompt, insira o nome do domínio do nó principal. Deve corresponder aos valores fornecidos durante a configuração.
      Exemplo
      /scratch/user/oracle_home/domains/essbase_domain

      Depois que você tiver fornecido todas as entradas ao script, ele terminará de configurar o failover para o nó secundário.

Configurações Adicionais

  1. Em ambos os nós, atualize as propriedades de inicialização do servidor gerenciado para fazer referência à porta e ao nome do host do balanceador de carga do Oracle HTTP Server (OHS).
    1. Configure entradas do OHS para nós principais e secundários usando as etapas documentadas em Configurar um Balanceador de Carga para Suportar Failover.
    2. Nos nós principal e failover:

      No Linux, edite <Domain Home>\bin\setStartupEnv.sh

      No Windows, edite <Domain Home>\bin\setStartupEnv.cmd

      • Procure a string DISCOVERY_URL para o grupo de inicialização ESSBASE-MAN-SVR e altere o nome do host e a porta para o URL do Oracle HTTP Server.
        Exemplo
        -DDISCOVERY_URL=http(s)://OHS_HOST:OHS_PORT/essbase/agent
  2. Inicie e valide a Configuração de Failover do Essbase usando as etapas em Iniciar e Validar a Configuração de Failover do Essbase.