升級開發人員入口網站

Developer Services Portal 4.17.09 版

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

確定正確的更新程序

您用來更新入口網站的程序取決於目前的安裝方式：

• 如果安裝的是 Nginx/Postgres，請參閱下方的使用 RPM 升級入口網站。
• 如果您的安裝作業使用 Apache/MySQL 或 Apache/MariaDB，請參閱將 tar 入口網站轉換為 RPM 入口網站。

判斷目前的安裝類型

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

• ls /opt

  如果您使用的是 Nginx/Postgres，會看到下列目錄：/opt/apigee 和 /opt/nginx。

  如果您使用的是 Apache/MySQL 或 Apache/MariaDB，則這些目錄不應出現。

• /opt/apigee/apigee-service/bin/apigee-all status

  如果您使用的是 Nginx/Postgres，會看到下列輸出內容：

  + apigee-service
    apigee-drupal-devportal status
    OK: apigee-drupal-devportal is up and running
    + apigee-service apigee-lb status
    apigee-service: apigee-lb: OK
    + apigee-service apigee-postgresql status
    apigee-service: apigee-postgresql: OK

• apachectl -S

  如果您使用的是 Apache/MySQL 或 Apache/MariaDB，則這個指令應會傳回入口網站的網頁根目錄，格式如下：

  *:80
    192.168.56.102
    (/etc/httpd/conf/vhosts/devportal.conf:1)

預設安裝目錄

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

• 4.17.05 以上版本：/opt/apigee/apigee-drupal/wwwroot
• 4.17.05 之前：/opt/apigee/apigee-drupal (Nginx) 或 /var/www/html (Apache)

如果您並未在預設目錄中安裝入口網站，請按照下列程序修改路徑，才能使用安裝目錄。

支援的升級版本

以下版本的入口網站支援此升級程序：

• OPDK-17-01.x
• OPDK-17-05.x

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

http://your_portal.com/buildInfo

更新前

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

繼續安裝前，請先備份整個 Drupal 網路根目錄。執行下列安裝步驟後，您可以從備份還原自訂項目。

使用 RPM 升級入口網站

如要更新節點的 Portal RPM，請按照下列程序操作：

1. 切換至 Drupal 目錄。例如：/opt/apigee/apigee-drupal/wwwroot。

   cd /opt/apigee/apigee-drupal/wwwroot

   如需產品版本的預設目錄，請參閱預設安裝目錄。

2. 備份 Drupal 資料庫執行個體。pg_dump 指令會建立資料庫的副本：
   

   pg_dump --dbname=devportal --host=192.168.56.101
     --username=drupaladmin --password --format=c > /tmp/portal.dmp

   其中：

   • dbname 會指定資料庫名稱，這項資訊由入口網站安裝設定檔中的 PG_NAME 屬性指定。
   • host 指定入口網站節點的 IP 位址。
   • username 會指定入口網站用來存取資料庫的 Postgres 使用者名稱，如入口網站安裝設定檔中的 DRUPAL_PG_USER 屬性所指定。
   • 系統會提示您輸入在入口網站安裝設定檔中 DRUPAL_PG_PASS 屬性中定義的 Postgres 使用者密碼。

   如果之後需要從備份還原，請使用以下指令：

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. 備份整個 Drupal 網站根目錄。預設安裝位置為 /opt/apigee/apigee-drupal，但您可能已變更。
   如果您不確定這個目錄的位置，請使用 drush status 指令或 Drupal 選單中的 「Configuration」>「Media」>「File」 項目，判斷公用檔案系統和私人檔案系統路徑的位置 (下一個步驟)。
4. 備份 /opt/apigee/data/apigee-drupal-devportal/private 中的檔案。
5. 將 Drupal 設為維護模式：
   1. 在 Drupal 選單中選取「Configuration」。
   2. 在「設定」頁面的「開發」下方，選取「維護模式」。
   3. 選取「將網站切換成維護模式」方塊。
   4. 輸入使用者在維護期間看到的訊息。
   5. 選取「儲存設定」。
6. 按照「安裝 Edge apigee-setup 公用程式」中的說明，停用 SELinux。
7. 切換至 /opt 目錄：

   cd /opt

8. 如要在有網際網路連線的伺服器上進行升級：
   1. 將 Edge 4.17.09 bootstrap_4.17.09.sh 檔案下載至 /tmp/bootstrap_4.17.09.sh：

      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

   2. 安裝 Edge 4.17.09 apigee-service 公用程式和依附元件：

      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
        apigeepassword=pWord

      其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。
      

      根據預設，安裝程式會檢查您是否已安裝 Java 1.8。使用「C」選項即可在不安裝 Java 的情況下繼續操作。

9. 如要在沒有網際網路連線的伺服器上升級：
   1. 按照「安裝 Edge apigee-setup 公用程式」一文中的「建立本機 Apigee 存放區」一節所述，建立本機 4.17.09 存放區。
   2. 如要從 .tar 檔案安裝 apigee-service：
      1. 在含有本機存放區的節點上，使用下列指令將本機存放區封裝成名為 /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz 的單一 .tar 檔案：

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，將其複製到新節點的 /tmp 目錄。
      3. 在新節點上，將檔案解壓縮至 /tmp 目錄：
         

         tar -xzf apigee-4.17.09.tar.gz

         這個指令會在含有 .tar 檔案的目錄中建立名為 repos 的新目錄。例如 /tmp/repos。

      4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：

         sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         請注意，您必須在這個指令中加入 repos 目錄的路徑。

   3. 如何使用 Nginx 網路伺服器安裝 apigee-service：
      1. 按照安裝 Edge apigee-setup 公用程式，按照「使用 Nginx 網路伺服器從存放區安裝」一節的說明，設定 Nginx 網路伺服器。
      2. 在遠端節點上，將 Edge bootstrap_4.17.09.sh 檔案下載至 /tmp/bootstrap_4.17.09.sh：

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
           -o /tmp/bootstrap_4.17.09.sh

         其中 uName:pWord 是您為存放區設定的使用者名稱和密碼，而 remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。

      3. 在遠端節點上安裝 Edge apigee-service 公用程式和依附元件：程式碼

         sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         其中 uName:pWord 是存放區使用者名稱和密碼。

10. 使用 apigee-service 更新 apigee-setup 公用程式：

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. 在節點上執行更新公用程式，以便更新 Postgres 資料庫：
    

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    其中 configFile 是用來安裝 Postgres 資料庫的設定檔。設定檔的唯一規定是，設定檔必須可由「apigee」使用者存取或讀取。

12. 啟動 Postgres：
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

13. 在節點上執行更新公用程式，以便更新入口網站：

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    其中 configFile 是您安裝入口網站所使用的設定檔。設定檔唯一的要求是，「apigee」使用者必須能夠存取或讀取設定檔。

14. 在瀏覽器視窗中開啟下列網址，執行 Drupal 的 update.php 指令碼：

    http://portalIP_DNS:8079/update.php

15. 停用 Drupal 維護模式：
    1. 在 Drupal 選單中選取「Configuration」。
    2. 在「設定」頁面的「開發」下方，選取「維護模式」。
    3. 取消選取「將網站切換成維護模式」方塊。
    4. 選取「儲存設定」。

請注意，更新後的根目錄為：

/opt/apigee/apigee-drupal/wwwroot

升級已完成。