在節點上安裝 Edge 元件

Private Cloud v. 4.17.09 版本

在節點上安裝 Edge apigee-setup 公用程式後,請使用 使用 apigee-setup 公用程式安裝 節點上的一或多個 Edge 元件

Apigee-setup 公用程式會使用下列格式的指令:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

其中 component 是要安裝的 Edge 元件,且 configFile 是包含安裝內容的靜音設定檔 可能不準確或不適當設定檔必須可由「apigee」存取或讀取內容。適用對象 例如,您可以為檔案建立新的目錄,將檔案放在 /usr/local,或是 /usr/local/share 目錄,或是「 Apigee」節點存取的節點上任何其他位置 內容。

例如,如要安裝 Edge Management Server:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

安裝注意事項

編寫設定檔時,請考量下列選項。

設定 Postgres 主要執行個體待命複製

根據預設,Edge 會在主模式中安裝所有 Postgres 節點。但在實際工作環境系統中 與多個 Postgres 節點共用時,您必須將這些節點設為使用主要執行個體待命複製功能, 如果主要節點故障,待命節點仍可繼續處理流量。

您可以在安裝時,使用 無訊息設定檔或者,您也可以在安裝後啟用主待命複製功能。適用對象 詳情請參閱設定主待命 Postgres 的複製功能

啟用 Cassandra 驗證

根據預設,Cassandra 會在不啟用驗證功能的情況下安裝。這意味著每個人都能存取 Cassandra您可以在安裝 Edge 後啟用驗證功能,或是在安裝過程中啟用驗證功能 上傳資料集之後,您可以運用 AutoML 自動完成部分資料準備工作

詳情請參閱「啟用 Cassandra 驗證

使用受保護的 通訊埠和通訊埠

要建立將路由器繫結至受保護通訊埠 (例如通訊埠) 的虛擬主機 小於 1000 的數字,那麼您必須設定路由器,使其成為具有存取權限的用戶 這些通訊埠根據預設,路由器會以使用者「 Apigee」的身分執行所以無法存取 特殊權限通訊埠

如要瞭解如何將虛擬主機和路由器限制為存取 1000 以下的通訊埠, 請參閱設定虛擬主機

指定要安裝的元件

下表列出您傳送到 apigee-service 公用程式 -p 選項的選項 指定要在節點上安裝哪些元件:

元件

說明

僅安裝 Cassandra。

Zk 只能安裝 ZooKeeper。

數據資料學家

安裝 ZooKeeper 和 Cassandra。

ld

只安裝 OpenLDAP。

毫秒

安裝 Edge Management Server,一併安裝 Edge UI 和 OpenLDAP。

如果您在設定中設定了 USE_LDAP_REMOTE_HOST=y 檔案,系統就會略過 OpenLDAP 安裝作業,而管理伺服器會使用 OpenLDAP 安裝在不同節點上

R 鍵

只能安裝 Edge Router。

公尺

僅安裝邊緣訊息處理器。

rmp

安裝 Edge Router 和訊息處理器。

ui

安裝 Edge UI。

qs

只能安裝 Qpid 伺服器。

ps

只安裝 Postgres Server。

pdb 僅安裝 Postgres 資料庫 - 僅在安裝開發人員服務時使用 入口網站。請參閱開發人員服務入口網站 安裝

薩克斯風

安裝數據分析元件,也就是 Qpid 和 Postgres。

這個選項僅供開發和測試使用,不適用於正式環境。

sso 安裝 Edge SSO 模組。

安裝營利服務。

sa

獨立安裝 Edge,亦即 Cassandra、ZooKeeper、管理伺服器、OpenLDAP Edge UI、路由器和訊息處理器。這個選項會省略 Edge Analytics 元件: Qpid 和 Postgres。

這個選項僅供開發和測試使用,不適用於正式環境。

Aio

在單一節點上安裝所有元件。

這個選項僅供開發和測試使用,不適用於正式環境。

dp

安裝開發人員服務入口網站。

建立設定檔

該設定檔包含安裝 Edge 所需的所有資訊。您通常可以 使用相同的設定檔來安裝 Edge 安裝中的所有元件。

不過,您必須使用不同的設定檔或修改設定。 檔案。

  • 您正在安裝多個 OpenLDAP 伺服器,且必須設定複製作業 13 個節點安裝。每個檔案的 LDAP_SIDLDAP_PEER 值不盡相同。
  • 在 12 個節點的安裝過程中,您會建立多個資料中心。每個資料中心 並為 ZK_CLIENT_HOSTSCASS_HOSTS 等資源使用不同的設定。

以下所述的每個安裝拓撲都會顯示該拓撲的範例設定檔。適用對象 如需設定檔的完整參考資料,請參閱邊緣設定檔參考資料

安裝記錄檔

根據預設,setup.sh 公用程式會將安裝記錄資訊寫入以下位置:

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

如果執行 setup.sh 公用程式的使用者 可以存取該目錄,並將記錄以檔案形式寫入 /tmp 目錄 名稱為 setup_username.log

如果使用者無法存取 /tmp,setup.sh 公用程式 失敗。

安裝 Edge 元件

本節說明如何為不同拓撲安裝 Edge 元件。訂單 依據所需的拓撲建立元件安裝元件

下列顯示的安裝範例均假設您要安裝:

  • 停用 Cassandra 驗證 (預設)。詳情請參閱「啟用 Cassandra 驗證」。
  • 停用 Postgres 主要執行個體待命複製功能時 (預設)。請參閱設定主待命複製功能: Postgres
  • 同一節點上的訊息處理器和路由器。如果安裝「訊息處理器」 不同節點上的路由器,請先安裝所有訊息處理器,然後再安裝 路由器
,瞭解如何調查及移除這項存取權。

全方位安裝

  1. 使用下列指令安裝單一節點上的所有元件:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. 按照「測試 安裝
  3. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。如需完整的參考資源 設定檔,請參閱 Edge 設定檔參考資料

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

雙主機獨立安裝

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

  1. 安裝獨立閘道和節點 1
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. 在節點 2 上安裝 Analytics:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. 按照「測試 安裝
  4. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。如需完整的參考資源 設定檔,請參閱 Edge 設定檔參考資料

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

5 主機叢集安裝

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

  1. 在節點 1、2 和 3 上安裝 Datastore 叢集:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在節點 1 上安裝管理伺服器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在節點 2 和 3 中安裝路由器和訊息處理器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 在節點 4 和 5 上安裝 Analytics:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. 按照「測試 安裝
  6. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。如需完整的參考資源 設定檔,請參閱 Edge 設定檔參考資料

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

9 主機叢集安裝

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

  1. 在節點 1、2 和 3 上安裝 Datastore 叢集節點:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在節點 1 中安裝 Apigee Management Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在節點 4 和 5 中安裝路由器和訊息處理器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 在節點 6 和 7 中安裝 Apigee Analytics Qpid Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 在節點 8 和 9 中安裝 Apigee Analytics Postgres Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 按照「測試 安裝
  7. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。如需完整的參考資源 設定檔,請參閱 Edge 設定檔參考資料

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

13 主機叢集安裝

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

  1. 在節點 1、2 和 3 上安裝 Datastore 叢集節點:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在節點 4 和 5 上安裝 OpenLDAP:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. 在節點 6 和 7 中安裝 Apigee Management Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. 在節點 8 和 9 中安裝 Apigee Analytics Postgres Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. 在節點 10 和 11 上安裝路由器和訊息處理器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. 在節點 12 和 13 中安裝 Apigee Analytics Qpid Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. 按照「測試 安裝
  8. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。如需完整的參考資源 設定檔,請參閱 Edge 設定檔參考資料

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

12 主機叢集安裝

在 a12 託管的叢集拓撲 (兩個資料中心) 中安裝 Edge 之前,您必須瞭解 如何在靜音設定檔中設定 ZooKeeper 和 Cassandra 屬性。

  • ZooKeeper

    針對兩個資料中心的 ZK_HOSTS 屬性,請指定 來自兩個資料中心的 ZooKeeper 節點 (順序相同),並將所有節點標示為 「:observer」修飾符沒有「:observer」修飾符的節點會被呼叫 「voters」。你必須有奇數的「選民」配置狀態

    在這個拓撲中,主機 9 的 ZooKeeper 主機是觀察器:

    針對每個資料中心的 ZK_CLIENT_HOSTS 屬性,指定 IP 位址或 DNS 名稱 只有資料中心內的 ZooKeeper 節點 (順序相同) 用於 這些功能以虛擬方式整合為 類似實體資料中心的資源在下列設定檔範例中,節點 9 標有 「:observer」修飾符,可以有五位投票者:節點 1、2、3、7 和 8。
  • Cassandra
    所有資料中心的 Cassandra 節點數量都必須相同。

    對於每個資料中心的 CASS_HOSTS,請務必指定所有 Cassandra IP 位址 (而非 DNS 名稱)。如為資料中心 1,請列出該資料中的 Cassandra 節點 放在 AI 的世界裡針對資料中心 2,請先列出該資料中心的 Cassandra 節點。列出 Cassandra 節點的順序與資料中心中的所有 Cassandra 節點相同。

    所有 Cassandra 節點的後置字元都必須是「:<d>,<r>」,例如「<ip>:1,1 =」 資料中心 1 和機架/供應可用區 1 和 <ip>:2,1 = 資料中心 2 與 機架/供應區域 1
    例如:「192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1」。 192.168.124.205:2,1 192.168.124.206:2,1 吋

    每個資料中心的機架/可用性可用區 1 的第一個節點將用做種子 伺服器

    在這個部署模型中,Cassandra 設定看起來會像這樣:

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

  1. 在節點 1、2、3、7、8 和 9 上安裝 Datastore 叢集節點:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. 在節點 1 和 7 中安裝具備 OpenLDAP 複製功能的 Apigee Management Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 在節點 2、3、8 和 9 上安裝路由器和訊息處理器:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 在節點 4、5、10 和 11 中安裝 Apigee Analytics Qpid Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. 在節點 6 和 12 上安裝 Apigee Analytics Postgres Server:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. 按照「測試 安裝
  7. 按照加入 機構

以下顯示的是這個拓撲的靜音設定檔。請注意,這項設定 檔案。如需設定檔的完整參考資料,請參閱邊緣設定檔參考資料

  • 設定 OpenLDAP,以便在兩個 OpenLDAP 節點間複製資料。
  • 在一個 ZooKeeper 節點上指定「:observer」修飾符。在單一資料中 置中安裝,請省略該修飾詞。
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"