安装 Edge apigee-setup 实用程序

如需在节点上安装 Edge，您首先要安装 Edge apigee-setup 实用程序。如果您所处的环境中的节点没有外部互联网连接，则还必须安装 Apigee 代码库的本地副本。

默认安装目录：/opt/apigee

Edge 会将所有文件安装在 /opt/apigee 目录中。您无法更改此 目录。不过，如果需要，您可以创建一个符号链接，将 /opt/apigee 映射到 其他位置。如需了解详情，请参阅安装要求。

前提条件：停用 SELinux

您必须先停用 SELinux 或将其设置为宽容模式，然后才能安装 Edge apigee-setup 实用程序或任何 Edge 组件。如有必要，您可以在安装 Edge 后重新启用 SELinux。

  • 如需永久 停用 SELinux 或将其设置为宽容模式，请执行以下操作：
    1. 在编辑器中打开 /etc/sysconfig/selinux。
    2. 设置 SELINUX=disabled 或 SELINUX=permissive
    3. 保存所做的修改。
    4. 重启节点。
    5. 如有必要，请在安装 Edge 后重新启用 SELinux，方法是重复此过程以 设置 SELINUX=enabled。

    • 前提条件：启用 EPEL 代码库

    您必须启用 Extra Packages for Enterprise Linux（或 EPEL），才能安装或更新 Edge，或创建 本地代码库。对于 Red Hat Enterprise Linux (RHEL) 9.x、Rocky Linux 9.x 或 Oracle Linux 9.x，请运行以下命令：

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    RHEL 9/Rocky 9/Oracle 9 的前提条件

    如果您要在运行 Red Hat Enterprise Linux (RHEL) 9、Rocky 9 或 Oracle 9 的服务器上安装 Edge，请先完成以下步骤，然后再执行安装：

    1. 启用 Extra Packages for Enterprise Linux (EPEL)： 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. 停用 Postgres 和 Nginx： 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    如需了解 PostgreSQL 和 LDAP 的预安装更改，请分别参阅 PostgreSQL 数据库 预安装要求 和 SymasLDAP 2.6.10 预安装更改。

    在具有外部互联网 连接的节点上安装 Edge apigee-setup 实用程序

    如需在具有外部互联网连接的节点上安装 Edge，请执行以下操作：

    1. 从 Apigee 获取用于访问 Apigee 代码库的用户名和密码。 如果您已有 Apigee ftp 网站的 username:password，则可以使用那些 凭据。
    2. 以根用户身份登录节点，以安装 Edge RPM
    3. 停用 SELinux。
    4. 启用 EPEL 代码库。
    5. 如果您要在 RHEL 9/Rocky 9/Oracle 9 上安装，请按照 RHEL 9/Rocky 9/Oracle 9 的前提条件中的步骤操作。
    6. 将 Edge bootstrap_4.54.00.sh 文件下载到 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. 安装 Edge apigee-service 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入密码。

      Apigee Edge for Private Cloud 4.54.00 需要双 Java 支持，即在节点上同时安装 Java 17 和 Java 21。您必须先安装 Java 17 和 Java 21，然后才能运行引导脚本。安装程序只会验证 是否安装了这两个 JDK 版本，而不会自动安装 Java 。

      安装 apigee-service 实用程序会创建 /etc/yum.repos.d/apigee.repo 文件 ，该文件定义了 Apigee 代码库。如需查看定义文件，请使用以下命令：

      cat /etc/yum.repos.d/apigee.repo

      如需查看代码库内容，请使用以下命令：

      sudo yum -v repolist 'apigee*'
    8. 使用 apigee-service 安装 apigee-setup 实用程序：
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情，请参阅在节点上安装 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 密码中使用特殊字符。
    连接问题

    执行以下 ncat 命令来测试网络连接：

    nc -v software.apigee.com 443

    您应该会收到类似于以下内容的消息：

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    如果您没有安装 nc，则可以执行以下 telnet 命令：

    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
echo $https_proxy

    对于出站 HTTP 代理，您应使用以下选项之一：

    • 在 /etc/yum.conf 中添加 HTTP 代理配置
    • 在 /etc/environment 中添加全局 HTTP 代理配置

    在没有外部互联网连接的节点上安装 Edge apigee-setup 实用程序

    如果您的 Edge 节点位于防火墙后，或者以其他方式被禁止访问 互联网，则必须创建多个代码库或镜像，其中包含安装期间所需的文件。然后，所有节点都必须能够访问这些镜像。创建后，节点 便可以访问这些本地镜像来安装 Edge。

    下载并安装这些依赖项。

    对于没有互联网连接的节点，Apigee Edge 安装过程需要访问 以下本地代码库：

    创建本地 Apigee 代码库

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

    创建本地 Apigee 代码库后，您可能需要稍后使用最新的 Edge 发布文件对其进行更新。以下部分介绍了如何创建本地 Apigee 代码库以及 如何更新该代码库。

    如需创建本地 Apigee 代码库，请执行以下操作：

    1. 从 Apigee 获取用于访问 Apigee 代码库的用户名和密码。 如果您已有 Apigee ftp 网站的用户名:密码，则可以使用这些 凭据。
    2. 以根用户身份登录节点，以安装 Edge RPM。
    3. 如上所述，停用 SELinux。
    4. 将 Edge bootstrap_4.54.00.sh 文件下载到 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. 安装 Edge apigee-service 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入密码。

    6. 在节点上安装 apigee-mirror 实用程序： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
    7. 使用 apigee-mirror 实用程序将 Apigee 代码库同步到 /opt/apigee/data/apigee-mirror/repos/ 目录。

      如需尽可能缩小代码库的大小，请添加 --only-new-rpms 以仅下载最新的 RPM。

    8. （可选） 如果您想从本地代码库将 Edge 安装到托管本地代码库的同一节点上，则需要先运行以下命令：
      1. 从本地代码库运行 bootstrap_4.54.00.sh 以安装 apigee-service 实用程序： 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
      2. 使用 apigee-service 安装 apigee-setup 实用程序： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      3. 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情，请参阅 在节点上安装 Edge 组件。

    从本地代码库在远程节点上安装 apigee-setup

    您可以选择两种方式从本地代码库安装 Edge。您可以执行以下任一项操作：

    • 创建代码库的 .tar 文件，将 .tar 文件复制到节点，然后从 .tar 文件安装 Edge。
    • 在具有本地代码库的节点上安装 Web 服务器，以便其他节点可以访问该服务器。 Apigee 提供 Nginx Web 服务器供您使用，您也可以使用自己的 Web 服务器。

    从 .tar 文件安装

    如需从 .tar 文件安装，请执行以下操作：

    1. 在具有本地代码库的节点上，使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz 的 单个 .tar 文件中： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. 将 .tar 文件复制到要安装 Edge 的节点。例如，将其复制到新节点上的 /tmp 目录。
    3. 在新节点上，如上所述停用 SELinux。
    4. 在新节点上，确保您可以访问本地 Yum 实用程序代码库和 EPEL 代码库。
    5. 仔细检查是否停用了所有外部互联网代码库（由于您是在没有互联网访问权限的机器上安装，因此应该停用）：
      sudo yum repolist

      所有外部代码库都应停用，但本地 Apigee 代码库和内部代码库 应启用。

    6. 使用 apigee-service 安装 apigee-setup 实用程序： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情，请参阅 在节点上安装 Edge 组件。

    使用 Nginx Web 服务器从代码库安装

    如需使用 Nginx Web 服务器从代码库安装，请执行以下操作：

    1. 在代码库节点上安装 Nginx Web 服务器：
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
    2. 默认情况下，Nginx 配置为使用 localhost 作为服务器名称和端口 3939。如需更改这些值，请执行以下操作：
      1. 在编辑器中打开 /opt/apigee/customer/application/mirror.properties。 如果该文件不存在，请创建该文件。
      2. 根据需要设置以下值： 
        conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost
      3. 重启 Nginx： 
        /opt/nginx/scripts/apigee-nginx restart
    3. 默认情况下，代码库需要 admin:admin 的用户名:密码。如需更改 这些凭据，请设置以下环境变量： 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. 在新节点上，确保在本地启用了 EPEL 代码库。
    5. 在新节点上，如上所述检查 libdb4 的版本。
    6. 在远程节点上，安装 Edge apigee-service 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      其中 uName:pWord 是代码库用户名和密码。

    7. 在远程节点上，使用 apigee-service 安装 apigee-setup 实用程序： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    8. 使用 apigee-setup 在远程节点上安装和配置 Edge 组件。 如需了解详情，请参阅在节点上安装 Edge 组件。

    更新本地 Apigee 代码库

    如需更新代码库，您必须下载最新的 bootstrap_4.54.00.sh 文件，然后 执行新的同步。

    如需更新代码库，请执行以下操作：

    1. 将 Edge bootstrap_4.54.00.sh 文件下载到 /tmp/bootstrap_4.54.00.sh： 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. 运行 Edge bootstrap_4.54.00.sh 文件： 
      sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您从 Apigee 收到的用户名和密码。如果您 省略 pWord，系统会提示您输入密码。

    3. 更新 apigee-mirror： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
    4. 执行同步： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
    5. 如果您想要整个代码库： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    清理本地 Apigee 代码库

    清理本地代码库会删除 /opt/apigee/data/apigee-mirror 和 /var/tmp/yum-apigee-*。

    如需清理本地代码库，请使用：

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean