安裝完成後

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

任務	說明
對 Edge 元件叫用指令	使用 apigee-service 公用程式來啟動、停止、重新啟動，以及取得各個 Edge 元件的狀態。
設定 Edge 元件	使用屬性檔案變更預設 Edge 元件設定。
執行 apigee-validate	叫用測試指令碼，確保成功安裝每個元件。
whatshot 調整 JVM 堆積設定	最佳化每個節點的 Java 記憶體設定。
管理 LDAP 密碼政策	變更預設 LDAP 密碼並調整各種驗證設定。
在節點中安裝 apigee-monit	安裝並使用可監控節點上的元件的工具，如果元件失敗，並嘗試重新啟動這些元件。
變更預設的 PostgreSQL 密碼	Apigee 建議您在安裝私有雲的 Edge 後變更預設的 PostgreSQL 密碼，以便維護資料安全。
設定 PostgreSQL 清除工作	刪去數據分析服務收集的過量資料。
設定 Cassandra 節點工具維修	您應定期維護 Cassandra 環，以確保所有節點的一致性。
啟用自動開始功能	指示 Private Cloud 在重新啟動時自動重新啟動。
安裝新的 Edge UI	Apigee 建議您安裝新的 Edge UI，這是適用於 Private Cloud 的 Apigee 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 (魁北克)
• apigee-sso (邊緣單一登入)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (管理伺服器)
• edge-management-ui (新版 Edge UI)
• edge-message-processor (訊息處理器)
• edge-postgres-server (Postgres 伺服器)
• edge-qpid-server (快速伺服器)
• edge-router (邊緣路由器)
• edge-ui (傳統版 UI)

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

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

/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 公用程式的組合。舉例來說，如要在 Edge UI 上設定 TLS/SSL，您可以編輯 .properties 檔案，設定必要的屬性。如要變更 .properties 檔案，您必須重新啟動受影響的邊緣元件。

.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 檔案。這表示更新會保留您在元件上設定的所有屬性。

如要進一步瞭解邊緣設定，請參閱如何設定邊緣一文。

在節點中安裝 apigee-monit

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

將 OpenLDAP 伺服器設為唯讀狀態

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

1. 在伺服器上建立 mark_readonly.ldif 檔案，並加入以下程式碼：

   dn: olcDatabase={2}bdb,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}bdb,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