适用于私有云的 Edge v. 4.17.05
在节点上安装 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 身份验证。
使用受保护的 创建虚拟主机时的端口
如果您想创建将路由器绑定到受保护的端口(例如端口)的虚拟主机,请执行以下操作: 则您必须配置路由器,使其以有权访问 这些端口。默认情况下,路由器以用户“apigee”的身份运行它无权访问 特权端口
如需了解如何配置虚拟主机和路由器以访问 1000 以下的端口, 请参阅设置虚拟主机。
指定要安装的组件
下表列出了您传递给 apigee-service 实用程序的 -p 选项的选项 指定要在节点上安装的组件:
组件 |
说明 |
---|---|
C |
仅安装 Cassandra。 |
兹克 | 仅安装 ZooKeeper |
DS |
安装 ZooKeeper 和 Cassandra。 |
ld |
仅安装 OpenLDAP。 |
毫秒 |
安装边缘管理服务器,同时还会安装 Edge 界面和 OpenLDAP。 如果您在配置中设置了 USE_LDAP_REMOTE_HOST=y 文件,则会跳过 OpenLDAP 安装,管理服务器会使用 OpenLDAP 安装在其他节点上的 |
r |
仅安装边缘路由器。 |
英里 |
仅安装 Edge 消息处理器。 |
每分钟转数 |
安装边缘路由器和消息处理器。 |
ui |
安装 Edge 界面。 |
qs |
仅安装 Qpid Server。 |
ps |
仅安装 Postgres Server。 |
pdb | 仅安装 Postgres 数据库 - 仅在安装开发者服务时使用 。请参阅 Developer Services 门户 安装。 |
萨克斯 |
安装分析组件,即 Qpid 和 Postgres。 此选项仅适用于开发和测试,不可用于生产环境。 |
月 |
安装变现应用。 |
sa |
单独安装 Edge(即 Cassandra、ZooKeeper、Management Server、OpenLDAP), 边缘界面、路由器和消息处理器。此选项会忽略 Edge 分析组件: Qpid 和 Postgres。 此选项仅适用于开发和测试,不可用于生产环境。 |
Aio |
在单个节点上安装所有组件。 此选项仅适用于开发和测试,不可用于生产环境。 |
dp |
安装 Developer Services 门户。 |
创建配置文件
配置文件包含安装 Edge 所需的所有信息。您通常可以 使用同一配置文件在 Edge 安装中安装所有组件。
但是,您必须使用其他配置文件,或者修改您的配置 文件,如果:
- 您正在安装多个 OpenLDAP 服务器,并且需要将复制配置为 13 节点安装。每个文件的 LDAP_SID 和 LDAP_PEER 需要不同的值。
- 您将在 12 节点安装过程中创建多个数据中心。每个数据中心 需要对 ZK_CLIENT_HOSTS 和 CASS_HOSTS 等属性使用不同的设置。
下面描述的每个安装拓扑都显示了该拓扑的示例配置文件。对于 有关配置文件的完整参考,请参阅 Edge 配置文件参考。
安装日志文件
默认情况下,setup.sh 实用程序会将有关安装的日志信息写入到:
/opt/apigee/var/log/apigee-setup/setup.log
如果运行 setup.sh 实用程序的用户没有 那么该目录会将日志作为文件写入 /tmp 目录 名为 setup_username.log。
如果用户无权访问 /tmp,则 setup.sh 实用程序 失败。
安装 Edge 组件
本部分介绍如何为不同拓扑安装 Edge 组件。顺序 基于您期望的拓扑来安装组件。
以下所示的所有安装示例均假定您正在安装:
- 停用 Cassandra 身份验证(默认)。如需了解详情,请参阅启用 Cassandra 身份验证。
- 停用 Postgres 主备用复制(默认)。请参阅为 Postgres。
- 消息处理器和路由器位于同一节点上。如果您在安装了消息处理器和 不同节点上的路由器,首先安装所有消息处理器,然后再安装所有 路由器。
一体式安装
- 使用以下命令,在单个节点上安装所有组件:
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考文档。
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
双主机独立安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 安装独立网关和节点 1
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - 在节点 2 上安装 Analytics:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考文档。
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
5 台主机集群安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 在节点 1、2 和 3 上安装 Datastore 集群:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - 在节点 1 上安装管理服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 在节点 2 和 3 上安装路由器和消息处理器:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - 在节点 4 和节点 5 上安装 Analytics:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考文档。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
9 主机集群安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 在节点 1、2 和 3 上安装 Datastore 集群节点:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - 在节点 1 上安装 Apigee Management Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 在节点 4 和 5 上安装路由器和消息处理器:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - 在节点 6 和节点 7 上安装 Apigee Analytics Qpid 服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - 在节点 8 和 9 上安装 Apigee Analytics Postgres 服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考文档。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
13 主机集群安装
如需查看 Edge 的列表,请参阅安装拓扑 拓扑和节点编号。
- 在节点 1、2 和 3 上安装 Datastore 集群节点:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - 在节点 4 和节点 5 上安装 OpenLDAP:
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - 在节点 6 和节点 7 上安装 Apigee Management Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 在节点 8 和 9 上安装 Apigee Analytics Postgres 服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - 在节点 10 和 11 上安装路由器和消息处理器:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - 在节点 12 和 13 上安装 Apigee Analytics Qpid 服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考文档。
# 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@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |
# 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@google.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、2、3、7、8 和 9 上安装 Datastore 集群节点:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - 在节点 1 和 7 上安装具有 OpenLDAP 复制功能的 Apigee Management Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 在节点 2、3、8 和 9 上安装路由器和消息处理器:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - 在节点 4、5、10 和 11 上安装 Apigee Analytics Qpid 服务器:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - 在节点 6 和 12 上安装 Apigee Analytics Postgres Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - 按照测试 安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。请注意,此配置 文件。有关配置文件的完整参考,请参阅 Edge 配置文件 参考文档。
- 将 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@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |
# 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@google.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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |