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

將 Apigee Edge 4.17.0x 更新至 4.18.01

Private Cloud v4.18.01 專用 Edge

哪些 Edge 版本可以更新至 4.18.01

您可以使用這個程序更新 Apigee Edge 4.17.0x 版。

如果您使用的是舊版 Edge 4.16.01 版，就必須先遷移至以下版本： 4.16.01.x 版，然後更新至 4.18.01 版。

可執行更新的使用者

執行更新的使用者必須與當初安裝 Edge 的使用者相同，或也就是以根的身分執行的使用者

任何使用者都可設定邊緣 RPM 套件。

您需要更新哪些元件

您必須更新所有 Edge 元件。Edge 不支援含有元件的設定以便擷取來自多個版本的內容

維持相容性

將適用於私有雲的 Apigee Edge 升級至 4.18.01 版時，您必須確保產生的結果實作項目只會參照其設定檔中支援的屬性。

屬性	位置	說明
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	從 `router.properties` 檔案移除這個屬性。如何設定重試選項請在 4.18.01 中使用虛擬主機設定屬性。

屬性自動傳播設定

如果您在 /opt/apigee/customer/application 中編輯 .properties 檔案來設定任何屬性，則這些屬性值都會由更新保留。

必須新增 SMTP MailFROM 設定參數

在您啟用設定檔時使用的設定檔時，Edge 4.17.05 新增了必要參數具備 SMTP 伺服器連線如果是透過 4.17.01 更新，則必須在設定檔中設定 SMTPmailFROM 啟用時可能發生這種情況

API BaaS 4.17.09 版也開始支援 SMTP MailFROM 屬性。從 4.17.01 或 4.17.05 更新 API BaaS 時，您必須在設定檔

這個參數的格式如下：

SMTPMAILFROM="My Company <myco@company.com>"

必須升級至 Postgres 9.6

這個版本的 Edge 包含 Postgres 9.6 的升級版本。本次升級 Postgres 資料會遷移至 Postgres 9.6。

大多數 Edge 生產系統使用兩個為主待命複製設定的 Postgres 節點。在更新過程中，當 Postgres 節點停止進行更新時，Analytics 資料仍然存在寫入 Qpid 節點Postgres 節點更新並恢復上線後，Analytics 資料再推送至 Postgres 節點

Postgres 更新的方式取決於您為 Postgres 節點：

如果 Postgres 節點使用了本機資料儲存空間，您必須在升級期間安裝新的 Postgres 待命節點。在升級完成後，可以停用新的 Postgres 待命節點。

如果必須復原更新，就必須新增額外的 Postgres 待命節點。如果必須復原更新，新的 Postgres 待命節點成為復原後的主要 Postgres 節點。因此，當您安裝新的 Postgres 待命節點，應位於符合所有硬體的節點上要求 Postgres 伺服器的要求 (如 Edge 內所定義) 安裝需求。

在 1 節點和 2 節點安裝 Edge 中，您可以透過拓撲進行原型設計和測試，只會有一個 Postgres 節點您可以直接更新這些 Postgres 節點，不必來建立新的 Postgres 節點
如果 Postgres 節點使用了網路儲存空間：您不必安裝新的 Postgres 節點，這是 Apigee 的建議。在您可以按照下方程序，略過指定安裝後停用新安裝 Postgres 待命節點。

開始更新程序前，請擷取 Postgres。然後，如果在更新期間發生任何錯誤，您也被強制復原，可以從該快照還原 Postgres 節點。

安裝新 Postgres 待命節點

這項程序會在新的節點上建立 Postgres 待命伺服器。務必安裝新的現有 Edge (4.17.0x) 版本適用的 Postgres 待命伺服器，不適用於版本 4.18.01。

使用與安裝目前版本相同的設定檔執行安裝這些物件

如何建立新的 Postgres 待命節點：

在目前的 Postgres 主要執行個體中，編輯使用 /opt/apigee/customer/application/postgresql.properties 個檔案設定下列內容符記：
```
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust
```
其中 existing_slave_ip 是目前 Postgres 的 IP 位址待命伺服器，new_slave_ip 是新待命節點的 IP 位址。

如果 postgresql.properties 檔案不存在，請建立該檔案並使用使用 chown 來向 apigee 使用者授予存取權，如以下範例所示顯示：
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```

重新啟動 apigee-postgresql 上的 Postgres 主要執行個體：

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

透過查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf，確認已新增待命節點複製到主要執行個體該檔案中應會顯示下列幾行內容：
```
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
```
安裝新的 Postgres 待命伺服器：
1. 編輯您用於安裝最新 Edge 版本的設定檔，以指定包括：
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102 
```
2. 請按照安裝 Edge Apigee-setup 公用程式。
3. 下載 Edge bootstrap_4.17.0x.sh 檔案 (其中 4.17.0x 為 4.17.01、4.17.05、或 4.17.09) 至 /tmp/bootstrap_4.17.0x.sh ：
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. 安裝 Edge apigee-service 公用程式並依附元件：
```
sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
```
5. 使用 apigee-service 安裝 apigee-setup 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
6. 安裝 Postgres：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
7. 在新待命伺服器上執行下列指令：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  驗證裝置是否為待機。

停用 Postgres 節點

更新完成後，停用新的待命節點：

確認 Postgres 正在執行：
> /opt/apigee/apigee-service/bin/apigee-all status

如果 Postgres 未執行，請啟動：
> /opt/apigee/apigee-service/bin/apigee-all start
請在新的待命節點上執行以下 cURL 指令，取得新待命節點的 UUID 待命節點：
>curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

輸出內容結尾處會顯示節點的 UUID，格式如下：
「類型」: [ "postgres-server" ],
「uUID」："599e8ebf-5d69-4ae4-aa71-154970a8ec75"
對新的待命節點執行下列指令，以停止新的待命節點：
> /opt/apigee/apigee-service/bin/apigee-all stop
在 Postgres 主要節點上，編輯 /opt/apigee/customer/application/postgresql.properties 從 conf_pg_hba_replication.connection 中移除新的待命節點：
conf_pg_hba_replication.connection=host 複製作業 Apigee existing_slave_ip/32 信任
在 Postgres 主要執行個體上重新啟動 apigee-postgresql：
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf，驗證新的待命節點是否已移除。複製到主要執行個體該檔案中應該只會出現以下這行內容：
主機複製 Apigee existing_slave_ip/32 信任
建立下列 Edge 管理功能，以便從 ZooKeeper 刪除待命節點的 UUID Management Server 節點上的 API 呼叫：
>curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

更新必要條件

升級 Apigee Edge 前，請先瞭解下列事項：

備份所有節點
更新前，建議您對所有節點執行完整備份以確保安全理由。按照目前 Edge 版本的程序執行備份。

這樣一來，您就可以建立備份方案，以在未更新至新版本時派上用場功能。如要進一步瞭解備份，請參閱備份和還原。
確保 Edge 正在執行
使用下列指令，確保 Edge 在更新程序期間已啟動並執行：

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

處理失敗的更新

如果更新失敗，您可以嘗試修正問題，然後執行 update.sh 可以選取「重新建立」，再次生成新的提示您可以多次執行更新，系統會從上次中斷的地方繼續更新關閉。

如果作業失敗，您必須將更新復原為先前版本，請參閱 4.18.01 復原程序以取得更多資訊。

記錄更新資訊

根據預設，update.sh 公用程式會將記錄資訊寫入：

/opt/apigee/var/log/apigee-setup/update.log

如果執行 update.sh 公用程式的使用者無法存取並將記錄寫入 /tmp 目錄，名稱為 update_username.log。

如果使用者無法存取 /tmp，update.sh 公用程式就會失敗。

零停機時間更新

零停機時間更新或滾動式更新可讓您在沒有停機時間的情況下更新 Edge 安裝作業進而關閉 Edge

零停機時間更新只能透過 5 個節點設定完成。

升級到零停機時間的關鍵，在於從負載中逐一移除每個路由器，一次一個。接著在路由器上更新路由器和任何其他元件，這些元件與路由器相同。然後將路由器加回負載平衡器

請依照下方「訂單」一節的說明，按照正確的安裝順序更新機器機器更新」
需要更新路由器時，請選取任一路由器並設為無法連線，如下所示：如啟用/停用伺服器中所述 (訊息處理器/路由器) 可連性。
在與路由器相同的機器上，更新所選路由器和所有其他 Edge 元件。所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
重新連線至路由器。
針對其餘的路由器，重複步驟 2 到 4。
請繼續為安裝中其餘的機器進行更新。

更新前後請謹慎處理下列事項：

在合併的路由器和訊息處理器節點上：
- 更新前 - 執行下列動作：
  1. 將路由器設為無法連線。
  2. 將無法連線至訊息處理器設為連線。
- 更新後，請執行下列步驟：
  1. 請連線至訊息處理器。
  2. 將路由器設為可連線。
在單一路由器節點上：
- 更新前，請先將無法連線至路由器設為無法使用。
- 更新後，請將路由器設為可連線。
在單一訊息處理器節點上：
- 更新前，請先設為無法連線至訊息處理器。
- 更新後，請連線至「訊息處理器」，

使用靜音設定檔

您必須將靜音設定檔傳送至 update 指令。靜音設定檔必須與您安裝 Edge 4.17.0x 時使用的相同。

程序時間：在有外部網際網路連線的節點上更新至 4.18.01

請使用下列程序更新節點上的 Edge 元件：

如果您目前使用含本機儲存空間的 Postgres 主待命複製功能，按照上方「安裝新的 Postgres」一節所述的方式，安裝新的 Postgres 待命節點待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
如果有 CRON 工作顯示，則請停用在 Cassandra 上執行修復作業的所有 CRON 工作直到更新完成為止
以根權限登入節點，安裝邊緣 RPM。
注意：雖然 RPM 安裝作業需要 Root 存取權，但你可以執行 Edge 沒有根目錄存取權的話
安裝 yum-utils 並 yum-plugin-priorities:
>sudo yum install yum-utils
>sudo yum install yum-plugin-priorities
按照安裝使用 Edge Apigee-setup 公用程式。
如果是在 Oracle 7.x 上安裝，請執行下列指令：
>sudo yum-config-manager --enable ol7_optional_latest
如果您是在 AWS 上安裝，請執行以下 yum-configure-manager 指令：
>Yum 更新 rh-amazon-rhui-client.noarch
>sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
下載 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
安裝 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。如果不是，便會自動安裝使用 JAVA_FIX 選項指定處理方式 Java 安裝。JAVA_FIX 採用下列值：

I = 安裝 OpenJDK 1.8 (預設)
C = 在不安裝 Java 的情況下繼續操作
問：退出，如果採用這個選項，您必須自行安裝 Java。
使用 apigee-service 可以更新 apigee-setup 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
更新 apigee-validate 管理伺服器的公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
更新 apigee-provision 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
依照以下「機器順序」一節的說明，在節點上執行更新公用程式更新」如下：
> /opt/apigee/apigee-setup/bin/update.sh -c 元件 -f configFile

設定檔的唯一規定是設定檔必須可供存取可由「apigee」讀取內容。

使用「-c」選項指定要更新的元件。系統會列出元件包括：
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 元件除了 Edge UI：管理伺服器、訊息處理器、路由器、QPID Server、Postgres 伺服器
ui = Edge UI
all = 更新機器 (僅適用於 Edge aio 安裝設定檔或 API BaaS 作為安裝之用個人資料)
e = ElasticSearch
b = API BaaS 堆疊
p = API BaaS 入口網站
ebp = ElasticSearch、API BaaS 在同一節點上建立堆疊和 API BaaS 入口網站
在 Management 上執行 apigee-validate 公用程式，以測試更新。伺服器，如「測試安裝」一節中所述。
如果您已安裝新的 Postgres 待命節點，請按照上述說明停用該節點請參閱停用 Postgres 節點。

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

如要稍後復原更新，請使用 4.18.01 復原程序所述的程序。

從本機更新至 4.18.01 的程序存放區

如果您的 Edge 節點在防火牆後面，或以其他方式遭禁止存取透過網際網路取得 Apigee 存放區，接著您可以從本機存放區執行更新或鏡像功能

建立本機 Edge 存放區後，您可以透過兩種方式更新 Edge 本機存放區：

建立存放區的 .tar 檔案，將 .tar 檔案複製到節點，然後從 .tar 檔案。
在含有本機存放區的節點中安裝網路伺服器，以便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用，您也可以使用自己的網路伺服器

如何從本機 4.18.01 存放區更新：

如果您目前使用的是 Postgres 主待命複製功能，請安裝新的 Postgres 待命節點，如上方「安裝新 Postgres」一節所述待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
按照「建立本機 Apigee 存放區」中的說明建立本機 4.18.01 存放區請參閱安裝 Edge apigee-setup 公用程式。
注意：如果已有 4.17.0x 存放區，則可將將 4.18.01 存放區連結到該存放區，如「更新本機 Apigee 存放區」中所述請參閱安裝 Edge apigee-setup 公用程式。
如要從 .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 套件
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
  
  請注意，您會在這個指令中加入存放區目錄的路徑。
使用 Nginx 網路伺服器安裝 apigee-service：
1. 按照「使用 Nginx 從存放區安裝」一節的說明，設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式。
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 是存放區節點
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
更新 apigee-validate 公用程式。
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
更新 apigee-provision 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
依照以下「機器順序」一節的說明，在節點上執行更新公用程式更新」如下：
> /opt/apigee/apigee-setup/bin/update.sh -c 元件 -f configFile

設定檔的唯一規定是設定檔必須可供存取可由「apigee」讀取內容。

使用「-c」選項指定要更新的元件。系統會列出元件包括：
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 元件除了 Edge UI：管理伺服器、訊息處理器、路由器、QPID Server、Postgres 伺服器
ui = Edge UI
all = 更新機器 (僅適用於 Edge aio 安裝設定檔或 API BaaS 作為安裝之用個人資料)
e = ElasticSearch
b = API BaaS 堆疊
p = API BaaS 入口網站
ebp = ElasticSearch、API BaaS 在同一節點上建立堆疊和 API BaaS 入口網站
在 Management 上執行 apigee-validate 公用程式，以測試更新。伺服器，如「測試安裝」一節中所述。
如果您已安裝新的 Postgres 待命節點，請按照下文說明停用該節點以上停用一個 Postgres 節點

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

如要稍後復原更新，請使用 4.18.01 復原程序所述的程序。

機器更新順序

您在 Edge 安裝程序中更新機器的順序相當重要。最常出現更新時的重要注意事項如下：

您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新任何節點和其他節點
適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器路由器、QPID 伺服器，而非 Postgres 伺服器)，使用「-c 邊緣」或是更新
如果步驟指定應在多部機器上執行，請在該步驟中執行指定的機器順序
更新營利設定無須另外執行一個步驟。這個清單會在您指定「-c」時更新邊緣」如果有需要 SQL 指令的分析工作負載則 BigQuery 可能是最佳選擇

單獨使用安裝

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新 Qpid：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
停止 Postgres Server、Qpid 伺服器和 PostgreSQL：
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
更新 postgresql：
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
更新 Postgres 資料庫：
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
更新其餘 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新 Edge UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

獨立 2 主機安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
在機器 1 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新機器 2 的 Qpid：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新裝置 1 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
在機器 2 上更新 postgresql：
1. 停止 Postgres Server、Qpid 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
2. 更新 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. 更新 Postgres 資料庫：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. 更新裝置 2 上的邊緣元件：
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

針對 5 個主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新機器 4 和 5 的 Qpid：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新機器 1、2、3 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
??更新機器 4 和 5：
1. 在機器 4 上停止 Postgres 伺服器和 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
2. 在電腦 5 上停止 Postgres 伺服器、Qpid 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
4. 更新機器 4 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. 更新機器 4 中的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. 更新機器 5 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. 在機器 4 和 5 上啟動 Postgres 伺服器和 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
8. 在電腦上執行下列指令，將 Postgres 設為待命節點 5：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
9. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  
  在機器 4 (主要節點) 中，執行：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  在機器 5 中，待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 4，5：
上的邊緣元件 > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

針對 9 主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新機器 6 和 7 上的 Qpid：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
請按照下列步驟更新機器 6、7、1、4 和 5 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
更新機器 8 和 9：
1. 在機器 8 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 9 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 6 和 7 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 8 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 9 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 8 和 9 上啟動 Postgres 伺服器伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 6 和 7 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 9：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  在機器 8 中，執行主要節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  機器 9 上的待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 8 和 9 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

13 主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新機器 12 和 13 上的 Qpid：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在電腦 4 和 5 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
請依照下列順序更新機器 12、13、6、7、10 和 11 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新機器 6 和 7 上的 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
更新機器 8 和 9：
1. 在機器 8 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 9 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 12 與 13 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 8 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 9 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 8 和 9 上啟動 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 12 和 13 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 9：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  在機器 8 中，執行主要節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  機器 9 上的待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 8 和 9 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

針對 12 個主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

如果是從 4.17.01 更新，請在設定檔中設定 SMTPmailFROM：您已經啟用 Edge 上的 SMTP。這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點

如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。
更新 Cassandra 和 ZooKeeper：
1. 在資料中心 1 的機器 1、2 和 3 中：
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. 位於資料中心 2 中的機器 7、8 和 9
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新 qpidd：
1. 資料中心 1 中的機器 4、5 部
  1. 更新 qpidd 的平台機器 4：
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. 使用機器 5 重複步驟 1。
2. 資料中心 2 中的機器 10、11
  1. 更新 qpidd 的平台機器 10：
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. 請在機器 11 上重複執行步驟 1。
更新 LDAP：
1. 資料中心 1
  中的機器 1 > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
2. 資料中心 2
  中的機器 7 > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新 Edge 元件：
1. 資料中心 1
  中的機器 4、5、1、2、3 > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
2. 資料中心 2 中的機器 10、11、7、8、9
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新 UI：
1. 資料中心 1 中的機器 1：
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2. 資料中心 2 中的機器 7：
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
?更新資料中心 1 和 12 的機器 6：
1. 在機器 6 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 12 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 4、5、10 和 11 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 6 上的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 6 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 12 上的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 6 和 12 上啟動 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 4、5、10 和 11 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 12：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  在機器 6 (主要節點) 上執行：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  在機器 12 中，待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新裝置 6 和 12 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

7 主機 API BaaS 安裝

在設定檔這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
在機器 5、6 和 7 上更新 Cassandra：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
在機器 1、2 和 3 上更新 ElasticSearch 和 API BaaS 堆疊：
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
在機器 4 上更新 API BaaS 入口網站：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

10 主機 API BaaS 安裝

在設定檔這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
在機器 8、9 與 10 上更新 Cassandra：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
在機器 1、2 和 3 上更新 ElasticSearch：
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
在機器 4、5 和 6 上更新 API BaaS 堆疊：
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
在機器 7 上更新 API BaaS 入口網站：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

一個資料中心的 API 基礎安裝

此程序需要更新兩個資料中心中的 Cassandra 節點。如果您是然後更新這些節點正在更新 Edge。

在設定檔這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
使用正確的複製係數更新兩個資料中心的 Cassandra 索引鍵空間。個人中心這個步驟只需要在任一資料中心的任何 Cassandra 伺服器上執行一次：

注意：下列所有指令都會將複製係數設為「3」，表示叢集內的三個 Cassandra 節點進行安裝時，請視需要修改這個值。
1. 啟動 Cassandra cqlsh 公用程式：
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. 在「cqlsh>」執行下列 CQL 指令設定複製作業的提示 Cassandra 索引鍵空間的層級：
  1. cqlsh>替代 KEYSPACE「Apigee_Baas_dc_1」WITH 複製 = { 'class': 'NetworkTopologyStrategy', 「dc-1」：'3','dc-2': '3'};
  2. cqlsh>替代 KEYSPACE「Apigee_Baas」WITH 複製 = { 'class': 'NetworkTopologyStrategy', 'dc-1': 「3','dc-2」：'3'};
  3. cqlsh>替代 KEYSPACE「Apigee_Baas_Locks」WITH 複製 = { 'class': 'NetworkTopologyStrategy', 「dc-1」：'3','dc-2': '3'};
  4. cqlsh>替代命名空間「system_traces」WITH 複製 = { 'class': 'NetworkTopologyStrategy', 'dc-1': 「3','dc-2」：'3'};
  5. cqlsh>替代 KEYSPACE「Apigee_Baas_dc_2」WITH 複製 = { 'class': 'NetworkTopologyStrategy', 「dc-1」：'3','dc-2': '3'};
  6. 使用下列指令查看索引鍵空間：
    cqlsh>從中選取 * system.schema_keyspaces;
  7. 離開 cqlsh：
    cqlsh>結束
(僅適用於未在更新時更新 Cassandra 的情況 Edge) 更新資料中心 1 中的 Cassandra 節點，一次只更新一部機器：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
(僅適用於未在更新時更新 Cassandra 的情況 Edge) 更新資料中心 2 中的 Cassandra 節點，一次一個機器：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
針對資料中心 1 中的機器逐一更新 ElasticSearch：
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
針對資料中心 2 中的機器逐一更新 ElasticSearch：
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
在資料中心 1 的機器中更新 API BaaS 堆疊，一次只能更新一部機器：
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
在資料中心 2 的機器中更新 API BaaS 堆疊，一次只能更新一部機器：
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
在資料中心 1 的機器中更新 API BaaS 入口網站，一次只能更新一部機器：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
在資料中心 2 的機器中更新 API BaaS 入口網站，一次只能更新一部機器：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
更新 BaaS 鍵空間值。安裝時必須設定這些索引鍵空間以供複製，但不一定要在執行期間移除複製作業也會節省 Cassandra 記憶體。

在任一資料中心的任何 Cassandra 伺服器上，只需執行這個步驟一次：
1. 啟動 Cassandra cqlsh 公用程式：
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. 執行下列 CQL 指令，設定 Cassandra 的複製層級索引鍵空間：
  1. cqlsh>替代命名空間 "Apigee_Baas_dc_1"WITH 複製 = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
  2. cqlsh>替代命名空間 "Apigee_Baas_dc_2"WITH 複製 = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
  3. 使用下列指令查看索引鍵空間：
    cqlsh>選取 * 來自 system.schema_keyspaces;
  4. 離開 cqlsh：
    cqlsh>結束

非標準安裝

如果您安裝的是非標準版本，請在下方更新 Edge 元件順序：

ZooKeeper
Cassandra
qpidd、ps
LDAP
邊緣，表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Postgres 伺服器、管理伺服器、訊息處理器和路由器。
注意：如果節點同時安裝 Qpid 伺服器和 Postgres 伺服器，請執行「-c 邊緣」設定檔步驟
Edge UI

將 Apigee Edge 4.17.01/4.17.05 更新至 4.17.09

將 Apigee Edge 4.17.0x 更新至 4.18.01

哪些 Edge 版本可以更新至 4.18.01

可執行更新的使用者

您需要更新哪些元件

維持相容性

屬性自動傳播 設定

必須新增 SMTP MailFROM 設定參數

必須升級至 Postgres 9.6

安裝新 Postgres 待命節點

停用 Postgres 節點

更新必要條件

處理失敗的更新

記錄更新資訊

零停機時間更新

使用靜音設定檔

程序時間： 在有外部網際網路連線的節點上更新至 4.18.01

從本機更新至 4.18.01 的程序 存放區

機器更新順序

單獨使用 安裝

獨立 2 主機 安裝

針對 5 個主機叢集 安裝

針對 9 主機叢集 安裝

13 主機叢集 安裝

針對 12 個主機叢集 安裝

7 主機 API BaaS 安裝

10 主機 API BaaS 安裝

一個資料中心的 API 基礎 安裝

非標準安裝

屬性自動傳播設定

程序時間：在有外部網際網路連線的節點上更新至 4.18.01

從本機更新至 4.18.01 的程序存放區

單獨使用安裝

獨立 2 主機安裝

針對 5 個主機叢集安裝

針對 9 主機叢集安裝

13 主機叢集安裝

針對 12 個主機叢集安裝

一個資料中心的 API 基礎安裝