此页面由 Cloud Translation API 翻译。

升级开发者服务门户

开发者服务门户 v. 4.17.05

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

<ph type="x-smartling-placeholder">。

确定正确的更新过程

更新门户所用的过程基于当前安装：

如果您的安装使用系统中的 Apache/MySQL 或 Apache/MariaDB 已更新至 4.17.01，则请使用正在升级（适用于 .tar 文件）。
如果您的安装使用新 4.17.01 版 Nginx/Postgres 安装，然后使用升级门户网站采用每千次展示收入

正在确定您当前的安装类型

如果您不确定当前的安装类型，请使用以下命令确定：

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-service apigee-lb 状态
apigee-service：apigee-lb：成功
+ apigee-service apigee-postgresql 状态
apigee-service：apigee-postgresql：正常
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

to:

/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 Core 或任何非自定义模块，您的修改将被覆盖。这些更改包括但不限于您对 .htaccess 所做的更改。您应该假定 /sites 目录之外的任何内容都归 Drupal 所有。一个 robots.txt 例外；如果此文件存在于网上 root，系统会为您保留该文件。

在继续安装之前，请备份您的整个 Drupal 网络根目录目录。执行下述安装步骤后，您就可以恢复备份中的自定义设置。

使用 .tar 文件升级门户

备份您的 Drupal MySQL/MariaDB 实例。
如需了解详情，请参阅 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 用户名 -p'PASSWORD'数据库名称 > /path/to/backup_dir/database-backup.sql
  
  -p 选项与密码之间不应有空格。单个如果密码中包含特殊字符，则必须用引号将密码括起来。
  
  您已设置 USERNAME 和 DATABASENAME 安装该门户时的步骤默认情况下，两者都是 devportal。
备份整个 Drupal 网络根目录。默认安装位置为 /var/www/html，但您可能会已在安装时更改
下载开发者渠道服务 DeveloperServices_x.y.z.tar 来自 ftp.apigee.com 的文件，其中 x.y.z 与门户版本号相对应。出现提示时，输入您收到的凭据

您可以在浏览器中通过 Apigee 发送给您的链接下载文件，也可以将该文件复制并然后将其添加到以下 c网址命令中：
>curl -kOL <粘贴链接 here>

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

转到 Apigee Edge 支持，然后选择 Login to your Support Portal（登录支持门户）以申请开发者频道服务升级 .tar 文件。如果您没有支持门户的账号，请选择 登录支持门户，然后在登录页面上选择在赶时间吗？在此处提交支持服务工单。
在连接到互联网的服务器上进行升级： <ph type="x-smartling-placeholder">
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 菜单中选择 Modules 并向下滚动到 更新管理器模块。如果未启用，请启用。
  
  启用后，您可以使用报告 >可用更新菜单项。
  
  使用报告 >可用更新 >Settings 菜单项设置为将模块配置为在有更新时向您发送电子邮件，并设置检查更新。
要在没有互联网连接的服务器上进行升级，请执行以下操作： <ph type="x-smartling-placeholder">
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. 回答提示。

升级现已完成。

使用 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 地址，和门户节点的地址
- 用户名用于指定根据 DRUPAL_PG_USER 属性门户安装配置文件。
- 系统会提示您输入由 DRUPAL_PG_PASS 属性定义的门户安装配置文件。
如果以后必须从备份进行恢复，请使用以下命令：
pg_restore --clean --dbname=devportal --host=localhost --username=apigee </tmp/portal.dmp
备份整个 Drupal 网络根目录。默认安装位置为 /opt/apigee/apigee-drupal，但您可能已对其进行了更改

如果您不确定此目录的位置，请使用 drush status 命令或 配置 >媒体 >Drupal 菜单中的“File”条目，以确定公开文件系统的位置和私有文件系统路径（对于下一个步骤）。
备份 /opt/apigee/data/apigee-drupal-devportal/private 中的文件。
按照安装 Edge apigee-setup 实用程序，
在连接到互联网的服务器上进行升级： <ph type="x-smartling-placeholder">
1. 下载 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.sh
2. 安装 Edge 4.17.05 apigee-service 实用程序，并依赖项：
  >sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
  
  其中，uName:pWord 是您通过 Google 发送的用户名和密码 Apigee。如果您省略 pWord，系统会提示您输入。
  
  默认情况下，安装程序会检查您是否已安装 Java 1.8。您可以使用 “C”选择继续而不安装 Java。
要在没有互联网连接的服务器上进行升级，请执行以下操作： <ph type="x-smartling-placeholder">
1. 按照“创建本地 Apigee 代码库”中的说明创建本地 4.17.05 代码库在安装 Edge apigee-setup 实用程序。
  注意：如果您已有 4.17.01 代码库，则可以 4.17.05 代码库，如“更新本地 Apigee 代码库”中所述安装 Edge apigee-setup 实用程序。
2. 如需从 .tar 文件安装 apigee-service，请执行以下操作： <ph type="x-smartling-placeholder">
  1. 在具有本地代码库的节点上，使用以下命令将本地代码库代码库存储到名为 /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz 的单个.tar 文件中：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror 软件包
  2. 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如，将该文件复制到进入 /tmp 目录新节点上的资源
  3. 在新节点上，将文件解压缩到 /tmp 目录：
    >tar -xzf apigee-4.17.05.tar.gz
    
    此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录文件。例如 /tmp/repos。
  4. 安装 Edge apigee-service 实用程序并 /tmp/repos 中的依赖项：
    >sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    请注意，您在此命令中加入了代码库目录的路径。
3. 如需使用 Nginx Web 服务器安装 apigee-service，请执行以下操作： <ph type="x-smartling-placeholder">
  1. 按照“使用 Nginx Web 服务器”Install the Edge apigee-setup 实用程序，
  2. 在远程节点上，下载 Edge bootstrap_4.17.05.sh 文件， /tmp/bootstrap_4.17.05.sh：
    >/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    
    其中，uName:pWord 是您在上面设置的用户名和密码 remoteRepo 是代码库的 IP 地址或 DNS 名称代码库节点
  3. 在远程节点上，安装 Edge apigee-service 实用程序并依赖项：
    >sudo bash /tmp/bootstrap_4.17.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 更新
在您的节点上运行更新实用程序，以更新 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