开发者服务门户 v. 4.17.05
此过程介绍了如何在本地升级现有的 Apigee 开发者渠道服务。
确定正确的更新过程
用于更新门户的过程取决于当前安装:
- 如果您在安装过程中使用的是 Apache/MySQL 或 Apache/MariaDB,相应系统已更新为 4.17.01,请使用使用 .tar 文件升级门户。
- 如果您的安装使用来自新的 4.17.01 安装的 Nginx/Postgres,请使用使用 RPM 升级门户。
确定当前安装类型
如果您不确定当前的安装类型,请使用以下命令确定:
- ls /opt
如果您使用的是 Nginx/Postgres,则会看到以下目录:/opt/apigee 和 /opt/nginx。
如果您使用的是 Apache/MySQL 或 Apache/MariaDB,这些目录不应存在。 - /opt/apigee/apigee-service/bin/apigee-all
状态
如果正在使用 Nginx/Postgres,会看到以下输出:
+ apigee-service apigee-drupal-devportal 状态
良好:apigee-drupal-devportal 已启动并运行
apigee-apigee-replication+sql 状态
apigee-resql
: - apachectl -S
如果您使用的是 Apache/MySQL 或 Apache/MariaDB,则此命令应返回门户的网页根目录,格式如下:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
默认安装目录
升级过程假定开发者门户安装于:
- /opt/apigee/apigee-drupal (Nginx)
- /var/www/html (Apache)
如果您未在默认目录中安装门户,请按以下过程中修改路径以使用安装目录。
如果您不知道安装目录,可以根据常用的 Drush 命令中的说明确定该目录。
从新的 4.17.01 安装更新 Nginx/Postgres 后的新默认安装目录
更新使用 Nginx/Postgres 的新 4.17.01 安装后,根目录从:
/opt/apigee/apigee-drupal
更改为:
/opt/apigee/apigee-drupal/wwwroot
支持的升级版本
以下版本的门户支持此升级过程:
- pantheon-14.02.x
- pantheon-14.03.x
- pantheon-14.04.x
- pantheon-14.07.x
- Pantheon-15-01.x
- OPDK-15-04.x
- OPDK-15-07.x
- OPDK-16-01.x
- OPDK-16-05.x
- OPDK-16-09.x
- OPDK-17-01.x
如需确定门户版本,请在浏览器中打开以下网址:
http://yourportal.com/buildInfo
更新之前
对于现有安装,如果您修改了 Drupal 核心或任何非自定义模块中的任何代码,您的修改内容将被覆盖。其中包括您对 .htaccess 所做的任何更改。 您应假定 /sites 目录之外的所有内容都归 Drupal 所有。robots.txt 是此规则的例外情况;如果该文件位于网络根目录中,系统会为您保留该文件。
在继续安装之前,请备份您的整个 Drupal 网页根目录。执行下述安装步骤后,您可以使用备份恢复您的自定义设置。
使用 .tar 文件升级门户
- 备份您的 Drupal MySQL/MariaDB 实例。
如需了解详情,请参阅 http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- 方法 1:使用 Drush
Drush 命令 sql-dump 会创建数据库的副本。默认情况下,从 Drupal 目录 /var/www/html 运行以下命令:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
如需了解详情,请使用 drush help sql-dump。 - 方法 2:使用 MySQLdump
使用 mysqldump 命令创建数据库副本:
mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
-p 选项和密码之间不应留空格。如果密码包含特殊字符,则必须用英文单引号将密码引起来。
在安装门户时设置 USERNAME 和 DATABASENAME。默认情况下,这两者均为 devportal。
- 方法 1:使用 Drush
- 备份整个 Drupal 网站根目录。默认安装位置为 /var/www/html,但您可能在安装时已更改了该位置。
- 从 ftp.apigee.com 下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件,其中 x.y.z 对应于门户版本号。出现提示时,输入您从 Apigee 收到的凭据。
您可以从 Apigee 在浏览器中发送给您的链接下载文件,也可以复制该文件并将其添加到以下 c网址 命令中:
> curl -kOL <paste link here>
注意:如果您的门户位于没有外部互联网连接的服务器上,请在具有访问权限的服务器上执行此步骤。
前往 Apigee Edge 支持,然后选择登录支持门户以请求开发者渠道服务升级 .tar 文件。如果您没有在支持门户上创建帐号,请选择 Login to your Support Portal(登录支持门户),然后在登录页面上选择 In a time?请在此处提交支持服务工单。 -
在连接到互联网的服务器上进行升级:
- 解压缩门户升级文件:
> tar -xvf <tar file>
此命令会创建名为 DeveloperServices-4.x.y.z 的新目录。 - 切换到 DeveloperServices-4.x.y.z 目录。
- 使用以下命令下载最新的 Drupal 版本:
> drush dl drupal
此命令会创建一个名为 drupal-x.y 的目录,其中 x.y 与 Drupal 的当前版本相对应。 - 运行 networked-update.sh 脚本:
> ./networked-update.sh
根据文件权限,您可能必须使用 sudo 来运行此命令,或以管理员身份运行此命令。 - 如需接收 Drupal 更新通知,请确保已启用 Drupal 更新管理器模块。从 Drupal 菜单中,选择模块,然后向下滚动到更新管理器模块。如果未启用,请将其启用。
启用后,您可以使用报告 > 可用更新菜单项查看可用的更新。
使用报告 > 可用更新 > 设置菜单项将模块配置为在有可用更新时向您发送电子邮件,并设置检查更新的频率。
- 解压缩门户升级文件:
-
在没有互联网连接的服务器上进行升级:
- 在下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件的服务器上,提取门户升级文件:
> tar -xvf <tar file>
此命令提取操作会创建名为 DeveloperServices-4.x.y.z 的新目录。 - 切换到 DeveloperServices-4.x.y.z 目录。
- 运行 non-networked-update.sh 脚本:
> ./non-networked-update.sh
根据文件权限,您可能必须使用 sudo 或管理员身份运行此命令。
此命令会下载所有必要的更新文件,并将其打包到名为 devportal-update.tgz 的单个文件中,然后将该文件写入您选择的位置。 - 将 devportal-update.tgz 复制到目标服务器(即运行门户的服务器)。
注意:请勿将 devportal-update.tgz 复制到目标服务器的 Web 根目录。 - 将 devportal-update.tgz 文件解压缩到当前目录:
> tar -xzf /path/to/devportal-update.tgz - 切换到 developer-update 目录。
- 运行以下命令以安装更新:
> ./install-update.sh - 按照提示回答问题。
- 在下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件的服务器上,提取门户升级文件:
升级现已完成。
使用 RPM 升级门户
请按照以下步骤更新节点上的门户 RPM:
- 切换到默认 Drupal 目录 /opt/apigee/apigee-drupal:
> cd /opt/apigee/apigee-drupal - 备份您的 Drupal 数据库实例。pg_dump 命令会创建数据库的副本:
pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
- dbname 指定由门户安装配置文件中 PG_NAME 属性指定的数据库名称。
- host 指定门户节点的 IP 地址。
- username,用于指定门户用于访问数据库的 Postgres 用户名,由门户安装配置文件中 DRUPAL_PG_USER 属性指定。
- 系统会提示您输入门户安装配置文件中 DRUPAL_PG_PASS 属性所定义的 Postgres 用户密码。
如果您以后必须从备份进行恢复,请使用以下命令:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp - 备份整个 Drupal 网站根目录。默认安装位置为 /opt/apigee/apigee-drupal,但也可能已经更改了。
如果您不确定此目录的位置,请使用 drush status 命令或 Drupal 菜单中的 Configuration > Media > File 条目来确定公共文件系统的位置和私有文件系统路径(在下一步中使用)。 - 备份 /opt/apigee/data/apigee-drupal-devportal/private 中的文件。
- 按照安装 Edge apigee-setup 实用程序中的说明停用 SELinux。
-
在连接到互联网的服务器上进行升级:
- 将 Edge 4.17.05 bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05。 - 安装 Edge 4.17.05 apigee-service 实用程序和依赖项:
> sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord,系统会提示您输入该密码。
默认情况下,安装程序会检查是否安装了 Java 1.8。您可以使用“C”选项继续操作,无需安装 Java。
- 将 Edge 4.17.05 bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh:
-
在没有互联网连接的服务器上进行升级:
- 按照安装 Edge apigee-setup 实用程序中的“创建本地 Apigee 代码库”中的说明创建本地 4.17.05 代码库。
注意:如果您已有一个 4.17.01 代码库,则可以向其添加 4.17.05 代码库,如安装 Edge apigee-setup 实用程序中的“更新本地 Apigee 代码库”中所述。 -
如需通过 .tar 文件安装 apigee-service,请执行以下操作:
- 在具有本地代码库的节点上,使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz 的.tar 文件中:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如,将其复制到新节点上的 /tmp 目录。
- 在新节点上,将文件解压缩到 /tmp 目录:
> tar -xzf apigee-4.17.05.tar.gz
此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录。例如 /tmp/repos。 - 从 /tmp/repos 安装 Edge apigee-service 实用程序和依赖项:
> sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
请注意,此命令中包含 Repos 目录的路径。
- 在具有本地代码库的节点上,使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz 的.tar 文件中:
-
如需使用 Nginx Web 服务器安装 apigee-service,请执行以下操作:
- 按照安装 Edge apigee-setup 实用程序中的“使用 Nginx 网络服务器从代码库安装”中的说明配置 Nginx Web 服务器。
- 在远程节点上,将 Edge bootstrap_4.17.05.sh 文件下载到 /tmp/bootstrap_4.17.05.sh:
> /usr/bin/curl, http://uName:@remote-Repo:3939/bootstrap_4.sh.17。 - 在远程节点上,安装 Edge apigee-service 实用程序和依赖项:
> sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 u
- 按照安装 Edge apigee-setup 实用程序中的“创建本地 Apigee 代码库”中的说明创建本地 4.17.05 代码库。
- 使用 apigee-service 更新 apigee-setup 实用程序:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - 在您的节点上运行更新实用程序以更新 Postgres 数据库:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
其中 configFile 是用来安装 Postgres 数据库的配置文件。配置文件的唯一要求是配置文件必须可供“apigee”用户访问或读取。 - 启动 Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 在您的节点上运行更新实用程序以更新门户:
> /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
其中 configFile 是用来安装门户的配置文件。配置文件的唯一要求是配置文件必须可供“apigee”用户访问或读取。
请注意,更新后的 根目录现在为:
/opt/apigee/apigee-drupal/wwwroot
升级现已完成。