安裝完成後

成功安裝 Edge 後，您可能需要執行一些常見工作，以驗證安裝、調整設定及自訂設定。這些工作包括：

工作 說明
叫用 Edge 元件上的指令 使用 apigee-service 公用程式啟動、停止、重新啟動及取得各個 Edge 元件的狀態。
設定 Edge 元件 使用屬性檔案變更 Edge 元件的預設設定。
執行 apigee-validate 叫用測試指令碼，確保每個元件都已成功安裝。
調整 JVM 堆積設定 為每個節點最佳化 Java 記憶體設定。
管理 LDAP 密碼政策 變更預設 LDAP 密碼，並設定各種驗證設定。
在節點上安裝 apigee-monit 安裝並使用工具監控節點上的元件，並在元件故障時嘗試重新啟動。
變更預設 PostgreSQL 密碼 Apigee 建議您在安裝 Edge for Private Cloud 後變更預設 PostgreSQL 密碼，以維護資料安全。
設定 PostgreSQL 清除工作 刪除數據分析服務收集的多餘資料。
設定 Cassandra nodetool 修復 您應定期對 Cassandra 環執行維護作業，確保所有節點的一致性。
啟用自動啟動功能 指示 Edge for Private Cloud 在重新啟動時自動重新啟動。
設定新版 Edge UI 為新版 Edge UI (Apigee Edge for Private Cloud 開發人員和管理員的管理使用者介面) 設定驗證和選用設定。

請注意，這些只是安裝 Edge 後通常會執行的一些常見工作。如需其他作業和管理工作，請參閱「如何設定 Edge」和「作業」。

在 Edge 元件上叫用指令

Edge 會在 /opt/apigee/apigee-service/bin 下安裝管理公用程式，您可以使用這些公用程式管理 Edge 安裝作業。舉例來說，您可以使用 apigee-all 公用程式啟動、停止、重新啟動或判斷節點上所有 Edge 元件的狀態：

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

使用 apigee-service 公用程式控制及設定個別元件。apigee-service 公用程式的格式如下：

/opt/apigee/apigee-service/bin/apigee-service component_name action

其中 component_name 代表元件。您執行 apigee-service 的節點上必須有該元件。視設定而定，component_name 的值可能包括：

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (PostgreSQL 資料庫)
  • apigee-qpidd (Qpidd)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (管理伺服器)
  • edge-management-ui (新版 Edge 使用者介面)
  • edge-message-processor (訊息處理器)
  • edge-postgres-server (Postgres 伺服器)
  • edge-qpid-server (Qpid 伺服器)
  • edge-router (邊緣路由器)

除了這些元件外，您也可以根據設定，在 apigee-provision 和 apigee-validate 元件上叫用 apigee-service。

舉例來說，如要重新啟動 Edge 路由器，請執行下列指令：

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

您可以檢查 /opt/apigee 目錄，判斷節點上安裝的元件清單。該目錄包含節點上安裝的每個 Edge 元件的子目錄。每個子目錄都會加上下列前置字元：

  • apigee：Edge 使用的第三方元件。例如：apigee-cassandra
  • edge：Apigee 的 Edge 元件。例如：edge-management-server
  • edge-mint：營利元件。例如 edge-mint-management-server。

元件的完整動作清單取決於元件本身，但所有元件都支援下列動作：

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

設定 Edge 元件

如要在安裝後設定 Edge，請搭配使用 .properties 檔案和 Edge 公用程式。舉例來說，如要在 New Edge UI 上設定 TLS/SSL，請編輯 .properties 檔案，設定必要屬性。變更 .properties 檔案後，您必須重新啟動受影響的 Edge 元件。

.properties 檔案位於 /opt/apigee/customer/application 目錄中。該目錄中的每個元件都有自己的 .properties 檔案。 例如 router.properties 和 management-server.properties。

如要為元件設定屬性，請編輯對應的 .properties 檔案，然後重新啟動元件：

/opt/apigee/apigee-service/bin/apigee-service component restart

例如：

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

更新 Edge 時，系統會讀取 /opt/apigee/customer/application 目錄中的 .properties 檔案。也就是說，更新會保留您在元件上設定的所有屬性。

如要進一步瞭解 Edge 設定，請參閱「如何設定 Edge」。

在節點上安裝 apigee-monit

在節點上完成元件安裝後，您可以視需要新增 apigee-monit 公用程式。apigee-monit 會監控節點上的元件，並在元件失敗時嘗試重新啟動。 詳情請參閱「使用 apigee-monit 進行自我修復」。

將 SymasLDAP 伺服器設為唯讀

如果 Edge 安裝作業包含不需要切換流量的 SymasLDAP 伺服器，建議您將伺服器設為唯讀。方法如下：

  1. 在伺服器上建立 mark_readonly.ldif 檔案，並加入下列程式碼： 
    dn: olcDatabase={2}mdb,cn=config
  changetype: modify
  replace: olcReadOnly
  olcReadOnly: TRUE
  2. 在伺服器上執行下列指令，將伺服器標示為唯讀： 
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

如果主要伺服器故障，您可以按照下列步驟，將待命伺服器切換為主要伺服器：

  1. 在待命伺服器上建立 mark_writable.ldif 檔案，並加入以下這行：
      dn: olcDatabase={2}mdb,cn=config
  changetype: modify
  replace: olcReadOnly
  olcReadOnly: FALSE
  2. 在待命伺服器上執行下列指令： 
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif