新增 ZooKeeper 節點

本文件說明如何在現有的 Edge for Private Cloud 安裝中新增三個 ZooKeeper 節點。

您可以在現有的 Edge 安裝中新增一或兩個 ZooKeeper 節點，但您必須 確認 ZooKeeper 選民節點數量一律為奇數 (如下所述)。

現有的 Edge 設定

正式系統支援的所有 Edge 拓樸都指定使用三個 ZooKeeper 節點。三個節點會指定為 ZK_HOSTS 設定檔中的 ZK_CLIENT_HOSTS 屬性，如下所示：

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
HOSTIP=$(hostname -i)
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"
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
SMTPPASSWORD=smtppwd

在此情況下：

  • ZK_HOSTS 指定 ZooKeeper 節點的 IP 位址或 DNS 名稱。IP 位址或 DNS 名稱 必須按照所有 ZooKeeper 節點的順序排列。在多資料中心環境中 列出兩個資料中心的所有 ZooKeeper 節點。
  • ZK_CLIENT_HOSTS 會指定此資料中心所使用的 ZooKeeper 節點的 IP 位址或 DNS 名稱。IP 位址 或 DNS 名稱必須在所有 ZooKeeper 節點上按照相同順序排列。

    在單一資料中心安裝作業中，這些節點與 ZK_HOSTS 指定的節點相同。在多資料中心環境中，請只列出這一份 ZooKeeper 節點 這些功能以虛擬方式整合為 類似實體資料中心的資源

修改設定檔以新增三個新的 ZooKeeper 節點

在這個範例中，三個新 ZooKeeper 節點位於以下 IP 位址：

  • 10.10.0.14
  • 10.10.0.15
  • 10.10.0.16

您必須先更新 Edge 設定檔，才能新增新節點：

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
# Add the new node IP addresses.
IP14=10.10.0.14
IP15=10.10.0.15
IP16=10.10.0.16
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
...
# Update ZK_HOSTS to add each new node after an existing nodes.
ZK_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16:observer"
# Update ZK_Client_HOSTS to add each new node after an existing nodes.
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16"

使用 :observer 修飾符標示 ZK_HOSTS 中的最後一個節點。沒有 :observer 修飾符的節點稱為「投票者」。設定中必須有奇數個「投票者」。因此，在這個例子中 您有 5 位 ZooKeeper 選民和一位觀察者。

請務必按照相同順序，將節點新增至 ZK_HOSTS 和 ZK_CLIENT_HOSTS。不過，請省略 :observer 修飾符 設定 ZK_CLIENT_HOSTS 時。

設定 Edge

編輯設定檔之後，您必須執行以下所有工作。

在新節點上安裝 ZooKeeper

  1. 按照「安裝 Edge apigee-setup 公用程式」一節所述，在第一個節點上安裝 apigee-setup。
  2. 使用下列指令，在第一個節點上安裝 ZooKeeper： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile
  3. 針對其他新的 ZooKeeper 節點重複步驟 1 和 2。

重新設定現有的 ZooKeeper 節點

在現有的 ZooKeeper 節點上：

  1. 使用新的設定檔重新執行設定指令： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile

重新啟動所有 Zookeeper 節點

在所有 ZooKeeper 節點上：

  1. 重新啟動節點： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

    您必須重新啟動所有 ZooKeeper 節點，但重新啟動的順序沒有影響。

重新設定管理伺服器節點

在管理伺服器節點上：

  1. 執行設定指令： 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server setup -f updatedConfigFile
  2. 重新啟動管理伺服器： 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

重新設定所有路由器

在所有路由器節點上：

  1. 執行設定指令： 
    /opt/apigee/apigee-service/bin/apigee-service edge-router setup -f updatedConfigFile
  2. 重新啟動路由器： 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

重新設定所有訊息處理器

在所有訊息處理工具節點上：

  1. 執行設定指令：
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor setup -f updatedConfigFile
  2. 重新啟動訊息處理器： 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

重新設定所有 Qpid 節點

在所有 Qpid 節點上：

  1. 執行設定指令：
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server setup -f updatedConfigFile
  2. 重新啟動 Qpid：
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

重新設定所有 Postgres 節點

在所有 Postgres 節點上：

  1. 執行設定指令：
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server setup -f updatedConfigFile
  2. 重新啟動 Postgres：
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

驗證安裝

您可以傳送指令到通訊埠 2181，驗證新 ZooKeeper 節點的安裝作業。 透過 netcat (nc) 或 telnet如要進一步瞭解 ZooKeeper 指令，請參閱：https://zookeeper.apache.org/doc/r3.8.3/zookeeperAdmin.html#sc_zkCommands。

驗證方法如下：

  1. 如未安裝在 ZooKeeper 節點上，請安裝 nc: 
    sudo yum install nc
  2. 執行下列 nc 指令： 
    echo stat | nc localhost 2181
  3. 在每個 ZooKeeper 節點上重複步驟 1 和 2。在以下項目輸出內容的 Mode 行中： 一個節點應指定為觀察者、一個節點做為主要節點，其餘節點則 位追蹤者。