本頁面由 Cloud Translation API 翻譯而成。

升級開發人員入口網站

Edge for Private Cloud 4.18.01

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

，瞭解如何調查及移除這項存取權。

確定正確的更新程序

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

如果您的安裝作業使用 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

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

http://yourportal.com/buildInfo

注意：如果您因某些原因移除了 buildInfo 檔案，則可以從 profiles/apigee/apigee.info 檔案判斷版本。預設安裝位置為 /var/www/html/profiles/apigee/apigee.info，但如果您在 /var/www/html 以外的目錄中安裝入口網站，可能會在安裝時變更該位置。apigee.info 檔案包含格式如下：

version = "OPDK-4.17.05"

更新前

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

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

使用 RPM 升級入口網站

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

將 /opt/apigee/apigee-drupal 變更為 Drupal 目錄預設：
```
cd /opt/apigee/apigee-drupal
```
備份 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
```
備份整個 Drupal 網站根目錄。預設安裝位置是 /opt/apigee/apigee-drupal，但您可能已變更。
如果您不確定這個目錄的位置，請使用 drush status 指令或 設定 >媒體 >判斷 Drupal 選單中的「File」項目公開檔案系統的位置以及私人檔案系統路徑 ( 步驟)。
備份 /opt/apigee/data/apigee-drupal-devportal/private 中的檔案。
將 Drupal 設為維護模式：
1. 在 Drupal 選單中選取「Configuration」。
2. 在「設定設定」頁面中，選取「維護」模式底下的 開發中。
3. 選取「將網站切換成維護模式」方塊。
4. 輸入使用者在維護期間看到的訊息。
5. 選取「儲存設定」。
按照安裝 Edge apigee-setup 公用程式。
切換至 /opt 目錄：
```
> cd /opt
```
在具備網際網路連線的伺服器上升級應用程式：
1. 下載 Edge 4.18.01 bootstrap_4.18.01.sh 檔案至 /tmp/bootstrap_4.18.01.sh：
```
curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
```
2. 安裝 Edge 4.18.01 apigee-service 公用程式和依附元件：
```
sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
```
  其中 uName:pWord 是您所收到使用者名稱和密碼 Apigee。如果省略 pWord，系統會提示您輸入。
  
  根據預設，安裝程式會檢查您是否已安裝 Java 1.8。您可以使用「C」選項繼續操作，而無須安裝 Java。
在沒有網際網路連線的伺服器上升級應用程式：
1. 按照「建立本機 Apigee 存放區」中的說明建立本機 4.18.01 存放區於安裝邊緣 apigee-setup 公用程式。
  注意：如果您已擁有現有的 4.17.05 存放區，可以按照「安裝 Edge apigee-setup 公用程式」中的「更新本機 Apigee 存放區」一節所述，將 4.18.01 存放區新增至該存放區。
2. 如要從 .tar 檔案安裝 apigee-service：
  1. 在含有本機存放區的節點上，使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的單一 .tar 檔案：
```
 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，複製新增至新節點的 /tmp 目錄。
  3. 在新節點上，將檔案卸離至 /tmp 目錄：
```
tar -xzf apigee-4.18.01.tar.gz
```
    這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos。
  4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
```
sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    請注意，您會在這個指令中加入存放區目錄的路徑。
3. 使用 Nginx 網路伺服器安裝 apigee-service：
  1. 依據「安裝 Edge apigee-setup 公用程式」一文中的「使用 Nginx 網路伺服器從存放區安裝」說明，設定 Nginx 網路伺服器。
  2. 在遠端節點上，將 Edge bootstrap_4.18.01.sh 檔案下載至 /tmp/bootstrap_4.18.01.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
  -o /tmp/bootstrap_4.18.01.sh
```
    其中 uName:pWord 是您為存放區設定的使用者名稱和密碼，而 remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。
  3. 在遠端節點上安裝 Edge apigee-service 公用程式和依附元件：
```
sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
    apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    其中 uName:pWord 是存放區使用者名稱和密碼。

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

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

在 Postgre 節點上執行更新公用程式：
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
其中 configFile 是用來安裝 Postgres 資料庫的設定檔。設定檔的唯一要求是檔案必須可由「apigee」存取或讀取內容。

更新 Postgres 資料庫：

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

在節點上執行更新公用程式，以便更新入口網站：
```
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
```
其中 configFile 是用來安裝入口網站的設定檔。設定檔唯一的要求是，「apigee」使用者必須能夠存取或讀取設定檔。
在瀏覽器視窗中開啟下列網址，執行 Drupal 的 update.php 指令碼：
```
http://portalIP_DNS:8079/update.php
```
將 Drupal 停用至維護模式：
1. 在 Drupal 選單中選取「Configuration」。
2. 在「Configuration」頁面中，選取「Development」下方的「Maintenance mode」。
3. 取消選取「將網站設為維護模式」方塊。
4. 選取「儲存設定」。

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

/opt/apigee/apigee-drupal/wwwroot

升級已完成。