硬件要求
对于生产级环境中的高可用性基础架构,您必须满足以下最低硬件要求。
以下视频为您提供了安装时的总体尺寸调整指南:
对于安装拓扑中描述的所有安装场景,下表中列出了安装组件的最低硬件要求。
这些表中除操作系统所需的硬盘空间外,还列出了硬盘要求。安装所需的资源可能比下面列出的资源多或少,具体取决于您的应用和网络流量。
安装组件 | RAM | CPU | 最小硬盘 |
---|---|---|---|
Cassandra | 16 GB | 8 核 | 250GB 本地存储空间,固态硬盘支持 2000 IOPS |
消息处理器/路由器 | 16 GB | 8 核 | 100GB |
消息处理器(独立) | 16 GB | 8 核 | 100GB |
路由器(独立) | 16 GB | 8 核 | 100GB |
Google Analytics(分析)- 同一服务器上的 Postgres/Qpid | 16GB* | 8 核* | 500GB - 1TB** 网络存储空间***,最好使用 SSD 后端,支持 1000 IOPS 或更高* |
Google Analytics(分析)- Postgres 主实例或备用实例(独立) | 16GB* | 8 核* | 500GB - 1TB** 网络存储空间***,最好使用 SSD 后端,支持 1000 IOPS 或更高* |
Google Analytics(分析)- Qpid 独立式 | 8 GB | 4 核 | 30GB - 50GB 本地存储空间(带 SSD)
默认 Qpid 队列大小为 1 GB,可以增加到 2 GB。如果您需要更多容量,请添加其他 Qpid 节点。 |
OpenLDAP/界面/管理服务器 | 8 GB | 4 核 | 60 GB |
界面/管理服务器 | 4 GB | 2 核 | 60 GB |
OpenLDAP(独立) | 4 GB | 2 核 | 60 GB |
* 根据吞吐量调整 Postgres 系统要求:
** Postgres 硬盘值基于 Edge 捕获的开箱即用分析结果。如果您向分析数据添加自定义值,则应相应地增加这些值。使用以下公式估算所需存储空间:
例如:
*** 建议为 Postgresql 数据库使用 Network Storage,因为:
|
此外,下面还列出了如果您想安装创收服务(不支持一体式安装)的硬件要求:
支持创收功能的组件 | RAM | CPU | 硬盘 |
---|---|---|---|
管理服务器(含变现服务) | 8 GB | 4 核 | 60 GB |
Google Analytics(分析)- 同一服务器上的 Postgres/Qpid | 16 GB | 8 核 | 500GB - 1TB 网络存储空间(最好使用 SSD 后端,支持 1000 IOPS 或更高),或者使用上表中的规则。 |
Google Analytics(分析)- Postgres 主实例或备用独立式 | 16 GB | 8 核 | 500GB - 1TB 网络存储空间(最好使用 SSD 后端,支持 1000 IOPS 或更高),或者使用上表中的规则。 |
Google Analytics(分析)- Qpid 独立式 | 8 GB | 4 核 | 40GB - 500GB 本地存储空间(含 SSD 或快速 HDD)
如果安装时间超过 250 TPS,建议使用本地存储支持 1000 IOPS 的 HDD。 |
操作系统和第三方软件要求
这些安装说明和提供的安装文件已在支持的软件和支持的版本中所列的操作系统和第三方软件上进行了测试。
Java
在安装之前,您需要在每台计算机上安装受支持的 Java 1.8 版本。支持的软件和支持的版本中列出了支持的 JDK。
确保 JAVA_HOME
环境变量指向执行安装的用户的 JDK 的根目录。
SELinux
根据您针对 SELinux 的设置,Edge 可能会在安装和启动 Edge 组件时遇到问题。如有必要,您可以在安装过程中停用 SELinux 或将其设置为宽容模式,然后在安装后重新启用它。如需了解详情,请参阅安装 Edge apigee-setup 实用程序。
创建“apigee”用户
安装过程会创建一个名为“apigee”的 Unix 系统用户。Edge 目录和文件归“apigee”所有,Edge 进程也归“apigee”所有。这意味着 Edge 组件会以“apigee”用户身份运行。如有必要,您可以使用其他用户身份运行组件。
安装目录
默认情况下,安装程序会将所有文件写入 /opt/apigee
目录。您无法更改此目录位置。虽然您无法更改此目录,但可以创建一个符号链接以将 /opt/apigee
映射到其他位置,如从 /opt/apigee 创建符号链接中所述。
在本指南的说明中,安装目录标注为 /opt/apigee
。
从 /opt/apigee 创建符号链接
在创建符号链接之前,您必须先创建一个名为“apigee”的用户和群组。这与 Edge 安装程序创建的组和用户相同。
如需创建符号链接,请在下载 bootstrap_4.52.02.sh 文件之前执行以下步骤。 您必须以根用户身份执行所有这些步骤:
- 创建“apigee”用户和群组:
groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
- 创建从
/opt/apigee
到所需安装根目录的符号链接:ln -Ts /srv/myInstallDir /opt/apigee
其中 /srv/myInstallDir 是 Edge 文件所需的位置。
- 将安装根目录和符号链接的所有权更改为“apigee”用户:
chown -h apigee:apigee /srv/myInstallDir /opt/apigee
投放网络设置
Apigee 建议您在安装前检查网络设置。安装程序期望所有机器都有固定的 IP 地址。请使用以下命令验证设置:
hostname
会返回机器的名称hostname -i
返回可从其他机器寻址的主机名的 IP 地址。
如果主机名设置不正确,您可能需要修改 /etc/hosts
和 /etc/sysconfig/network
,具体取决于您的操作系统类型和版本。如需了解详情,请参阅具体操作系统的文档。
如果服务器具有多个接口卡,则“hostname -i”命令会返回以空格分隔的 IP 地址列表。默认情况下,Edge 安装程序使用返回的第一个 IP 地址,这可能并非在所有情况下都正确。作为替代方案,您可以在安装配置文件中设置以下属性:
ENABLE_DYNAMIC_HOSTIP=y
将该属性设置为“y”后,安装程序会提示您选择要在安装过程中使用的 IP 地址。默认值为“n”。如需了解详情,请参阅 Edge 配置文件参考。
TCP 封装容器
TCP 封装容器可以阻止某些端口的通信,并可能影响 OpenLDAP、Postgres 和 Cassandra 的安装。在这些节点上,检查 /etc/hosts.allow
和 /etc/hosts.deny
,以确保所需的 OpenLDAP、Postgres 和 Cassandra 端口没有端口限制。
iptables
验证是否没有阻止所需边缘端口上节点之间的连接的 iptables 政策。如有必要,您可以在安装期间使用以下命令停止 iptables:
sudo/etc/init.d/iptables stop
在 CentOS 7.x 上:
systemctl stop firewalld
目录访问权限
下表列出了对 Edge 进程有特殊要求的 Edge 节点上的目录:
服务 | 目录 | 说明 |
---|---|---|
路由器 | /etc/rc.d/init.d/functions |
边缘路由器使用 Nginx 路由器,并且需要对 如果您的安全流程要求您对 您可以将权限设置为 744,以允许对 |
ZooKeeper | /dev/random |
Zookeeper 客户端库需要拥有对随机数生成器 /dev/random 的读取权限。如果 /dev/random 在读取时被阻止,Zookeeper 服务可能无法启动。 |
卡桑德拉
所有 Cassandra 节点都必须连接到一个环。Cassandra 将数据副本存储在多个节点上,以确保可靠性和容错能力。每个 Edge 键空间的复制策略决定了副本所在的 Cassandra 节点。如需了解详情,请参阅 Cassandra 复制因子和一致性级别简介。
Cassandra 会根据可用内存自动调整其 Java 堆大小。如需了解详情,请参阅在出现性能下降或内存消耗较高时调整 Java 资源。
安装适用于私有云的 Edge 后,您可以通过检查 /opt/apigee/apigee-cassandra/conf/cassandra.yaml
文件来检查 Cassandra 是否已正确配置。例如,确保适用于私有云的 Edge 安装脚本设置了以下属性:
cluster_name
initial_token
partitioner
seeds
listen_address
rpc_address
snitch
PostgreSQL 数据库
安装 Edge 后,您可以根据系统上的可用 RAM 容量调整以下 PostgreSQL 数据库设置:
conf_postgresql_shared_buffers = 35% of RAM # min 128kB conf_postgresql_effective_cache_size = 45% of RAM conf_postgresql_work_mem = 512MB # min 64kB
如需设置这些值,请执行以下操作:
- 修改 postgresql.properties 文件:
vi /opt/apigee/customer/application/postgresql.properties
如果该文件不存在,请创建该文件。
- 设置上面列出的属性。
- 保存所做的修改。
- 重启 PostgreSQL 数据库:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
系统限制
确保您已在 Cassandra 和消息处理器节点上设置以下系统限制:
- 在 Cassandra 节点上,在
/etc/security/limits.d/90-apigee-edge-limits.conf
中为安装用户(默认值为“apigee”)设置软 memlock、硬 memlock、nofile 和地址空间 (as) 限制,如下所示:apigee soft memlock unlimited apigee hard memlock unlimited apigee soft nofile 32768 apigee hard nofile 65536 apigee soft as unlimited apigee hard as unlimited apigee soft nproc 32768 apigee hard nproc 65536
- 在消息处理器节点上,在
/etc/security/limits.d/90-apigee-edge-limits.conf
中将打开文件描述符的最大数量设置为 64K,如下所示:apigee soft nofile 32768 apigee hard nofile 65536
如有必要,您可以提高该上限。例如,如果您一次性打开了大量临时文件。
如果您在路由器或消息处理器
system.log
中看到以下错误,则文件描述符上限可能设置得过低:"java.io.IOException: Too many open files"
您可以运行以下命令来查看用户限制:
# su - apigee $ ulimit -n 100000
如果您在将文件描述符限制设置为
100000
后仍然达到打开文件数量上限,请向 Apigee Edge 支持开立工单,以便进一步排查问题。
网络威胁防护服务 (NSS)
网络安全服务 (NSS) 是一组库,支持开发具有安全功能的客户端应用和服务器应用。您应该确保已安装 NSS v3.19 或更高版本。
如需查看当前版本,请按以下步骤操作:
yum info nss
如需更新 NSS,请执行以下操作:
yum update nss
如需了解详情,请参阅 RedHat 的这篇文章。
使用 NSCD(名称服务缓存守护程序)时,在 IPv6 上停用 DNS 查找
如果您安装并启用 NSCD(名称服务缓存守护程序),则消息处理器将进行两次 DNS 查找:一次用于 IPv4,一次用于 IPv6。使用 NSCD 时,您应在 IPv6 上停用 DNS 查找。
要在 IPv6 上停用 DNS 查找功能,请执行以下操作:
- 在每个消息处理器节点上,修改
/etc/nscd.conf
- 设置以下属性:
enable-cache hosts no
在 Google Cloud Platform 上为 RedHat/CentOS 7 停用 IPv6
如果您要在 Google Cloud Platform 上的 RedHat 7 或 CentOS 7 上安装 Edge,则必须在所有 Qpid 节点上停用 IPv6。
如需了解如何停用 IPv6,请参阅您的具体操作系统版本的 RedHat 或 CentOS 文档。例如,您可以执行以下操作
- 在编辑器中打开
/etc/hosts
。 - 在以下第一行的列中插入一个“#”字符,以将其注释掉:
#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
- 保存文件。
AWS AMI
如果要在适用于 Red Hat Enterprise Linux 7.x 的 AWS Amazon 机器映像 (AMI) 上安装 Edge,则必须先运行以下命令:
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
工具
安装程序在 EL5 或 EL6 提供的标准版本中使用以下 UNIX 工具。
awk |
expr |
libxslt |
每分钟转数 |
unzip |
basename |
grep |
lua-socket |
rpm2cpio |
添加 |
bash |
hostname |
ls |
sed |
wc |
bc |
id |
net-tools |
sudo |
wget |
curl |
利巴约 |
perl(来自 procps) |
tar |
谢尔塞斯-C |
Cyrus-Sasl | libdb4 | pgrep(来自 procps) | tr | 美味 |
date |
libdb-cxx |
ps |
uuid |
chkconfig |
dirname | 附言 | pwd | uname | |
echo | librdmacm | python |
ntpdate
Apigee 建议您同步服务器的时间。如果尚未配置,则 ntpdate
实用程序可以用于此目的,以验证服务器是否已进行时间同步。您可以使用 yum install ntp
安装该实用程序。这在复制 OpenLDAP 设置时特别有用。请注意,您将服务器时区设置为世界协调时间 (UTC)。
openldap 2.4
本地安装需要 OpenLDAP 2.4。如果您的服务器已连接到互联网,则 Edge 安装脚本会下载并安装 OpenLDAP。如果您的服务器未连接到互联网,则必须先确保已安装 OpenLDAP,然后再运行 Edge 安装脚本。在 RHEL/CentOS 上,您可以运行 yum install openldap-clients openldap-servers
来安装 OpenLDAP。
对于 13 台主机安装以及 12 台主机安装和 2 个数据中心,需要进行 OpenLDAP 复制,因为有多个节点托管 OpenLDAP。
防火墙和虚拟主机
在 IT 领域,virtual
这个术语通常很常见,因此它用于私有云部署和虚拟主机的 Apigee Edge。澄清一下,virtual
这个术语有两个主要用途:
- 虚拟机 (VM):不是必需的,但某些部署使用虚拟机技术为其 Apigee 组件创建隔离服务器。虚拟机主机(如物理主机)可以具有网络接口和防火墙。
- 虚拟主机:网络端点,类似于 Apache 虚拟主机。
虚拟机中的路由器可以公开多个虚拟主机(只要这些主机的主机别名或接口端口各不相同)。
举一个命名示例,单个物理服务器 A
可能正在运行两个虚拟机,分别名为“VM1”和“VM2”。假设“VM1”公开了一个虚拟以太网接口,该接口在虚拟机内被命名为“eth0”,虚拟化机器或网络 DHCP 服务器为其分配了 IP 地址 111.111.111.111
;然后假设 VM2 公开了一个名为“eth0”的虚拟以太网接口,并为其分配了一个 IP 地址 111.111.111.222
。
两个虚拟机中可能都运行了一个 Apigee 路由器。路由器会公开虚拟主机端点,如以下假设示例所示:
VM1 中的 Apigee 路由器在其 eth0 接口(具有一些特定的 IP 地址)上公开了三个虚拟主机:api.mycompany.com:80
、api.mycompany.com:443
和 test.mycompany.com:80
。
VM2 中的路由器公开 api.mycompany.com:80
(与 VM1 公开的名称和端口相同)。
物理主机的操作系统可能具有网络防火墙;在这种情况下,必须将防火墙配置为通过与虚拟化接口(111.111.111.111:{80, 443}
和 111.111.111.222:80
)上公开的端口绑定的 TCP 流量。此外,每个虚拟机的操作系统都可能在其 eth0 接口上提供自己的防火墙,这些防火墙也必须允许端口 80 和 443 流量进行连接。
基本路径是将 API 调用路由到您可能已部署的不同 API 代理所涉及的第三个组成部分。如果 API 代理软件包具有不同的基本路径,则可以共享一个端点。例如,一个基本路径可以定义为 http://api.mycompany.com:80/
,另一个基本路径可以定义为 http://api.mycompany.com:80/salesdemo
。
在这种情况下,您需要某种负载平衡器或 Traffic Director,在两个 IP 地址(VM1 上的 111.111.111.111
和 VM2 上的 111.111.111.222
)之间拆分 http://api.mycompany.com:80/ 流量。此功能特定于您的特定安装,并由您的本地网络群组配置。
基本路径是在部署 API 时设置的。在上面的示例中,您可以使用主机别名为 api.mycompany.com
且端口设置为 80
的虚拟主机,为组织 mycompany-org
部署 mycompany
和 testmycompany
这两个 API。如果未在部署中声明基本路径,则路由器将不知道将传入请求发送到哪个 API。
但是,如果您使用 /salesdemo
的基础网址部署 API testmycompany
,则用户可以使用 http://api.mycompany.com:80/salesdemo
访问该 API。如果您使用基准网址 /
部署 API mycompany,那么您的用户将通过网址 http://api.mycompany.com:80/
访问该 API。
许可
每次安装 Edge 时,您都需要从 Apigee 获取唯一的许可文件。安装管理服务器时,您需要提供许可文件的路径,例如 /tmp/license.txt。
安装程序会将许可文件复制到 /opt/apigee/customer/conf/license.txt
。
如果许可文件有效,管理服务器会验证过期时间以及允许的消息处理器 (MP) 数量。如果任何许可设置已过期,您可以在以下位置找到日志:/opt/apigee/var/log/edge-management-server/logs
。在这种情况下,您可以与 Apigee Edge 支持团队联系,了解迁移详情。
如果您还没有许可,请联系 Apigee 销售团队。