升級開發人員入口網站

開發人員服務入口網站 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 網站根目錄。預設安裝位置為 /var/www/html，但您可能在安裝時變更了這個位置。執行下列安裝步驟後，您可以從備份檔案還原自訂項目。

將 Apigee Developer Channel Services 升級至新版本

  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. 下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 與入口網站版本號碼相對應。

    您可以透過瀏覽器中的連結下載檔案，也可以複製連結並將其加入下列 cURL 指令：
    > curl -kOL <paste link here>

    注意：如果您的入口網站位於沒有外部網際網路連線的伺服器上，請在有連線的伺服器上執行這項步驟。

    前往 http://community.apigee.com/content/apigee-customer-support，然後選取「登入支援入口網站」，即可要求取得開發人員管道服務升級 .tar 檔案。如果您沒有支援入口網站的帳戶，請選取「登入支援入口網站」，然後在登入頁面中選取「趕快嗎？」請在這裡提交支援單。
  4. 如要在有網際網路連線的伺服器上進行升級：
    1. 擷取入口網站升級檔案：
      > tar -xvf <tar 檔案>

      這個擷取指令會建立名為 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 Manager 模組已啟用。在 Drupal 選單中，選取「Modules」，然後向下捲動至「Update manager」模組。如果尚未啟用，請啟用這項功能。

      啟用後，您可以使用「Reports > Available Updates」選單項目查看可用的更新。

      請依序點選「報表」>「可用的更新」>「設定」選單項目，設定模組在有可用更新時傳送電子郵件給您，以及設定檢查更新的頻率。
  5. 如要在沒有網際網路連線的伺服器上升級：
    1. 在您下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案的伺服器上，擷取入口網站升級檔案：
      > tar -xvf <tar 檔案>

      這個擷取指令會建立名為 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. 回答提示訊息中的問題。

升級作業已完成。