升级门户

此过程介绍了如何在本地升级现有的 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，则此命令应返回网页 根目录，格式为：

    *: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 及更高版本支持此升级过程。

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

http://yourportal.com/buildInfo

更新之前

对于现有安装，如果您修改了 Drupal Core 或任何非自定义 模块，您的修改将被覆盖。这些更改包括但不限于 您对.htaccess做出的更改。 您应该假定 /sites 目录以外的任何内容都归 Drupal 所有。一个 robots.txt例外；如果此文件存在于网络根目录中 为您保留。

在继续安装之前，请备份您的整个 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 属性所指定的数据库 配置文件

    系统会提示您输入 DRUPAL_PG_PASS 属性。

    如果您稍后想要使用备份进行恢复，请使用以下命令：

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

    如果您不确定此目录的位置，请使用 drush status 命令或 配置 >媒体 >Drupal 菜单中的“File”条目，以确定 公开文件系统的位置和私有文件系统路径（对于下一个 步骤）。

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

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

      默认情况下，安装程序会检查您是否已安装 Java 1.8。您可以使用 “C”选择继续而不安装 Java。

  9. 要在没有互联网连接的服务器上进行升级，请执行以下操作： <ph type="x-smartling-placeholder">
      </ph>
    1. 按照说明创建本地 4.19.06 代码库 创建本地 Apigee 代码库。
    2. 如需从 .tar 文件安装 apigee-service，请执行以下操作： <ph type="x-smartling-placeholder">
        </ph>
      1. 在具有本地代码库的节点上，使用以下命令将本地代码库 存储到单个 .tar 文件 /opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如，将该文件复制到 复制到新节点上的 /tmp 目录。
      3. 在新节点上，将文件解压缩到 /tmp 目录： 
        tar -xzf apigee-4.19.06.tar.gz

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

      4. 从以下位置安装 Edge apigee-service 实用程序和依赖项： /tmp/repos： 
        sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        请注意，您在此命令中加入了代码库目录的路径。

    3. 如需使用 Nginx Web 服务器安装 apigee-service，请执行以下操作： <ph type="x-smartling-placeholder">
        </ph>
      1. 按照“使用 Nginx Web 服务器”Install the Edge apigee-setup 实用程序，
      2. 在远程节点上，将 Edge bootstrap_4.19.06.sh 文件下载到 /tmp/bootstrap_4.19.06.sh： 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh
  -o /tmp/bootstrap_4.19.06.sh

        其中，uName 和 pWord 是您设置的用户名和密码 remoteRepo 是代码库的 IP 地址或 DNS 名称 代码库节点。

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

        其中，uName 和 pWord 是 Repo 用户名和密码。

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

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