Referência do arquivo de configuração do Edge

Edge para nuvem privada v. 4.17.01

Veja abaixo um exemplo de um arquivo de configuração silencioso completo para uma instalação do Edge com nove nós. Edite esse arquivo conforme necessário para sua configuração. Use a opção -f para setup.sh e incluir esse arquivo. Também são mostrados abaixo exemplos de arquivos de configuração para cada topologia de borda.

# 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.

A tabela a seguir contém informações adicionais sobre essas propriedades:

Propriedade

Observação

Nomes de IP/DNS

Não use um mapeamento de nome de host para 127.0.0.1 ou um endereço IP 127.0.0.1 ao especificar o endereço IP de um nó.

ADMIN_EMAIL
APIGEE_ADMINPW

A senha do administrador do sistema precisa ter pelo menos oito caracteres e conter uma letra maiúscula, uma letra minúscula, um dígito ou um caractere especial. Se você omitir a senha, ela será solicitada.

LICENSE_FILE

O local do arquivo de licença, que precisa ser acessível ao usuário "apigee". Por exemplo, armazene-o no diretório /tmp e use chmod 777 no arquivo. O arquivo será copiado para o diretório de instalação do Edge.

APIGEE_LDAPPW

Especifica a senha do OpenLDAP.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Se USE_LDAP_REMOTE_HOST for n, o Edge vai instalar o OpenLDAP automaticamente ao instalar o servidor de gerenciamento.

Defina USE_LDAP_REMOTE_HOST como y se você estiver se conectando a um servidor LDAP remoto. O OpenLDAP não é instalado com o servidor de gerenciamento.

Se você estiver se conectando a um servidor OpenLDAP remoto, use LDAP_HOST
e LDAP_PORT para especificar o endereço IP ou o nome DNS e o número da porta do host.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Defina LDAP_TYPE=1 para OpenLDAP sem replicação. LDAP_TYPE=2 corresponde ao OpenLDAP com replicação.

Se a topologia do Edge usar um único servidor OpenLDAP, especifique 1. Se a instalação do Edge usar vários nós do OpenLDAP, como em uma instalação de produção de 13 nós, especifique 2.

Se você ativar a replicação, defina as seguintes propriedades:

  • LDAP_SID=1: ID exclusivo para este servidor LDAP. Cada nó LDAP usa um ID diferente. Por exemplo, defina como 2 para o peer LDAP.
  • LDAP_PEER=10.0.0.1: IP ou nome DNS do par LDAP.

BIND_ON_ALL_INTERFACES

Se definido como "y", o roteador/processador de mensagens é vinculado (ouve) em todas as interfaces (IPs). Se definido como “n”, o roteador/processador de mensagens será vinculado (ouvir) em uma interface específica, o IP retornado pelo comando "hostname -i".

MP_POD

Especifique o nome do processador de mensagens e do pod do roteador. Por padrão, o nome é gateway.

REGION

Nome da região. Por convenção, os nomes geralmente têm o formato dc-#, em que # corresponde a um valor inteiro. Por exemplo, dc-1, dc-2 etc. É possível usar dc-1, a menos que a instalação seja em um ambiente com vários data centers.

Em uma instalação de vários data centers, o valor é dc-1 ou dc-2, etc., dependendo do data center que você está instalando. No entanto, você não precisa usar apenas nomes no formato dc-#. É possível usar qualquer nome para a região.

ZK_HOSTS

Os endereços IP ou nomes DNS dos nós do ZooKeeper. Os endereços IP ou nomes DNS precisam ser listados na mesma ordem em todos os nós do ZooKeeper.

Em um ambiente com vários data centers, liste todos os nós do ZooKeeper dos dois data centers.

Especifique o modificador :observer nos nós do ZooKeeper somente ao criar vários data centers, conforme descrito em uma instalação de 12 hosts. Em uma única instalação de data center, omita esse modificador.

ZK_CLIENT_HOSTS

Os endereços IP ou nomes DNS dos nós do ZooKeeper usados por esse data center. Os endereços IP ou nomes de DNS precisam ser listados na mesma ordem em todos os nós do ZooKeeper.

Em uma única instalação de data center, esses são os mesmos nós especificados por ZK_HOSTS.

Em um ambiente com vários data centers, liste apenas os nós do ZooKeeper nesse data center.

CASS_CLUSTERNAME Opcionalmente, especifique o nome do aglomerado Cassandra. O nome padrão é "Apigee".

CASS_HOSTS

Os endereços IP (não os nomes DNS) dos nós do Cassandra. Os dois primeiros nós serão usados como servidores de semente. Os endereços IP precisam ser listados na mesma ordem em todos os nós do Cassandra.

Os nós do Cassandra podem ter um sufixo opcional ":dc,ra" que especifica o data center e o rack do nó do Cassandra. Especifique esse modificador apenas ao criar vários data centers, conforme descrito em uma instalação de 12 hosts. Em uma única instalação de data center, omita esse modificador.

Por exemplo, "192.168.124.201:1,1" = data center 1 e rack/zona de disponibilidade 1, e "192.168.124.204:2,1" = data center 2 e rack/zona de disponibilidade 1.

Em um ambiente de vários data centers, para resolver problemas de firewall, é necessário ordenar CASS_HOSTS de maneira (como mostrado no exemplo acima) de modo que os nós do data center atual sejam colocados no início.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Se você ativar a autenticação do Cassandra, CASS_AUTH=y, poderá passar o nome de usuário e a senha do Cassandra usando essas propriedades.

PG_PWD

Por padrão, o banco de dados PostgreSQL tem dois usuários definidos: "postgres" e "apigee". Ambos os usuários têm uma senha padrão de "postgres". Use PG_PWD para definir a senha como um valor diferente para os dois usuários no momento da instalação.

PG_MASTER

PG_STANDBY

Definir para ativar a replicação mestre-standby do Postgres, no formulário:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Configure o SMTP para que o Edge possa enviar e-mails para senhas perdidas e outras notificações.

Se as credenciais de usuário SMTP não forem obrigatórias, omita SMTPUSER e SMTPPASSWORD.