如需在节点上安装 Edge，您首先要安装 Edge apigee-setup 实用程序。如果您所处的环境中的节点没有外部互联网连接，则还必须安装 Apigee 代码库的本地副本。
默认安装目录：/opt/apigee
Edge 会安装 /opt/apigee 目录中的所有文件。您无法更改此目录。不过，如果需要，您可以创建符号链接，将 /opt/apigee 映射到其他位置。如需了解详情，请参阅安装要求。
前提条件：停用 SELinux
您必须先停用 SELinux 或将其设置为宽容模式，然后才能安装 Edge apigee-setup 实用程序或任何 Edge 组件。如有必要，您可以在安装 Edge 后重新启用 SELinux。
- 在编辑器中打开
/etc/sysconfig/selinux。 - 设置
SELINUX=disabled或SELINUX=permissive - 保存修改内容。
- 重启节点。
- 如有必要，请在安装 Edge 后重新启用 SELinux，方法是重复执行此程序以设置
SELINUX=enabled。
前提条件：启用 EPEL 仓库
您必须启用 Extra Packages for Enterprise Linux (EPEL) 才能安装或更新 Edge，或创建本地代码库。您使用的命令取决于 RedHat/CentOS 版本：
- 对于 Red Hat/CentOS/Oracle 8.x：
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm - 对于 Red Hat/CentOS/Oracle 9.x：
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm - 启用 Extra Packages for Enterprise Linux (EPEL)：
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- 停用 Postgres 和 Nginx：
sudo dnf module disable postgresql
sudo dnf module disable nginx - 启用 Extra Packages for Enterprise Linux (EPEL)：
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- 停用 Postgres 和 Nginx：
sudo dnf module disable postgresql
sudo dnf module disable nginx - 从 Apigee 获取用于访问 Apigee 代码库的用户名和密码。 如果您已有 Apigee FTP 站点的 username:password，则可以使用这些凭据。
- 以 root 身份登录节点，安装 Edge RPM
- 停用 SELinux。
- 启用 EPEL 代码库。
- 如果您要在 RHEL 9/Rocky 9/Oracle 9 上安装，请按照 RHEL 9/Rocky 9/Oracle 9 的前提条件中的步骤操作。
- 将 Edge
bootstrap_4.53.01.sh文件下载到/tmp/bootstrap_4.53.01.sh：curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- 安装 Edge apigee-service 实用程序和依赖项：
sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
其中，uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入该值。
默认情况下，安装程序会检查您是否已安装 Java 1.8。如果您未安装，系统会为您安装。使用
JAVA_FIX选项指定如何处理 Java 安装。JAVA_FIX采用以下值：- I：安装 OpenJDK 1.8（默认）
- C：继续但不安装 Java
- 问：退出。如果选择此选项，您必须自行安装 Java。
安装 apigee-service 实用程序会创建 /etc/yum.repos.d/apigee.repo 文件，该文件用于定义 Apigee 代码库。如需查看定义文件，请使用以下命令：
cat /etc/yum.repos.d/apigee.repo
如需查看代码库内容，请使用以下命令：
sudo yum -v repolist 'apigee*'
- 使用 apigee-service 安装 apigee-setup 实用程序：
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情，请参阅在节点上安装 Edge 组件。
- 在
/etc/yum.conf中添加 HTTP 代理配置 - 在
/etc/environment中添加全局 HTTP 代理配置 - Apigee Edge 代码库：如创建本地 Apigee 代码库中所述。
- Extra Packages for Enterprise Linux（或 EPEL）：您的运营团队应该能够为您设置此功能。
- 从 Apigee 获取用于访问 Apigee 代码库的用户名和密码。 如果您已有 Apigee FTP 网站的用户名和密码，则可以使用这些凭据。
- 以根用户身份登录节点，以安装 Edge RPM。
- 如上所述，停用 SELinux。
- 将 Edge
bootstrap_4.53.01.sh文件下载到/tmp/bootstrap_4.53.01.sh：curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- 安装 Edge apigee-service 实用程序和依赖项：
sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
其中，uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入该值。
- 在节点上安装
apigee-mirror实用程序：/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 使用
apigee-mirror实用程序将 Apigee 代码库同步到/opt/apigee/data/apigee-mirror/repos/目录。为尽可能减小代码库的大小，请添加
--only-new-rpms以仅下载最新的 RPM。 -
（可选）如果您想将 Edge 从本地代码库安装到托管本地代码库的同一节点上，则需要先运行以下命令：
- 从本地代码库运行
bootstrap_4.53.01.sh以安装apigee-service实用程序：sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- 使用
apigee-service安装apigee-setup实用程序：/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup在节点上安装和配置 Edge 组件。如需了解详情，请参阅在节点上安装 Edge 组件。
- 从本地代码库运行
- 创建代码库的 .tar 文件，将该 .tar 文件复制到节点，然后从该 .tar 文件安装 Edge。
- 在具有本地代码库的节点上安装 Web 服务器，以便其他节点可以访问该代码库。 Apigee 提供了 Nginx Web 服务器供您使用，您也可以使用自己的 Web 服务器。
- 在具有本地代码库的节点上，使用以下命令将本地代码库打包到名为
/opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz的单个 .tar 文件中：/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 将 .tar 文件复制到要安装 Edge 的节点。例如，将其复制到新节点上的
/tmp目录。 - 在新节点上，如上所述停用 SELinux。
- 在新节点上，确保您可以访问本地 Yum 实用程序 repo 和 EPEL repo。
- 仔细检查是否已停用所有外部互联网代码库（由于您是在无法访问互联网的机器上进行安装，因此应已停用）：
sudo yum repolist
所有外部代码库都应停用，但本地 Apigee 代码库和内部代码库应启用。
- 使用
apigee-service安装apigee-setup实用程序：/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup在节点上安装和配置 Edge 组件。如需了解详情，请参阅在节点上安装 Edge 组件。 - 在 repo 节点上安装 Nginx Web 服务器：
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- 默认情况下，Nginx 配置为使用 localhost 作为服务器名称和端口 3939。如需更改这些值，请执行以下操作：
- 在编辑器中打开
/opt/apigee/customer/application/mirror.properties。 如果该文件不存在，请创建一个。 - 根据需要设置以下值：
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- 重启 Nginx：
/opt/nginx/scripts/apigee-nginx restart
- 在编辑器中打开
- 默认情况下，该代码库需要提供用户名：密码
admin:admin。如需更改这些凭据，请设置以下环境变量：MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- 在新节点上，确保 EPEL 代码库已在本地启用。
- 在新节点上，按照上述说明检查
libdb4的版本。 - 在远程节点上，安装 Edge
apigee-service实用程序和依赖项：sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中，uName:pWord 是代码库用户名和密码。
- 在远程节点上，使用
apigee-service安装apigee-setup实用程序：/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 使用
apigee-setup在远程节点上安装和配置 Edge 组件。 如需了解详情，请参阅在节点上安装 Edge 组件。 - 将 Edge bootstrap_4.53.01.sh 文件下载到
/tmp/bootstrap_4.53.01.sh：curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- 运行 Edge
bootstrap_4.53.01.sh文件：sudo bash/tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
其中，uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入该值。
- 更新
apigee-mirror：/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- 执行同步：
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- 如果您想导出整个代码库，请执行以下操作：
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
RHEL 8/Rocky 8/Oracle 8 的前提条件
如果您要在运行 Red Hat Enterprise Linux (RHEL) 8 的服务器上安装 Edge，请在执行安装之前完成以下步骤：
RHEL 9/Rocky 9/Oracle 9 的前提条件
如果您要在运行 Red Hat Enterprise Linux (RHEL) 9、Rocky 9 或 Oracle 9 的服务器上安装 Edge，请先完成以下步骤，然后再执行安装：
如需了解 PostgreSQL 和 LDAP 的预安装变更，请分别参阅 PostgreSQL 数据库预安装要求和 SymasLDAP 2.6.7 预安装变更。
在具有外部互联网连接的节点上安装 Edge apigee-setup 实用程序
如需在具有外部互联网连接的节点上安装 Edge，请执行以下操作：
问题排查
尝试在具有外部互联网连接的节点上安装时，您可能会遇到以下一个或多个错误：
Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm bootstrap.sh: Error: Repo configuration failed error: package package_name is not installed
下表列出了针对这些错误的一些可能解决方法：
| 错误类型 | 可能的解决方案 |
|---|---|
| 密码包含无效字符 | 请勿在 Apigee 密码中使用特殊字符。 |
| 连接问题 | 执行以下 nc -v software.apigee.com 443 您应该会看到如下所示的消息： Connection to software.apigee.com 443 port [tcp/https] succeeded! 如果您未安装 telnet software.apigee.com 443 如果命令成功执行，您可以使用 CTRL+C 中止打开的连接。 如果任一命令失败，则表示网络连接受限或没有网络连接。请咨询您的网络管理员。 |
| 凭据不正确 | 确保您的用户名和密码正确无误。 例如，检查您尝试使用以下命令（使用您的 Apigee 用户名和密码）时是否会收到错误： curl -i -u username:password https://software.apigee.com/apigee-repo.rpm |
| 代理问题 | 您的本地配置使用出站 HTTP 代理，但您尚未将同一配置扩展到 yum 软件包管理器。检查环境变量：
echo $http_proxy
对于出站 HTTP 代理，您应使用以下选项之一： |
在没有外部互联网连接的节点上安装 Edge apigee-setup 实用程序
如果您的 Edge 节点位于防火墙后面，或者以某种其他方式被禁止访问互联网，那么您必须创建多个包含安装期间所需文件的代码库或镜像。然后，所有节点都必须能够访问这些镜像。创建完成后，节点便可访问这些本地镜像来安装 Edge。
对于没有互联网连接的节点，Apigee Edge 安装过程需要访问以下本地代码库：
创建本地 Apigee 代码库
如需创建内部 Apigee 代码库，您需要一个具有外部互联网访问权限的节点，以便能够下载 Edge RPM 和依赖项。创建内部代码库后，您可以将其移至另一个节点，或使 Edge 节点能够访问该节点以进行安装。
创建本地 Apigee 代码库后，您可能需要在日后使用最新的 Edge 版本文件对其进行更新。以下部分介绍了如何创建本地 Apigee 代码库以及如何更新该代码库。
如需创建本地 Apigee 代码库，请执行以下操作：
从本地代码库在远程节点上安装 apigee-setup
您可以通过两种方式从本地代码库安装 Edge。您可以执行以下任一项操作：
从 .tar 文件安装
如需从 .tar 文件进行安装，请执行以下操作：
使用 Nginx Web 服务器从代码库安装
如需使用 Nginx Web 服务器从代码库进行安装，请执行以下操作：
更新本地 Apigee 代码库
如需更新 repo，您必须下载最新的 bootstrap_4.53.01.sh 文件，然后执行新的同步。
如需更新代码库，请执行以下操作：
清理本地 Apigee 代码库
清理本地代码库会删除 /opt/apigee/data/apigee-mirror 和 /var/tmp/yum-apigee-*.
如需清理本地代码库，请使用：
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean