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 開發人員通路服務升級至新版本
- Drupal MySQL 執行個體的備份。
詳情請參閱 http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- 選項 1:使用「Drush」
「Drush」指令 sql-dump 會建立資料庫的副本。根據預設,在 Drupal 目錄中 /var/www/html 執行下列指令:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
使用 drush help sql-dump 取得更多資訊。 - 選項 2:使用 MySQLdump
使用 MySQLdump 指令建立資料庫副本:
MySQLdump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
-p 選項和密碼之間不應有空格。如果密碼含有特殊字元,就必須用單引號括住密碼。
您會在安裝入口網站時設定 USERNAME 和 DATABASENAME,根據預設,兩者皆為偵錯狀態。
- 選項 1:使用「Drush」
- 備份整個 Drupal 網路根目錄。預設的安裝位置為 /var/www/html,但您可能在安裝時變更了位置。
- 從 ftp.apigee.com 下載開發人員 Channel Services DeveloperServices_x.y.z.tar 檔案,其中 x.y.z 與入口網站版本號碼相應。出現提示時,輸入從 Apigee 取得的憑證。
前往 http://community.apigee.com/content/apigee-customer-support,然後選取「登入支援入口網站」來要求升級開發人員通路服務 .tar 檔案。如果支援入口網站上沒有帳戶,請選取登入支援入口網站,然後在登入頁面選取「等不及了嗎?」。請按這裡提交支援單。 -
在需要網際網路連線的伺服器中升級:
- 擷取入口網站升級檔案:
> tar -xvf <tar file>
這個指令會擷取為 DeveloperServices-4.x.y.z 的新目錄。 - 變更為 DeveloperServices-4.x.y.z 目錄。
- 使用下列指令下載最新版 Drupal:
> drush dl drupal
這個指令會建立名為 drupal-x.y 的目錄,其中 x.y 會對應至目前的 Drupal 版本。 - 執行 networked-update.sh 指令碼:
> ./networked-update.sh
視檔案權限而定,您可能需要使用 sudo 執行這個指令,或是以管理員身分執行這個指令。 - 如要接收 Drupal 更新通知,請確認已啟用 Drupal Update Manager 模組。在 Drupal 選單中選取「Modules」,然後向下捲動至「Update Manager」模組。如果尚未啟用,請啟用。
啟用後,您可以前往「報表」>「可用的更新」選單項目,查看可用的更新。
依序點選「報表」>「可用更新」>「設定」選單項目,即可設定模組,讓系統在有更新時寄送電子郵件通知您,以及設定更新頻率。
- 擷取入口網站升級檔案:
-
在沒有網際網路連線的伺服器中升級:
- 在下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案的伺服器上,擷取入口網站升級檔案:
> tar -xvf <tar file>
這個指令會擷取並建立名為 DeveloperServices-4.x.y.z 的新目錄。 - 變更為 DeveloperServices-4.x.y.z 目錄。
- 執行 non-networked-update.sh 指令碼:
> ./non-networked-update.sh
視檔案權限而定,您可能必須透過 sudo 執行這個指令,或是以管理員身分執行指令。
這個指令會下載所有必要的更新檔案並封裝至名為 devportal-update.tgz 的單一檔案,然後將檔案寫入您選擇的位置。 - 將 devportal-update.tgz 複製到目標伺服器,也就是執行入口網站的目標伺服器。
注意:請勿將 devportal-update.tgz 複製到目標伺服器的網路根目錄。 - 將 devportal-update.tgz 檔案解壓縮至目前的目錄:
> tar -xzf /path/to/devportal-update.tgz - 變更為 developer-update 目錄。
- 執行下列指令來安裝更新:
> ./install-update.sh - 回答提示問題。
- 在下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案的伺服器上,擷取入口網站升級檔案:
升級完成。