安装 Edge apigee-setup 实用程序

适用于私有云的 Edge v. 4.17.05

如需在节点上安装 Edge,请先安装 Edge apigee-setup 实用程序。如果您位于 您的节点没有外部互联网连接的环境,还必须安装 Apigee 代码库的本地副本。

默认安装目录:/opt/apigee

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

必备条件:停用 SELinux

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

  • 要暂时将 SELinux 设置为宽容模式,请执行以下命令: 命令: <ph type="x-smartling-placeholder">
      </ph>
    1. 在 Linux 6.x 操作系统中
      sudo echo 0 > /selinux/enforce

      如需在安装 Edge 后重新启用 SELinux,请执行以下操作:
      sudo echo 1 > /selinux/enforce
    2. 在 Linux 7.x 操作系统上
      sudo setenforce 0

      如需在安装 Edge 后重新启用 SELinux,请执行以下操作:
      sudo setenforce 1
  • 如需永久停用 SELinux 或将其设为宽容模式,请执行以下操作: <ph type="x-smartling-placeholder">
      </ph>
    1. 在以下位置打开 /etc/sysconfig/selinux: 编辑器。
    2. 设置 SELINUX=disabledSELINUX=permissive
    3. 保存所做的修改。
    4. 重启节点。
    5. 如有必要,在安装 Edge 后重新启用 SELinux,具体操作步骤如下: 设置 SELINUX=enabled

前提条件:启用 EPEL 代码库

您必须针对以下应用启用额外软件包: Enterprise Linux(或 EPEL):用于安装或更新 Edge。您使用的命令取决于 安装在您的 RedHat/CentOS 上:

  • 对于 RedHat/CentOS 7.x:
    &gt;wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm;sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • 对于 RedHat/CentOS 6.x:
    &gt;wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm;sudo rpm -ivh epel-release-latest-6.noarch.rpm

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

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

  1. 从您用于访问 Apigee 代码库的 Apigee 获取用户名和密码。 如果 Apigee FTP 网站已有“用户名:密码”,则可以使用这些 凭据。
  2. 以 root 身份登录您的节点以安装 Edge RPM
    注意:虽然 RPM 安装需要 root 访问权限,但您可以执行 Edge, 配置。
  3. 按照上述说明停用 SELinux。
  4. 按照上述说明启用 EPEL 代码库。
  5. 将 Edge bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh
    &gt;curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  6. 安装 Edge apigee-service 实用程序和依赖项:
    &gt;sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    其中,uName:pWord 是您通过 Google 发送的用户名和密码 Apigee。如果您省略 pWord,系统会提示您输入。

    默认情况下,安装程序会检查您是否已安装 Java 1.8。否则, 安装它。使用 JAVA_FIX 选项指定如何处理 Java 安装。JAVA_FIX 采用以下值:

    I = 安装 OpenJDK 1.8(默认)
    C = 不安装 Java 继续操作
    Q = 退出。对于此选项,您必须自行安装 Java。

    安装 apigee-service 实用程序将创建 /etc/yum.repos.d/apigee.repo 文件 它定义了一个定义 Apigee 代码库的平台。如需查看定义文件,请使用以下命令:
    &gt;猫 /etc/yum.repos.d/apigee.repo

    如需查看代码库内容,请使用以下命令:
    &gt;sudo yum -v repolist “apigee*”
  7. (仅限 CentOS-6.x 和 RedHat-6.x)在所有 Qpid 节点上,运行以下命令: 命令,以确保您下载正确的 Qpid 版本:
    &gt;yum 安装 apigee-qpidd --disablerepo=epel
  8. 使用 apigee-service 安装 apigee-setup 实用程序:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装
  9. 请使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件

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

如果您的 Edge 节点受防火墙保护,或以其他方式被禁止访问 Apigee 代码库,那么您必须创建一个本地代码库,也就是镜像 介绍然后,该镜像必须可供所有节点访问。创建完成后,节点 然后可以访问该本地镜像以安装 Edge。

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

创建本地 Edge 代码库后,您之后可能必须使用最新的 Edge 版本文件。以下各部分介绍了如何创建本地代码库,以及如何 更新。

创建本地 Apigee 代码库

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

  1. 从您用于访问 Apigee 代码库的 Apigee 获取用户名和密码。 如果 Apigee FTP 网站已有“用户名:密码”,则可以使用这些 凭据。
  2. 以根用户身份登录 RedHat 或 CentOS 节点以安装 Edge RPM。
    注意:虽然 RPM 安装需要 root 访问权限,但您可以执行 Edge, 配置。
  3. 确保您安装了最新版本的 yum-utils:
    &gt;sudo yum update yum-utils
  4. 按照上述说明停用 SELinux。
  5. 按照上述说明启用 EPEL 代码库。
  6. 将 Edge bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh
    &gt;curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  7. (仅限 CentOS-6.x 和 RedHat-6.x)运行以下命令以确保 请下载正确的 Qpid 版本:
    &gt;yum 安装 apigee-qpidd --disablerepo=epel
  8. 安装 Edge apigee-service 实用程序和依赖项:
    &gt;sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    其中 uName:pWord 是您通过该电子邮件收到的用户名和密码 Apigee。如果您省略 pWord,系统会提示您输入。
  9. 安装 apigee-mirror
    上的实用程序 &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 安装

    注意:如果您要将现有的代码库更新到 4.17.05,则只需更新 apigee-mirror
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 更新
  10. 使用 apigee-mirror 用于将 Apigee 代码库同步到 /opt/apigee/data/apigee-mirror/repos/ 的实用程序 目录。

    为了尽量缩减代码库的大小,请添加 --only-new-rpms 以仅下载最新版本 每千次展示收入。下载以下内容大约需要 1.6 GB 的磁盘空间:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms

    如果您要下载整个代码库,包括旧的 RPM,请省略 --only-new-rpms。您需要大约 6 个 GB 的磁盘空间(用于完整下载):
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步

    您现在拥有 Apigee 代码库的本地副本。下一部分将介绍如何安装 Edge apigee-setup 实用程序,来自 本地代码库中。
  11. (可选)如果您想通过本地代码库将 Edge 安装到 托管本地代码库的节点,则需要先运行以下命令: <ph type="x-smartling-placeholder">
      </ph>
    1. 从本地运行 bootstrap_4.17.05.sh 用于安装 apigee-service 实用程序的代码库:
      &gt;sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. 使用 apigee-service 执行以下操作: 安装 apigee-setup 实用程序:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装
    3. 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件

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

您可以通过两种方法从本地代码库安装 Edge。您可以选择以下任一解决办法:

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

通过 .tar 文件安装:

  1. 在具有本地代码库的节点上,使用以下命令将本地代码库打包到 单个 .tar 文件,名为 /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz

    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包
  2. 将 .tar 文件复制到要在其中安装 Edge 的节点。例如,将其复制到 /tmp 目录 节点。
  3. 在新节点上,按照上述说明停用 SELinux。
  4. 在新节点上,将文件解压缩到 /tmp 目录:
    &gt;tar -xzf apigee-4.17.05.tar.gz

    此命令会创建一个新目录, 位于包含 .tar 文件的目录中。例如 /tmp/repos.
  5. /tmp/repos 安装 Edge apigee-service 实用程序和依赖项:
    &gt;sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    请注意,您在此命令中加入了代码库目录的路径。
  6. 使用 apigee-service 执行以下操作: 安装 apigee-setup 实用程序:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装
  7. 使用 apigee-setup 安装 并在节点上配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件

使用 Nginx 网络服务器从代码库安装:

  1. 在代码库节点上安装 Nginx 网络服务器:
    &gt; opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. 默认情况下,Nginx 配置为使用 localhost 作为服务器名称和端口 3939。接收者 更改这些值 <ph type="x-smartling-placeholder">
      </ph>
    1. 打开 /opt/apigee/customer/application/mirror.properties 。如果文件不存在,请创建一个。
    2. 根据需要设置以下值:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. 重启 Nginx:
      &gt; /opt/nginx/scripts/apigee-nginx restart
  3. 默认情况下,代码库要求用户名:密码为 admin:admin。如需更改这些凭据,请执行以下操作: 设置以下环境变量:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. 在新节点上,按照上述说明停用 SELinux。
  5. 在远程节点上,将 Edge bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh
    &gt;/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

    其中 uName:pWord 是您在上面为 代码库,而 remoteRepo 是代码库的 IP 地址或 DNS 名称 节点。
  6. 在远程节点上,安装 Edge apigee-service 实用程序和依赖项:
    &gt;sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    其中 uName:pWord 是 Repo 用户名, 密码。
  7. 在远程节点上,使用 apigee-service 安装 apigee-setup 实用程序:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装
  8. 使用 apigee-setup 安装 并在远程节点上配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件

更新本地 Apigee 代码库

要更新代码库,您必须下载最新的 bootstrap_4.17.05.sh 文件,然后执行新的 同步:

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

    其中,uName:pWord 是您登录时 获得的数据如果您省略 pWord,系统会提示您 请输入该密码。
  3. 更新 apigee-mirror
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 更新
  4. 执行同步:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms
  5. 如果您想下载整个代码库,请执行以下操作:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步

清理本地 Apigee 代码库

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

如需清理本地代码库,请使用以下命令:

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

在 4.17.05 代码库中添加或更新 Edge 4.16.01/4.16.05/4.16.09/4.17.01

如果您必须在 4.17.05 代码库中维护 Edge 4.16.0x 或 4.17.01 的安装,则可以 并维护包含所有版本的代码库之后,您便可通过该代码库安装 Edge。

如需将 4.16.0x/4.17.01 添加到 4.17.05 代码库,请执行以下操作:

  1. 确保您已安装 4.17.05 版 apigee-mirror 实用程序:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 版本

    您应该会看到下方表单的结果,其中 xyz 是 build 编号:
    apigee-mirror-4.17.05-0.0.xyz
  2. 使用 apigee-mirror 实用程序将 Edge 4.16.01/4.16.05/4.16.09/4.17.01 下载到您的代码库。请注意添加前缀 请将命令替换为所需版本:
    &gt; apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms

    稍后可使用以下命令更新 4.16.05/4.16.09/4.17.01 代码库,方法是指定 所需的版本号。
  3. 检查 /opt/apigee/data/apigee-mirror/repos 目录中以查看文件结构:
    &gt;ls /opt/apigee/data/apigee-mirror/repos

    您应该会看到以下文件和目录:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh 第三方

    请注意,您的所有 Edge 版本都有相应的引导文件。apigee 目录中还包含单独的 每个 Edge 版本的目录。
  4. 如需将代码库打包为 .tar 文件,请使用以下命令:
    &gt; apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包

    此命令将所有 4.17.0x 和 4.16.0x 代码库打包到同一个 .tar 文件中。您不能 仅打包代码库的一部分。

要通过本地代码库或 .tar 文件安装 Edge,只需确保运行正确的引导加载程序即可 文件。本示例将安装 Edge 4.16.01:

  • 如果通过 .tar 文件安装,请从代码库中运行正确的引导文件:
    &gt;sudo bash /tmp/repos/bootstrap_4.16.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    要完成安装,请按照“从 .tar 文件安装”中的其余步骤操作 。
  • 如果使用 Nginx 网络服务器进行安装,请下载并运行正确的引导文件 从代码库中:
    &gt;/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.01.sh -o /tmp/bootstrap_4.16.01.sh
    &gt;sudo bash /tmp/bootstrap_4.16.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://


    要完成安装,请按照“使用 Nginx Web 服务器”。