Riferimento file di configurazione perimetrale

Edge per Private Cloud v. 4.17.01

Di seguito è riportato un esempio di file di configurazione silenzioso completo per un'installazione di Edge con 9 nodi. Modifica questo file in base alle tue esigenze. Utilizza l'opzione -f per setup.sh per includere questo file. Di seguito sono riportati anche file di configurazione di esempio per ogni topologia Edge.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

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

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses (not DNS names) of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Set Postgres password. Default is postgres.
PG_PWD=postgres

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

La seguente tabella contiene informazioni aggiuntive su queste proprietà:

Proprietà

Nota

Nomi IP/DNS

Non utilizzare una mappatura del nome host a 127.0.0.1 o un indirizzo IP di 127.0.0.1 quando specifichi l'indirizzo IP di un nodo.

ADMIN_EMAIL
APIGEE_ADMINPW

La password dell'amministratore di sistema deve essere lunga almeno 8 caratteri e contenere una lettera maiuscola, una lettera minuscola, una cifra o un carattere speciale. Se ometti la password, ti verrà chiesta.

LICENSE_FILE

La posizione del file di licenza, che deve essere accessibile all'utente "apigee". Ad esempio, memorizzalo nella directory /tmp e applica chmod 777 al file. Il file viene copiato nella directory di installazione di Edge.

APIGEE_LDAPPW

Specifica la password OpenLDAP.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Se USE_LDAP_REMOTE_HOST è n, Edge installa automaticamente OpenLDAP quando installa il server di gestione.

Imposta USE_LDAP_REMOTE_HOST su y se ti connetti a un server LDAP remoto. OpenLDAP non è installato con il server di gestione.

Se ti connetti a un server OpenLDAP remoto, utilizza LDAP_HOST
e LDAP_PORT per specificare l'indirizzo IP o il nome DNS e il numero di porta dell'host.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Imposta LDAP_TYPE=1 per OpenLDAP senza replica. LDAP_TYPE=2 corrisponde a OpenLDAP con replica.

Se la topologia perimetrale utilizza un singolo server OpenLDAP, specifica 1. Se l'installazione di Edge utilizza più nodi OpenLDAP, ad esempio in un'installazione di produzione con 13 nodi, specifica 2.

Se abiliti la replica, imposta le proprietà seguenti:

  • LDAP_SID=1: ID univoco per questo server LDAP. Ogni nodo LDAP utilizza un ID diverso. Ad esempio, impostalo su 2 per il peer LDAP.
  • LDAP_PEER=10.0.0.1: nome DNS o IP del peer LDAP.

BIND_ON_ALL_INTERFACES

Se impostato su "y", il router/processore di messaggi esegue il binding (ascolta) su tutte le interfacce (IP). Se impostato su "n", il router/processore di messaggi esegue il binding (ascolta) su un'interfaccia specifica, l'IP restituito dal comando "hostname -i").

MP_POD

Specifica il nome del pod del processore di messaggi e del router. Per impostazione predefinita, il nome è gateway.

REGION

Nome regione. Per convenzione, i nomi sono in genere nel formato dc-#, dove # corrisponde a un valore intero. Ad esempio, dc-1, dc-2 e così via. Puoi utilizzare dc-1, a meno che l'installazione non venga eseguita in un ambiente con più data center.

In un'installazione in più data center, il valore è dc-1, dc-2 e così via, a seconda del data center in cui esegui l'installazione. Tuttavia, non puoi utilizzare solo nomi nel formato dc-#. Puoi utilizzare qualsiasi nome per la regione.

ZK_HOSTS

Gli indirizzi IP o i nomi DNS dei nodi ZooKeeper. Gli indirizzi IP o i nomi DNS devono essere elencati nello stesso ordine su tutti i nodi ZooKeeper.

In un ambiente multi-data center, elenca tutti i nodi ZooKeeper di entrambi i data center.

Specifica il modificatore ":observer" sui nodi ZooKeeper solo quando crei più data center come descritto in un'installazione con 12 host. In un'installazione di un singolo data center, ometti questo modificatore.

ZK_CLIENT_HOSTS

Gli indirizzi IP o i nomi DNS dei nodi ZooKeeper utilizzati da questo data center. Gli indirizzi IP o i nomi DNS devono essere elencati nello stesso ordine su tutti i nodi ZooKeeper.

In un'installazione in un singolo data center, si tratta degli stessi nodi specificati da ZK_HOSTS.

In un ambiente multi-data center, elenca solo i nodi ZooKeeper presenti in questo data center.

CASS_CLUSTERNAME Se vuoi, specifica il nome del cluster Cassandra. Il nome predefinito è "Apigee".

CASS_HOSTS

Gli indirizzi IP (non i nomi DNS) dei nodi Cassandra. I primi due nodi verranno utilizzati come server di seed. Gli indirizzi IP devono essere elencati nello stesso ordine su tutti i nodi Cassandra.

I nodi Cassandra possono avere un suffisso facoltativo ":dc,ra" che specifica il data center e il rack del nodo Cassandra. Specifica questo modificatore solo quando crei più data center come descritto in un'installazione con 12 host. In un'installazione in un singolo data center, ometti questo modificatore.

Ad esempio, '192.168.124.201:1, 1 = data center 1 e rack/zona di disponibilità 1 e '192.168.124.204:2,1 = data center 2 e rack/zona di disponibilità 1.

In un ambiente multi-data center, per superare i problemi relativi al firewall, CASS_HOSTS deve essere ordinato in modo (come mostrato nell'esempio precedente) che i nodi del data center corrente siano posizionati all'inizio.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Se attivi l'autenticazione Cassandra, CASS_AUTH=y, puoi passare il nome e la password dell'utente Cassandra utilizzando queste proprietà.

PG_PWD

Per impostazione predefinita, il database PostgreSQL ha due utenti definiti: "postgres" e "apigee". Entrambi gli utenti hanno una password predefinita di "postgres". Utilizza PG_PWD per impostare la password su un valore diverso per entrambi gli utenti al momento dell'installazione.

PG_MASTER

PG_STANDBY

Impostato per abilitare la replica master-standby di Postgres, nel formato:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Configura SMTP in modo che Edge possa inviare email per password perse e altre notifiche.

Se le credenziali utente SMTP non sono richieste, ometti SMTPUSER e SMTPPASSWORD.