安装要求

硬件要求

您必须满足以下最低硬件要求，才能获得高可用性 部署在生产级环境中的基础架构。

以下视频为您提供了安装时的总体尺寸调整指南：

对于安装拓扑中描述的所有安装场景，下表中列出了 对安装组件的最低硬件要求

在以下表格中，除了要用到的磁盘可用空间之外， 操作系统根据您的应用和网络流量，您的安装可能 所需的资源比下面列出的资源要多或少。

安装组件 RAM CPU 硬盘最低要求
Cassandra 16 GB 8 核 250GB 本地存储空间，配备支持 2000 IOPS 的 SSD
同一台机器上的消息处理器/路由器 16 GB 8 核 100GB
消息处理器（独立） 16 GB 8 核 100GB
路由器（独立） 16 GB 8 核 100GB
分析 - 同一服务器上的 Postgres/Qpid 16GB* 8 核* 500GB - 1TB** 网络存储空间***，最好带 SSD 后端， 支持 1000 IOPS 或更高*
分析 - Postgres 主服务器或备用服务器（独立） 16GB* 8 核* 500GB - 1TB** 网络存储空间***，最好有 SSD 后端，支持 1,000 IOPS 或更高*
Google Analytics- Qpid 独立式 16 GB 8 核 30GB - 50GB 本地存储空间（含 SSD）

Qpid 队列的默认大小为 1 GB，可增加到 2 GB。如果您需要 请添加更多 Qpid 节点。
OpenLDAP/界面/管理服务器 8 GB 4 核 60 GB
界面/管理服务器 4GB 2 核 60 GB
OpenLDAP（独立） 4GB 2 核 60 GB

* 根据吞吐量调整 Postgres 系统要求：

  • 低于 250 TPS：可以考虑使用 8GB、4 核实例，并搭配支持 1,000 IOPS 或更高的托管网络存储空间***
  • 高于 250 TPS：16GB、8 核、托管式网络存储空间*** 支持 1000 IOPS 或更高
  • 大于 1,000 TPS：16GB、8 核、托管式网络存储空间***，支持 2,000 IOPS 或更高
  • 大于 2000 TPS：32GB、16 核、托管式网络存储空间***，支持 2000 IOPS 或更高
  • 大于 4000 TPS：64GB、32 核、托管式网络存储空间***，支持 4000 IOPS 或更高 IOPS

** Postgres 硬盘值基于 Edge 捕获的开箱即用分析。 如果您向分析数据添加自定义值，则应相应地增加这些值。使用以下公式估算所需存储空间：

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

例如：

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB of storage needed

*** 建议为 Postgresql 数据库使用 Network Storage，因为：

  • 它能够在以下情况下动态增加存储空间大小： 必填字段。
  • 在当今的大部分 环境/存储/网络子系统。
  • 可以在备份和恢复过程中启用存储级快照 解决方案。

此外，如果您想安装变现服务（不支持“一站式”安装），请参阅下方列出的硬件要求：

支持创收功能的组件 RAM CPU 硬盘
管理服务器（包含创收服务） 8 GB 4 核 60 GB
分析 - 同一服务器上的 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 系统用户。边缘目录和 “apigee”拥有的文件和 Edge 进程均拥有。这意味着 Edge 组件以 “apigee”用户。如有必要，您可以以其他用户身份运行组件。

安装目录

默认情况下，安装程序会将所有文件写入 /opt/apigee 目录。您 无法更改此目录位置。虽然您无法更改此目录，但可以创建一个 用于将 /opt/apigee 映射到其他位置的符号链接，如 从 /opt/apigee 创建符号链接。

在本指南中的说明中，安装目录记为 /opt/apigee。

在创建符号链接之前，您必须先创建一个名为“apigee”的用户和群组。这是 Edge 安装程序创建的同一组和用户。

如需创建符号链接，请先执行以下步骤，然后再下载 bootstrap_4.50.00.sh 文件。 您必须以 root 用户身份执行以下所有步骤：

  1. 创建“apigee”用户和群组： 
    groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. 创建从 /opt/apigee 到所需安装根目录的符号链接： 
    ln -Ts /srv/myInstallDir /opt/apigee

    其中 /srv/myInstallDir 是 Edge 文件所需的位置。

  3. 将安装根目录和符号链接的所有权更改为“apigee”用户： 
    chown -h apigee:apigee /srv/myInstallDir /opt/apigee

投放网络设置

Apigee 建议您在安装之前检查网络设置。安装程序 希望所有机器都具有固定的 IP 地址。使用以下命令验证设置：

  • hostname 会返回机器的名称
  • hostname -i 会返回可从其他机器访问的主机名的 IP 地址。

根据您的操作系统类型和版本，您可能需要修改 /etc/hosts 和 /etc/sysconfig/network（如果主机名不是） 设置正确。如需了解详情，请参阅具体操作系统的文档。

如果服务器有多张接口卡，“主机名 -i”命令会返回以空格分隔的 IP 地址列表。默认情况下，Edge 安装程序使用返回的第一个 IP 地址， 并非在所有情况下都正确。作为替代方案，您可以在 安装配置文件：

ENABLE_DYNAMIC_HOSTIP=y

将该属性设置为“y”后，安装程序会提示您选择要用作 IP 地址的 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 节点上具有特殊要求的目录， 边缘进程：

服务 目录 说明
路由器 /etc/rc.d/init.d/functions

边缘路由器使用 Nginx 路由器，并且需要 /etc/rc.d/init.d/functions。

如果您的安全流程要求您为 /etc/rc.d/init.d/functions 设置权限，请勿将其设置为 700，否则路由器将无法启动。

您可以将权限设置为 744，以允许对 /etc/rc.d/init.d/functions 进行读取访问。
ZooKeeper /dev/random Zookeeper 客户端库需要对随机数生成器 /dev/random 具有读取权限。如果 /dev/random 在读取时被屏蔽，则 Zookeeper 服务可能无法启动。

Cassandra

所有 Cassandra 节点都必须连接到一个环。Cassandra 会在多个节点上存储数据副本，以确保可靠性和容错能力。每个 Pod 的复制策略 边缘键空间决定了副本所在的 Cassandra 节点。有关详情，请参阅 关于 Cassandra 复制因子和一致性级别。

Cassandra 会根据可用内存自动调整其 Java 堆大小。如需了解详情，请参阅在性能下降或内存用量过高时调整 Java 资源。

安装适用于私有云的 Edge 后，您可以检查 Cassandra 是否已配置 检查 /opt/apigee/apigee-cassandra/conf/cassandra.yaml 文件。例如，确保 Edge for Private Cloud 安装脚本设置了以下属性：

  • 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

如需设置这些值，请执行以下操作：

  1. 修改 postgresql.properties 文件： 
    vi /opt/apigee/customer/application/postgresql.properties

    如果该文件不存在，请创建该文件。

  2. 设置上面列出的属性。
  3. 保存所做的修改。
  4. 重启 PostgreSQL 数据库： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

系统限制

确保您已在 Cassandra 和消息处理器节点上设置以下系统限制：

  • 在 Cassandra 节点上，针对 /etc/security/limits.d/90-apigee-edge-limits.conf 中的安装用户（默认值为“apigee”） 如下所示： 
    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

    如需了解详情，请参阅 Apache Cassandra 文档中的推荐的生产设置。

  • 在消息处理器节点上，将打开文件描述符的最大数量设置为 64K 在 /etc/security/limits.d/90-apigee-edge-limits.conf 中，如下所示： 
    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 3.19 或更高版本。

如需查看当前的版本，请执行以下操作：

yum info nss

如需更新 NSS，请执行以下操作：

yum update nss

请参阅这篇文章 了解详情。

使用 NSCD（名称服务缓存守护程序）时，停用 IPv6 上的 DNS 查找

如果已安装并启用 NSCD（名称服务缓存守护程序），则消息处理器 进行两次 DNS 查找：一次用于 IPv4，另一次用于 IPv6。使用 NSCD 时，您应停用 IPv6 上的 DNS 查找。

如需停用 IPv6 上的 DNS 查找，请执行以下操作：

  1. 在每个消息处理器节点上，修改 /etc/nscd.conf
  2. 设置以下属性： 
    enable-cache hosts no

在 Google Cloud Platform 上停用适用于 RedHat/CentOS 7 的 IPv6

如果您要在 Google Cloud Platform 上的 RedHat 7 或 CentOS 7 上安装 Edge，则需要 必须在所有 Qpid 节点上停用 IPv6。

有关说明，请参阅您所用操作系统版本的 RedHat 或 CentOS 文档。 停用 IPv6。例如，您可以：

  1. 在编辑器中打开 /etc/hosts。
  2. 插入“#”字符，以将其注释掉： 
    #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
  3. 保存文件。

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 提供的标准版中使用以下 UNIX 工具，或者 EL6。

awk

expr

libxslt

每分钟转数

unzip

basename

grep

lua-socket

rpm2cpio

useradd

bash

 主机名

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

利巴约

perl（来自 procps）

tar

xerces-c
Cyrus-Sasl libdb4 pgrep（通过 procps 提供） tr 美味

日期

 libdb-cxx

ps

uuid

chkconfig
dirname 附言 pwd uname  
echo librdmacm Python    

ntpdate

Apigee 建议您确保服务器时间保持同步。如果尚未配置，ntpdate 实用程序可以用于此目的，用于验证服务器是否同步了时间。您可以使用 yum install ntp 来安装 实用程序。这对于复制 OpenLDAP 设置特别有用。请注意，您设置了 时区。

openldap 2.4

本地安装需要 OpenLDAP 2.4。如果您的服务器已连接到互联网， 然后下载并安装 OpenLDAP.如果您的服务器没有连接到互联网，您必须先确保已安装 OpenLDAP，然后才能运行 Edge 安装脚本。在 RHEL/CentOS 上，您可以运行 yum install openldap-clients openldap-servers 来安装 OpenLDAP。

对于 13 台主机安装以及具有 2 个数据中心的 12 台主机安装：OpenLDAP 由于有多个托管 OpenLDAP 的节点，因此需要进行复制。

防火墙和虚拟主机

在 IT 领域，virtual 这个术语通常会被过度使用，适用于私有云的 Apigee Edge 部署和虚拟主机也是如此。需要说明的是，virtual 一词有两种主要用法：

  • 虚拟机 (VM)：不是必需的，但部分部署会使用虚拟机技术 为 Apigee 组件创建独立的服务器。与物理主机一样，虚拟机主机可以有网络接口和防火墙。
  • 虚拟主机：Web 端点，类似于 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）。在 此外，每个虚拟机的操作系统可能在其 eth0 接口上提供自己的防火墙， 还必须允许端口 80 和 443 流量进行连接。

基本路径是将 API 调用路由到您可能已部署的不同 API 代理时涉及的第三个组件。API 代理软件包可以共享端点，前提是它们具有不同的基路径。例如，一个基准路径可以定义为 http://api.mycompany.com:80/，另一个基准路径可以定义为 http://api.mycompany.com:80/salesdemo。

在这种情况下，您需要通过某种类型的负载平衡器或 Traffic Director 来拆分 http://api.mycompany.com:80/ 两个 IP 地址之间的流量 （在 VM1 上为 111.111.111.111，在 VM2 上为 111.111.111.222）。此函数因您的具体安装而异，由本地网络组配置。

基本路径是在部署 API 时设置的。在上述示例中，您可以为组织 mycompany-org 部署两个 API（mycompany 和 testmycompany），虚拟主机的主机别名为 api.mycompany.com，端口设置为 80。如果您没有声明 基本路径，则路由器不知道要发送传入请求的 API 目标。

不过，如果您使用以下基准网址部署 API testmycompany： /salesdemo，则用户可通过如下方式访问该 API： http://api.mycompany.com:80/salesdemo。如果您使用基准网址 / 部署 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 销售团队联系。