升級開發人員入口網站

Developer Services Portal 4.17.05 版

這個程序說明如何升級現有的 Apigee Developer Channel 服務 內部部署安裝。

確定正確的更新程序

更新入口網站的程序取決於目前的安裝程序：

• 如果您安裝的項目是從系統中使用 Apache/MySQL 或 Apache/MariaDB 更新至 4.17.01，然後使用升級 入口網站。
• 如果您安裝的元件是使用新 4.17.01 的 Nginx/Postgres 安裝，然後使用升級入口網站 每千次觀看收益

決心 目前的安裝類型

如果不確定目前的安裝類型，請使用以下指令來判斷目前的安裝類型 它：

• ls /opt
  如果您使用的是 Nginx/Postgres，就會看到下列目錄：/opt/apigee 和 /opt/nginx。
  
  如果您使用的是 Apache/MySQL 或 Apache/MariaDB，則不應使用這些目錄 。
• /opt/apigee/apigee-service/bin/apigee-all 狀態
  如果您使用的是 Nginx/Postgres，會看到下列輸出結果：
  
  + apigee-service apigee-drupal-devportal 狀態
  確定：apigee-drupal-devportal 已啟動並正在執行
  + apigee-service apigee-lb 狀態
  Apigee-service：apigee-lb：確定
  + apigee-service apigee-postgresql 狀態
  apigee-service: apigee-postgresql: OK
• apachectl -S
  如果您使用的是 Apache/MySQL 或 Apache/MariaDB，則這個指令應會傳回 入口網站的根目錄，格式為：
  
  *:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

預設安裝目錄

升級程序假設開發人員入口網站已安裝於：

• /opt/apigee/apigee-drupal (Nginx)
• /var/www/html (Apache)

如果您並非在預設目錄中安裝入口網站，請修改程序中的路徑 使用安裝目錄。

如果您不知道安裝目錄，可以按照「常用的筆刷指令」中的指示操作。

全新內容 從新的 4.17.01 更新 Nginx/Postgres 後，預設安裝目錄 安裝

更新使用 Nginx/Postgres (根目錄) 的新 4.17.01 安裝之後 從：

/opt/apigee/apigee-drupal

收件者：

/opt/apigee/apigee-drupal/wwwroot

支援的升級版本

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

• 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
• OPDK-17-01.x

如要判斷入口網站版本，請在瀏覽器中開啟以下網址：

http://yourportal.com/buildInfo

更新前的準備

針對現有安裝項目，如果您曾經修改 Drupal Core 或 修改內容就會遭到覆寫包括任何變更 您對 .htaccess 的相關權限。 您應假設 /sites 目錄之外的所有內容為 Drupal 所擁有。一個 但這項規則是 robots.txt。該檔案是否存在 因此檔案會保留下來。

繼續安裝前，請先備份整個 Drupal 網路根目錄 目錄。完成下列安裝步驟後， 自訂備份設定

使用 .tar 檔案升級入口網站

1. 備份 Drupal MySQL/MariaDB 執行個體。
   如需更多資訊，請參閱 http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
   1. 方法 1：使用筆刷
      
      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 使用者名稱 -p'密碼'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 檔案從 ftp.apigee.com 存取，x.y.z 對應入口網站版本編號系統提示時，輸入您收到的憑證 。
   
   您可以透過 Apigee 在瀏覽器中傳送的連結下載檔案，或複製 然後新增至以下 cURL 指令中：
   &gt;curl -kOL <貼上連結 here&gt;
   
   注意：如果入口網站位於沒有外部網際網路連線的伺服器中， 請在具有存取權的伺服器上執行這個步驟。
   
   前往 Apigee Edge 支援頁面 然後選取 [登入支援入口網站] 來申請開發人員頻道 服務升級 .tar 檔案。如果您沒有支援入口網站的帳戶，請選取 登入支援入口網站，然後在登入頁面上選取 趕時間嗎？請在這裡提交支援單，
4. 在具備網際網路連線的伺服器上升級應用程式：
   1. 擷取入口網站升級檔案：
      &gt;tar -xvf <tar file&gt;
      
      這個指令擷取作業會建立一個名為 DeveloperServices-4.x.y.z 的新目錄。
   2. 變更為 DeveloperServices-4.x.y.z 目錄。
   3. 使用下列指令下載最新的 Drupal 版本：
      &gt;Drush dl drupal
      
      這個指令會建立一個名為 drupal-x.y 的目錄，其中 x.y 對應目前的 Drupal 推出的版本
   4. 執行 networked-update.sh 指令碼：
      &gt; ./networked-update.sh
      
      視檔案權限而定，您可能必須使用 sudo 執行這個指令，或是以 管理員。
   5. 如要接收 Drupal 更新通知，請確認 Drupal Update 管理員 就會啟用該模組。在 Drupal 選單中選取「Modules」，然後向下捲動至 「Update manager」模組。如果尚未啟用，請加以啟用。
      
      啟用後，您可以前往 [報表] > [可用 更新選單項目。
      
      使用報表 >有可用的更新 >點選「設定」選單項目 設定模組，讓系統在有可用的更新時以電子郵件通知您，並設定 正在檢查更新。
5. 在沒有網際網路連線的伺服器上升級應用程式：
   1. 在下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案的伺服器上， 擷取入口網站升級檔案：
      &gt;tar -xvf <tar file&gt;
      
      這個指令擷取作業會建立一個名為 DeveloperServices-4.x.y.z 的新目錄。
   2. 變更為 DeveloperServices-4.x.y.z 目錄。
   3. 執行 non-networked-update.sh 指令碼：
      &gt; ./non-networked-update.sh
      
      視檔案權限而定，您可能必須使用 sudo 執行這個指令，或是以 管理員。
      
      這個指令會下載所有必要的更新檔案，並將其封裝為單一檔案 名為 devportal-update.tgz 並將檔案寫入您選擇的位置
   4. 將 devportal-update.tgz 複製到目標 執行入口網站的伺服器
      注意：請「不要」將 devportal-update.tgz 複製到 複製到目標伺服器
   5. 將 devportal-update.tgz 檔案解壓縮至 目前的目錄：
      &gt;tar -xzf /path/to/devportal-update.tgz
   6. 切換至 developer-update 目錄。
   7. 執行下列指令安裝更新：
      &gt; ./install-update.sh
   8. 回答提示問題。

/opt/apigee/apigee-drupal/wwwroot