更新 Apigee Edge 4.50.00 或 4.51.00 至 4.52.00

Apigee 支援從 4.50.00 版或 4.51.00 版直接遷移至 版本 4.52.00。本頁說明如何執行任一升級。

可執行更新的使用者

執行更新的人員必須與最初安裝 Edge 的使用者相同，或 一個人以根的身分跑步

安裝邊緣 RPM 後，任何人都能設定。

您需要更新哪些元件

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

更新必要條件

升級 Apigee Edge 前，請確認以下事項：

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

    這樣一來，您便可有備份方案，以在未更新至新版本時派上用場 功能。如要進一步瞭解備份，請參閱備份 和還原。

  • 確保 Edge 正在執行
    使用下列指令，確保 Edge 在更新程序期間已啟動且正在執行： 
    /opt/apigee/apigee-service/bin/apigee-all status
  • 確認 Cassandra 編譯策略為 LeveledCompactionStrategy
    確保 Cassandra 相容性策略已設為 LeveledCompactionStrategy，如 變更 Cassandra 壓縮策略。

自動傳播資源設定

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

必須升級至 Zookeeper 3.8.0

這個版本的 Edge for Private Cloudes 包含 Zookeeper 3.8.0。隸屬於 升級後，所有 Zookeeper 資料都會遷移至 Zookeeper 3.8.0。

升級 Zookeeper 前，請先詳閱 Zookeeper 維護指南。大多數 Edge 生產系統使用 Zookeeper 節點叢集 可以跨越多個資料中心運作其中一些節點已設定為參與投票者 並將其餘部分設為觀察員 詳情請參閱 關於領導者、追蹤者、選民和觀察者瞭解更多詳細資訊。選民節點會 選民將成為追隨者。

更新程序期間，可能短暫延遲或寫入 Zookeeper 當主要節點關閉時這可能會影響 Zookeeper，例如 Proxy 的部署作業和 Apigee 基礎架構變更 例如新增或移除訊息處理工具等 的 API 在 Zookeeper 升級期間的 Apigee (除非這些執行階段 API 呼叫管理 API) 請按照以下程序操作。

整體而言，升級程序需要備份每個節點。其他使用者 升級所有觀察器和追蹤者，最後升級主要節點。

建立備份

備份 Zookeeper 的所有節點，以便在需要復原時使用。請注意， 復原作業會將 Zookeeper 還原至備份時的狀態。注意： 任何部署項目 自備份進行以來，Apigee 的基礎架構異動 (資訊儲存在 動物) 會在還原期間遺失。 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

如果您使用虛擬機器且具備相關權限，VM 快照或備份也能 還原或復原 (如有必要)

找出領導者、追蹤者和觀察者

注意：以下範例指令使用 nc 公用程式 將資料傳送給 Zookeeper。您可以運用 替代公用程式，將資料傳送給 Zookeeper。

  1. 如未安裝在 ZooKeeper 節點上，請安裝 nc: 
      sudo yum install nc
  2. 在節點上執行下列 nc 指令，其中 2181 是 ZooKeeper 通訊埠： 
      echo stat | nc localhost 2181

    您會看到如下所示的輸出：

      Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    在節點輸出的 Mode 行中，您應該會看到觀察器、勝出版本或 依節點設定而定，追蹤者 (即選民並非主要投票者)。 注意：在含有單一 ZooKeeper 節點的 Edge 的獨立安裝項目中，Mode 設為獨立模式

  3. 在每個 ZooKeeper 節點上重複步驟 1 和 2。

在觀察器和追蹤者節點上升級 Zookeeper

在每個觀察器和追蹤者節點上升級 Zookeeper，如下所示：

  1. 下載並執行 Private Cloud 4.52 適用的 Edge 啟動功能，詳情請參閱下列說明： 針對有外部網際網路連線的節點，更新至 4.52.00 版。 視情況而定 您正在離線安裝。
  2. 升級 Zookeeper 元件： 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    注意：如果這些節點安裝了其他元件 (例如 Cassandra)，您可以 但現在也支援 cs,zk 設定檔Apigee 建議您只升級 Zookeeper，並確保叢集正常運作 才能升級其他元件
  3. 在每個 Zookeeper 觀察器和追蹤者節點重複上述步驟。

關閉領導者

所有觀察器和追蹤者節點都升級完成後，關閉主要節點。節點上 請執行以下指令： 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

請注意，在選出新的領導者前，可能會出現短暫延遲或 寫入 Zookeeper 中的寫入失敗。這可能會影響寫入 Zookeeper 的作業 例如 Proxy 的部署動作或 Apigee 基礎架構變更，例如新增或 移除訊息處理工具等

確認已選出新的領導者

請按照找出勝出版本 追蹤者和觀察者一節，確認您已從 追蹤者的追蹤者。請注意，在受審的階段， 與目前領導者不同的資料中心

升級主管

請按照 中的步驟操作 在上方的觀察器和追蹤者節點上升級 Zookeeper。

舊的主要節點也一併升級後，請確認叢集健康狀態並 確保有一個主要節點

復原

如果需要復原：

  1. 請先對觀察者和追蹤者執行復原步驟。
  2. 下載並執行要復原版本的啟動版本 (4.50 或 4.51)。 處理流程將因節點是否使用外部網際網路連線而有所不同 或是您正在進行離線安裝作業。
  3. 如果 Zookeeper 是在節點上執行，請停止這樣做： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. 解除安裝現有動物管理程式： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  • 照常安裝 Zookeeper： 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • 所有追蹤者和觀察器都復原後，請按照以下方法復原主要節點 主要節點上的步驟 2 至 5。
  • 所有節點都復原後，請驗證叢集健康狀態並確保 做為叢集的主要節點

    • 還原備份

    請參閱「從備份還原」。 請注意，如要從較舊版本的 Edge for Private Cloud (例如 4.50 和 4.51) 取得 Zookeeper 備份，請 與 Edge for Private Cloud 4.52 版中的 Zookeeper 版本相容

    必須升級至 Postgres 14

    這個版本的 Edge 包含適用於 Postgres 14 的升級版本。本次升級 Postgres 資料會遷移至 Postgres 14。

    大多數 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.50.00 或 4.51.00) 適用的 Postgres 待命伺服器 不適用於版本 4.52.00

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

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

    1. 在目前的 Postgres 主要執行個體上，編輯 /opt/apigee/customer/application/postgresql.properties 檔案來設定下列權杖。如果該檔案不存在，請建立一個： 
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

      其中 existing_standby_ip 是目前 Postgres 的 IP 位址 待命伺服器，new_standby_ip 是新待命節點的 IP 位址。

    2. 在 Postgres 主要執行個體上重新啟動 apigee-postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    3. 查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 檔案。您應該會看到 中的下列程式碼： 
      host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
    4. 安裝新的 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 4.51.00：

        1. 下載 Edge bootstrap_4.51.00.sh 檔案， /tmp/bootstrap_4.51.00.sh : 
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. 安裝 Edge apigee-service 公用程式和依附元件： 
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        如果目前使用 Edge 4.50.00：

        1. 下載 Edge bootstrap_4.50.00.sh 檔案， /tmp/bootstrap_4.50.00.sh : 
          curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
        2. 安裝 Edge apigee-service 公用程式和依附元件： 
          sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
      4. 使用 apigee-service 安裝 apigee-setup 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      5. 安裝 Postgres： 
        /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
      6. 在新待命節點上執行下列指令： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        驗證是否處於待機模式。

    執行 Postgres 就地升級

    注意：您必須先完成以下前置步驟 直接升級 Postgres 即可

    初步步驟

    執行直接升級到 Postgres 前，請在主要執行個體上執行下列步驟 來更新叢集和待命主機 apigee-postgresql 上的 max_locks_per_transaction 資源：

    1. 如果沒有，請建立檔案 /opt/apigee/customer/application/postgresql.properties。
    2. 將這個檔案的擁有權變更為 apigee： 
      sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. 在檔案中新增以下屬性： 
      conf/postgresql.conf+max_locks_per_transaction=30000
    4. 設定 apigee-postgresql： 
      apigee-service apigee-postgresql configure
    5. 重新啟動 apigee-postgresql： 
      apigee-service apigee-postgresql restart
    ，瞭解如何調查及移除這項存取權。

    執行直接升級

    如要直接升級至 Postgres 14，請按照下列步驟操作：

    1. 在主要主機上升級 Postgres 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    2. 在主要主機上執行設定指令： 
      apigee-service apigee-postgresql setup -f /opt/silent.conf
    3. 在主要主機上執行設定指令： 
      apigee-service apigee-postgresql configure
    4. 重新啟動主要主機： 
      apigee-service apigee-postgresql restart
    5. 設為主要執行個體： 
      apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
    6. 確認已啟動主要主機： 
      apigee-service apigee-postgresql wait_for_ready
    7. 停止待命： 
      apigee-service apigee-postgresql stop
    8. 升級待命。

      注意：如果這個步驟錯誤/失敗，則可略過。update.sh 將嘗試 以錯誤的設定啟動待命伺服器。提供 Postgres 安裝版本升級至 14，即可忽略這個錯誤。

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    9. 確認待命已停止： 
      apigee-service apigee-postgresql stop
    10. 移除舊的待命設定： 
      rm -rf /opt/apigee/data/apigee-postgresql/
    11. 在待命伺服器上設定複製作業： 
      apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
    12. 移除下列位置的 conf/postgresql.conf+max_locks_per_transaction=30000 行： 有兩個檔案：/opt/apigee/customer/application/postgresql.properties 主要主機和待命主機這一行之前為 已加入初步步驟。

    完成這項程序後，待命程序就會順利啟動。

    停用 Postgres 節點

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

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

      如果 Postgres 未執行，請啟動： 

      /opt/apigee/apigee-service/bin/apigee-all start

    2. 對新待命節點執行下列 curl 指令，取得新待命節點的 UUID 待命節點： 
      curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

      輸出內容結尾處會顯示節點的 UUID，格式如下： 

      "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

    3. 對新的待命節點執行下列指令，以停止新的待命節點： 
      /opt/apigee/apigee-service/bin/apigee-all stop
    4. 在 Postgres 主要節點上編輯 /opt/apigee/customer/application/postgresql.properties 從 conf_pg_hba_replication.connection 移除新的待命節點： 
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
    5. 在 Postgres 主要執行個體上重新啟動 apigee-postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    6. 查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 檔案。您應該會看到 該檔案中的下一行： 
      host replication apigee existing_standby_ip/32 trust
    7. 建立下列 Edge 管理功能，以便從 ZooKeeper 刪除待命節點的 UUID Management Server 節點上的 API 呼叫： 
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    Postgres 升級後的步驟

    在重大的 Postgres 升級後，Postgres 的內部統計資料會抹除。這些統計資料可協助 Postgres 查詢規劃工具，利用最適當的索引和路徑執行查詢。

    Postgres 可以在執行查詢的過程中，以及在 autovacuum Daemon 執行時，逐步重建統計資料。但是，除非統計資料重新建構，否則查詢速度可能會變慢。

    如要解決這個問題，請在主要 Postgres 節點上，對資料庫中的所有資料表執行 ANALYZE。您也可以一次對數個資料表執行 ANALYZE。

    新版 Edge UI

    本節列出 Edge UI 的注意事項。若需更多資訊，請參閲 Private Cloud 的全新 Edge UI。

    安裝 Edge UI

    完成初始安裝程序後，Apigee 建議您安裝 Edge UI。 這是適用於 Private Cloud 的 Apigee Edge 開發人員和管理員的強化使用者介面。

    請注意，Edge UI 會要求停用基本驗證功能，並使用 IDP，例如 SAML 或 LDAP。

    詳情請參閱「安裝新版 Edge UI」。

    更新 Edge UI

    如要更新 Edge UI 元件，請考慮您所用的私有雲的 Edge 版本 升級自：

    使用 Apigee mTLS 更新

    如要更新 Apigee mTLS，請按照下列步驟操作 步驟：

    復原更新

    如果更新失敗，您可以嘗試修正問題，並 update.sh。您可以多次執行更新，然後繼續更新作業 從上次中斷的地方繼續開啟

    如果作業失敗而需要您將更新復原為先前版本，請參閱 如需詳細操作說明，請復原 4.52.00 版。

    記錄更新資訊

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

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

    如果執行 update.sh 公用程式的使用者沒有存取權 目錄，就會以名稱為 /tmp 的名檔將記錄寫入 update_username.log。

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

    零停機時間更新

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

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

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

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

    請在更新前後進行下列操作：

    使用靜音設定檔

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

    更新為 4.52.00 版 (有外部網際網路連線的節點)

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

    1. 如果有建立要執行修復作業的 cron 工作，請停用這些工作 Cassandra 直到更新完成為止。
    2. 以根權限登入節點，安裝邊緣 RPM。
    3. 安裝 yum-utils 和 yum-plugin-priorities： 
      sudo yum install yum-utils
sudo yum install yum-plugin-priorities
    4. 按照安裝 使用 Edge Apigee-setup 公用程式。
    5. 如果是在 Oracle 7.x 上安裝，請執行下列指令： 
      sudo yum-config-manager --enable ol7_optional_latest
    6. 如果您是在 AWS 上安裝，請執行下列指令： yum-configure-manager 指令： 
      yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

    7. 如果目前使用 Edge 4.51.00：

      1. 下載 Edge bootstrap_4.52.00.sh 檔案，以便 /tmp/bootstrap_4.52.00.sh: 
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. 請透過下列方式安裝 Edge 4.52.00 apigee-service 公用程式和依附元件： 執行下列指令： 
        sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

        其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果發生以下情況： 省略 pWord，系統會提示您輸入。

        根據預設，安裝程式會檢查您是否已安裝 Java 1.8。如果不是， 安裝程式會為您安裝

        使用 JAVA_FIX 選項指定處理方式 Java 安裝。JAVA_FIX 會使用下列值：

        • I：安裝 OpenJDK 1.8 (預設)。
        • C：在不安裝 Java 的情況下繼續操作。
        • Q：結束。如果採用這個選項，您必須自行安裝 Java。
      3. 使用 apigee-service 更新 apigee-setup 公用程式，因為 範例如下： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. 依照下列方式更新管理 Server 上的 apigee-validate 公用程式 範例如下所示： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. 依照下列方式更新管理 Server 上的 apigee-provision 公用程式 範例如下所示： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      6. 執行下列指令，在節點上執行 update 公用程式： 
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        請按照機器順序中所述順序執行此操作 更新。

        在此情況下：

        • component 是要更新的邊緣元件。可能的值包括：
          • cs：Cassandra
          • edge：Edge UI 以外的所有 Edge 元件： Management Server、Message 處理器、路由器、QPID Server、Postgres Server
          • ldap：OpenLDAP
          • ps：postgresql
          • qpid：qpidd
          • sso：Apigee 單一登入 (如果已安裝單一登入)
          • ue：新版 Edge UI
          • ui：傳統版 Edge UI
          • zk：Zookeeper
        • configFile 與您過去使用的設定檔相同 定義您的邊緣 元件。

        您可以設定 component，對所有元件執行 update.sh 。例如：

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. 請在所有執行該元件的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動)： 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
      8. 在管理頁面執行 apigee-validate 公用程式，測試更新作業 伺服器，如「測試安裝」一節中所述。

      如果您之後決定要復原更新，請使用 復原 4.52.00 版。

      從本機存放區更新至 4.52.00

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

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

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

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

      1. 按照「建立本機 Apigee 存放區」一節的說明，建立本機 4.52.00 存放區於 安裝 Edge apigee-setup 公用程式。
      2. 如要從 .tar 檔案安裝 apigee-service：
        1. 在含有本機存放區的節點上，使用下列指令來封裝本機存放區 複製到名為 /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz 的單一 .tar 檔案： 
          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
        2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，請複製到 新節點上的 /tmp 目錄。
        3. 在新節點上，將檔案解壓縮至 /tmp 目錄： 
          tar -xzf apigee-4.52.00.tar.gz

          這個指令會在目錄中建立名為 repos 的新目錄 這個檔案包含 .tar 檔案例如 /tmp/repos。

        4. 從下列位置安裝 Edge apigee-service 公用程式和依附元件： /tmp/repos: 
          sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

          請注意，您會在這個指令中加入存放區目錄的路徑。

      3. 使用 Nginx 網路伺服器安裝 apigee-service：
        1. 按照「使用 Nginx 從存放區安裝」一節的說明，設定 Nginx 網路伺服器 webserver&quot;「Install the Edge apigee-setup 公用程式。
        2. 在遠端節點上，將 Edge bootstrap_4.52.00.sh 檔案下載至 /tmp/bootstrap_4.52.00.sh: 
          /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

          其中 uName:pWord 是您先前設定的使用者名稱和密碼 存放區，remoteRepo 是存放區節點的 IP 位址或 DNS 名稱。

        3. 在遠端節點上，安裝 Edge apigee-setup 公用程式和依附元件： 
          sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

          其中 uName:pWord 是存放區使用者名稱和密碼。

      4. 使用 apigee-service 更新 apigee-setup 公用程式，因為 範例如下： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      5. 依照下列方式更新管理 Server 上的 apigee-validate 公用程式 範例如下所示： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. 依照下列方式更新管理 Server 上的 apigee-provision 公用程式 範例如下所示： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      7. 請依下列說明，在節點上執行 update 公用程式。 機器更新順序： 
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        地點：

        • component 是要更新的邊緣元件。您通常會更新 加入下列元件：
          • cs：Cassandra
          • edge：Edge UI 以外的所有邊緣元件：管理伺服器、訊息處理器、路由器 QPID 伺服器、Postgres 伺服器
          • ldap：OpenLDAP
          • ps：postgresql
          • qpid：qpidd
          • sso：Apigee 單一登入 (如果已安裝單一登入)
          • ue 新增 Edge UI
          • ui：傳統版 Edge UI
          • zk：Zookeeper
        • configFile 與您過去使用的設定檔相同 定義 Edge 元件 閱讀進度

        您可以設定 component，對所有元件執行 update.sh 。例如：

        /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
      8. 重新啟動所有執行容器的節點上的 UI 元件 (如果尚未重新啟動)： 
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      9. 在管理頁面執行 apigee-validate 公用程式，測試更新作業 伺服器，如「測試安裝」一節中所述。

      如果您之後決定要復原更新，請使用 復原 4.52.00 版。

      機器更新順序

      請務必按照以下順序更新 Edge 安裝過程中的機器：

      • 您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新任何節點 和其他節點
      • 適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器 路由器、QPID 伺服器，而非 Postgres 伺服器)，使用 -c edge 選項更新
      • 如果步驟指定應在多部機器上執行，請在該步驟中執行 指定的機器順序
      • 更新營利設定無須另外執行一個步驟。這個物件會在您指定 -c edge選項。
      ，瞭解如何調查及移除這項存取權。

      1 個節點獨立昇級授權

      如要將 1 個節點的獨立設定升級至 4.52.00 版：

      1. 更新所有元件： 
        /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
      2. (如果您已安裝 apigee-adminapi) 更新 apigee-adminapi 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      雙節點獨立昇級

      針對雙節點獨立安裝更新下列元件：

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

      1. 在機器 1 上更新 Cassandra 和 ZooKeeper： 
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. 在機器 2 上更新 Qpid 和 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
      3. 在電腦 1 上更新 LDAP： 
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      4. 更新機器 2 和 1 上的邊緣元件： 
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      5. 更新機器 1 上的 UI： 
        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
      6. (如果您已安裝 apigee-adminapi) 已更新電腦 1 上的 apigee-adminapi 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      7. (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO)： 
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

      8. 在電腦 1 上重新啟動 Edge UI 元件： 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

      升級 5 個節點

      針對 5 節點安裝作業更新下列元件：

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

      1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. 在機器 4 上更新 Qpid 和 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      3. 在機器 5 上更新 Qpid 和 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      4. 在電腦 1 上更新 LDAP： 
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. 更新機器 4、5、1、2、3 上的 Edge 元件： 
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. 更新 Edge UI：
        • 傳統版 UI：如果您使用的是傳統版 UI，請更新 機器 1 的 ui 元件，如以下範例所示： 
          /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
        • New Edge UI：如果您安裝了新的 Edge UI， 適當機器上的 ue 元件 (非機器 1)： 
          /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
      7. (如果您已安裝 apigee-adminapi) 已更新電腦 1 上的 apigee-adminapi 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO)： 
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

      9. 重新啟動 UI 元件：
        • 傳統版 UI：如果您使用的是傳統版 UI，請重新啟動 機器 1 的 edge-ui 元件，如以下範例所示： 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • New Edge UI：如果您安裝了新的 Edge UI，請重新啟動 適當機器上的 edge-management-ui 元件 (非機器) 1)： 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      9 個節點叢集升級作業

      針對 9 節點的叢集安裝作業更新下列元件：

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

      1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. 更新機器 6 和 7 上的 Qpid： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. 在機器 8 上更新 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. 在電腦 9 上更新 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. 在電腦 1 上更新 LDAP： 
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. 請依照下列順序更新機器 6、7、8、9、1、4 和 5 上的 Edge 元件： 
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. 在機器 1 上更新新版 UI (ue) 或傳統版 UI (ui)： 
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (如果您已安裝 apigee-adminapi) 在電腦 1 上更新 apigee-adminapi 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO)： 
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

      10. 重新啟動 UI 元件：
        • 傳統版 UI：如果您使用的是傳統版 UI，請重新啟動 機器 1 的 edge-ui 元件，如以下範例所示： 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • New Edge UI：如果您安裝了新的 Edge UI，請重新啟動 適當機器上的 edge-management-ui 元件 (非機器) 1)： 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      13 個節點叢集升級

      針對 13 節點的叢集安裝作業更新下列元件：

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

      1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. 更新機器 12 和 13 的 Qpid： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. 在機器 8 上更新 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. 在電腦 9 上更新 Postgres： 
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. 在電腦 4 和 5 上更新 LDAP： 
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. 請依照下列順序更新機器 12、13、8、9、6、7、10 和 11 中的 Edge 元件： 
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. 更新電腦 6 的新版使用者介面 (ue) 或傳統版 UI (ui)，並 7： 
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (如果您已安裝 apigee-adminapi) 已更新電腦 6 和 7 上的 apigee-adminapi 公用程式： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (如果您已安裝 Apigee 單一登入) 在機器 6 和 7 上更新 Apigee 單一登入： 
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

      10. 重新啟動 UI 元件：
        • 傳統版 UI：如果您使用的是傳統版 UI，請重新啟動 機器 6 和 7 的 edge-ui 元件，如以下範例所示： 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • New Edge UI：如果您安裝了新的 Edge UI，請重新啟動 機器 6 和 7 上的 edge-management-ui 元件： 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      12 個節點叢集升級

      針對 12 個節點的叢集安裝作業更新下列元件：

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

      1. 更新 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
      2. 更新 qpidd：
        1. 資料中心 1 中的機器 4、5 部
          1. 在機器 4 上更新 qpidd： 
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. 在機器 5 上更新 qpidd： 
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
        2. 資料中心 2 中的機器 10、11
          1. 在機器 10 上更新 qpidd ： 
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. 在機器 11 上更新 qpidd ： 
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. 更新 Postgres：
        1. 資料中心 1 中的機器 6 
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
        2. 資料中心 2 中的機器 12 
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. 更新 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
      5. 更新 Edge 元件：
        1. 資料中心 1 中的機器 4、5、6、1、2、3 
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
        2. 資料中心 2 中的機器 10、11、12、7、8、9 
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. 請更新新版 UI (ue) 或傳統版 UI (ui)：
        1. 資料中心 1 中的機器 1： 
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
        2. 資料中心 2 中的機器 7： 
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      7. (如果您已安裝 apigee-adminapi) 更新 apigee-adminapi 公用程式：
        1. 資料中心 1 中的機器 1： 
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
        2. 資料中心 2 中的機器 7： 
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (如果您已安裝 Apigee 單一登入) 更新 Apigee 單一登入 (SSO)：
        1. 資料中心 1 中的機器 1： 
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
        2. 資料中心 2 中的機器 7： 
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

          3. 其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

      9. 重新啟動新版 Edge UI (edge-management-ui) 或傳統版 Edge UI 機器 1 和 7 上的 (edge-ui) 元件： 
        /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

      針對非標準設定

      如果您有非標準設定，請在下方更新 Edge 元件 順序：

      1. ZooKeeper
      2. Cassandra
      3. qpidd、ps
      4. LDAP
      5. 邊緣，表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Edge Postgres Server、管理伺服器、訊息處理器和路由器。
      6. Edge UI (傳統版或新版)
      7. apigee-adminapi
      8. Apigee 單一登入 (SSO)

      完成更新後，請務必在所有執行中的機器重新啟動 Edge UI 元件 基礎架構