Questa pagina è stata tradotta dall'API Cloud Translation.

Installa i componenti perimetrali su un nodo

Edge per Private Cloud v. 4.16.05

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 silenziosa contenente le informazioni di installazione. Il file di configurazione deve essere accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /tmp sul nodo.

Ad esempio, per installare Edge Management Server:

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

Considerazioni sull'installazione

Quando scrivi il file di configurazione, prendi in considerazione le opzioni seguenti.

Configurazione della replica master in standby 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 da utilizzare la replica in standby master in modo che, in caso di errore del nodo master, il nodo standby possa continuare a gestire il traffico.

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

Attivazione dell'autenticazione Cassandra

Per impostazione predefinita, Cassandra esegue l'installazione senza autenticazione abilitata. Ciò significa che chiunque può accedere a Cassandra. Puoi abilitare l'autenticazione dopo aver installato Edge o durante la procedura di installazione.

Puoi attivare l'autenticazione Cassandra come ora di installazione utilizzando le proprietà nel file di configurazione silenziosa. In alternativa, puoi abilitarlo dopo l'installazione.

Per ulteriori informazioni, consulta Attivare l'autenticazione Cassandra.

Associazione del router a una porta protetta

Se vuoi associare il router a una porta protetta, ad esempio 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 utente diverso:

Come root, crea il file /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Aggiungi la voce seguente 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 scegliendolo come utente:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Riavvia router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router reboot

Specifica dei componenti da installare

La seguente tabella elenca le opzioni passate all'opzione -p dell'utilità apigee-service per specificare quali componenti installare sul nodo:

Componente	Descrizione
	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 Edge e OpenLDAP. Se imposti USE_LDAP_REMOTE_HOST=y nel file di configurazione, l'installazione di OpenLDAP viene ignorata e il server di gestione utilizza OpenLDAP installato su un nodo diverso.
r	Installa solo il router Edge.
mp	Installa solo processore di messaggi Edge.
RMP	Installa il router Edge e il processore di messaggi.
ui	Installa l'UI di Edge.
qs	Installa solo Qpid Server.
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	Monetizzazione delle installazioni.
sa	Installa Edge in modalità autonoma, ovvero Cassandra, ZooKeeper, Management Server, OpenLDAP, UI Edge, router e processore di messaggi. Questa opzione omette i componenti di analisi Edge: Qpid e Postgres. Utilizza questa opzione solo per lo sviluppo e i test, non per la produzione.
Aio	Installare 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 l'installazione di Edge. Spesso puoi utilizzare lo stesso file di configurazione per installare tutti i componenti di un'installazione 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 come parte 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.

Esempio di file di configurazione

Di seguito è riportato un esempio di file di configurazione invisibile all'utente completo per un'installazione Edge a nove nodi. Modifica questo file come necessario per la tua configurazione. Utilizza l'opzione -f per setup.sh per includere questo file. Di seguito sono anche mostrati di seguito 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 informazioni aggiuntive su queste proprietà:

Proprietà	Nota
Nomi IP/DNS	Non utilizzare una mappatura dei nomi host su 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 costituita da almeno 8 caratteri e contenere una lettera maiuscola, una lettera minuscola, una cifra o un carattere speciale. Se ometti la password, ti verrà chiesta la password.
LICENSE_FILE	La posizione del file di licenza, che deve essere accessibile all'utente "apigee". Ad esempio, archivialo nella directory /tmp e in chmod 777 sul 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 stai connettendo 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 Edge utilizza un singolo server OpenLDAP, specifica 1. Se l'installazione Edge utilizza più nodi OpenLDAP, ad esempio un'installazione di produzione a 13 nodi, specifica 2 nodi. Se abiliti la replica, imposta le seguenti proprietà: LDAP_SID=1 - ID univoco del server LDAP. Ogni nodo LDAP utilizza un ID diverso. Ad esempio, puoi impostare il valore 2 per il peer LDAP. LDAP_PEER=10.0.0.1 - Nome IP o DNS del peer LDAP.
BIND_ON_ALL_INTERFACES	Se impostato su "y", il router/elaboratore di messaggi esegue il binding (ascolto) su tutte le interfacce (IP). Se impostato su "n", il router/elaboratore di messaggi associa (ascolta) su un'interfaccia specifica, l'IP restituito dal comando "hostname -i".
MP_POD	Specifica il nome del processore di messaggi e del pod del router. Per impostazione predefinita, il nome è gateway.
REGIONE	Nome della regione. Per convenzione, i nomi sono generalmente 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 non venga installato in un ambiente multi-data center. In un'installazione con più data center, il valore è dc-1, dc-2 e così via, a seconda del data center che stai installando. Tuttavia, non sei obbligato a utilizzare solo i 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 a 12 host. In una singola installazione di data center, ometti questo modificatore. Per ulteriori informazioni, consulta Installazione in cluster su 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 una singola installazione di 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. Per ulteriori informazioni, consulta Installazione in cluster su 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 ":dc,ra" facoltativo 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 a 12 host. In una singola installazione di 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 del firewall, CASS_HOSTS deve essere ordinato in modo (come mostrato nell'esempio sopra) in modo che i nodi del data center attuale si trovino all'inizio. Per ulteriori informazioni, consulta Installazione in cluster su 12 host.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Se abiliti l'autenticazione Cassandra, CASS_AUTH=y, puoi passare il nome utente e la password Cassandra utilizzando queste proprietà.
PG_MASTER PG_STANDBY	Imposta l'abilitazione della replica master in standby 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 in caso di 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 desiderata.

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

Con l'autenticazione Cassandra disattivata (impostazione predefinita). Per saperne di più, vedi Attivare l'autenticazione Cassandra.
Con la replica master in standby Postgres disabilitata (impostazione predefinita). Per saperne di più, consulta Configurare la replica master-in standby per Postgres.
Il processore di messaggi e il router sono sullo stesso nodo. Se installi i processori e i router di messaggi su nodi diversi, installa prima tutti i processori di messaggi, 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 questa directory, il log viene scritto nella directory /tmp come file denominato setup_username.log.

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