How do you add an additional management server?

Not applicable

I would like to add an additional edge-ui/management server to an existing installation so that we have high availability. What is the best way to do that? Thanks!

1 1 521
1 REPLY 1

Not applicable

You will follow the same installation process you use for the initial one but you will require a new response file (configuration file for the setup.sh step). On Edge, each region or each Management Server beyond one require a dedicated response file.

Installation of new Management Server:

curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/apigee/bootstrap_4.17.01.sh
bash /tmp/apigee/bootstrap_4.17.01.sh apigeeuser=<user> apigeepassword=<password>
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/apigee/edge-response-1701-dc1-ms2.txt

Where /tmp/apigee/edge-response-1701-dc1-ms2.txt look as follows:

IP1="Management Server 1"
IP2="Management Server 2"
IP3="Cassandra+Zookeeper 1"
IP4="Cassandra+Zookeeper 1"
IP5="Cassandra+Zookeeper 1"
IP6="Postgres1"
IP7="Postgres2"
HOSTIP="$(hostname -i)"
MSIP="$IP2"
ADMIN_EMAIL="xxxxx@apigee.com"
APIGEE_ADMINPW="xxxxx"
LICENSE_FILE="/tmp/apigee/license.txt"
USE_LDAP_REMOTE_HOST="n"
LDAP_TYPE="2"    # <------- 2 = replication
LDAP_SID="2"     # <------- consecutive
LDAP_PEER="$IP1" # <------- MS 2 peer
APIGEE_LDAPPW="xxxxx"
MP_POD="gateway"
REGION="dc-1"
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER="$IP6"
PG_STANDBY="$IP7"
SKIP_SMTP="n" 
SMTPHOST="smtp.example.com" 
SMTPPORT="25" 
SMTPUSER="smtp@example.com" 
SMTPPASSWORD="smtppwd"
SMTPSSL="n" 
BIND_ON_ALL_INTERFACES="y"

You will need to update your original response file to reconfigure LDAP to know about the new Management Sever by enabling replication. Below example of how the original response file may look.

To reconfigure the existing MS, you need to execute setup.sh on the existing MS 1 using the updated file below:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/apigee/edge-response-1701-dc1-ms1.txt

Where /tmp/apigee/edge-response-1701-dc1-ms1.txt correspond to the original response file used to install the first Management Server updated as follows:

IP1="Management Server 1"
IP2="Management Server 2"
IP3="Cassandra+Zookeeper 1"
IP4="Cassandra+Zookeeper 1"
IP5="Cassandra+Zookeeper 1"
IP6="Postgres1"
IP7="Postgres2"
HOSTIP="$(hostname -i)"
MSIP="$IP1"
ADMIN_EMAIL="xxxxx@apigee.com"
APIGEE_ADMINPW="xxxxx"
LICENSE_FILE="/tmp/apigee/license.txt"
USE_LDAP_REMOTE_HOST="n"
LDAP_TYPE="2"     # <------- 2 = replication
LDAP_SID="1"      # <------- consecutive
LDAP_PEER="$IP2"  # <------- MS 1 peer
APIGEE_LDAPPW="xxxxx"
MP_POD="gateway"
REGION="dc-1"
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER="$IP6"
PG_STANDBY="$IP7"
SKIP_SMTP="n" 
SMTPHOST="smtp.example.com" 
SMTPPORT="25" 
SMTPUSER="smtp@example.com" 
SMTPPASSWORD="smtppwd"
SMTPSSL="n" 
BIND_ON_ALL_INTERFACES="y"