Riferimento file di configurazione perimetrale

Di seguito è riportato un esempio di un file di configurazione silenziosa completo per un'installazione Edge a 9 nodi. Modifica questo file in base alle esigenze della tua configurazione. Utilizza l'opzione -f per setup.sh per includere questo file. Per esempi di file di configurazione specifici per ogni topologia, consulta Installare i componenti Edge.

    # IP address or DNS name of nodes.
    IP1=192.168.1.1  # Management Server, SymasLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name)
    IP2=192.168.1.2  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
    IP3=192.168.1.3  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
    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)
    
    # Specify "y" to check that the system meets the CPU and memory requirements
    # for the component being installed. See Installation Requirements for requirements
    # for each component. The default value is "n" to disable check.
    ENABLE_SYSTEM_CHECK=n
    
    # When "hostname -i" returns multiple IP addresses,
    # set to "y", to have the installer prompt you to select the IP address to use.
    ENABLE_DYNAMIC_HOSTIP=n
    
    # 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.
    
    # SymasLDAP information.
    # Set to y if you are connecting to a remote LDAP server.
    # If n, Edge installs SymasLDAP when it installs the Management Server.
    USE_LDAP_REMOTE_HOST=n
    
    # If connecting to remote SymasLDAP server, specify the IP/DNS name and port.
    # LDAP_HOST=$IP1    # IP or DNS name of SymasLDAP node.
    # LDAP_PORT=10389   # Default is 10389.
    APIGEE_LDAPPW=yourLdapPassword
    
    # Specify SymasLDAP 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.
    
    # 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.
    
    # If you are using region names other than dc-1, dc-2 etc, set this property to map your region
    # name to the appropriate dc-x format region name. This property is required by Management server
    # to appropriately register Cassandra data stores based on Cassandra's data centers and regions.
    REGION_MAPPING="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>:dc-x"
    
    # 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.
    
    # Space-separated IP addresses of the Cassandra hosts (previously defined; do not use DNS names)
    # Syntax is: IP_address:host_number,rack_number
    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=''
    
    # Postgres username and password as set when you installed Edge.
    # Default is apigee:postgres.
    PG_USER=apigee
    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.
    SMTPMAILFROM="My Company <myco@company.com>"
    
    # The following four properties are only effective for Management server:
    # Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication.
    # CASS_JMX_USERNAME =
    # CASS_JMX_PASSWORD =
    
    # Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra.
    # JMX Truststore file should be readable by Apigee user
    # CASS_JMX_TRUSTSTORE =
    # CASS_JMX_TRUSTSTORE_PASS =
    
    # Set up username and password to access Qpid broker's management console
    
    QPID_MGMT_USERNAME=qpid
    QPID_MGMT_PASSWORD=Apigee1234
    

La tabella seguente contiene ulteriori informazioni su queste proprietà:

Proprietà Nota
Nomi IP/DNS Non utilizzare un mapping 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.

Tieni presente che per le definizioni degli host Cassandra devi utilizzare solo indirizzi IP; non utilizzare nomi DNS nomi.

ENABLE_SYSTEM_CHECK

Se "y", controlla che il sistema soddisfi i requisiti di CPU e memoria per il componente da installare. Per i requisiti di ogni componente, consulta Installation Requirements.

Il valore predefinito è "n" per disattivare il controllo.

ENABLE_DYNAMIC_HOSTIP

Se un server ha più schede di interfaccia, il comando "hostname -i" restituisce un elenco di indirizzi IP separati da spazi. Per impostazione predefinita, il programma di installazione di Edge utilizza il primo indirizzo IP restituito, che potrebbe non essere corretto in tutte le situazioni. In alternativa, puoi impostare la seguente proprietà nel file di configurazione dell'installazione.

Se impostato su "y", il programma di installazione ti chiede di selezionare l'indirizzo IP da utilizzare nell' installazione. Il valore predefinito è "n".

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à richiesta.

Al termine dell'installazione, Apigee consiglia di rimuovere la password da il file di configurazione.

LICENSE_FILE

La posizione del file di licenza, a cui deve poter accedere l'utente "apigee". Ad esempio, archivialo nella directory /tmp ed esegui chmod 777 sul file. Il file viene copiato nella directory di installazione di Edge.

APIGEE_LDAPPW

Specifica la password di SymasLDAP.

Al termine dell'installazione, Apigee consiglia di rimuovere la password da il file di configurazione.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

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

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

Se ti connetti a un server SymasLDAP 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 SymasLDAP senza replica. LDAP_TYPE=2 corrisponde a SymasLDAP con replica.

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

Se abiliti la replica, imposta le seguenti proprietà:

  • LDAP_SID=1: ID univoco per questo server LDAP. Ogni nodo LDAP utilizza un ID diverso. Ad esempio, imposta su 2 per il peer LDAP.
  • LDAP_PEER=10.0.0.1: indirizzo IP o nome DNS del peer LDAP.
MP_POD Specifica il nome del pod processore di messaggi e 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 e così via. Puoi utilizzare dc-1 a meno che non esegui l'installazione in un ambiente con più data center.

In un'installazione con più data center, il valore è dc-1, dc-2 e così via, a seconda di quale data center stai installando. Tuttavia, non sei limitato a utilizzare solo nomi nel formato dc-#. Puoi utilizzare qualsiasi nome per la regione.

REGION_MAPPING

Se utilizzi nomi di regioni diversi da dc-1, dc-2 e così via, imposta questa proprietà per mappare il nome della regione al nome della regione nel formato dc-x appropriato. Questa proprietà è richiesta dal server di gestione per registrare correttamente i datastore Cassandra in base ai data center e alle regioni di Cassandra.

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.

Utilizza lo stesso formato per HOSTIP che utilizzi per ZK_HOSTS. Ovvero, se specifichi l'indirizzo IP per ZK_HOSTS, utilizza un indirizzo IP per HOSTIP. Se utilizzi un DNS, utilizza un nome DNS per entrambi.

In un ambiente con più data center, elenca tutti i nodi ZooKeeper di entrambi i data centri.

Specifica il modificatore ":observer" sui nodi ZooKeeper solo quando crei più data center, come descritto in un'installazione a 12 host. In un'installazione con un singolo data center, ometti il modificatore. Per saperne di più, consulta Installazione cluster a 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.

Utilizza lo stesso formato per HOSTIP che utilizzi per ZK_CLIENT_HOSTS. Ovvero, se specifichi l'indirizzo IP per ZK_CLIENT_HOSTS utilizza un indirizzo IP per HOSTIP. Se utilizzi un DNS, utilizza un nome DNS per entrambi.

In un'installazione con 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 cluster a 12 host.

CASS_CLUSTERNAME Facoltativamente, specifica il nome del cluster Cassandra. Il nome predefinito è "Apigee".
CASS_HOSTS

Specifica un elenco separato da virgole degli indirizzi IP host (non dei nomi DNS) dei nodi Cassandra e, facoltativamente, il numero del data center e il rack a cui appartengono.

Per le topologie di produzione, in questo elenco devono essere presenti almeno tre nodi. I primi due nodi vengono utilizzati come "server seed". Di conseguenza, gli indirizzi IP devono essere elencati nello stesso ordine su tutti i nodi Cassandra.

La sintassi per ogni voce dell'elenco è la seguente:

IP_address[:data_center_number,rack_number]

I nodi Cassandra possono specificare facoltativamente il data center e il rack del nodo Cassandra. Specifica il modificatore data_center_number solo quando crei più data center, come descritto in un'installazione a 12 host. In un'installazione con un singolo data center ometti il 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 con più data center, per risolvere i problemi del firewall, CASS_HOSTS deve essere ordinato in modo che i nodi del data center corrente vengano inseriti all'inizio (come mostrato nell'esempio precedente). Per saperne di più, consulta Installazione cluster a 12 host.

Per informazioni su come specificare il rack_number per un host Cassandra, consulta Aggiungere il supporto per i rack Cassandra.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

Al termine dell'installazione, Apigee consiglia di rimuovere la password da il file di configurazione.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG controlla la modalità di registrazione delle modifiche ai file di configurazione. Se imposti CONFIG_DELTA_LOG=y, le modifiche alla configurazione di un componente non vengono registrate.

PG_USER
PG_PWD

Per impostazione predefinita, il database PostgreSQL ha due utenti definiti: "postgres" e "apigee".

PG_USER ti consente di modificare il nome utente dell'utente "apigee". Non puoi modificare il nome dell'utente "postgres".

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

Al termine dell'installazione, Apigee consiglia di rimuovere la password da il file di configurazione.

PG_MASTER
PG_STANDBY

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

PG_MASTER=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

SMTPMAILFROM è obbligatorio.

CASS_JMX_USERNAME Nome utente JMX di Cassandra. Obbligatorio se hai abilitato l'autenticazione JMX di Cassandra.
CASS_JMX_PASSWORD Password JMX di Cassandra. Obbligatorio se hai abilitato l'autenticazione JMX di Cassandra.
CASS_JMX_TRUSTSTORE Nome utente del truststore SSL JMX di Cassandra, se hai abilitato JMX basato su SSL in Cassandra. Il file del truststore JMX deve essere leggibile dall'utente Apigee.
CASS_JMX_TRUSTSTORE_PASS Password del truststore SSL JMX di Cassandra, se hai abilitato JMX basato su SSL in Cassandra.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
Queste credenziali forniscono l'accesso alla Console di gestione web di Qpid del broker Qpid . La Console di gestione web fornisce un'interfaccia semplice e intuitiva per la gestione e il controllo del broker Qpid.

Oltre alle proprietà elencate qui, esistono proprietà per la configurazione di Apigee mTLS. Per saperne di più, consulta Configurare Apigee mTLS.