升級開發人員入口網站

Developer Services Portal 4.16.05 版

本程序說明如何升級現有的 Apigee Developer Channel Services 地端部署安裝。

預設安裝目錄

升級程序會假設開發人員入口網站安裝在 /var/www/html。如果您未在預設目錄中安裝入口網站,請修改下列程序中的路徑,改用安裝目錄。

如果您不知道安裝目錄,可以按照「常用的 Drush 指令」一文中的說明找出目錄。

支援的升級版本

下列入口網站版本支援這項升級程序:

  • pantheon-4.24.216
  • pantheon-4.24.246
  • 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

如要判斷入口網站版本,請在瀏覽器中開啟下列網址:

http://yourportal.com/buildInfo

將 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. 下載開發人員管道服務 DeveloperServices_x.y.z.tar 檔案,其中 x.y.z 對應入口網站版本號碼。

    您可以在瀏覽器中,透過 Apigee 傳送給您的連結下載檔案,也可以複製連結,然後將連結新增至下列 cURL 指令:
    > curl -kOL <paste link here>

    注意:如果入口網站位於未連上外部網際網路連線的伺服器,請在可存取網際網路連線的伺服器上執行這個步驟。

    前往 http://community.apigee.com/content/apigee-customer-support,然後選取「Login to your Support Portal」,要求取得開發人員入口網站服務升級 .tar 檔案。如果您沒有支援入口網站帳戶,請選取 「Login to your Support Portal」(登入支援入口網站),然後在登入頁面選取 「In a hurry?」(趕時間嗎?)在這裡提交支援單。
  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 Update Manager 模組。在 Drupal 選單中選取「Modules」,然後向下捲動至「Update manager」模組。如果尚未啟用,請啟用。

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

      依序點選「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. 回答提示訊息中的問題。

升級完成。