升級入口網站

Private Cloud v4.19.01 版

這個程序說明如何將現有的 Apigee Developer 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
• OPDK-17-09.x
• OPDK-18-01.x
• OPDK-18-05.x

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

http://yourportal.com/buildInfo

更新前的準備

針對現有安裝項目，如果您曾經修改 Drupal Core 或 修改內容就會遭到覆寫包括任何變更 你對.htaccess的觀察結果。 您應假設 /sites 目錄之外的所有內容為 Drupal 所擁有。一個 此規則的例外狀況是 robots.txt；如果檔案位於網路根目錄中 保存。

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

透過 RPM 升級入口網站

如何更新節點上的入口網站 RPM：

1. 變更為 Drupal 目錄，預設為 /opt/apigee/apigee-drupal：

   cd /opt/apigee/apigee-drupal

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

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

   在此情況下：

   • devportal 是資料庫名稱 PG_NAME 屬性。
   • host_IP_address 是入口網站節點的 IP 位址。
   • drupaladmin 是入口網站用來存取 與入口網站安裝項目中 DRUPAL_PG_USER 屬性指定的資料庫 設定檔

   系統會提示您輸入 Postgres 使用者密碼， DRUPAL_PG_PASS 屬性。

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

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

3. 備份整個 Drupal 網站根目錄。預設安裝位置 是 /opt/apigee/apigee-drupal，但您可能已變更。

   如果您不確定這個目錄的位置，請使用 drush status 指令或 設定 >媒體 >判斷 Drupal 選單中的「File」項目 公開檔案系統的位置以及私人檔案系統路徑 ( 步驟)。

4. 備份 /opt/apigee/data/apigee-drupal-devportal/private 中的檔案。
5. 將 Drupal 設為維護模式：
   1. 在 Drupal 選單中選取「Configuration」。
   2. 在「Configuration」(設定) 頁面中，選取 [維護模式]。 位於「開發」底下。
   3. 選取「讓網站進入維護模式」方塊。
   4. 輸入使用者維護期間看到的訊息。
   5. 選取「儲存設定」。
6. 按照 安裝 Edge apigee-setup 公用程式。
7. 切換至 /opt 目錄：

   cd /opt

8. 在具備網際網路連線的伺服器上升級應用程式：
   1. 下載 Edge 4.19.01 bootstrap_4.19.01.sh 檔案， /tmp/bootstrap_4.19.01.sh:

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

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

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

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

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

9. 在沒有網際網路連線的伺服器上升級應用程式：
   1. 按照下列說明建立本機 4.19.01 存放區： 建立本機 Apigee 存放區。
   2. 如要從 .tar 檔案安裝 apigee-service：
      1. 在含有本機存放區的節點上，使用下列指令來封裝本機 複製到名為 /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz:

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

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

         tar -xzf apigee-4.19.01.tar.gz

         這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos。

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

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

         請注意，您會在這個指令中加入存放區目錄的路徑。

   3. 使用 Nginx 網路伺服器安裝 apigee-service：
      1. 按照「使用 Nginx webserver」「Install the Edge apigee-setup 公用程式。
      2. 在遠端節點上，將 Edge bootstrap_4.19.01.sh 檔案下載至 /tmp/bootstrap_4.19.01.sh:

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

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

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

         sudo bash /tmp/bootstrap_4.19.01.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」存取或讀取內容。