為機構註冊

Edge for Private Cloud 4.17.09 版

使用 setup-org 指令執行新手上路程序。您必須在管理伺服器節點上執行指令。

在新手上路程序中，指令碼會執行下列操作：

  • 建立組織。
  • 將指定使用者設為組織管理員。
    • 這位使用者不得與系統管理員使用者相同。也就是說，請勿將系統管理員使用者設為機構組織管理員使用者。
    • 您可以為組織管理員指定現有使用者，或設定指令碼來建立新使用者。
  • 將組織與 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.

注意事項：

  • 如果是 VHOST_ALIAS，且您已有要用於存取虛擬主機的 DNS 記錄，請指定主機別名和通訊埠 (選用)，例如「myapi.example.com」。如果您還沒有 DNS 記錄，可以使用路由器的 IP 位址。

    如要進一步瞭解如何設定虛擬主機，請參閱「設定虛擬主機」。
  • 如要瞭解 TLS/SSL 設定，請參閱「KeyStore 和 TrustStore」和「設定私有雲 API 的 TLS 存取權」，進一步瞭解如何建立 JAR 檔案，以及設定 TLS/SSL 的其他方面。
  • 如要進一步瞭解如何設定虛擬主機，請參閱「設定私有雲 API 的 TLS 存取權」。

新手上路程序

  1. 在管理伺服器節點上安裝 apigee-provision：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 在管理伺服器節點上執行指令：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    「apigee」使用者必須能存取或讀取設定檔。

新手上路驗證

完成新手上路程序後，請在管理伺服器節點上發出下列 CURL 指令，驗證系統狀態。

  1. 發出下列 CURL 指令，檢查管理伺服器上的使用者和組織狀態：
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments
  2. 如果您已啟用數據分析，請使用下列指令：
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. 您也可以在機器 2 上執行下列指令，啟動 psql，檢查 PostgreSQL 資料庫狀態：
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    在命令提示字元中輸入下列指令，查看貴組織的數據分析資料表：
    apigee=# : \d analytics."<orgname>.prod.fact"

    使用下列指令退出 psql：
    apigee=# \q
  4. 使用網路瀏覽器存取 Apigee Edge 使用者介面。請注意，您在安裝結束時已記下管理控制台網址。
    1. 啟動偏好的瀏覽器，然後輸入 Edge UI 的網址。網址看起來會像下方這樣，其中 IP 位址是機器 1 的 IP 位址，或您安裝 UI 的機器 IP 位址 (如果是其他設定)：
      http://192.168.56.111:9000/login

      9000 是 UI 使用的通訊埠編號。如果您直接在託管 Edge UI 的伺服器上啟動瀏覽器，則可以使用以下格式的網址：
      http://localhost:9000/login

      注意：請確認通訊埠 9000 已開啟。
    2. 在控制台登入頁面，指定 Apigee 系統管理員使用者名稱/密碼。
      注意：這是您在安裝期間設定的全域系統管理員密碼。你也可以：
  5. 註冊新的 Apigee 新使用者帳戶，並使用新的使用者憑證登入。
    1. 按一下「Sign In」，瀏覽器會重新導向至：
      http://192.168.56.111:9000/platform/#/<orgname>/

      並開啟資訊主頁，讓您設定先前建立的組織 (如果使用 Apigee 管理員憑證登入)。
    2. 如果您是 Edge 新手，現在可以建立第一個 API Proxy。詳情請參閱「建構第一個 API Proxy」。

      另請參閱範例相關章節，包括範例清單，以及可用於 API 建構實驗的模擬目標 RESTful API，詳情請參閱「模擬目標 API」。