边缘安装概览

适用于私有云的 Edge v4.19.01

典型的 Edge 安装由分布在多个节点中的 Edge 组件组成。 在节点上安装 Edge 后，可以在节点上安装并配置一个或多个 Edge 组件 节点。

安装流程

在节点上安装 Edge 的过程分为多个步骤：

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

      请参阅安装 Edge apigee-setup 实用程序 。

  6. 使用 apigee-setup 实用程序在每个设备上安装一个或多个 Edge 组件 节点。

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

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

    如需了解详情，请参阅对组织进行初始配置。

  8. 安装完成后，在每个节点上重启 Edge 界面组件， 请参阅以下示例： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

谁可以执行安装

Apigee Edge 发行版文件作为一组 RPM 和依赖项安装。接收者 安装、卸载和更新 Edge RPM，必须由 root 用户或用户运行这些命令 具有完整 sudo 访问权限的用户运行。对于完整的 sudo 访问权限，这意味着用户有权执行 sudo 与 root 相同的操作。

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

  • apigee-service 实用程序： <ph type="x-smartling-placeholder">
      </ph>
    • apigee-service 命令：install, uninstall, update。
    • apigee-all 命令：install, uninstall, update。
  • setup.sh 脚本来安装 Edge 组件（除非您已使用 “apigee-service install”安装所需的每千次展示收入然后执行 root 或完整 sudo 访问。）
  • update.sh 脚本，用于更新 Edge 组件

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

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

  • apigee-service 实用程序命令，包括： <ph type="x-smartling-placeholder">
      </ph>
    • 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”或者，如果您更改了用户 从“apigee”运行 Edge 服务对运行您文件的用户 Edge 服务

将 Edge 安装任务分离开根用户和非根用户

虽然以根用户或 具有完整的 sudo 访问权限，这并非总是可行。相反，您可以将 进程转换为由 root 执行的任务，以及由具有 对“apigee”的完整 sudo 访问权限用户。

  1. root 执行的任务： <ph type="x-smartling-placeholder">
      </ph>
    1. 下载并运行 bootstrap_4.19.01.sh 文件： 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
sudo bash /tmp/bootstrap_4.19.01.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-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server。

  2. root 用户在节点上安装 Edge RPM 后，拥有完全 sudo 访问权限的用户 “apigee”用户完成配置过程： <ph type="x-smartling-placeholder">
      </ph>
    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

安装配置文件的位置

您必须将配置文件传递给 apigee-setup 实用程序，其中包含 有关 Edge 安装的信息。静默安装的唯一要求是 配置文件必须可供“apigee”访问或读取用户。例如，将文件 （位于节点上的 /usr/local/var 或 /usr/local/share 目录中），以及 将其 chown 更改为“apigee:apigee”。

除 Edge 系统外，配置文件中的所有信息都需要 管理员密码。如果您省略密码，apigee-setup 实用程序会提示您 您需要在命令行中输入该密码。

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

处理安装失败问题

如果 Edge 组件安装失败，您可以尝试更正 问题，然后再次运行安装程序。安装程序可在 之后您想更改或更新组件 安装。

安装或升级后，请务必在 运行状态

互联网安装或非互联网安装

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

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

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

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

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

    要创建内部 Apigee 代码库，您确实需要一个具有外部互联网的节点 以便下载 Edge RPM 和依赖项。创建 你可以将其移至其他节点，或将该节点设为可供边缘访问 节点进行安装。

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

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

<ph type="x-smartling-placeholder">

解析 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 操作指南》中，安装根目录标注为：

/opt/apigee

安装过程使用以下文件系统结构来部署专用 Apigee Edge Cloud 的最新动态和提示。

日志文件

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

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

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

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

组件 位置

管理服务器

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

路由器

 /opt/apigee/var/log/edge-router

边缘路由器使用 Nginx 实现。如需了解其他日志，请参阅：

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

消息处理器

 /opt/apigee/var/log/edge-message-processor

Apigee Qpid 服务器

 /opt/apigee/var/log/edge-qpid-server
Apigee Postgres 服务器 /opt/apigee/var/log/edge-postgres-server
Edge 界面 /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra
Qpidd 卡 /opt/apigee/var/log/apigee-qpidd
PostgreSQL 数据库 /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

数据

组件 位置
管理服务器 /opt/apigee/data/edge-management-server
路由器 /opt/apigee/data/edge-router
消息处理器 /opt/apigee/data/edge-message-processor
Apigee Qpid 代理 /opt/apigee/data/edge-qpid-server
Apigee Postgres 代理 /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd 卡 /opt/apigee/data/apigee-qpid/data
PostgreSQL 数据库 /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

启用系统检查（安装时）

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

ENABLE_SYSTEM_CHECK=y

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