在节点上安装 Edge 组件

适用于私有云的 Edge v. 4.16.09

在节点上安装 Edge apigee-setup 实用程序后,请使用 要安装的 apigee-setup 实用程序 节点上的一个或多个 Edge 组件。

apigee-setup 实用程序使用如下形式的命令:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

其中 component 是要安装的 Edge 组件, configFile 是包含安装项的静默配置文件 信息。配置文件必须可供“apigee”访问或读取用户。对于 例如,可以为文件创建一个新目录,将其放在 /usr/local 或 /usr/local/share 目录下,或者“apigee”可访问的节点上任何其他位置 用户。

例如,如需安装边缘管理服务器,请运行以下命令:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

安装注意事项

在编写配置文件时,请考虑以下选项。

设置 Postgres 主备用复制

默认情况下,Edge 会以主模式安装所有 Postgres 节点。但在生产系统中, 具有多个 Postgres 节点,则必须将这些节点配置为使用主备用复制, 如果主节点发生故障,则备用节点可以继续处理流量。

您可以使用 静默配置文件您也可以在安装后启用主备用复制。对于 请参见设置主备用模式 Postgres 的复制

启用 Cassandra 身份验证

默认情况下,Cassandra 安装时未启用身份验证。这意味着任何人都可以访问 Cassandra。您可以在安装 Edge 后或在安装过程中启用身份验证 过程。

您可以通过在静默文件中使用 配置文件您也可以在安装后启用它。

如需了解详情,请参阅启用 Cassandra 身份验证

将路由器绑定到 受保护的端口

如果您想将路由器绑定到受保护的端口(例如,小于 1024 的端口号),则 您必须将路由器配置为以有权访问这些端口的用户身份运行。默认情况下, Router 以用户“apigee”的身份运行它无权访问特权端口

要以其他用户身份运行路由器,请执行以下操作:

  1. 以根用户身份创建文件 /opt/apigee/etc/edge-router.d/RUN_USER.sh
  2. 将以下条目添加到该文件中:
    RUN_USER=root
    如果您不希望以根用户身份运行路由器,请指定有权访问该端口的用户。
  3. 保存文件。
  4. 如果您指定了除 root 以外的用户,请将文件的所有者更改为该用户:
    >冠军 USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. 重启路由器:
    > /opt/apigee/apigee-service/bin/apigee-service edge-router restart

指定要安装的组件

下表列出了您传递给 apigee-service 实用程序的 -p 选项的选项 指定要在节点上安装的组件:

组件

说明

C

仅安装 Cassandra。

兹克 仅安装 ZooKeeper

安装 ZooKeeper 和 Cassandra。

ld

仅安装 OpenLDAP。

毫秒

安装边缘管理服务器,同时还会安装 Edge 界面和 OpenLDAP。

如果您在配置中设置了 USE_LDAP_REMOTE_HOST=y 文件,则会跳过 OpenLDAP 安装,管理服务器会使用 OpenLDAP 安装在其他节点上的

r

仅安装边缘路由器。

英里

仅安装 Edge 消息处理器。

每分钟转数

安装边缘路由器和消息处理器。

ui

安装 Edge 界面。

qs

仅安装 Qpid Server。

ps

仅安装 Postgres Server。

萨克斯

安装分析组件,即 Qpid 和 Postgres。

此选项仅用于开发和测试,不用于生产环境。

安装变现应用。

sa

单独安装 Edge(即 Cassandra、ZooKeeper、Management Server、OpenLDAP), 边缘界面、路由器和消息处理器。此选项会忽略 Edge 分析组件: Qpid 和 Postgres。

此选项仅用于开发和测试,不用于生产环境。

Aio

在单个节点上安装所有组件。

此选项仅用于开发和测试,不用于生产环境。

创建配置文件

配置文件包含安装 Edge 所需的所有信息。您通常可以 使用同一配置文件在 Edge 安装中安装所有组件。

但是,您必须使用其他配置文件,或者修改您的配置 文件,如果:

  • 您正在安装多个 OpenLDAP 服务器,并且需要将复制配置为 13 节点安装。每个文件的 LDAP_SIDLDAP_PEER 需要不同的值。
  • 您将在 12 节点安装过程中创建多个数据中心。每个数据中心 需要对 ZK_CLIENT_HOSTSCASS_HOSTS 等属性使用不同的设置。

示例配置文件

下面显示了一个 9 节点 Edge 的完整静默配置文件示例 安装。根据您的配置需要修改此文件。使用 -f 选项 setup.sh 来包含此文件。其他显示 以下是每个 Edge 拓扑的示例配置文件。

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

下表包含有关这些属性的其他信息:

属性

备注

IP/DNS 名称

在以下情况下,请勿使用映射到 127.0.0.1 的主机名或 IP 地址 127.0.0.1 节点的 IP 地址

ADMIN_EMAIL
APIGEE_ADMINPW

系统管理员的密码长度必须至少为 8 个字符,且包含一个字符 一个大写字母、一个小写字母、一个数字或一个特殊字符。如果省略 密码,系统会提示您输入密码。

LICENSE_FILE

许可文件的位置,必须可供“apigee”访问用户。 例如,将其存储在 /tmp 目录和该文件的 chmod 777 中。文件已复制 复制到 Edge 安装目录中。

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

如果 USE_LDAP_REMOTE_HOST 为 n,则 Edge 在安装 OpenLDAP 时会自动安装 OpenLDAP。 管理服务器

如果您要连接到远程 LDAP 服务器,请将 USE_LDAP_REMOTE_HOST 设置为 y。OpenLDAP 未随管理服务器安装。

如果您要连接到远程 OpenLDAP 服务器,请使用 LDAP_HOST
和 LDAP_PORT,以指定主机的 IP 地址或 DNS 名称和端口号。

LDAP_TYPE
LDAP_SID
LDAP_PEER

为 OpenLDAP 设置 LDAP_TYPE=1,不进行复制。LDAP_TYPE=2 对应于 OpenLDAP 以及复制。

如果您的边缘拓扑使用单个 OpenLDAP 服务器,请指定 1。如果你的 Edge 安装使用多个 OpenLDAP 节点,例如在具有 13 个节点的正式版安装中, 指定 2。

如果启用复制,请设置以下属性:

  • LDAP_SID=1 - 此 LDAP 服务器的唯一 ID。每个 LDAP 节点使用不同的 ID。 例如,将 LDAP 对等端设置为 2。
  • LDAP_PEER=10.0.0.1 - LDAP 对等方的 IP 或 DNS 名称。

BIND_ON_ALL_INTERFACES

如果设置为“y”则路由器/消息处理器会在所有接口 (IP) 上绑定(监听)。 如果设置为“n”,则路由器/邮件处理器将绑定(监听)某个特定的 “hostname -i”返回的 IP 地址命令)。

MP_POD

指定消息处理器和路由器 pod 的名称。默认情况下,名称为 网关。

地区

地区名称。按照惯例,名称通常采用 dc-# 格式,其中 # 对应于 设置为整数值。例如,dc-1、dc-2 等。您可以使用 dc-1,除非在 一个多数据中心环境

在使用多个数据中心时,该值为 dc-1 或 dc-2 等,具体取决于 您要安装哪个数据中心不过,您并非只能使用名称 格式为 dc-#。您可以使用任何名称作为区域名称。

ZK_HOSTS

ZooKeeper 节点的 IP 地址或 DNS 名称。IP 地址或 DNS 名称 必须在所有 ZooKeeper 节点上以相同的顺序列出。

在多数据中心环境中,列出两个数据中的所有 ZooKeeper 节点 。

仅当满足以下条件时,才能在 ZooKeeper 节点上指定“:observer”修饰符 创建多个数据中心(如 12 台主机安装所述)。在单一数据中 请省略该修饰符。请参阅12 主机集群 安装

ZK_CLIENT_HOSTS

此数据中心使用的 ZooKeeper 节点的 IP 地址或 DNS 名称。IP 地址 地址或 DNS 名称必须在所有 ZooKeeper 节点上以相同的顺序列出。

在单个数据中心安装中,这些节点就是 ZK_HOSTS。

在多数据中心环境中,仅列出此数据中心中的 ZooKeeper 节点。 请参阅12 主机集群 安装

CASS_HOSTS

Cassandra 节点的 IP 地址(而非 DNS 名称)。前两个节点 用作种子服务器。必须在所有 Cassandra 上以相同的顺序列出 IP 地址 节点。

Cassandra 节点可以带有可选的“:dc,ra”后缀, 数据中心和机架的 Cassandra 节点上。仅在创建 如 12 台主机安装所述。在一个数据中心内 请省略该修饰符。

例如,“192.168.124.201:1,1 = 数据中心 1 和机架/可用区 1”,以及 '192.168.124.204:2,1 = 数据中心 2 和机架/可用区 1。

在多数据中心环境中,要克服防火墙问题,CASS_HOSTS 按某种方式进行排序(如上例所示), 数据中心位于最开始的位置。请参阅12 主机集群 安装

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

如果您启用 Cassandra 身份验证 CASS_AUTH=y,则可以将 Cassandra 用户 名称和密码。

PG_MASTER

PG_STANDBY

设置为启用 Postgres 主备用复制,格式如下:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTP 密码
SMTPSSL
SMTPPORT

配置 SMTP,以便 Edge 可在密码丢失和其他通知时发送电子邮件。

如果不需要 SMTP 用户凭据,请省略 SMTPUSERSMTPPASSWORD

组件安装顺序

组件安装的顺序取决于您所需的拓扑。

以下所示的所有安装示例均假定您正在安装:

  • 停用 Cassandra 身份验证(默认)。如需了解详情,请参阅启用 Cassandra 身份验证
  • 停用 Postgres 主备用复制(默认)。请参阅为 Postgres
  • 消息处理器和路由器位于同一节点上。如果您在安装了消息处理器和 不同节点上的路由器,首先安装所有消息处理器,然后再安装所有 路由器。

安装日志文件

默认情况下,setup.sh 实用程序会将有关安装的日志信息写入到:

/opt/apigee/var/log/apigee-setup/setup.log

如果运行 setup.sh 实用程序的用户无权访问 目录中,系统会将日志以名为 /tmp 的文件写入 /tmp 目录。

如果用户无权访问 /tmp,则 setup.sh 实用程序将会失败。

一体式安装

  1. 使用以下命令,在单个节点上安装所有组件:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. 按照测试 安装
  3. 按照对 组织

下面显示此拓扑的静默配置文件:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

双主机独立式 安装

如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。

  1. 安装独立网关和节点 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. 在节点 2 上安装 Analytics:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. 按照测试 安装
  4. 按照对 组织

下面显示此拓扑的静默配置文件:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

5 台主机集群 安装

如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。

  1. 在节点 1、2 和 3 上安装 Datastore 集群:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在节点 1 上安装管理服务器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在节点 2 和 3 上安装路由器和消息处理器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 在节点 4 和节点 5 上安装 Analytics:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. 按照测试 安装
  6. 按照对 组织

下面显示此拓扑的静默配置文件:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

9 台主机集群 安装

如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。

  1. 在节点 1、2 和 3 上安装 Datastore 集群节点:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在节点 1 上安装 Apigee Management Server:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在节点 4 和 5 上安装路由器和消息处理器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 在节点 6 和节点 7 上安装 Apigee Analytics Qpid 服务器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 在节点 8 和 9 上安装 Apigee Analytics Postgres 服务器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 按照测试 安装
  7. 按照对 组织

下面显示此拓扑的静默配置文件:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

13 台主机集群 安装

如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。

  1. 在节点 1、2 和 3 上安装 Datastore 集群节点:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在节点 4 和节点 5 上安装 OpenLDAP:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. 在节点 6 和节点 7 上安装 Apigee Management Server:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. 在节点 8 和 9 上安装 Apigee Analytics Postgres 服务器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. 在节点 10 和 11 上安装路由器和消息处理器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. 在节点 12 和 13 上安装 Apigee Analytics Qpid 服务器:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. 按照测试 安装
  8. 按照对 组织

下面显示此拓扑的静默配置文件:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

12 台主机集群 安装

在 a12 主机集群拓扑(两个数据中心)上安装 Edge 之前,您必须了解 如何在静默配置文件中设置 ZooKeeper 和 Cassandra 属性。

  • ZooKeeper

    对于这两个数据中心的 ZK_HOSTS 属性,请指定所有数据中心的 IP 地址或 DNS 名称 以相同的顺序来自两个数据中心的 ZooKeeper 节点, “:observer”修饰符。不带“:observer”修饰符的节点称为 “voters”。“投票者”数量必须为奇数。

    在此拓扑中,主机 9 上的 ZooKeeper 主机是观察器:

    对于每个数据中心的 ZK_CLIENT_HOSTS 属性,请指定以下内容的 IP 地址或 DNS 名称: 按相同顺序,为可用区中的所有 ZooKeeper 节点 数据中心。在如下所示的示例配置文件中,使用 “:observer”修饰符,这样您就有五个投票者:节点 1、2、3、7 和 8。
  • Cassandra
    所有数据中心都必须拥有相同数量的 Cassandra 节点。

    对于每个数据中心的 CASS_HOSTS,请确保您指定所有 Cassandra IP 地址(而不是 DNS 名称)。对于数据中心 1,列出该数据中的 Cassandra 节点 居中对齐。对于数据中心 2,首先列出该数据中心中的 Cassandra 节点。列出 数据中心内所有 Cassandra 节点按相同顺序排列 Cassandra 节点。

    所有 Cassandra 节点都必须带有后缀“:<d>,<r>”,例如“<ip>:1,1 = 数据中心 1 和机架/可用性区域 1,'<ip>:2,1 = 数据中心 2 和 机架/可用区 1。
    例如:"192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"

    每个数据中心的机架/可用性可用区 1 中的第一个节点将用作种子 服务器。

    在此部署模型中,Cassandra 设置将如下所示:

如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。

  1. 在节点 1、2、3、7、8 和 9 上安装 Datastore 集群节点:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在节点 1 和 7 上安装具有 OpenLDAP 复制功能的 Apigee Management Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在节点 2、3、8 和 9 上安装路由器和消息处理器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile配置文件
  4. 在节点 4、5、10 和 11 上安装 Apigee Analytics Qpid 服务器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 在节点 6 和 12 上安装 Apigee Analytics Postgres Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 按照测试 安装
  7. 按照对 组织

下面显示了一个此拓扑的静默配置文件。请注意,此配置 文件:

  • 将 OpenLDAP 配置为在两个 OpenLDAP 节点之间进行复制。
  • 在一个 ZooKeeper 节点上指定“:observer”修饰符。在单一数据中 请省略该修饰符。
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25