Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Installa i componenti perimetrali su un nodo

Edge for Private Cloud v. 4.16.09

Dopo aver installato l'utilità Edge apigee-setup su un nodo, utilizza l'utilità apigee-setup per installare uno o più componenti Edge sul nodo.

L'utilità apigee-setup utilizza un comando nel formato:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

dove component è il componente Edge da installare e configFile è il file di configurazione invisibile all'utente contenente le informazioni di installazione. Il file di configurazione deve essere accessibile o leggibile dall'utente "apigee". Ad esempio, puoi creare una nuova directory per i file, posizionarli nella directory /usr/local o /usr/local/share o in qualsiasi altro punto del nodo accessibile dall'utente "apigee".

Ad esempio, per installare Edge Management Server:

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

Considerazioni sull'installazione

Quando scrivi il file di configurazione, tieni conto delle seguenti opzioni.

Configurazione della replica master-standby di Postgres

Per impostazione predefinita, Edge installa tutti i nodi Postgres in modalità master. Tuttavia, nei sistemi di produzione con più nodi Postgres, devi configurarli in modo che utilizzino la replica master-standby in modo che, se il nodo master non funziona, il nodo standby possa continuare a gestire il traffico.

Puoi attivare e configurare la replica master-standby al momento dell'installazione utilizzando le proprietà nel file di configurazione silenziosa. In alternativa, puoi attivare la replica master-standby dopo l'installazione. Per saperne di più, consulta Configura la replica master-standby per Postgres.

Abilitazione dell'autenticazione Cassandra

Per impostazione predefinita, Cassandra viene installato senza autenticazione abilitata. Ciò significa che chiunque può accedere a Cassandra. Puoi attivare l'autenticazione dopo aver installato Edge o durante il processo di installazione.

Puoi attivare l'autenticazione Cassandra al momento dell'installazione utilizzando le proprietà nel file di configurazione silenziosa. In alternativa, puoi attivarla dopo l'installazione.

Per saperne di più, consulta Attiva l'autenticazione Cassandra.

Associazione del router a una porta protetta

Se vuoi associare il router a una porta protetta, ad esempio con numeri di porta inferiori a 1024, devi configurare il router in modo che venga eseguito come utente con accesso a queste porte. Per impostazione predefinita, il router viene eseguito come utente "apigee", che non ha accesso alle porte con privilegi.

Per eseguire il router come un altro utente:

Come utente root, crea il file /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Aggiungi la seguente voce al file:
RUN_USER=root
Se non vuoi eseguire il router come root, specifica un utente con accesso alla porta.
Salva il file.
Se hai specificato un utente diverso da root, cambia il proprietario del file in quell'utente:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Riavvia il router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Specifica dei componenti da installare

La tabella seguente elenca le opzioni che passi all'opzione -p dell'utilità apigee-service per specificare i componenti da installare sul nodo:

Componente	Descrizione
c	Installa solo Cassandra.
zk	installare solo ZooKeeper.
ds	Installa ZooKeeper e Cassandra.
ld	Installa solo OpenLDAP.
ms	Installa Edge Management Server, che installa anche la UI di Edge e OpenLDAP. Se imposti USE_LDAP_REMOTE_HOST=y nel file di configurazione, l'installazione di OpenLDAP viene saltata e il server di gestione utilizza OpenLDAP installato su un nodo diverso.
r	Installa solo il router perimetrale.
mp	Installa solo Edge Message Processor.
rmp	Installa il router Edge e il processore di messaggi.
ui	Installa la UI di Edge.
qs	Installa solo il server Qpid.
ps	Installa solo il server Postgres.
sax	Installa i componenti di analisi, ovvero Qpid e Postgres. Utilizza questa opzione solo per lo sviluppo e i test, non per la produzione.
mese	Installa Monetizzazione.
sa	Installa Edge in modalità autonoma, ovvero Cassandra, ZooKeeper, Management Server, OpenLDAP, Edge UI, Router e processore di messaggi. Questa opzione omette i componenti di analisi di Edge: Qpid e Postgres. Utilizza questa opzione solo per lo sviluppo e i test, non per la produzione.
aio	Installa tutti i componenti su un singolo nodo. Utilizza questa opzione solo per lo sviluppo e i test, non per la produzione.

Creazione di un file di configurazione

Il file di configurazione contiene tutte le informazioni necessarie per installare Edge. Spesso puoi utilizzare lo stesso file di configurazione per installare tutti i componenti in un'installazione di Edge.

Tuttavia, dovrai utilizzare file di configurazione diversi o modificare il file di configurazione se:

Stai installando più server OpenLDAP e devi configurare la replica nell'ambito di un'installazione a 13 nodi. Ogni file richiede valori diversi per LDAP_SID e LDAP_PEER.
Stai creando più data center nell'ambito di un'installazione a 12 nodi. Ogni data center richiede impostazioni diverse per proprietà come ZK_CLIENT_HOSTS e CASS_HOSTS.

File di configurazione di esempio

Di seguito è riportato un esempio di file di configurazione silenziosa completo per un'installazione di Edge a 9 nodi. Modifica questo file in base alle tue esigenze di configurazione. Utilizza l'opzione -f per setup.sh per includere questo file. Di seguito sono riportati anche i 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 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=

# 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 tabella seguente contiene ulteriori informazioni su queste proprietà:

Proprietà	Nota
Nomi IP/DNS	Non utilizzare una mappatura del nome host su 127.0.0.1 o un indirizzo IP 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à chiesto di inserirla.
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.
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 viene 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 Edge utilizza un singolo server OpenLDAP, specifica 1. Se l'installazione di Edge utilizza più nodi OpenLDAP, ad esempio in un'installazione di produzione a 13 nodi, specifica 2. Se attivi la replica, imposta le seguenti proprietà: 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 - IP o nome DNS del peer LDAP.
BIND_ON_ALL_INTERFACES	Se impostato su "y", il router/processore di messaggi esegue il binding (ascolto) su tutte le interfacce (IP). Se impostato su "n", il router/processore di messaggi esegue il binding (ascolto) 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 della regione. Per convenzione, i nomi sono in genere nel formato dc-#, dove # corrisponde a un valore intero. Ad esempio, dc-1, dc-2 ecc. Puoi utilizzare dc-1, a meno che l'installazione non avvenga in un ambiente con più data center. In un'installazione di più data center, il valore è dc-1 o dc-2 e così via, a seconda del data center che stai installando. Tuttavia, non sei limitato a 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 con più 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 su 12 host. In un'installazione di un singolo data center, ometti questo modificatore. Per saperne di più, consulta Installazione in cluster con 12 host.
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, questi sono gli stessi nodi specificati da ZK_HOSTS. In un ambiente con più data center, elenca solo i nodi ZooKeeper in questo data center. Per saperne di più, consulta Installazione in cluster con 12 host.
CASS_HOSTS	Gli indirizzi IP (non i nomi DNS) dei nodi Cassandra. I primi due nodi verranno utilizzati come server 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 di un singolo data center, ometti questo modificatore. Ad esempio, "192.168.124.201:1,1" = data center 1 e rack/zona di disponibilità 1, mentre "192.168.124.204:2,1" = data center 2 e rack/zona di disponibilità 1. In un ambiente con più data center, per superare i problemi del firewall, CASS_HOSTS deve essere ordinato in modo (come mostrato nell'esempio precedente) che i nodi del data center corrente siano posizionati all'inizio. Per saperne di più, consulta Installazione in cluster con 12 host.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Se attivi l'autenticazione Cassandra, CASS_AUTH=y, puoi passare il nome utente e la password di Cassandra utilizzando queste proprietà.
PG_MASTER PG_STANDBY	Imposta per attivare 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 le password perse e altre notifiche. Se le credenziali utente SMTP non sono richieste, ometti SMTPUSER e SMTPPASSWORD.

Ordine di installazione dei componenti

L'ordine di installazione dei componenti si basa sulla topologia che preferisci.

Tutti gli esempi di installazione mostrati di seguito presuppongono che tu stia installando:

Con l'autenticazione Cassandra disattivata (impostazione predefinita). Per saperne di più, consulta Attiva l'autenticazione Cassandra.
Con la replica master-standby di Postgres disattivata (impostazione predefinita). Per saperne di più, consulta Configura la replica master-standby per Postgres.
Processore di messaggi e router sullo stesso nodo. Se installi i processori di messaggi e i router su nodi diversi, installa prima tutti i processori di messaggi e poi tutti i router.

File di log di installazione

Per impostazione predefinita, l'utilità setup.sh scrive le informazioni di log sull'installazione in:

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

Se l'utente che esegue l'utilità setup.sh non ha accesso a quella directory, scrive il log nella directory /tmp come file denominato setup_username.log.

Se l'utente non ha accesso a /tmp, l'utilità setup.sh non va a buon fine.