私有雲版本 4.17.01 版本
使用 setup-org 指令來執行新手上路程序。您必須在管理伺服器節點上執行指令。
在新手上路流程中，指令碼會如下：
- 建立機構。
- 將指定的使用者設為機構管理員。
- 該使用者必須與系統管理員使用者不同。也就是說，請勿將 sys 管理員使用者設為機構管理員使用者。
- 您可以為機構管理員指定現有的使用者，或是設定指令碼來建立新使用者。
- 根據預設，系統會將機構與 Pod 建立關聯，並將其與「閘道」Pod 建立關聯。
- 建立環境。
- 為環境建立虛擬主機。
- 將環境與所有訊息處理器建立關聯。
- 啟用數據分析。
新手上路的設定檔
將設定檔傳遞至 setup-org 指令。叫用 setup-org 指令並指定 -f 選項，包括靜音設定檔的路徑：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
靜音安裝的唯一條件是，設定檔必須可供「Apigee」使用者存取或讀取。
下方是靜音設定檔的範例。然後視需要編輯：
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=adminPassword # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
注意事項：
- 如果已有用來存取虛擬主機的 DNS 記錄，請指定 VHOST_ALIAS 的 DNS 記錄，並指定主機別名，並視需要指定通訊埠，例如「myapi.example.com」。如果您沒有 DNS 記錄，可以使用路由器的 IP 位址。
如要進一步瞭解如何設定虛擬主機，請參閱「Edge Demo 安裝規定」。 - 如需傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 的設定資訊，請參閱「KeyStores 和 Truststores」和「設定私有雲的傳輸層安全標準 (TLS) 存取權」一文，進一步瞭解如何建立 JAR 檔案和設定 TLS/SSL 的其他設定資訊。
新手上路程序
- 在管理伺服器節點中安裝 apigee-provision：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision 安裝 - 在「管理伺服器」節點上執行指令：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
設定檔必須能讓使用者存取或讀取設定檔。
新手上路驗證
完成新手上路程序後，請在管理伺服器節點上發出下列 CURL 指令，驗證系統狀態。
- 發出下列 CURL 指令，藉此確認管理伺服器的使用者和機構狀態：
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations
<管理員密碼>> - 如果您已啟用數據分析功能，請使用下列指令：
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/Provisioning/axstatus - 您也可以在機器 2 上執行下列指令，查看 PostgreSQL 資料庫狀態，以便啟動 psql：
> psql -h /opt/apigee/var/run/apigee-postgresql -U Apigee Apigee
在命令提示字元中，輸入下列指令： - 使用網路瀏覽器存取 Apigee Edge 使用者介面。請記住，您記下安裝結尾的管理控制台網址。
- 啟動偏好的瀏覽器，並輸入 Edge UI 的網址。看起來會像下方這樣，其中的 IP 位址代表機器 1，或是您安裝 UI 以進行其他設定的機器：
http://192.168.56.111:9000/login
9000 是 UI 使用的通訊埠編號。如果您直接在代管 Edge UI 的伺服器上啟動瀏覽器，可以使用格式如下：
http://localhost:9000/login
注意：確認通訊埠 9000 已開啟。 - 在控制台登入頁面上，指定 Apigee 系統管理員的使用者名稱/密碼。
注意：這是您在安裝期間設定的全域系統管理員密碼。或者，您可以執行下列操作：
- 啟動偏好的瀏覽器，並輸入 Edge UI 的網址。看起來會像下方這樣，其中的 IP 位址代表機器 1，或是您安裝 UI 以進行其他設定的機器：
- 註冊新的 Apigee 使用者帳戶，並使用新使用者憑證登入。
- 按一下「Sign in」(登入)，瀏覽器將重新導向至：
http://192.168.56.111:9000/platform/#/<orgname>/
並開啟資訊主頁，讓您設定先前建立的機構 (如果使用 Apigee 管理員憑證登入的話)。 - 如果您是第一次使用 Edge，可以建立第一個 API Proxy。詳情請參閱「建構第一個 API Proxy」。
另請參閱範例 (包含範例清單) 中的範例，以及可在 Mock Target API 自己的 API 建構實驗中使用的模擬目標 REST REST API。
- 按一下「Sign in」(登入)，瀏覽器將重新導向至：