边缘安装概览

典型的 Edge 安装由分布在多个节点上的 Edge 组件组成。 在节点上安装 Edge 后，您需要在该节点上安装和配置一个或多个 Edge 组件，然后将其安装到 节点上。

安装流程

在节点上安装 Edge 是一个多步骤的过程：

1. 在节点上停用 SELinux 或将其设置为宽容模式。如需了解详情，请参阅 安装 Edge apigee-setup 实用程序。
2. 确定是否要启用 Cassandra 身份验证。
3. 确定是否要为 Postgres 设置主备复制。
4. 从推荐的拓扑列表中选择 Edge 配置。例如，您 可以在单个节点上安装 Edge 以进行测试，也可以在 13 个节点上安装 Edge 以进行生产。如需了解详情，请参阅 安装拓扑。
5. 在所选拓扑中的每个节点上，安装 Edge apigee-setup 实用程序：
   • 将 Edge bootstrap_4.54.00.sh 文件下载到 /tmp/bootstrap_4.54.00.sh。
   • 安装 Edge apigee-service 实用程序和依赖项。
   • 安装 Edge apigee-setup 实用程序和依赖项。

     如需了解详情，请参阅安装 Edge apigee-setup 实用程序。

6. 使用 apigee-setup 实用程序在每个 节点上安装一个或多个 Edge 组件，具体取决于您选择的拓扑。

   请参阅在节点上安装 Edge 组件。

7. 在管理服务器节点上，使用 apigee-setup 实用程序安装 apigee-provision，即用于创建和管理 Edge 组织的实用程序。

   如需了解详情，请参阅组织上架。

8. 安装完成后，在每个节点上重启 New Edge 界面组件， 如以下示例所示：

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. 为 New Edge 界面（其组件名称为 edge-management-ui 和 edge-management-ui-static）配置身份验证和可选设置。

   如需了解详情，请参阅配置 New Edge 界面。

安装完成后，请查看此 常见安装后操作列表。

谁可以执行安装

Apigee Edge 分发文件以一组 RPM 和依赖项的形式安装。如需 安装、卸载和更新 Edge RPM，必须由根用户或具有完整 sudo 访问权限的用户 运行这些命令。对于完整 sudo 访问权限，这意味着用户具有 sudo 访问权限，可以执行 与根用户相同的操作。

任何想要运行以下命令或脚本的用户都必须是根用户，或者具有完整 sudo 访问权限的用户 ：

• apigee-service 实用程序：
  • apigee-service 命令：install, uninstall, update。
  • apigee-all 命令：install, uninstall, update。
• setup.sh 脚本，用于安装 Edge 组件（除非您已使用 "apigee-service install" 安装所需的 RPM。如果不需要，则使用根用户或完整 sudo 访问权限。）
• update.sh 脚本，用于更新 Edge 组件

此外，Edge 安装程序会在您的系统上创建一个名为“apigee”的新用户。许多 Edge 命令 会调用 sudo 以“apigee”用户的身份运行。

任何想要运行除上述命令之外的所有其他命令的用户都必须是具有 对“apigee”用户的完整 sudo 访问权限的用户。这些命令包括：

• apigee-service 实用程序命令，包括：
  • apigee-service 命令，例如 start, stop, restart, configure。
  • apigee-all 命令，例如 start, stop, restart, configure。

创建具有对“apigee”用户的完整 sudo 访问权限的用户

如需将用户配置为具有对“apigee”用户的完整 sudo 访问权限，请使用“visudo”命令来 修改 sudoers 文件以添加：

installUser        ALL=(apigee)      NOPASSWD: ALL

其中，installUser 是使用 Edge 的人员的用户名。

设置配置文件的权限

Edge 命令使用的任何文件或资源都必须可供“apigee”用户访问。这 包括 Edge 许可文件和任何配置文件。

创建配置文件时，您可以将其所有者更改为“apigee:apigee”，以确保 Edge 命令可以访问该文件：

1. 以任何用户的身份在编辑器中创建文件。
2. chown 文件所有者为“apigee:apigee”，或者，如果您将运行 Edge 服务的用户从“apigee”用户更改为其他用户，则将文件 chown 为运行 Edge 服务的用户。

在根用户和非根用户之间分离 Edge 安装任务

虽然以根用户或具有完整 sudo 访问权限的用户身份执行整个 Edge 安装过程最简单，但并非总是可行。您可以将该 过程分为由根用户执行的任务和由具有 对“apigee”用户的完整 sudo 访问权限的用户执行的任务。

1. 由根用户执行的任务：
   1. 下载并运行 bootstrap_4.54.00.sh 文件：

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      此步骤会安装 apigee-service 实用程序并创建“apigee” 用户。

   2. 将用户配置为具有对“apigee”用户的完整 sudo 访问权限，如 创建具有对“apigee”用户的完整 sudo 访问权限的用户中所述。
   3. 安装 apigee-setup 实用程序：

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. 使用 apigee-setup 实用程序在节点上安装 Edge RPM：

      /opt/apigee/apigee-service/bin/apigee-service compName install

      您在节点上安装的 Edge RPM 取决于您的拓扑。可用组件列表包括：apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server。

2. 根用户在节点上安装 Edge RPM 后，具有对 “apigee”用户的完整 sudo 访问权限的用户会完成配置过程：
   1. 使用 setup.sh 实用程序完成节点上 Edge 组件的配置。命令的形式取决于您在节点上安装的组件。如需查看完整列表，请参阅 在节点上安装 Edge 组件。

      例如，如需完成 ZooKeeper 和 Cassandra 的安装，请使用以下 命令：

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      其中，configFile 是 Edge 配置文件。

      或者，如需执行一体式安装，请使用以下命令：

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

安装配置文件的位置

您必须将包含 Edge 安装相关信息的配置文件传递给 apigee-setup 实用程序。静默安装的唯一要求是 配置文件必须可供“apigee”用户访问或读取。例如，将文件 放在节点上的 /usr/local/var 或 /usr/local/share 目录中，并 chown 它到 "apigee:apigee"。

配置文件中的所有信息都是必需的，但 Edge system administrator's password 除外。如果您省略密码，apigee-setup 实用程序会提示 您在命令行中输入密码。

如需了解详情，请参阅在节点上安装 Edge 组件。

处理安装失败

如果 Edge 组件的安装过程中出现失败，您可以尝试更正 问题，然后再次运行安装程序。安装程序旨在在检测到失败时重复运行，或者如果您稍后想要在安装后更改或更新组件。

安装或升级后，请务必在运行 New Edge 界面组件的每个节点上重启该组件。

互联网或非互联网安装

如需在节点上安装 Edge，该节点必须能够访问 Apigee 代码库：

• 具有外部互联网连接的节点

  具有外部互联网连接的节点访问 Apigee 代码库以安装 Edge RPM 和依赖项。

• 没有外部互联网连接的节点

  没有外部互联网连接的节点可以访问您在内部设置的 Apigee 代码库的镜像版本。此代码库包含所有 Edge RPM，但您必须确保可以从内部网络上的代码库获取所有其他依赖项。

  如需创建内部 Apigee 代码库，您确实需要一个具有外部互联网 访问权限的节点，以便能够下载 Edge RPM 和依赖项。创建内部代码库后，您可以将其移至另一个节点，也可以使该节点可供 Edge 节点访问以进行安装。

使用本地 Edge 代码库来维护 Edge 版本

使用本地或镜像代码库的原因之一是在没有外部互联网连接的节点上安装 Edge ，如上一部分所述。

解决 RPM 安装依赖项

Apigee Edge 分发文件以一组 RPM 文件的形式安装，每个文件都可以有 自己的安装依赖项链。许多此类依赖项由 Apigee 无法控制且可以随时更改的第三方 组件定义。因此， 文档不会列出每个依赖项的明确版本号。

如果您在具有互联网访问权限的机器上执行安装，则节点可以下载 必要的 RPM 和依赖项。但是，如果您从没有互联网 访问权限的节点进行安装，则通常需要设置一个包含所有必要依赖项的内部代码库。确保本地代码库中包含所有依赖项的唯一方法是尝试安装，找出任何缺失的依赖项，然后将其复制到本地代码库，直到安装成功。

常用 Yum 命令

适用于 Linux 的 Edge 安装工具依赖于 Yum 来安装和更新组件。您可能需要使用多个 Yum 命令来管理节点上的安装。

• 清除所有 Yum 缓存：

  sudo yum clean all

• 如需更新 Edge 组件：

  sudo yum update componentName

  例如：

  sudo yum update apigee-setup
  sudo yum update edge-management-server

文件系统结构

Edge 会将所有文件安装在 /opt/apigee 目录中。

在本指南和 Edge Operations 指南中，根安装目录表示为：

/opt/apigee

安装使用以下文件系统结构来部署 Apigee Edge for Private Cloud。

日志文件

apigee-setup 和 setup.sh 脚本的日志文件写入 /tmp/setup-root.log。

每个组件的日志文件都包含在 /opt/apigee/var/log 目录中。每个组件都有自己的子目录。例如，管理服务器的日志位于以下目录中：

/opt/apigee/var/log/edge-management-server

下表列出了日志文件的位置：

数据

在安装时启用系统检查

Edge 安装配置文件支持以下属性：

ENABLE_SYSTEM_CHECK=y

如果您将此属性设置为“y”，则安装程序会检查系统是否满足要安装的组件的 CPU 和 内存要求。默认值为“n”，用于停用 检查。