适用于私有云的 Edge v. 4.16.05
如需在节点上安装 Edge,请先安装 Edge apigee-setup 实用程序。如果您位于 您的节点没有外部互联网连接的环境,还必须安装 Apigee 代码库的本地副本。
从 /opt/apigee 创建符号链接
Edge 会将所有文件安装到 /opt/apigee 目录中。您无法更改此设置 目录。不过,如果需要,您可以创建一个符号链接,将 /opt/apigee 映射到另一个位置。
在创建符号链接之前,您必须先创建一个名为“apigee”的用户和群组。这是 与 Edge 安装程序创建的同一群组和用户相同。
如需创建符号链接,请在下载 bootstrap_4.16.05.sh 文件之前执行以下步骤。 您必须以根用户身份执行所有这些步骤:
- 创建“apigee”用户和群组:
>groupadd -r apigee
>useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c “Apigee 平台用户” apigee - 创建从 /opt/apigee 指向所需安装的符号链接
根:
>ln -Ts /srv/myInstallDir /opt/apigee
其中,/srv/myInstallDir 是 Edge 的所需位置 文件。 - 将安装根目录和符号链接的所有权更改为“apigee”用户:
>chown -h apigee:apigee /srv/myInstallDir /opt/apigee
必备条件:停用 SELinux
您必须先停用 SELinux 或将其设置为宽容模式,然后才能安装 Edge apigee-setup 实用程序或任何 Edge 组件。如有必要,在安装 Edge 后,您可以重新启用 SELinux。
- 要暂时将 SELinux 设置为宽容模式,请执行以下命令:
命令:
<ph type="x-smartling-placeholder">
- </ph>
- 在 Linux 6.x 操作系统中:
echo 0 > /selinux/enforce
如需在安装 Edge 后重新启用 SELinux,请执行以下操作:
echo 1 > /selinux/enforce - 在 Linux 7.x 操作系统上:
setenforce 0
如需在安装 Edge 后重新启用 SELinux,请执行以下操作:
setenforce 1
- 在 Linux 6.x 操作系统中:
- 如需永久停用 SELinux 或将其设为宽容模式,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 在以下位置打开 /etc/sysconfig/selinux: 编辑器。
- 设置 SELINUX=disabled 或 SELINUX=permissive
- 保存所做的修改。
- 重启节点。
- 如有必要,在安装 Edge 后重新启用 SELinux,重复以下程序即可 设置 SELINUX=enabled。
安装 Edge 具有外部互联网连接的节点上的 apigee-setup 实用程序
如需在具有外部互联网连接的节点上安装 Edge,请执行以下操作:
- 从您用于访问 Apigee 代码库的 Apigee 获取用户名和密码。 如果 Apigee FTP 网站已有“用户名:密码”,则可以使用这些 凭据。
- 以 root 身份登录您的节点以安装 Edge RPM
注意:虽然 RPM 安装需要 root 访问权限,但您可以执行 Edge, 配置。 - 按照上述说明停用 SELinux。
- 将 Edge bootstrap_4.16.05.sh 文件下载到 /tmp/bootstrap_4.16.05.sh:
>curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - 安装 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/bootstrap_4.16.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 代码库的平台。如需查看定义文件,请使用以下命令:
>猫 /etc/yum.repos.d/apigee.repo
如需查看代码库内容,请使用以下命令:
>sudo yum -v repolist “apigee*” - 使用 apigee-service 安装 apigee-setup 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装 - 请使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件。
安装 Edge 无外部互联网连接的节点上的 apigee-setup 实用程序
如果您的 Edge 节点受防火墙保护,或以其他方式被禁止访问 Apigee 代码库,那么您必须创建一个本地代码库,也就是镜像 介绍然后,该镜像必须可供所有节点访问。创建完成后,节点 然后可以访问该本地镜像以安装 Edge。
注意:Apigee 不会在我们的公共资源中托管所有第三方依赖项 代码库您必须从可公开访问的位置下载并安装这些依赖项 代码库
创建本地 Edge 代码库后,您之后可能必须使用最新的 Edge 版本文件。以下各部分介绍了如何创建本地代码库,以及如何 更新。
创建本地 Apigee 代码库
如需创建本地 Apigee 代码库,请执行以下操作:
- 从您用于访问 Apigee 代码库的 Apigee 获取用户名和密码。 如果 Apigee FTP 网站已有“用户名:密码”,则可以使用这些 凭据。
- 以根用户身份登录 RedHat 或 CentOS 节点以安装 Edge RPM。
注意:虽然 RPM 安装需要 root 访问权限,但您可以执行 Edge, 配置。 - 确保您安装了最新版本的 yum-utils:
>sudo yum update yum-utils - 按照上述说明停用 SELinux。
- 将 Edge bootstrap_4.16.05.sh 文件下载到 /tmp/bootstrap_4.16.05.sh:
>curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - 安装 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您通过该电子邮件收到的用户名和密码 Apigee。如果您省略 pWord,系统会提示您输入。 - 安装 apigee-mirror
上的实用程序 > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 安装 - 使用 apigee-mirror
用于将 Apigee 代码库同步到 /opt/apigee/data/apigee-mirror/repos/ 的实用程序
目录。
为了尽量缩减代码库的大小,请添加 --only-new-rpms 以仅下载最新版本 每千次展示收入。下载此项内容大约需要 1.6GB 的磁盘空间:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms
如果您要下载整个代码库,包括旧的 RPM,请省略 --only-new-rpms。您需要大约 6 个 GB 的磁盘空间(用于完整下载):
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步
您现在拥有 Apigee 代码库的本地副本。下一部分将介绍如何安装 Edge apigee-setup 实用程序,来自 本地代码库中。 -
(可选)如果您想通过本地代码库将 Edge 安装到
托管本地代码库的节点,则需要先运行以下命令:
<ph type="x-smartling-placeholder">
- </ph>
- 从本地运行 bootstrap_4.16.05.sh
用于安装 apigee-service 实用程序的代码库:
>sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos - 使用 apigee-service 执行以下操作:
安装 apigee-setup
实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装 - 使用 apigee-setup 在节点上安装和配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件。
- 从本地运行 bootstrap_4.16.05.sh
用于安装 apigee-service 实用程序的代码库:
从本地代码库在远程节点上安装 apigee-setup
您可以通过两种方法从本地代码库安装 Edge。您可以选择以下任一解决办法:
- 创建代码库的 .tar 文件,将 .tar 文件复制到节点,然后从以下位置安装 Edge 下载 .tar 文件。
- 在具有本地代码库的节点上安装网络服务器,以便其他节点可以访问该服务器。 Apigee 提供 Nginx Web 服务器供您使用,您也可以使用自己的 网络服务器
通过 .tar 文件安装:
- 在具有本地代码库的节点上,使用以下命令将本地代码库打包到
单个 .tar 文件,名为 /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包 - 将 .tar 文件复制到要在其中安装 Edge 的节点。例如,将其复制到 /tmp 目录 节点。
- 在新节点上,按照上述说明停用 SELinux。
- 在新节点上,将文件解压缩到 /tmp 目录:
>tar -xzf apigee-4.16.05.tar.gz
此命令会创建一个新目录, 位于包含 .tar 文件的目录中。例如 /tmp/repos. - 从 /tmp/repos 安装 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
请注意,您在此命令中加入了代码库目录的路径。 - 使用 apigee-service 执行以下操作:
安装 apigee-setup
实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装 - 使用 apigee-setup 安装 并在节点上配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件。
使用 Nginx 网络服务器从代码库安装:
- 在代码库节点上安装 Nginx 网络服务器:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig - 默认情况下,Nginx 配置为使用 localhost 作为服务器名称和端口 3939。接收者
更改这些值
<ph type="x-smartling-placeholder">
- </ph>
- 打开 /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 - 在新节点上,按照上述说明停用 SELinux。
- 在远程节点上,将 Edge bootstrap_4.16.05.sh 文件下载到 /tmp/bootstrap_4.16.05.sh:
>/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
其中 uName:pWord 是您在上面为 代码库,而 remoteRepo 是代码库的 IP 地址或 DNS 名称 节点。 - 在远程节点上,安装 Edge apigee-service 实用程序和依赖项:
>sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是 Repo 用户名和密码。 - 在远程节点上,使用 apigee-service 安装 apigee-setup 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup 安装 - 使用 apigee-setup 安装 并在远程节点上配置 Edge 组件。如需了解详情,请参阅在节点上安装 Edge 组件。
更新本地 Apigee 代码库
要更新代码库,您必须下载最新的 bootstrap_4.16.05.sh 文件,然后执行新的 同步:
- 将 Edge bootstrap_4.16.05.sh 文件下载到 /tmp/bootstrap_4.16.05.sh:
>curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - 执行同步:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms - 如果您想下载整个代码库,请执行以下操作:
> /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.16.05 代码库中添加或更新 Edge 4.16.01
如果您必须维护 Edge 4.16.05 和 4.16.01 的安装,您可以 代码库。然后,您可以从该代码库中安装 Edge 4.16.05 和 4.16.01.
如需将 4.16.01 添加到 4.15.05 代码库,请执行以下操作:
- 确保您已安装 4.16.05 版 apigee-mirror 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 版本
您应该会看到下方表单的结果,其中 xyz 是 build 编号:
apigee-mirror-4.16.05-0.0.xyz - 使用 apigee-mirror
实用程序将 Edge 4.16.01 下载到您的代码库。请注意,为命令添加前缀
apigeereleasever=4.16.01:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 同步 --only-new-rpms
稍后使用同一命令更新 4.16.01 代码库。 - 检查 /opt/apigee/data/apigee-mirror/repos
目录中以查看文件结构:
>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 第三方
请注意,这两个版本的 Edge 都有相应的引导文件。apigee 目录中还包含单独的 每个 Edge 版本的目录。 - 如需将代码库打包为 .tar 文件,请使用以下命令:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包
此命令会将 4.16.05 和 4.16.01 代码库打包到同一个 .tar 文件中。您不能 仅打包代码库的一部分。
要通过本地代码库或 .tar 文件安装 Edge,只需确保运行正确的引导加载程序即可 文件:
- 如果通过 .tar 文件安装,请从代码库中运行正确的引导文件:
>sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
要完成安装,请按照“从 .tar 文件安装”中的其余步骤操作 。 - 如果使用 Nginx 网络服务器进行安装,请下载并运行正确的引导文件
从代码库中:
>/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
>sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
要完成安装,请按照“使用 Nginx Web 服务器”。