适用于私有云的 Edge v4.19.01
在节点上安装 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
如需了解如何安装 Edge apigee-setup
,请参阅
安装 Edge apigee-setup 实用程序。
安装注意事项
在编写配置文件时,请考虑以下选项。
设置 Postgres 主备用复制
默认情况下,Edge 会以主模式安装所有 Postgres 节点。但在生产系统中, 具有多个 Postgres 节点,则必须将这些节点配置为使用主备用复制, 如果主节点发生故障,则备用节点可以继续处理流量。
您可以使用 静默配置文件您也可以在安装后启用主备用复制。对于 请参阅设置主备用模式 复制作业。
启用 Cassandra 身份验证
默认情况下,Cassandra 安装时未启用身份验证。这意味着任何人都可以访问 Cassandra。您可以在安装 Edge 后或在安装过程中启用身份验证 过程。
如需了解详情,请参阅启用 Cassandra 身份验证。
使用受保护的 创建虚拟主机时的端口
如果您想创建将路由器绑定到受保护的端口(例如端口)的虚拟主机,请执行以下操作: 则您必须配置路由器,使其以有权访问 这些端口默认情况下,路由器以用户“apigee”的身份运行它无权访问 特权端口
如需了解如何配置虚拟主机和路由器以访问 1000 以下的端口, 请参阅设置虚拟主机。
指定要安装的组件
下表列出了您传递给 -p
选项的
apigee-service
实用程序指定要在节点上安装的组件:
组件 | 说明 |
---|---|
|
仅安装 Cassandra。 |
zk |
仅安装 ZooKeeper |
|
安装 ZooKeeper 和 Cassandra。 |
|
仅安装 OpenLDAP。 |
|
安装边缘管理服务器,同时还会安装 Edge 界面和 OpenLDAP。 如果您在配置文件中设置了 |
|
仅安装边缘路由器。 |
|
仅安装 Edge 消息处理器。 |
|
安装边缘路由器和消息处理器。 |
|
安装 Edge 界面。 |
|
仅安装 Qpid Server。 |
|
仅安装 Postgres Server。 |
pdb |
仅安装 Postgres 数据库 - 仅在安装 Apigee Developer Services 门户(简称门户)时使用。 请参阅安装门户。 |
|
安装分析组件,即 Qpid 和 Postgres。 此选项仅用于开发和测试,不用于生产环境。 |
sso |
安装 Edge SSO 模块。 |
|
安装变现应用。 |
|
单独安装 Edge(即 Cassandra、ZooKeeper、Management Server、OpenLDAP), 边缘界面、路由器和消息处理器。此选项会忽略 Edge 分析组件: Qpid 和 Postgres。 此选项仅用于开发和测试,不用于生产环境。 |
|
在单个节点上安装所有组件。 此选项仅用于开发和测试,不用于生产环境。 |
dp |
安装门户。 |
创建配置文件
配置文件包含安装 Edge 所需的所有信息。您通常可以 使用同一配置文件在 Edge 安装中安装所有组件。
但是,您必须使用其他配置文件,或者修改您的配置 文件,如果:
- 您正在安装多个 OpenLDAP 服务器,并且需要将复制配置为
13 节点安装。每个文件的
LDAP_SID
和LDAP_PEER
。 - 您将在 12 节点安装过程中创建多个数据中心。每个数据中心
需要针对
ZK_CLIENT_HOSTS
和CASS_HOSTS
。
下面描述的每个安装拓扑都显示了该拓扑的示例配置文件。对于 有关配置文件的完整参考,请参阅 Edge 配置文件参考。
在不运行的情况下测试系统要求 一次安装
私有云的 Edge 支持使用 ENABLE_SYSTEM_CHECK=y
属性检查 CPU
和内存要求不过,在以前的 Edge 版本中
该检查需要您实际执行安装。
现在,您可以使用“-t”标志执行该检查,而不必执行安装。例如: 查看“aio”的系统要求直接使用 以下命令:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t
此命令会在屏幕上显示系统要求的所有错误。
请参阅安装要求,获取一系列 所有 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。
- 消息处理器和路由器位于同一节点上。如果您在安装了消息处理器和 不同节点上的路由器,首先安装所有消息处理器,然后再安装所有 路由器。
前提条件
在安装 Edge 组件之前,您必须:
- 请查看安装要求, 以及一系列必需文件,然后才能继续 安装。请确保在开始安装之前已查看相关要求 过程。
- 停用 SELinux 或将其设置为宽容模式。请参阅 安装 Edge apigee-setup 实用程序, 。
一体式安装
- 使用以下命令,在单个节点上安装所有组件:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- 安装完成后,重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
观看 Edge 一体式安装视频 此处。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考。
# With SMTP IP1=IP_or_DNS_name_of_Node_1 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com # Admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" # Set up username and password to access Qpid broker's management console QPID_MGMT_USERNAME=qpid QPID_MGMT_PASSWORD=pass1234
双节点独立安装
如需查看 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
- 在节点 1 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考。
# With SMTP IP1=IP_of_Node_1 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # 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
- 在节点 1 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考。
# With SMTP IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP4=IP_of_Node_4 IP5=IP_of_Node_5 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # 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
- 在节点 1 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 请参阅 Edge 配置文件 参考。
# With SMTP IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP8=IP_of_Node_8 IP9=IP_of_Node_9 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>"
13 节点集群安装
本部分介绍含 13 个节点的集群的安装顺序。有关 Edge 的列表 拓扑和节点编号,请参阅安装拓扑。
包含 13 个节点的集群的安装顺序如下所示:
- 在节点 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
- 在节点 6 和 7 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件示例。完整的参考信息 请参阅 Edge 配置文件 参考。
# For all nodes except IP4 and IP5 # (which are the OpenLDAP nodes) IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP4=IP_of_Node_4 IP5=IP_of_Node_5 IP6=IP_of_Node_6 IP7=IP_of_Node_7 IP8=IP_of_Node_8 IP9=IP_of_Node_9 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt # Management Server on IP6 only MSIP=$IP6 USE_LDAP_REMOTE_HOST=y LDAP_HOST=$IP4 LDAP_PORT=10389 # Management Server on IP7 only # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=y # LDAP_HOST=$IP5 # LDAP_PORT=10389 # Use the same password for both OpenLDAP nodes APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
# For OpenLDAP nodes only (IP4 and IP5) IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP4=IP_of_Node_4 IP5=IP_of_Node_5 IP6=IP_of_Node_6 IP7=IP_of_Node_7 IP8=IP_of_Node_8 IP9=IP_of_Node_9 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD # For the OpenLDAP Server on IP4 only MSIP=$IP6 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP5 # For the OpenLDAP Server on IP5 only # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=n # LDAP_TYPE=2 # LDAP_SID=2 # LDAP_PEER=$IP4 # Set same password for both OpenLDAPs. APIGEE_LDAPPW=LDAP_PASSWORD |
12 节点集群安装
在 12 节点集群拓扑(两个数据中心)上安装 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 服务器:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- 在节点 1 和节点 7 上重启 Edge 界面组件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照测试安装中的说明测试安装。
- 按照对 组织。
下面显示了一个此拓扑的静默配置文件。如需全面了解 配置文件,请参阅 Edge 配置文件 参考。
- 将 OpenLDAP 配置为在两个 OpenLDAP 节点之间进行复制。
- 在一个 ZooKeeper 节点上指定
:observer
修饰符。在单一数据中 请省略该修饰符。
# Datacenter 1 IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP6=IP_of_Node_6 IP7=IP_of_Node_7 IP8=IP_of_Node_8 IP9=IP_of_Node_9 IP12=IP_of_Node_12 HOSTIP=$(hostname -i) MSIP=$IP1 ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP7 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
# Datacenter 2 IP1=IP_of_Node_1 IP2=IP_of_Node_2 IP3=IP_of_Node_3 IP6=IP_of_Node_6 IP7=IP_of_Node_7 IP8=IP_of_Node_8 IP9=IP_of_Node_9 IP12=IP_of_Node_12 HOSTIP=$(hostname -i) MSIP=$IP7 ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=ADMIN_PASSWORD LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=2 LDAP_PEER=$IP1 APIGEE_LDAPPW=LDAP_PASSWORD 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=SMTP_PASSWORD # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |