升级开发者服务门户

开发者服务门户 v. 4.16.09

此过程介绍了如何升级现有的 Apigee Developer Channel Services 本地安装。

默认安装目录

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

如果您不知道安装目录，可以按照常用的 Drush 命令中所述的方法确定。

支持的升级版本

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

  • 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

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

http://yourportal.com/buildInfo

安装之前的准备工作

对于现有安装，如果您修改了 Drupal 核心或任何非自定义模块中的任何代码，这些修改将会被覆盖。这包括您可能对 .htaccess 所做的任何更改。您应假定 /sites 目录之外的所有内容均归 Drupal 所有。robots.txt 是这条规则的例外情况；如果此文件存在于网站根目录中，我们会为您保留该文件。

在继续安装之前，请备份整个 Drupal Web 根目录。默认安装位置是 /var/www/html，但您可能在安装时更改了该位置。执行下文所述的安装步骤后，您可以从备份中恢复自定义设置。

将 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 Web 根目录。默认安装位置为 /var/www/html，但您可能在安装时更改了该位置。
  3. 下载开发者渠道服务 DeveloperServices_x.y.z.tar 文件，其中 x.y.z 对应于门户版本号。

    您可以通过浏览器访问 Apigee 向您发送的链接来下载文件，也可以复制该链接，然后将其添加到以下 c网址 命令中：
    > curl -kOL <paste link here>

    注意：如果您的门户位于没有外部互联网连接的服务器上，请在有访问权限的服务器上执行此步骤。

    请访问 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 更新管理器模块。从 Drupal 菜单中，选择模块，然后向下滚动到更新管理器模块。如果未启用，请进行启用。

      启用后，您可以通过依次点击报告 > 可用更新菜单项来查看可用更新。

      依次选择 Reports > Available Updates > Settings 菜单项，配置模块以便在有更新时向您发送电子邮件，并设置检查更新的频率。
  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 复制到目标服务器的网站根目录。
    5. 将 devportal-update.tgz 文件解压缩到当前目录：
      > tar -xzf /path/to/devportal-update.tgz
    6. 切换到 developer-update 目录。
    7. 运行以下命令以安装更新：
      > ./install-update.sh
    8. 回答提示。

升级现已完成。