升级开发者服务门户

开发者服务门户 v. 4.16.05

此过程介绍了如何升级本地安装的 Apigee 开发者渠道服务。

默认安装目录

升级过程假设开发者门户是通过 /var/www/html 安装的。如果未将门户安装到默认目录中，请修改以下过程中的路径以使用安装目录。

如果您不知道安装目录，可以按常用的 Drush 命令中的说明确定该目录。

支持的升级版本

以下版本的门户支持此升级过程：

• Pantheon-4.24.216
• Pantheon-4.24.246
• 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

如需确定门户版本，请在浏览器中打开以下网址：

http://yourportal.com/buildInfo

将 Apigee 开发者渠道服务升级到新版本

1. 备份您的 Drupal MySQL 实例。
   如需了解详情，请参阅 http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
   1. 方法 1：使用 Drush
      
      Drush 命令 sql-dump 用于创建数据库的副本。从您的 Drupal 目录 /var/www/html 默认运行该命令：
      > drush sql-dump > /path/to/backup_dir/database-backup.sql
      
      使用 drush help sql-dump 了解详情。
   2. 方法 2：使用 MySQLdump
      使用 mysqldump 命令创建数据库副本：
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
      
      -p 选项与密码之间不应有空格。如果密码包含特殊字符，则必须用英文双引号将密码括起来。
      
      您在安装门户时设置了 USERNAME 和 DATABASENAME。默认情况下，这两者都是 devportal。
2. 备份您的整个 Drupal 网站根目录。默认安装位置是 /var/www/html，但您可能是在安装时更改了它。
3. 下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件，其中 x.y.z 对应于门户版本号。
   
   您可以从 Apigee 在浏览器中向您发送的链接中下载文件，或复制该文件，然后将其添加到以下 c网址 命令中：
   > curl -kOL <paste link 在此处>
   
   注意：如果您的门户所在的服务器没有外部互联网连接，请在具有访问权限的服务器上执行此步骤。
   
   转到 http://community.apigee.com/content/apigee-customer-support，然后选择登录支持门户以请求开发者渠道服务升级 .tar 文件。如果您在支持门户上没有帐号，请选择登录您的支持门户，然后在登录页面选择赶时间？请在此处提交支持服务工单。
4. 对于已连接到互联网的服务器升级：
   1. 提取门户升级文件：
      > tar -xvf <tar file>
      
      此命令提取的内容会创建一个名为 DeveloperServices-4.x.y.z 的新目录。
   2. 切换到 DeveloperServices-4.x.y.z 目录。
   3. 使用以下命令下载最新的 Drupal 版本：
      > drush dl drupal
      
      此命令会创建一个名为 drupal-x.y 的目录，其中 x.y 对应于当前版本的 Drupal。
   4. 运行 networked-update.sh 脚本：
      > ./networked-update.sh
      
      您可能需要使用 sudo 运行此命令，或者以管理员身份运行该命令，具体取决于文件权限。
   5. 如需接收 Drupal 更新通知，请确保已启用 Drupal Update 管理器模块。从 Drupal 菜单中，选择 Modules，然后向下滚动到 Update manager 模块。如果未启用，请启用。
      
      启用后，您可以使用报告 > 可用更新菜单项来查看可用的更新。
      
      使用报告 > 可用更新 > 设置菜单项，配置该模块在有可用更新时向您发送电子邮件，并设置检查更新的频率。
5. 对于未连接到互联网的服务器升级：
   1. 在您下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件的服务器上，提取门户升级文件：
      > tar -xvf <tar file>
      
      此命令提取会创建一个名为 DeveloperServices-4.x.y.z 的新目录。
   2. 切换到 DeveloperServices-4.x.y.z 目录。
   3. 运行 non-networked-update.sh 脚本：
      > ./non-networked-update.sh
      
      您可能需要使用 sudo 运行此命令，或者以管理员身份运行，具体取决于文件权限。
      
      此命令会下载所有必要的更新文件，并将其打包到名为 devportal-update.tgz 的单个文件中，并将该文件写入您选择的位置。
   4. 将 devportal-update.tgz 复制到目标服务器（即运行门户的服务器）。
      注意：不要将 devportal-update.tgz 复制到目标服务器的 Web 根目录。
   5. 将 devportal-update.tgz 文件解压缩到当前目录：
      > tar -xzf /path/to/devportal-update.tgz
   6. 切换到 developer-update 目录。
   7. 运行以下命令以安装更新：
      > ./install-update.sh
   8. 根据提示回答问题。

升级现已完成。