where component is the Edge component to install, and
configFile is the silent configuration file containing the installation
information. The configuration file must be accessible or readable by the "apigee" user. For
example, you can create a new directory for the files, place them in the /usr/local or
/usr/local/share directory, or anywhere else on the node accessible by the "apigee"
user.

For example, to install the Edge Management Server:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Installation considerations

As you write your config file, take into consideration the following options.

Setting up Postgres
master-standby replication

By default, Edge installs all Postgres nodes in master mode. However, in production systems
with multiple Postgres nodes, you must configure them to use master-standby replication so that
if the master node fails, the standby node can continue to serve traffic.

You can enable and configure master-standby replication at install time by using properties in
the silent config file. Or, you can enable master-standby replication after installation. For
more, see Set up Master-Standby
Replication for Postgres.

Enabling Cassandra
authentication

By default, Cassandra installs without authentication enabled. That means anyone can access
Cassandra. You can enable authentication after installing Edge, or as part of the installation
process.

Note: While you can enable authentication when you install Cassandra,
you cannot change the default username and password. You have to perform that step manually after
installation of Cassandra completes.

Using a protected
port when creating a virtual host

If you want to create a virtual host that binds the Router to a protected port, such as port
numbers less than 1000, then you have to configure the Router to run as a user with access to
those ports. By default, the Router runs as the user "apigee" which does not have access to
privileged ports.

Creating a configuration file

The configuration file contains all the information necessary to install Edge. You can often
use the same configuration file to install all components in an Edge installation.

Note: In the configuration file, you must specify all Cassandra nodes
by IP address. Other components can be specified by IP address or DNS name.

However, you will have to use different configuration files, or modify your configuration
file, if:

You are installing multiple OpenLDAP servers and need to configure replication as part of a
13-node installation. Each file requires different values for LDAP_SID and LDAP_PEER.

You are creating multiple data centers as part of a 12-node installation. Each data center
requires different settings for properties such as ZK_CLIENT_HOSTS and CASS_HOSTS.

Each installation topology described below shows an example config file for that topology. For
a complete reference on the config file, see Edge Configuration File Reference.

Warning:Creating a config file on a Windows machine and
then copying it to a Linux machine can add additional end-of-line, carriage return, or newline
characters to the file that are not compatible with all Linux utilites. This situation
can also occur if you copy text from a Windows editor and paste into a Linux window. As an
alternative, you can use the Linux dos2unix utility to clean up a config file
created on Windows. Or, make sure to do all editing of config files in a Linux editor.

Installation log files

By default, the setup.sh utility writes log information about the installation to:

/opt/apigee/var/log/apigee-setup/setup.log

If the user running the setup.sh utility does not
have access to that directory, it writes the log to the /tmp directory as a file
named setup_username.log.

If the user does not have access to /tmp, the setup.sh utility
fails.

Install Edge components

This section describes how to install Edge components for the different topologies. The order
of component installation is based on your desired topology.

All of the installation example shown below assume that you are installing:

Message Processor and Router on the same node. If you install the Message Processors and
Routers on different nodes, install all the Message Processors first, and then all the
Routers.

Note: You must disable SELinux or set it to permissive mode before you
install Edge components. See Install the Edge
apigee-setup utility for more.Note: The Installation
Requirements details the installation prerequisites and provides a list of required files to
obtain before proceeding with the installation. Ensure that you have reviewed the requirements
before beginning the installation process.

12-host clustered installation

Before you install Edge on a12-host clustered topology (two data centers), you must understand
how to set the ZooKeeper and Cassandra properties in the silent config file.

Note: Shown below is a complete config file for both data
centers.

ZooKeeper

For the ZK_HOSTS property for both data centers, specify the IP addresses or DNS names of all
ZooKeeper nodes from both data centers, in the same order, and mark any nodes with the with
“:observer” modifier. Nodes without the “:observer” modifier are called
"voters". You must have an odd number of "voters" in your configuration.

In this topology, the ZooKeeper host on host 9 is the observer:
For the ZK_CLIENT_HOSTS property for each data center, specify the IP addresses or DNS names of
only the ZooKeeper nodes in the data center, in the same order, for all ZooKeeper nodes in the
data center. In the example configuration file shown below, node 9 is tagged with the
“:observer” modifier so that you have five voters: Nodes 1, 2, 3, 7, and 8.

Cassandra
All datacenters must to have the same number of Cassandra nodes.

For CASS_HOSTS for each data center, ensure that you specify all Cassandra IP addresses (not
DNS names) for both data centers. For data center 1, list the Cassandra nodes in that data
center first. For data center 2, list the Cassandra nodes in that data center first. List the
Cassandra nodes in the same order for all Cassandra nodes in the data center.