升级门户

Edge for Private Cloud v4.19.01

此过程介绍了如何升级本地安装的现有 Apigee Developer Services 门户(简称门户)。

确定正确的更新过程

用于更新门户的过程取决于当前安装:

确定当前安装类型

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

  • 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,则此命令应按如下形式返回门户的 Web 根目录:

    *: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
  • OPDK-18-05.x

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

http://yourportal.com/buildInfo

更新之前

对于现有安装,如果您修改了 Drupal 核心或任何非自定义模块中的任何代码,您的修改内容将被覆盖。其中包括您对 .htaccess 所做的任何更改。 您应假定 /sites 目录以外的所有内容都归 Drupal 所有。此规则的一个例外情况是 robots.txt;如果此文件位于 Web 根目录中,系统会为您保留它。

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

使用 RPM 升级门户

如需更新某个节点上的门户 RPM,请执行以下操作

  1. 切换到 Drupal 目录(默认为 /opt/apigee/apigee-drupal):
    cd /opt/apigee/apigee-drupal
  2. 备份您的 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 属性指定)的 Postgres 用户名。

    系统会提示您输入门户安装配置文件中 DRUPAL_PG_PASS 属性定义的 Postgres 用户密码。

    如果您以后想要从备份进行恢复,请使用以下命令:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. 备份整个 Drupal 网站根目录。默认安装位置为 /opt/apigee/apigee-drupal,但您可能已更改过它。

    如果您不确定此目录的位置,请使用 drush status 命令或 Drupal 菜单中的 Configuration > Media > File 条目来确定公共文件系统的位置和私有文件系统路径(在下一步中)。

  4. 备份 /opt/apigee/data/apigee-drupal-devportal/private 中的文件。
  5. 将 Drupal 设置为维护模式:
    1. 在“Drupal”菜单中选择配置
    2. 配置页面上,选择开发下的维护模式
    3. 选中将网站置于维护模式复选框。
    4. 输入用户在维护期间会看到的消息。
    5. 选择保存配置
  6. 按照安装 Edge apigee-setup 实用程序中的说明停用 SELinux。
  7. 切换到 /opt 目录:
    cd /opt
  8. 在连接到互联网的服务器上进行升级
    1. 将 Edge 4.19.01 bootstrap_4.19.01.sh 文件下载到 /tmp/bootstrap_4.19.01.sh
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    2. 安装 Edge 4.19.01 apigee-service 实用程序和依赖项:
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      其中,uNamepWord 是您从 Apigee 收到的用户名和密码。如果省略 pWord,系统会提示您输入。

      默认情况下,安装程序会检查是否安装了 Java 1.8。您可以使用“C”选项继续操作,无需安装 Java。

  9. 在没有互联网连接的服务器上进行升级
    1. 按照创建本地 Apigee 代码库中的说明创建本地 4.19.01 代码库。
    2. 如需通过 .tar 文件安装 apigee-service,请执行以下操作:
      1. 在包含本地代码库的节点上,使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz 的单个 .tar 文件中:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如,将其复制到新节点上的 /tmp 目录。
      3. 在新节点上,将文件解压缩到 /tmp 目录:
        tar -xzf apigee-4.19.01.tar.gz

        此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录。例如 /tmp/repos。

      4. /tmp/repos 安装 Edge apigee-service 实用程序和依赖项:
        sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        请注意,此命令中包含 repos 目录的路径。

    3. 如需使用 Nginx Web 服务器安装 apigee-service,请执行以下操作
      1. 按照安装 Edge apigee-setup 实用程序中的“使用 Nginx 网络服务器从代码库安装”中的说明配置 Nginx Web 服务器。
      2. 在远程节点上,将 Edge bootstrap_4.19.01.sh 文件下载到 /tmp/bootstrap_4.19.01.sh
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
          -o /tmp/bootstrap_4.19.01.sh

        其中,uNamepWord 是您上面为代码库设置的用户名和密码,remoteRepo 是代码库节点的 IP 地址或 DNS 名称。

      3. 在远程节点上,安装 Edge apigee-service 实用程序和依赖项:
        sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939
          apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        其中,uNamepWord 是代码库用户名和密码。

  10. 使用 apigee-service 更新 apigee-setup 实用程序:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. 在 Postgres 节点上运行更新实用程序:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    其中,configFile 是您用于安装 Postgres 数据库的配置文件。配置文件的唯一要求是配置文件必须可供“apigee”用户访问或读取。

  12. 在您的节点上运行更新实用程序以更新门户:
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    其中,configFile 是您用于安装门户的配置文件。配置文件的唯一要求是配置文件必须可供“apigee”用户访问或读取。

  13. 在浏览器窗口中打开以下网址,运行 Drupal 的 update.php 脚本:
    http://portal_IP_DNS:8079/update.php
  14. 停用维护模式:
    1. 在“Drupal”菜单中选择配置
    2. 配置页面上,选择开发下的维护模式
    3. 取消选中将网站置于维护模式复选框。
    4. 选择保存配置

请注意,更新后的根目录为:

/opt/apigee/apigee-drupal/wwwroot

升级现已完成。如果 Apigee 更新实用程序降级了您的 Drupal 版本,您可能需要重新运行 Drupal 升级实用程序。如需了解详情,请参阅重新运行 Drupal 升级

重新运行 Drupal 升级

如果运行 Apigee 更新实用程序来升级适用于 Private Cloud 的 Edge 实际上导致您的 Drupal 版本降级,请重新安装 Drupal 升级。如果您在私有云更新之间仅升级了 Drupal,就可能出现这种情况。

例如:

  1. 您运行的是适用于私有云的 Edge 4.18.05 版本,其中包含 Drupal 7.59。
  2. 由于需要进行安全更新,您已将 Drupal 升级至 7.64。
  3. 您正在将 Private Cloud 升级到 4.19.01(包括 Drupal 7.61)。

如图所示,Apigee 更新实用程序使用的 Drupal 版本可能未引用最新的 Drupal 升级。因此,您现在必须重新运行 Drupal 升级,才能将 Drupal 安装恢复到更新版本。