Send Docs Feedback

Onboard an organization

Edge for Private Cloud v. 4.16.09

Use the setup-org command to perform the onboarding process. You must run the command on the Management Server node.

As part of the onboarding process, the script:

  • Optionally creates a new user to function as the organization administrator.
  • Creates the organization.
  • Adds the specified user as the org admin. The user must already exist; otherwise the script issues an error. 
  • Associates the organization with a pod, by default is associates it with the "gateway" pod.
  • Create an environment.
  • Create a virtual host for the environment.
  • Associate the environment with all Message Processor(s).
  • Enables analytics.

You cannot create two organizations with the same name. In that case, the second create will fail 

Silent configuration file for onboarding

Pass a configuration file to the setup-org command. Invoke the setup-org command and specify the -f option, including the path to the silent configuration file:

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

The only requirement on silent installations is that the configuration file must be accessible or readable by the "apigee" user. For example, put the file in the /tmp directory on the node. 

Shown below is an example silent configuration file. Edit it as necessary for your requirements:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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

# 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.

Notes:

  • For VHOST_ALIAS, if you already have a DNS record that you will use to access to the virtual host, specify the host alias and optionally the port, for example, “myapi.example.com”. 

    If you do not yet have a DNS record, see Setting up a virtual host for more information.
  • For TLS/SSL configuration, see Keystores and Truststores and Configuring TLS access to an API for the Private Cloud for more information on creating the JAR file, and other aspects of configuring TLS/SSL.

Onboarding

  1. Install apigee-provision on the Management Server node:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Run the command on the Management Server node:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    The configuration file must be accessible or readable by the "apigee" user. For example, put the file in the /tmp directory on the node.

Onboarding Verification 

On completion of onboarding, verify the status of the system by issuing the following CURL commands on the  Management Server node.  

  1. Check for user and organization status on the Management Server by issuing the following CURL commands:
    > 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. If you enabled analytics, then use this command:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. You can also check the PostgreSQL database status by running the following command on Machine 2 to start psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    At the command prompt, enter the following command to view the analytics table for your organization:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Use the following command to exit psql:
    apigee=# \q
  4. Access the Apigee Edge user interface using a web browser. Remember that you already noted the management console URL at the end of the installation.
    1. Launch your preferred browser and enter the URL of the Edge UI. It looks similar to the following, where the IP address is for Machine 1, or for whichever machine you installed the UI on for alternative configurations: 
      http://192.168.56.111:9000/login

      9000 is the port number used by the UI. If you are starting the browser directly on the server hosting the Edge UI, then you can use a URL in the form:
      http://localhost:9000/login

      Note: Ensure that port 9000 is open.
    2. On the console login page, specify the Apigee system admin username/password.
      Note: This is the global system administrator password that you have set during the installation. Alternately, you can:
  5. Sign up for a new Apigee user account and use the new user credential to login.
    1. Click Sign In, the browser redirects to:
      http://192.168.56.111:9000/platform/#/<orgname>/ 

      and opens a dashboard which allows you to configure the organization created before (if logged in using Apigee admin credentials).
    2. If you are new to Edge, you can now create your first API proxy. For more information, see the following tutorials:

       

Help or comments?