安裝條件

Private Cloud v. 4.16.05 專用 Edge

硬體需求

您必須符合下列硬體最低需求，才能在實際工作環境中建構高可用度的基礎架構。針對「安裝拓撲」所述的所有安裝情境，下表列出安裝元件的最低硬體需求。

在這些表格中，除了作業系統所需的硬碟空間外，還滿足硬碟需求。視應用程式和網路流量而定，安裝作業可能需要比下列資源多或少的資源。

此外，下列是您想安裝營利服務的硬體需求：

如要安裝 API BaaS，請參考下列硬體需求：

注意：

• 如果根檔案系統的空間不足以安裝，建議將資料放置在較大的磁碟上。
• 如果機器上安裝的是舊版 Apigee Edge for Private Cloud，請務必先刪除 /tmp/java 資料夾，再重新安裝。
• 系統層級的暫存資料夾 /tmp 需要執行權限，才能啟動 Cassandra。
• 如果在安裝前已建立使用者「apigee」，請確認「/home/apigee」是主目錄，且由「apigee:apigee」擁有。

作業系統和第三方軟體需求

這些安裝說明和提供的安裝檔案已在以下列出的作業系統和第三方軟體上進行測試：https://apigee.com/docs/api-services/reference/supported-software。

建立 Apigee 使用者

安裝程序會建立名為「apigee」的 Unix 系統使用者。Edge 目錄和檔案由「apigee」擁有，Edge 程序也是如此。這表示 Edge 元件會以「 Apigee」使用者身分執行。如有需要，您可以用不同使用者的身分執行元件。如需範例，請參閱「在節點上安裝 Edge 元件」中的「將 Router 繫結至受保護的連接埠」。

安裝目錄

根據預設，安裝程式會將所有檔案寫入 /opt/apigee 目錄。您無法變更這個目錄位置。

在本指南的操作說明中，安裝目錄會顯示為 /<inst_root>/apigee，其中 /<inst_root> 預設為 /opt。

Java

您必須先在每部機器上安裝支援的 Java 1.8 版本，才能進行安裝作業。支援的 JDK 在這裡列出：

https://apigee.com/docs/api-services/reference/supported-software

確認 JAVA_HOME 指向使用者執行安裝作業的 JDK 根。

網路設定

建議在安裝前檢查網路設定。安裝程式預期所有機器都具有固定 IP 位址。請使用下列指令驗證設定：

• hostname 會傳回機器的名稱
• hostname -i 會傳回主機名稱的 IP 位址，該主機名稱可從其他機器尋址。

視作業系統類型和版本而定，如果主機名稱設定不正確，您可能需要編輯 /etc/hosts 和 /etc/sysconfig/network。如需詳細資訊，請參閱特定作業系統的說明文件。

Cassandra

所有 Cassandra 節點都必須連線至圓環。

Cassandra 會根據可用記憶體自動調整 Java 堆積大小。詳情請參閱「調整 Java 資源」。在效能降低或記憶體用量高的情況下。

安裝 Private Cloud 適用的 Edge 後，您可以透過檢查 /&lt;inst_root&gt;/apigee/apigee-cassandra/conf/cassandra.yaml 檔案，檢查 Cassandra 設定是否正確。舉例來說，請確認 Edge for Private Cloud 安裝指令碼已設定下列屬性：

• cluster_name
• initial_token
• 分割器
• 種子
• listen_address
• rpc_address
• 斯納特

警告：請勿編輯這個檔案。

PostgreSQL 資料庫

安裝 Edge 後，您可以根據系統可用的 RAM 量調整下列 PostgreSQL 資料庫設定：

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

如要設定這些值，請按照下列步驟操作：

1. 編輯 postgresql.properties：
   > vi /<inst_root>/apigee/customer/application/postgresql.properties
   
   如果檔案不存在，請建立檔案。
2. 設定上述屬性。
3. 儲存編輯內容。
4. 重新啟動 PostgreSQL 資料庫：
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

jsvc

「jsvc」是使用 API BaaS 的必要條件。安裝 API BaaS 時，系統會安裝 1.0.15-dev 版。

網路安全服務 (NSS)

網路安全性服務 (NSS) 是一組程式庫，可支援開發已啟用安全性功能的用戶端與伺服器應用程式。請確認您已安裝 NSS 3.19 以上版本。

如何查看目前版本：

> yum info nss

如何更新 NSS：

> yum update nss

詳情請參閱 RedHat 的這篇文章。

AWS AMI

如果您要在 Red Hat Enterprise Linux 7.x 的 AWS Amazon Machine Image (AMI) 上安裝 Edge，請先執行下列指令：

> yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

工具

安裝程式會使用 EL5 或 EL6 提供的標準版本中，下列 UNIX 工具。

注意：

• 工具「useradd」的可執行檔位於 /usr/sbin，chkconfig 則位於 /sbin。
• 透過 sudo 存取權，您可以取得呼叫使用者環境的存取權，例如，您通常會呼叫「sudo <command>」或「sudo PATH=$PATH:/usr/sbin:/sbin <command>」。
• 請務必先安裝「修補程式」工具，再安裝服務包 (修補程式)。

ntpdate – 建議將伺服器時間保持同步。如果尚未設定，則可使用「ntpdate」公用程式，確認伺服器是否已同步時間。您可以使用「yum install ntp」安裝公用程式。這項功能特別適合用於複製 OpenLDAP 設定。請注意，您必須以世界標準時間設定伺服器時區。

openldap 2.4 – 在內部安裝時，必須使用 OpenLDAP 2.4。如果您的伺服器有網際網路連線，Edge 安裝指令碼就會下載並安裝 OpenLDAP。如果您的伺服器沒有網路連線，請務必先確認已安裝 OpenLDAP，再執行 Edge 安裝指令碼。在 RHEL/CentOS 上，您可以執行「yum install openldap-clients openldap-servers」並安裝 OpenLDAP。

對於 13 個主機的裝置，以及 12 個主機的裝置 (含兩個資料中心)，您需要 OpenLDAP 複製功能，因為有許多節點會代管 OpenLDAP。

防火牆和虛擬主機

「虛擬」一詞在 IT 領域中通常會被過度使用，這點在 Apigee Edge for Private Cloud 部署和虛擬主機的情況下也是如此。為避免混淆，「虛擬」一詞有兩種主要用途：

• 虛擬機器 (VM)：非必要，但有些部署會使用 VM 技術為 Apigee 元件建立獨立伺服器。虛擬機器人主機 (VM 主機) 和實體主機一樣，可以有網路介面和防火牆。這些安裝說明不支援 VM 安裝作業。
• 虛擬主機：網路端點，類似於 Apache 虛擬主機。

VM 中的路由器可公開多個虛擬主機，前提是主機別名或介面通訊埠中的虛擬主機彼此不同。

舉例來說，單一實體伺服器「A」可能會執行兩個 VM，分別命名為「VM1」和「VM2」。假設 VM1 公開虛擬乙太網路介面，在 VM 內部命名為 eth0，並由虛擬化機制或網路 DHCP 伺服器指派 IP 位址 111.111.111.111；接著假設 VM2 公開虛擬乙太網路介面，也命名為 eth0，並指派 IP 位址 111.111.111.222。

我們可能會在兩個 VM 中各執行一個 Apigee 路由器。路由器會公開虛擬主機端點，如以下假設範例所示：

VM1 中的 Apigee 路由器會在其 eth0 介面 (具有特定 IP 位址) 上公開三個虛擬主機：api.mycompany.com:80、api.mycompany.com:443 和 test.mycompany.com:80。

VM2 中的路由器會公開 api.mycompany.com:80 (與 VM1 公開的名稱和連接埠相同)。

實體主機的作業系統可能設有網路防火牆；如果是的話，該防火牆必須設為針對在虛擬化介面 (111.111.111.111:{80, 443} 和 111.111.111.222:80) 中公開的通訊埠傳遞 TCP 流量。此外，每個 VM 的作業系統可能會在 eth0 介面上提供自己的防火牆，這些防火牆也必須允許通訊埠 80 和 443 的流量連線。

basepath 是第三個元件，用於將 API 呼叫轉送至您可能已部署的不同 API Proxy。如果 API Proxy 套件具有不同的 basepath，則可以共用端點。舉例來說，您可以將一個 basepath 定義為 http://api.mycompany.com:80/，另一個 basepath 定義為 http://api.mycompany.com:80/salesdemo。

在這種情況下，您需要負載平衡器或某種流量轉送器，才能在兩個 IP 位址 (VM1 上的 111.111.111.111 和 VM2 上的 111.111.111.222) 之間分割 http://api.mycompany.com:80/ 流量。這項功能適用於特定安裝作業，並由當地網路群組設定。

您在部署 API 時會設定 basepath。在上方的範例中，您可以透過 api.mycompany.com 主機別名並將通訊埠設為 80 的虛擬主機，為 mycompany-org 機構部署 mycompany 和 testmycompany 這兩個 API。如果您未在部署中宣告 basepath，則路由器就不知道要將傳入要求傳送至哪個 API。

不過，如果您部署的 API testmycompany 基本網址為 /salesdemo，使用者就能透過 http://api.mycompany.com:80/salesdemo 存取該 API。如果您以 / 做為基本網址部署 API mycompany，使用者就能透過網址 http://api.mycompany.com:80/ 存取 API。

邊緣通訊埠需求

除了虛擬主機之外，VM 和實體主機防火牆都必須允許元件用於彼此通訊的通訊埠流量。

下圖顯示每個邊緣元件的通訊埠需求：

這張圖表的注意事項：

• *只有在您設定路由器和訊息處理器之間的 TLS/SSL 時，訊息處理器上的通訊埠 8082 才需要開放路由器存取。如果您未在 Router 和 Message Processor 之間設定 TLS/SSL，則仍必須在 Message Processor 上開啟預設設定的通訊埠 8082 才能管理元件，但 Router 不需要存取該通訊埠。
• 前置為「M」的通訊埠是用於管理元件的通訊埠，必須在元件上開啟，才能供管理伺服器存取。
• 下列元件需要存取管理伺服器上的通訊埠 8080：路由器、訊息處理器、UI、Postgres 和 Qpid。
• 訊息處理器必須開啟 4528 通訊埠做為管理通訊埠。如果您有多個訊息處理器，則這些處理器必須能夠透過通訊埠 4528 相互存取 (上方圖表中，訊息處理器的通訊埠 4528 有循環箭頭表示)。如果您有多個資料中心，則所有資料中心的所有訊息處理器都必須能存取該連接埠。
• 雖然這不是必要步驟，但您可以開啟 Router 上的通訊埠 4527，讓任何 Message Processor 都能存取。否則，您可能會在 Message Processor 記錄檔中看到錯誤訊息。
• 路由器必須開啟通訊埠 4527 做為其管理通訊埠。如果您有多個路由器，則這些路由器都必須能夠透過通訊埠 4527 相互存取 (上方圖表中路由器上的通訊埠 4527 的迴圈箭頭表示)。
• Edge UI 需要存取 API Proxy 公開的 Router 端口，才能支援追蹤工具中的「Send」按鈕。
• 管理伺服器需要存取 Cassandra 節點上的 JMX 通訊埠。
• 您可以設定 JMX 連接埠的存取權，要求使用者輸入使用者名稱/密碼。詳情請參閱如何監控。
• 您可以選擇針對可使用不同通訊埠的特定連線設定 TLS/SSL 存取。詳情請參閱「TLS/SSL」。
• 如果要將兩個 Postgres 節點設定為使用主/待命式複寫，則必須在每個節點上開啟 22 通訊埠，以便使用 SSH 存取。您可以選擇在個別節點上開啟通訊埠，以便使用 SSH 存取。
• 您可以設定管理伺服器和 Edge UI，透過外部 SMTP 伺服器傳送電子郵件。如果您選擇這項做法，請務必確保管理伺服器和使用者介面可存取 SMTP 伺服器上的必要通訊埠。如果是非 TLS SMTP，通訊埠號碼通常為 25。對於支援 TLS 的 SMTP，通常為 465，但請向 SMTP 供應商確認。

下表列出 Edge 元件必須在防火牆中開啟的通訊埠：

> curl -v http://<routerIP>:15999/v1/servers/self/reachable

下表列出相同的連接埠，並以數字列出來源和目的地元件：

訊息處理程序會持續開啟專屬的 Cassandra 連線集區，並設為永不逾時。如果防火牆位於訊息處理器和 Cassandra 伺服器之間，防火牆可能會讓連線逾時。不過，訊息處理工具並未設計用於重新建立與 Cassandra 的連線。

為了避免這種情況，Apigee 建議 Cassandra 伺服器、訊息處理器和路由器位於同一個子網路中，以免防火牆參與部署這些元件。

如果路由器和訊息處理器之間有防火牆，且已設定閒置 TCP 逾時時間，建議您採取以下做法：

1. 在 Linux 作業系統的 sysctl 設定中，將 net.ipv4.tcp_keepalive_time = 1800 設為 1800，其中 1800 應低於防火牆閒置 TCP 逾時時間。這項設定應讓連線維持在已建立狀態，以免防火牆中斷連線。
2. 在所有 Message Processor 上，編輯 /<inst_root>/apigee/customer/application/message-processor.properties 以新增下列屬性。如果檔案不存在，請建立檔案。
   conf_system_casssandra.maxconnecttimeinmillis=-1
3. 重新啟動訊息處理器：
   > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
4. 在所有路由器上編輯 /&lt;inst_root&gt;/apigee/customer/application/router.properties，來新增下列屬性。如果檔案不存在，請建立檔案。
   conf_system_casssandra.maxconnecttimeinmillis=-1
5. 重新啟動路由器：
   > /opt/apigee/apigee-service/bin/apigee-service edge-router restart

如果您在兩個資料中心安裝 12 主機叢集組態，請確認兩個資料中心中的節點可透過下列通訊埠進行通訊：

API BaaS 通訊埠需求

如果您選擇安裝 API BaaS，請新增 API BaaS Stack 和 API BaaS Portal 元件。這些元件會使用下圖所示的連接埠：

這張圖表的注意事項：

• Cassandra 節點可以專用於 API BaaS，或是與 Edge 共用。
• API BaaS 的正式安裝作業會在 API BaaS Portal 節點和 API BaaS Stack 節點之間使用負載平衡器。設定 Portal 和進行 BaaS API 呼叫時，請指定負載平衡器的 IP 位址或 DNS 名稱，而非 Stack 節點。
• 您必須將所有 Baas Stack 節點設為透過外部 SMTP 伺服器傳送電子郵件。對於非 TLS SMTP，通訊埠號碼通常為 25。對於啟用 TLS 的 SMTP，通常為 465，但請向 SMTP 供應商確認。

下表列出各元件在防火牆中需要開啟的預設通訊埠：

授權

每個 Edge 安裝作業都需要您從 Apigee 取得的專屬授權檔案。安裝管理伺服器時，您需要提供授權檔案的路徑，例如 /tmp/license.txt。

安裝程式會將授權檔案複製到 /<inst_root>/apigee/customer/conf/license.txt。

如果授權檔案有效，管理伺服器會驗證到期日和允許的 Message Processor (MP) 數量。如果任何授權設定過期，您可以在以下位置找到記錄：/<inst_root>/apigee/var/log/edge-management-server/logs。在這種情況下，您可以與 Apigee 支援團隊聯絡，瞭解遷移作業的詳細資訊。