向组织添加徽章

适用于私有云的 Edge v4.18.05

使用 setup-org 脚本执行初始配置流程。您必须运行 脚本。

如要对组织进行初始配置，请按以下步骤操作：

1. 在管理服务器节点上安装 apigee-provision：

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision install

2. 在管理服务器节点上运行 setup-org 脚本：

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

   配置文件必须可供“apigee”读取用户。如需查看示例配置 文件，请参阅初始配置配置文件。

3. 验证您是否已成功完成组织的初始配置。一种方法是记录 通过在浏览器中请求以下网址，导入到界面中：

   http://IP_address:9000/login

   其中 IP_address 是您安装 Edge 的服务器的 IP 地址 界面。

   如需了解其他验证步骤，请参阅验证初始配置。

4. 创建您的第一个代理！

初始配置配置文件

如需使用 setup-org 脚本执行静默配置，请传递一个配置 文件，如以下示例所示：-f

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

本部分包含一个示例配置文件，该配置文件可通过 setup-org。

在对组织进行初始配置时，setup-org 脚本会执行以下操作：

• 创建新组织。
• 创建环境。
• 为环境创建虚拟主机。
• 将指定用户设置为组织管理员。请注意： <ph type="x-smartling-placeholder">
  </ph>
  • 您可以使用现有用户，也可以为组织管理员创建一个新用户。
  • 组织管理员不得与系统管理员相同。
• 将组织与“网关”相关联Pod。（这是默认值，不能 changed.)
• 将环境与所有消息处理器相关联。
• 启用分析功能。

请复制以下示例，并根据需要进行修改，以进行组织的初始配置：

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=admin_password  # 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
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
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  # lowercase only

# 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 配置，请参阅密钥库和 信任存储区和配置 对私有云 API 的 TLS 访问。详细了解如何创建 JAR 文件。 以及配置 TLS/SSL 的其他方面
• 要详细了解如何配置虚拟主机，请参阅为安全配置配置 TLS 访问 适用于私有云的 API。
• 您不能创建两个同名的组织。在这种情况下，第二次创建 失败。

有关使用 Management API 对组织进行初始配置的详细信息，请参阅 创建组织、环境 和虚拟主机。

验证初始配置

完成初始配置后，通过发出以下 C网址 来验证系统的状态 命令：

1. 通过执行以下命令，检查管理服务器上的用户和组织状态 命令：

   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/org_name/deployments

2. 通过执行以下命令来检查分析数据：

   curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

3. 通过在节点 2 上执行以下命令来检查 PostgreSQL 数据库状态（如下所示 在安装拓扑中）：

   psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

   在命令提示符处输入以下命令，以查看 组织：

   \d analytics."org_name.env_name.fact"

   使用以下命令退出 psql：

   \q

4. 使用网络浏览器访问 Apigee Edge 界面。请注意，您已经注意到 管理控制台网址。
   1. 启动首选浏览器，然后输入 Edge 界面的网址。它看起来类似于 其中 IP 地址代表节点 1（如 安装拓扑）的节点，或者 您为备用配置安装了界面：

      http://192.168.56.111:9000/login

      9000 是界面使用的端口号。

      如果您是直接在托管 Edge 界面的服务器上启动浏览器，那么您需要 可以使用以下形式的网址：

      http://localhost:9000/login

   2. 在控制台登录页面上，指定 Apigee 系统管理员用户名/密码。
5. 注册新的 Apigee 用户账号，然后使用新用户凭据登录。在 控制台登录页面，点击登录按钮。

   浏览器重定向至 http://192.168.56.111:9000/platform/#/org_name/ 并打开一个信息中心，供您配置所创建的组织（如果您已 使用 Apigee 管理凭据）。

创建您的第一个代理

在您与新组织完成初始配置并验证新手入门流程 您现在可以创建您的第一个代理了。如需了解详情，请参阅构建您的第一个 API 代理。

其他可能对您有用的资源包括：

• 示例列表
• 您可以使用的模拟目标 RESTful API 构建自己的 API