使用故障转移设置脚本设置 Essbase 故障转移环境

从发行版 21.5.2 开始，您可以使用 Essbase 故障转移设置脚本来自动执行以下工作流，在以前的发行版中，这些工作流需要手动完成：

请使用以下工作流来自动设置 21.5.2 版及更高版本中的故障转移，而不是执行手动步骤。

入门

按照 Essbase Failover Prerequisites 中的步骤操作。
登录主节点，打开命令提示符或终端，并对辅助（故障转移）节点进行 ping 操作。记下其公共 IP。
范例
```
ping secondaryhost.example.com
```
登录辅助（故障转移）节点，打开命令提示符或终端，并对主节点执行 Ping 操作。记下其公共 IP。
范例
```
ping primaryhost.example.com
```

设置主节点（主机 1）

在主节点（主机 1）上，打开 Essbase 服务器配置文件，然后添加配置属性： FAILOVERMODE TRUE。请参阅设置服务器级别的配置属性。
在主节点（主机 1）上，导航到 <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover 中的 Essbase 故障转移设置脚本。
如果您不知道 <Essbase Product Home> 的位置，请参阅 Essbase 平台中的环境位置以了解详细信息。

Linux 示例
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Windows 示例
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
仅适用于 Linux：在主节点（主机 1）上，更改访问权限以使 Essbase 故障转移设置脚本可执行。
范例
```
chmod +x essbaseFailoverSetup.sh
```
在主节点（主机 1）上，运行 Essbase 故障转移设置脚本以设置主配置。脚本使用语法如下：
```
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
```
脚本会话示例
1. 使用 -primaryconfig 选项运行该脚本。
  Linux 示例
```
./essbaseFailoverSetup.sh –primaryconfig
```
  Windows 示例
```
.\essbaseFailoverSetup.cmd –primaryconfig
```
2. 如果 WebLogic 系统中配置了多个域，则该脚本将显示所有域主目录，并提示您选择域主目录。如果存在单个域主目录，则系统在不提示的情况下使用该域。
  
  示例：
```
Identified multiple domains, listed as below: 
Choose the Essbase domain home path(<DOMAIN_HOME>) from the list:  
../domains/esscs
../domains/esscs2
```
  在提示符下，输入 Essbase <Application Directory> 的共享网络路径。它必须是 Essbase 故障转移先决条件的步骤 1 中输入的同一网络路径。
  Linux 示例
```
/u01/essbase_data
```
  Windows 示例
```
z:\essbase_mount
```
  注意：
  在为故障转移设置的环境中，应用程序目录必须是两个主机均可访问的共享网络挂载。
3. 在提示符下，输入故障转移节点的名称。如果启用了 TLS，请输入受管服务器安全端口。如果未启用 TLS，请输入受管服务器端口。输入节点管理器端口。
  示例
```
essbase_domain2 
9001 
9555
```
  如果您输入了安全端口，则还必须完成为 Essbase 故障转移配置 TLS 。
4. 在提示符下，输入在前面的步骤中获取的故障转移和主节点的公共 IP 地址。
  示例
```
100.x.x.01 
100.x.x.02
```
  向脚本提供所有输入后，它将完成为主节点配置故障转移。现在，您可以转到辅助节点配置。

设置辅助节点（主机 2）

通过 SSH 连接到辅助节点 "Host 2"。
导航到 <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover 中的 Essbase 故障转移设置脚本。
如果您不知道 <Essbase Product Home> 的位置，请参阅 Essbase 平台中的环境位置以了解详细信息。
Linux 示例
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Windows 示例
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
仅适用于 Linux：在辅助/故障转移节点（主机 2）上，更改访问权限以使 Essbase 故障转移设置脚本可执行。
范例
```
chmod +x essbaseFailoverSetup.sh
```
在辅助/故障转移节点（主机 2）上，运行 Essbase 故障转移设置脚本以设置故障转移节点配置。
脚本使用语法如下：
```
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
```
脚本会话示例
1. 使用 -failoverconfig 选项运行该脚本。
  Linux 示例
```
./essbaseFailoverSetup.sh –failoverconfig
```
  Windows 示例
```
.\essbaseFailoverSetup.cmd –failoverconfig
```
2. 在提示符下，输入 Essbase <Application Directory> 的共享网络路径。如果您不知道 <Application Directory> 的位置，请参阅 Essbase 平台中的环境位置以了解详细信息。
  Linux 示例
```
/u01/essbase_data
```
  Windows 示例
```
z:\essbase_mount
```
  注意：
  在为故障转移设置的环境中，应用程序目录必须是两个主机均可访问的共享网络挂载。
3. 在提示符下，输入主节点的域名。这必须与您在配置期间提供的值匹配。
  范例
```
/scratch/user/oracle_home/domains/essbase_domain
```
  向脚本提供所有输入后，它将完成为辅助节点配置故障转移。

其他配置

在两个节点上，更新托管服务器启动属性以引用 Oracle HTTP Server (OHS) 负载平衡器主机名和端口。
1. 使用 Configure a Load Balancer to Support Failover 中介绍的步骤为主节点和辅助节点配置 OHS 条目。
2. 在主节点和故障转移节点上：
  在 Linux 上，编辑 <Domain Home>\bin\setStartupEnv.sh
  
  在 Windows 上，编辑 <Domain Home>\bin\setStartupEnv.cmd
  - 在字符串 DISCOVERY_URL 中搜索 ESSBASE-MAN-SVR 启动组，并将主机名和端口更改为 Oracle HTTP Server URL。
    范例
```
-DDISCOVERY_URL=http(s)://OHS_HOST:OHS_PORT/essbase/agent
```
使用启动和验证 Essbase 故障转移配置中的步骤启动和验证 Essbase 故障转移配置。