升級開發人員入口網站

Developer Services Portal 4.17.01 版

這項程序說明如何升級現有的 Apigee 開發人員通路服務地端部署安裝。

預設安裝目錄

升級程序假設開發人員入口網站已安裝在 /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
• OPDK-16-09.x

如要確認您的入口網站版本，請在瀏覽器中開啟下列網址：

http://yourportal.com/buildInfo

安裝前的注意事項

至於現有安裝項目，如果您修改了 Drupal 核心或任何非自訂模組中的任何程式碼，則修改內容會遭到覆寫。這包括您變更了 .htaccess 的任何變更。您應假設 /sites 目錄以外的內容均由 Drupal 所擁有。robots.txt 是例外狀況，如果這個檔案存在於網路根目錄，系統會為您保留該檔案。

繼續安裝之前，請先備份整個 Drupal 網路根目錄。預設的安裝位置為 /var/www/html，但您可能在安裝時變更了位置。執行以下安裝步驟後，您就可以從備份還原自訂內容。

將 Apigee 開發人員通路服務升級至新版本

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，根據預設，兩者皆為偵錯狀態。
2. 備份整個 Drupal 網路根目錄。預設的安裝位置為 /var/www/html，但您可能在安裝時變更了位置。
3. 從 ftp.apigee.com 下載開發人員 Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 與入口網站版本號碼相應。出現提示時，輸入從 Apigee 取得的憑證。
   
   
   
   
   
   
   前往 http://community.apigee.com/content/apigee-customer-support，然後選取「登入支援入口網站」來要求升級開發人員通路服務 .tar 檔案。如果支援入口網站上沒有帳戶，請選取登入支援入口網站，然後在登入頁面選取「等不及了嗎？」。請按這裡提交支援單。
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」模組。如果尚未啟用，請啟用。
      
      啟用後，您可以前往「報表」>「可用的更新」選單項目，查看可用的更新。
      
      依序點選「報表」>「可用更新」>「設定」選單項目，即可設定模組，讓系統在有更新時寄送電子郵件通知您，以及設定更新頻率。
5. 在沒有網際網路連線的伺服器中升級：
   1. 在下載 Developer Channel Services 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. 回答提示問題。

升級完成。