BaaS Configuration File Reference

Edge for Private Cloud v. 4.17.09

Shown below is an example silent configuration file for a 10-node API BaaS installation. Edit this file as necessary for your configuration. Use the -f option to setup.sh to include this file.

# Specify IP address or DNS name of node.
IP1=192.168.1.1   # ElasticSearch
IP2=192.168.1.2   # ElasticSearch
IP3=192.168.1.3   # ElasticSearch
IP4=192.168.1.4   # API BaaS Stack
IP5=192.168.1.5   # API BaaS Stack
IP6=192.168.1.6   # API BaaS Stack
IP7=192.168.1.7   # API BaaS Portal
IP8=192.168.1.8   # Cassandra (shared with Edge or standalone)
IP9=192.168.1.9   # Cassandra (shared with Edge or standalone)
IP10=192.168.1.10  # Cassandra (shared with Edge or standalone)

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Define the API BaaS administrator account.  
AS_ADMIN="superuser"    # User name - default is "superuser".
AS_ADMIN_EMAIL=stackAdmin@email.com
AS_PASSWD=stackAdminPWrod

# Only if you are installing Cassandra.
# Specify Cassandra data center and rack suffix.
# Must use IP addresses for CASS_HOSTS, not DNS names.
# CASS_HOSTS="$IP8:1,1 $IP9:1,1 $IP10:1,1"

# If connecting to existing Cassandra nodes, 
# specify Cassandra IPs.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP8 $IP9 $IP10"

# Cassandra uname/pword.
# Even if Cassandra authentication is disabled,
# you must still pass values for these properties.
CASS_USERNAME=cassandra    # Default value
CASS_PASSWORD=cassandra    # Default value

# Specify BaaS Cassandra connection information.
# Specify the data center name.
BAAS_CASS_LOCALDC=dc-1    # Default is dc-1.

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For example, for dc-1 with three Cassandra nodes, it is dc-1:3.
BAAS_CASS_REPLICATION=dc-1:3

# Defines the initial contact points for members of the BaaS cluster. 
# For a single node install, specify the IP address of the node. 
BAAS_CLUSTER_SEEDS="dc-1:$IP1"

# ElasticSearch IPs or DNS names, separated by spaces.
ES_HOSTS="$IP1 $IP2 $IP3"

# API BaaS Stack information.
# Default cluster name is "apigee_baas"
BAAS_USERGRID_CLUSTERNAME="apigee_baas" 

# URL and port of the load balancer for the API BaaS Stack nodes, 
# or IP/DNS and port 8080 of a single Stack node with no load balancer.
BAAS_USERGRID_URL=http://myloadbalancer:8443

# API BaaS Portal information.
# URL and port number of load balancer, if there is one in front of the Portal,
# or the URL and port of the Portal node.  
BAAS_PORTAL_URL="http://$IP7:9000"

# Portal port. Default value is 9000.
BAAS_PORTAL_LISTEN_PORT=9000 

# SMTP information. BaaS requires an SMTP server.
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPMAILFROM="My Company <myco@company.com>"

The following table contains additional information about these properties:

Property

Note

CASS_HOSTS

If you are installing Cassandra, specify the Cassandra node IPs (not DNS names) and include the “:dc,ra” modifier that specify the data center and rack of the Cassandra node.

For example '192.168.124.201:1,1 = datacenter 1 and rack/availability zone 1, and '192.168.124.204:2,1 = datacenter 2 and rack/availability zone 1.

CASS_USERNAME
CASS_PASSWORD

Cassandra user name and password.

If Cassandra authentication is disabled, you still have to pass these values. However, the values are ignored.

BAAS_CASS_LOCALDC

The region names must be in the form dc-# where # corresponds to an integer value.

For example, dc-1, dc-2, etc. If you are connecting to a Cassandra cluster installed with Edge, you can ask the Edge system administrator for this value. In an Edge single data center installation, the default value is dc-1.

If you installed Cassandra as part of installing the API BaaS, then during Cassandra installation you added the “:dc,ra” modifier to the Cassandra IP addresses. The first value "dc" is the data center number. The data center name is the string "dc-" with the data center number as a suffix.

BAAS_CASS_DC_LIST

Specify the same value as BAAS_CASS_LOCALDC.

BAAS_CASS_REPLICATION

The format is dataCenterName:#CassandraNodes without quotes. For example, for dc-1 with three Cassandra nodes, it is dc-1:3.

For installing a second data center, specify information for both data centers:

BAAS_CASS_REPLICATION=dc-1:3,dc-2:3

BAAS_CLUSTER_SEEDS

Defines the initial contact points for members of the BaaS cluster. Specify a comma separated list of the BaaS Stack seed nodes in the data center, enclosed in double quotes, in the form "dc-#:nodeIP", where dc-# is the name of the data center as defined by BAAS_CASS_LOCALDC.

For a single node install, specify the IP address of the node.

In a production environment with at least three BaaS Stack nodes in the data center, specify two Stack nodes as seeds. Do not specify more than two nodes even when you have three or more Stack nodes.

For multiple data centers, specify only the seed nodes in that data center.

BAAS_USERGRID_URL

In a production environment, this is the URL and port of the load balancer that is in front of the API BaaS Stack nodes, in the form:

http://myStackLoadBalancer:8443

In a testing or development environment, where you only have a single API BaaS Stack node, this can be the URL and port number of an API BaaS Stack node, in the form:

http://stackIPorDNS:8080

The port number for the API BaaS Stack server is 8080.

BAAS_PORTAL_URL

The URL and port number of the load balancer, if there is one in front of the Portal, in the form:

http://myPortalLoadBalancer:8443

If there is no load balancer, the URL and port number of the Portal node, in the form:

http://portalIPorDNS:9000

By default, the port number for the API BaaS Portal is 9000.

BAAS_PORTAL_LISTEN_PORT

The port number for the API BaaS Portal server is 9000. If this port is not available, specify a different port.

If you are setting BAAS_PORTAL_URL to the URL of the Portal node, the port numbers must be the same for both properties.

SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

Configure SMTP so API BaaS can send emails for lost passwords and other notifications.

If SMTP user credentials are not required, omit SMTPUSER and SMTPPASSWORD.