將 Apigee Edge 更新至 4.16.09

Private Cloud v. 4.16.09 版本

哪些 Edge 版本可以更新至 4.16.09

您可以將 Apigee Edge 4.16.01.0x 版和 4.16.05.x 版更新至 4.16.09 版。

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

可執行更新的使用者

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

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

需要升級至 Java JDK 8 版

您需要為所有 Edge 安裝 Java JDK 8 版,才能使用這個版本的 Edge 來處理節點您可以安裝 Oracle JDK 8 或 OpenJDK 8。如果未安裝 Java JDK 8 ,更新指令碼即可為您安裝。

更新至 Java 8 後,Oracle JDK 8 中不再提供某些 TLS 加密。適用對象 完整清單,請參閱「預設停用加密套件」部分前往 http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html

如果從以下位置進行更新,則將 Zookeeper 降級: 4.16.01

Edge 私人 Cloud 4.16.01 中的 Zookeeper RPM 版本是 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm。 在後續版本的 Edge 中,Zookeeper 版本已改回 apigee-zookeeper-3.4.5-0.0.94x。 這可以避免 yum 將 4.16.01 升級至較新版本。穿越馬利亞的路 這種情況是在執行 yum 降級時 再更新 Zookeeper。

您可以使用下列指令查看 Zookeeper 版本:

> rpm -qa |grep apigee-zookeeper

如果這個指令傳回 Zookeeper 版本:

apigee-zookeeper-3.4.5-1.0.905

就必須執行降級。

屬性自動傳播 設定

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

更新必要條件

升級 Apigee Edge 前,請先瞭解下列事項:

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

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

    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-all 狀態

處理失敗的更新

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

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

記錄更新資訊

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

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

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

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

必須升級至 Postgres 9.4

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

在更新過程中,當 Postgres 節點停止進行更新時,Analytics 資料會維持 寫入 Qpid 節點Postgres 節點更新並恢復上線後,Analytics 再將資料推送至 Postgres 節點

如果必須復原任何舊的 Postgres 待命節點, 原因。如果必須復原更新,新的 Postgres 待命節點會成為主要執行個體 復原後的 Postgres 節點。因此,當您安裝新的 Postgres 待命節點時 應位於符合 Postgres 伺服器所有硬體需求的節點上,定義請見 邊緣安裝 相關規定

安裝新 Postgres 待命節點

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

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

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

  1. 在目前的 Postgres 主要執行個體上,編輯 /opt/apigee/customer/application/postgresql.properties 檔案來設定下列權杖。如果該檔案不存在,請建立一個:

    conf_pg_hba_replication.connection=host 複製作業 Apigee existing_slave_ip/32 信任\ \n 主機複製 Apigee new_slave_ip/32 信任

    其中 existing_slave_ip 是目前 Postgres 的 IP 位址 待命伺服器,new_slave_ip 是新待命的 IP 位址 節點。
  2. 重新啟動 apigee-postgresql 適用於 Postgres 主要執行個體:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. 查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf,確認已新增待命節點 複製到主要執行個體該檔案中應會顯示下列幾行內容:
    主機複製 Apigee existing_slave_ip/32 信任
    主機複製作業 Apigee new_slave_ip/32 信任
  4. 安裝新的 Postgres 待命伺服器:
    1. 編輯您用於安裝最新 Edge 版本的設定檔,以指定 包含下列內容:

      # 個目前 IP 位址 主要執行個體:
      PG_MASTER=192.168.56.103
      新待命節點的 # 個 IP 位址
      PG_STANDBY=192.168.56.102
    2. 按照「安裝 Edge 」一文的說明停用 SELinux apigee-setup 公用程式
    3. 下載 Edge bootstrap_4.16.05.sh 檔案至 /tmp/bootstrap_4.16.05.sh
      &gt;curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      注意:如果您使用的是 4.16.01 版更新,請下載 Edge bootstrap.sh 檔案。
    4. 安裝 Edge apigee-service 公用程式和依附元件:
      &gt;sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. 使用 apigee-service 安裝 apigee-setup 公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. 安裝 Postgres:
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. 在新待命節點上執行下列指令:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。

停用 Postgres 節點

更新完成後,停用新的待命節點:

  1. 確認 Postgres 正在執行:
    &gt; /opt/apigee/apigee-service/bin/apigee-all status

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

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

零停機時間更新

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

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

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

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

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

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

使用靜音設定檔

您必須將靜音設定檔傳送至 update 指令。靜音設定檔 必須與用於安裝 Edge 4.16.01 或 4.16.05 時使用的帳戶相同。

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

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

  1. 如果您目前使用的是 Postgres 主待命複製功能,請安裝新的 Postgres 待命節點,方法如上方「安裝新的 Postgres 待命節點」一節所述。
  2. 如果有 CRON 工作顯示,則請停用在 Cassandra 上執行修復作業的所有 CRON 工作 直到更新完成為止
  3. 以根權限登入節點,安裝邊緣 RPM。
    注意:雖然 RPM 安裝作業需要 Root 存取權,但你可以執行 Edge 沒有根目錄存取權的話
  4. 按照安裝 Edge Apigee-setup 中的說明停用 SELinux 公用程式
  5. 下載 Edge 4.16.09 bootstrap_4.16.09.sh 檔案至 /tmp/bootstrap_4.16.09.sh
    &gt;curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. 安裝 Edge 4.16.09 apigee-service 公用程式並 依附元件:
    &gt;sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    其中 uName:pWord 是你收到的使用者名稱和密碼 Apigee。如果您省略 pWord,系統會提示您輸入。

    根據預設,安裝程式會檢查您是否已安裝 Java 1.8。如果不是, 便會自動安裝使用 JAVA_FIX 選項指定處理方式 Java 安裝。JAVA_FIX 採用下列值:

    I = 安裝 OpenJDK 1.8 (預設)
    C = 在不安裝 Java 的情況下繼續操作
    問:退出,如果採用這個選項,您必須自行安裝 Java。
  7. 使用 apigee-service 可以 更新 apigee-setup 公用程式:
    1. 如果您先前透過升級 Edge 4.15.07.0x 版本安裝 4.16.01,就必須安裝 Apigee-setup 公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      這個指令會在 <inst_dir>/apigee/apigee-setup/bin 安裝 update.sh 公用程式。

      如果您已安裝 apigee-setup 公用程式,請更新 它:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. 如果您是直接安裝 4.16.01,代表您並未從 4.15.07.0x,您必須更新 apigee-setup 公用程式
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      這項 apigee-service 會安裝 update.sh 公用程式: &lt;inst_dir&gt;/apigee/apigee-setup/bin.
    3. 如果是由直接更新或更新安裝 4.16.05 版,請務必更新 apigee-setup 公用程式
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      這項 apigee-service 會安裝 update.sh 公用程式: &lt;inst_dir&gt;/apigee/apigee-setup/bin.
  8. 視現行的 Edge 版本而定,您必須安裝或更新 使用 apigee-validate 公用程式 Management Server。
    1. 如果您目前使用的是 Edge 4.16.05:請更新 apigee-validate 公用程式: 管理伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
    2. 如果您目前使用的是 Edge 4.16.01:請在apigee-validate 管理伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      注意:如果已在訊息中安裝 apigee-validate 公用程式 安裝 4.16.01 時的處理器節點;如要更新,請在 該節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      不過,自 4.16.05 以上版本起,Apigee 建議您安裝及執行 使用 apigee-validate 公用程式 管理伺服器
    3. 如果是從 4.16.01 升級:請編輯傳送到 apigee-validate 公用程式。於 4.16.01 Edge 版本,apigee-validate 使用的設定檔需要下列項目: 資源:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      在這個版本中,設定檔只需要 APIGEE_ADMINPW 屬性。您可以移除 檔案中的其他兩個屬性
  9. 更新 apigee-provision 公用程式:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. 依照以下「機器順序」一節的說明,在節點上執行更新公用程式 更新」如下:
    &gt; /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 入口網站
  11. 在管理伺服器上執行 Apigee-validate 公用程式,以測試更新。 請參閱「測試安裝」一文。
  12. 如果您已安裝新的 Postgres 待命節點,請按照上述說明停用該節點 停用 Postgres 節點

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

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

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

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

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

如何從本機 4.16.09 存放區更新:

  1. 如果您目前使用的是 Postgres 主待命複製功能,請安裝新的 Postgres 待命節點,方法如上方「安裝新的 Postgres 待命節點」一節所述。
  2. 按照「建立本機 Apigee 存放區」一節的說明,建立本機 4.16.09 存放區前往安裝 Edge apigee-setup 公用程式
    注意:如果已有 4.16.01 或 4.16.05 存放區,則可將 將 4.16.09 存放區新增至存放區,請參閱「更新本機 Apigee 存放區」一文前往 安裝 Edge apigee-setup 公用程式
  3. 如要從 .tar 檔案安裝 apigee-service
    1. 在含有本機存放區的節點上,使用下列指令來封裝本機存放區 複製到名為 /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz 的單一.tar 檔案:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件
    2. 將 .tar 檔案複製到要更新 Edge 的節點。例如,請複製到 上的 /tmp 目錄 新節點
    3. 在新節點上,將檔案解壓縮至 /tmp 目錄:
      &gt;tar -xzf apigee-4.16.09.tar.gz

      這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos。
    4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件:
      &gt;sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file:// apigeerepobasepath=/tmp/repos

      請注意,您會在這個指令中加入存放區目錄的路徑。
  4. 使用 Nginx 網路伺服器安裝 apigee-service:
    1. 按照「使用 Nginx 從存放區安裝」一節的說明,設定 Nginx 網路伺服器 webserver&quot;「Install the Edge apigee-setup 公用程式
    2. 在遠端節點上,下載 Edge bootstrap_4.16.09.sh 檔案, /tmp/bootstrap_4.16.09.sh:
      &gt;/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

      其中 uName:pWord 是您在上方設定的使用者名稱和密碼 存放區,而 remoteRepo 是 存放區節點
    3. 在遠端節點上,安裝 Edge apigee-service 公用程式和依附元件:
      &gt;sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      其中 uName:pWord 是存放區的使用者名稱和密碼。
  5. 使用 apigee-service 可以 更新 apigee-setup 公用程式:
    1. 如果您先前透過升級 Edge 4.15.07.0x 版本安裝 4.16.01,就必須安裝 Apigee-setup 公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      這個指令會在 <inst_dir>/apigee/apigee-setup/bin 安裝 update.sh 公用程式。

      如果您已安裝 apigee-setup 公用程式,請更新 它:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. 如果您是直接安裝 4.16.01,代表您並未從 4.15.07.0x,您必須更新 apigee-setup 公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      這項 apigee-service 會安裝 update.sh 公用程式: &lt;inst_dir&gt;/apigee/apigee-setup/bin.
    3. 如果是由直接更新或更新安裝 4.16.05 版,請務必更新 apigee-setup 公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      這項 apigee-service 會安裝 update.sh 公用程式: &lt;inst_dir&gt;/apigee/apigee-setup/bin.
  6. 視現行的 Edge 版本而定,您必須安裝或更新 使用 apigee-validate 公用程式 Management Server。
    1. 如果您目前使用的是 Edge 4.16.05:請更新 apigee-validate 公用程式: 管理伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
    2. 如果您目前使用的是 Edge 4.16.01:請安裝 apigee-validate 管理伺服器的公用程式:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      注意:如果已在訊息中安裝 apigee-validate 公用程式 安裝 4.16.01 時的處理器節點;如要更新,請在 該節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      不過,自 4.16.05 以上版本起,Apigee 建議您安裝及執行 Apigee-validate 管理公用程式。
    3. 如果是從 4.16.01 升級:請編輯傳送到 apigee-validate 公用程式。於 4.16.01 Edge 版本,apigee-validate 使用的設定檔需要下列項目: 資源:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      在這個版本中,設定檔只需要 APIGEE_ADMINPW 屬性。您可以移除 檔案中的其他兩個屬性
  7. 更新 apigee-provision 公用程式:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 依照以下「機器順序」一節的說明,在節點上執行更新公用程式 更新」如下:
    &gt; /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 入口網站
  9. 在管理伺服器上執行 Apigee-validate 公用程式,以測試更新。 請參閱「測試安裝」一文。
  10. 如果您已安裝新的 Postgres 待命節點,請按照上述說明停用該節點 停用 Postgres 節點

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

機器更新順序

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

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

單獨使用 安裝

  1. 如果是從 4.16.01 更新,請將 Zookeeper 降級:
    &gt;Yum 降級 Apigee-zookeeper
  2. 更新 Cassandra 和 ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新 Qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 更新 LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 停止 Postgres Server、Qpid 伺服器和 PostgreSQL:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    &gt;/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  6. 更新 postgresql:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. 更新 Postgres 資料庫:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. 更新其餘 Edge 元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. 更新 Edge UI:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

獨立 2 主機 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 如果是從 4.16.01 更新,請將 Zookeeper 在機器 1 上降級:
    &gt;Yum 降級 Apigee-zookeeper
  2. 在機器 1 上更新 Cassandra 和 ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新機器 2 上的 qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在電腦 1 上更新 LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 更新裝置 1 上的邊緣元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. 在機器 1 上更新 UI:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. 在機器 2 上更新 postgresql:
    1. 停止 Postgres Server、Qpid 伺服器和 postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. 更新 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. 更新 Postgres 資料庫:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. 更新機器 2 和機器 1 上的邊緣元件:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. 更新裝置 2 上的邊緣元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

針對 5 個主機叢集 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 確認您已安裝新的 Postgres 待命節點 (如安裝新的 Postgres 中所述) 待命節點
  2. 如果已從 4.16.01 版更新,請將 Zookeeper 在機器 1、2 和 3:
    &gt;Yum 降級 Apigee-zookeeper
  3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. 更新機器 4 和 5 上的 qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. 在電腦 1 上更新 LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 更新機器 1、2、3 上的邊緣元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. 在機器 1 上更新 UI:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. 更新機器 4 和 5:
    1. 在機器 4 上停止 Postgres 伺服器和 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    2. 在電腦 5 上停止 Postgres 伺服器、Qpid 伺服器和 postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. 更新機器 4 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. 更新機器 4 中的 Postgres 資料庫 (僅限 Postgres 主要執行個體):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. 更新機器 5 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 在機器 4 和 5 上啟動 Postgres 伺服器和 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      &gt;/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. 在電腦上執行下列指令,將 Postgres 設為待命節點 5:
      &gt;cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt;rm -rf *
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    9. 在兩個伺服器上發出下列指令碼,驗證複製狀態。 兩台伺服器上應該顯示相同的結果, 複製作業:

      在機器 4 (主要節點) 中,執行:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      驗證其是否為主版本。

      在機器 5 中,待命節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。
  9. 更新機器 4,5:
    上的邊緣元件 &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. 確認您已停用新的待命節點,方法是按照「停用 Postgres」一節所述的程序操作 節點的情況下,

針對 9 主機叢集 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 確認您已安裝新的 Postgres 待命節點 (如安裝新的 Postgres 中所述) 待命節點
  2. 如果已從 4.16.01 版更新,請將 Zookeeper 在機器 1、2 和 3:
    &gt;好吃 將 Apigee-zookeeper 降級
  3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. 更新機器 6 和 7 上的 qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. 在電腦 1 上更新 LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 請按照下列步驟更新機器 6、7、1、4 和 5 上的 Edge 元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. 在機器 1 上更新 UI:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. 更新機器 8 和 9:
    1. 在機器 8 上停止 Postgres 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. 在機器 9 上停止 Postgres 伺服器和 postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 6 和 7 上停止 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 更新機器 8 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. 更新機器 9 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. 在機器 8 和 9 上啟動 Postgres 伺服器伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. 在機器 6 和 7 上啟動 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. 在電腦上執行下列指令,將 Postgres 設為待命節點 9:
      &gt;cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt;rm -rf *
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 在兩個伺服器上發出下列指令碼,驗證複製狀態。 兩台伺服器上應該顯示相同的結果, 複製作業:
      在機器 8 中,執行主要節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      驗證其是否為主版本。

      機器 9 上的待命節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。
  9. 更新機器 8 和 9 上的邊緣元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. 確認您已停用新的待命節點,方法是按照「停用 Postgres」一節所述的程序操作 節點的情況下,

13 主機叢集 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 確認您已安裝新的 Postgres 待命節點 (如安裝新的 Postgres 中所述) 待命節點
  2. 如果已從 4.16.01 版更新,請將 Zookeeper 在機器 1、2 和 3:
    &gt;好吃 將 Apigee-zookeeper 降級
  3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. 在機器 12 和 13 上更新 qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. 在電腦 4 和 5 上更新 LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 請依照下列順序更新機器 12、13、6、7、10 和 11 上的 Edge 元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. 更新機器 6 和 7 上的 UI:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. 更新機器 8 和 9:
    1. 在機器 8 上停止 Postgres 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. 在機器 9 上停止 Postgres 伺服器和 postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 12 與 13 上停止 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 更新機器 8 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. 更新機器 9 的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. 在機器 8 和 9 上啟動 Postgres 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. 在機器 12 和 13 上啟動 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. 在電腦上執行下列指令,將 Postgres 設為待命節點 9:
      &gt;cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt;rm -rf *
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 在兩個伺服器上發出下列指令碼,驗證複製狀態。 兩台伺服器上應該顯示相同的結果, 複製作業:
      在機器 8 中,執行主要節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      驗證其是否為主版本。

      機器 9 上的待命節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。
  9. 更新機器 8 和 9 上的邊緣元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. 確認您已停用新的待命節點,方法是按照「停用 Postgres」一節所述的程序操作 節點的情況下,

針對 12 個主機叢集 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 確認您已安裝新的 Postgres 待命節點 (如安裝新的 Postgres 中所述) 待命節點
  2. 更新 Cassandra 和 ZooKeeper:
    1. 如果是從 4.16.01 更新,請將 Zookeeper 在機器 1、2、 而資料中心 1 為 3:
      &gt;好吃 將 Apigee-zookeeper 降級
    2. 在資料中心 1 的機器 1、2 和 3 中:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. 如果是從 4.16.01 更新,請將 Zookeeper 在電腦 7、8、 而資料中心 2 中的 9:
      &gt;好吃 將 Apigee-zookeeper 降級
    4. 位於資料中心 2 中的機器 7、8 和 9
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新 qpidd:
    1. 資料中心 1
      中的機器 4,5 &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. 資料中心 2
      中的機器 10、11 &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 更新 LDAP:
    1. 資料中心 1
      中的機器 1 &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. 資料中心 2
      中的機器 7 &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 更新 Edge 元件:
    1. 資料中心 1
      中的機器 4、5、1、2、3 &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. 資料中心 2 中的機器 10、11、7、8、9
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. 更新 UI:
    1. 資料中心 1 中的機器 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. 資料中心 2 中的機器 7:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. 在資料中心 2 中更新資料中心 1 和 12 中的機器 6:
    1. 在機器 6 上停止 Postgres 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. 在機器 12 上停止 Postgres 伺服器和 postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 4、5、10 和 11 上停止 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 更新機器 6 上的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 更新機器 6 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. 更新機器 12 上的 postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. 在機器 6 和 12 上啟動 Postgres 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. 在機器 4、5、10 和 11 上啟動 Qpid 伺服器:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. 在電腦上執行下列指令,將 Postgres 設為待命節點 12:
      &gt;cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt;rm -rf *
      &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 在兩個伺服器上發出下列指令碼,驗證複製狀態。 兩台伺服器上應該顯示相同的結果, 複製作業:
      在機器 6 (主要節點) 上執行:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      驗證其是否為主版本。

      在機器 12 中,待命節點:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。
  8. 更新裝置 6 和 12 上的 Edge 元件:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. 確認您已停用新的待命節點,方法是按照「停用 Postgres」一節所述的程序操作 節點的情況下,

7 主機 API BaaS 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 在機器 5、6 和 7 上更新 Cassandra:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. 在機器 1、2 和 3 上更新 ElasticSearch 和 API BaaS 堆疊:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. 在機器 4 上更新 API BaaS 入口網站:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

10 主機 API BaaS 安裝

請參閱安裝拓撲 查看 Edge 拓撲和節點編號清單

  1. 在機器 8、9 與 10 上更新 Cassandra:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. 在機器 1、2 和 3 上更新 ElasticSearch:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. 在機器 4、5 和 6 上更新 API BaaS 堆疊:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. 在機器 7 上更新 API BaaS 入口網站:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

非標準安裝

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. LDAP
  5. 邊緣,表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 而不是 Postgres 伺服器、管理伺服器、訊息處理器和路由器
    注意:如果節點同時安裝 Qpid 伺服器和 Postgres 伺服器,請執行 「-c 邊緣」設定檔步驟。
  6. Edge UI
  7. Postgres 主要執行個體上的 postgresql,包括升級。
  8. Postgresql 上的訊息:
  9. 邊緣,表示「-c 邊緣」所有 Qpid 和 Postgres 節點合併的設定檔,或任何 單獨的 Postgres 節點上