适用于私有云的 Edge v4.18.05
此过程介绍了如何在本地升级现有的 Apigee Developer Services 门户(简称门户), 安装。
。确定正确的更新过程
更新门户所用的过程基于当前安装:
- 如果您的安装使用 Nginx/Postgres 详见下文使用 RPM 升级门户。
- 如果您的安装使用 Apache/MySQL 或 Apache/MariaDB,请参阅 将 基于 tar 的门户迁移到基于 RPM 的门户。
正在确定 您当前的安装类型
如果您不确定当前的安装类型,请使用以下命令确定 :
ls /opt
如果您使用的是 Nginx/Postgres,则会看到以下目录:
/opt/apigee
和/opt/nginx
。如果您使用的是 Apache/MySQL 或 Apache/MariaDB,则不应将这些目录 存在。
/opt/apigee/apigee-service/bin/apigee-all status
如果您使用的是 Nginx/Postgres,则会看到以下输出:
+ apigee-service apigee-drupal-devportal status OK: apigee-drupal-devportal is up and running + apigee-service apigee-lb status apigee-service: apigee-lb: OK + apigee-service apigee-postgresql status apigee-service: apigee-postgresql: OK
apachectl -S
如果您使用的是 Apache/MySQL 或 Apache/MariaDB,则此命令应返回网页 根目录,格式为:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
默认安装目录
升级过程假定门户安装在:
- 4.17.05 及更高版本:
/opt/apigee/apigee-drupal/wwwroot
- 4.17.05 之前:
/opt/apigee/apigee-drupal
(Nginx) 或/var/www/html
(Apache)
如果未将门户安装在默认目录中,请修改过程中的路径 使用您的安装目录。
支持的升级版本
以下版本的门户支持此升级过程:
- OPDK-17-01.x
- OPDK-17-05.x
- OPDK-17-09.x
- OPDK-18-01.x
如需确定您的门户版本,请在浏览器中打开以下网址:
http://yourportal.com/buildInfo
更新之前
对于现有安装,如果您修改了 Drupal Core 或任何非自定义
模块,您的修改将被覆盖。这些更改包括但不限于
您对.htaccess
做出的更改。
您应该假定 /sites
目录以外的任何内容都归 Drupal 所有。一个
robots.txt
例外;如果此文件存在于网络根目录中
为您保留。
在继续安装之前,请备份您的整个 Drupal 网络根目录 目录。执行下述安装步骤后,您就可以恢复 备份中的自定义设置。
使用 RPM 升级门户
如需更新节点上的门户 RPM,请执行以下操作:
- 切换到 Drupal 目录,
/opt/apigee/apigee-drupal
默认值:cd /opt/apigee/apigee-drupal
- 备份您的 Drupal 数据库实例。
pg_dump
命令会创建 数据库:pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin --password --format=c > /tmp/portal.dmp
其中:
- devportal 是由
门户安装配置文件中的
PG_NAME
属性。 - host_IP_address 是门户节点的 IP 地址。
- drupaladmin 是门户用于访问
门户安装中
DRUPAL_PG_USER
属性所指定的数据库 配置文件 - 系统会提示您输入
DRUPAL_PG_PASS
属性。
如果以后必须从备份进行恢复,请使用以下命令:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- devportal 是由
门户安装配置文件中的
- 备份整个 Drupal 网络根目录。默认安装位置
为
/opt/apigee/apigee-drupal
,但您可能已更改了它。如果您不确定此目录的位置,请使用
drush status
命令或 配置 >媒体 >Drupal 菜单中的“File”条目,以确定 公开文件系统的位置和私有文件系统路径(对于下一个 步骤)。 - 备份
/opt/apigee/data/apigee-drupal-devportal/private
中的文件。 - 将 Drupal 设置为维护模式:
<ph type="x-smartling-placeholder">
- </ph>
- 在 Drupal 菜单中选择配置。
- 在配置页面上,选择维护模式 (在开发下方)。
- 选中将网站设为维护模式复选框。
- 输入用户在维护期间会看到的消息。
- 选择保存配置。
- 按照说明停用 SELinux 安装 Edge apigee-setup 实用程序。
- 切换到
/opt
目录:cd /opt
- 在连接到互联网的服务器上进行升级:
<ph type="x-smartling-placeholder">
- </ph>
- 将 Edge 4.18.05
bootstrap_4.18.05.sh
文件下载到/tmp/bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- 安装 Edge 4.18.05
apigee-service
实用程序和依赖项:sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord
其中,uName 和 pWord 是您收到的用户名和密码 如果您省略 pWord,系统会提示您输入。
默认情况下,安装程序会检查您是否已安装 Java 1.8。您可以使用 “C”选择继续而不安装 Java。
- 将 Edge 4.18.05
- 要在没有互联网连接的服务器上进行升级,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 按照说明创建本地 4.18.05 代码库 创建本地 Apigee 代码库。
- 如需从 .tar 文件安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 在具有本地代码库的节点上,使用以下命令将本地代码库
存储到单个 .tar 文件
/opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如,将该文件复制到
复制到新节点上的
/tmp
目录。 - 在新节点上,将文件解压缩到 /tmp 目录:
tar -xzf apigee-4.18.05.tar.gz
此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录 文件。例如 /tmp/repos。
- 从以下位置安装 Edge
apigee-service
实用程序和依赖项:/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
请注意,您在此命令中加入了代码库目录的路径。
- 在具有本地代码库的节点上,使用以下命令将本地代码库
存储到单个 .tar 文件
- 如需使用 Nginx Web 服务器安装 apigee-service,请执行以下操作:
<ph type="x-smartling-placeholder">
- </ph>
- 按照“使用 Nginx Web 服务器”Install the Edge apigee-setup 实用程序,
- 在远程节点上,将 Edge
bootstrap_4.18.05.sh
文件下载到/tmp/bootstrap_4.18.05.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
其中,uName 和 pWord 是您设置的用户名和密码 remoteRepo 是代码库的 IP 地址或 DNS 名称 代码库节点。
- 在远程节点上,安装 Edge
apigee-service
实用程序并 依赖项:sudo bash /tmp/bootstrap_4.18.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 update
- 在您的 Postgre 节点上运行更新实用程序:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
其中,configFile 是您用于安装 Postgres 数据库。对配置文件的唯一要求是 文件必须可供“apigee”访问或读取用户。
- 更新 Postgres 数据库:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
- 在节点上运行更新实用程序以更新门户:
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
其中,configFile 是您用于安装 打开该门户对配置文件的唯一要求是 必须可供“apigee”访问或读取用户。
- 通过在浏览器窗口中打开以下网址,运行 Drupal 的
update.php
脚本:http://portal_IP_DNS:8079/update.php
- 将 Drupal 停用到维护模式:
<ph type="x-smartling-placeholder">
- </ph>
- 在 Drupal 菜单中选择配置。
- 在配置页面上,选择维护模式 (在开发下方)。
- 取消选中将网站置于维护模式复选框。
- 选择保存配置。
请注意,更新后的根目录为:
/opt/apigee/apigee-drupal/wwwroot
升级现已完成。