Instalar componentes do Edge em um nó

Edge para nuvem privada v. 4.16.05

Depois de instalar o utilitário apigee-setup do Edge em um nó, use o utilitário apigee-setup para instalar um ou mais componentes do Edge no nó.

O utilitário apigee-setup usa um comando no formato:

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

em que component é o componente do Edge a ser instalado, e configFile é o arquivo de configuração silencioso que contém as informações de instalação. O arquivo de configuração precisa estar acessível ou legível para o usuário "apigee". Por exemplo, coloque o arquivo no diretório /tmp do nó.

Por exemplo, para instalar o Servidor de gerenciamento de borda:

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

Considerações sobre a instalação

Ao gravar o arquivo de configuração, considere as opções a seguir.

Como configurar a replicação mestre de espera do Postgres

Por padrão, o Edge instala todos os nós do Postgres no modo mestre. No entanto, nos sistemas de produção com vários nós do Postgres, é preciso configurá-los para usar a replicação mestre em espera. Assim, se o nó mestre falhar, o nó de espera poderá continuar a disponibilizar o tráfego.

É possível ativar e configurar a replicação mestre em espera no momento da instalação usando propriedades no arquivo de configuração silencioso. Outra opção é ativar a replicação mestre em espera após a instalação. Para mais informações, consulte Configurar a replicação mestre em espera para o Postgres.

Como ativar a autenticação do Cassandra

Por padrão, o Cassandra é instalado sem a autenticação ativada. Isso significa que qualquer pessoa pode acessar o Cassandra. É possível ativar a autenticação após instalar o Edge ou como parte do processo de instalação.

É possível ativar a autenticação do Cassandra como tempo de instalação usando as propriedades no arquivo de configuração silencioso. Também é possível ativá-lo após a instalação.

Para mais informações, consulte Ativar a autenticação do Cassandra.

Como vincular o roteador a uma porta protegida

Se você quiser vincular o roteador a uma porta protegida, como números de porta menores que 1.024, configure o roteador para ser executado como um usuário com acesso a essas portas. Por padrão, o roteador é executado como o usuário "apigee", que não tem acesso a portas com privilégios.

Para executar o roteador como um usuário diferente:

  1. Como raiz, crie o arquivo /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. Inclua a seguinte entrada no arquivo:
    RUN_USER=root
    Se você não quiser executar o roteador como raiz, especifique um usuário com acesso à porta.
  3. Salve o arquivo.
  4. Se você tiver especificado um usuário que não seja a raiz, mude o proprietário do arquivo para esse usuário:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. Reinicie o roteador:
    > /opt/apigee/apigee-service/bin/apigee-service reinicialização do roteador de borda da Apigee

Como especificar os componentes a serem instalados

A tabela a seguir lista as opções transmitidas para a opção -p do utilitário "apigee-service" para especificar quais componentes serão instalados no nó:

Componente

Descrição

c

Instale somente o Cassandra.

ZK instalar apenas o ZooKeeper.

ds

Instale o ZooKeeper e o Cassandra.

ID

Instale apenas o OpenLDAP.

ms

Instalar o Servidor de Gerenciamento de Borda, que também instala a IU do Edge e o OpenLDAP.

Se você definir USE_LDAP_REMOTE_HOST=y no arquivo de configuração, a instalação do OpenLDAP será ignorada, e o servidor de gerenciamento usará o OpenLDAP instalado em um nó diferente.

r

Instale apenas o Edge Router.

mp

Instale apenas o processador de mensagens do Edge.

rmp

Instale o roteador de borda e o processador de mensagens.

ui

Instale a interface do Edge.

qs

Instalar somente o servidor Qpid.

ps

Instale somente o servidor Postgres.

saxão

Instale os componentes de análise, ou seja, Qpid e Postgres.

Use essa opção apenas para desenvolvimento e testes, não para produção.

mês

Instale a monetização.

sa

Instale o Edge autônomo, ou seja, o Cassandra, o ZooKeeper, o servidor de gerenciamento, o OpenLDAP, a interface do Edge, o roteador e o processador de mensagens. Essa opção omite os componentes de análise do Edge: Qpid e Postgres.

Use essa opção apenas para desenvolvimento e testes, não para produção.

ia

Instale todos os componentes em um único nó.

Use essa opção apenas para desenvolvimento e testes, não para produção.

Como criar um arquivo de configuração

O arquivo de configuração contém todas as informações necessárias para instalar o Edge. Muitas vezes, é possível usar o mesmo arquivo de configuração para instalar todos os componentes em uma instalação do Edge.

No entanto, será necessário usar arquivos de configuração diferentes ou modificar o arquivo de configuração se:

  • Você está instalando vários servidores OpenLDAP e precisa configurar a replicação como parte de uma instalação de 13 nós. Cada arquivo requer valores diferentes para LDAP_SID e LDAP_PEER.
  • Você está criando vários data centers como parte de uma instalação de 12 nós. Cada data center requer configurações diferentes para propriedades, como ZK_CLIENT_HOSTS e CASS_HOSTS.

Exemplo: arquivo de configuração

Confira abaixo um exemplo de um arquivo de configuração silencioso completo para uma instalação de nove nós do Edge. Edite esse arquivo conforme necessário para sua configuração. Use a opção -f para setup.sh e inclua esse arquivo. Veja abaixo também 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 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.

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

Propriedade

Observação

Nomes IP/DNS

Não use um mapeamento de nome de host para 127.0.0.1 ou um endereço IP de 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 acessado pelo usuário "apigee". Por exemplo, armazene-o no diretório /tmp e chmod 777 no arquivo. O arquivo será copiado para o diretório de instalação do Edge.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Se USE_LDAP_REMOTE_HOST for n, o Edge instalará automaticamente o OpenLDAP 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 está 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

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

Se a topologia de borda 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 do servidor LDAP. Cada nó LDAP usa um ID diferente. Por exemplo, defina como 2 para o peering LDAP.
  • LDAP_PEER=10.0.0.1: nome do IP ou DNS do peering LDAP.

BIND_ON_ALL_INTERFACES

Se definido como "y", o roteador/processador de mensagens será vinculado (detectado) em todas as interfaces (IPs). Se definido como “n”, o roteador/processador de mensagens será vinculado (detectado) 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.

REGIÃO

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

Em uma instalação múltipla de data centers, o valor é dc-1 ou dc-2 etc., dependendo de qual data center você está instalando. No entanto, você não está restrito a usar apenas nomes no formato dc-#. Você pode 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. Consulte Instalação em cluster de 12 hosts para mais informações.

ZK_CLIENT_HOSTS

Os endereços IP ou nomes DNS dos nós do ZooKeeper usados por este data center. Os endereços IP ou nomes 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 de vários data centers, liste somente os nós do ZooKeeper nesse data center. Consulte Instalação em cluster de 12 hosts para mais informações.

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 origem. 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 ":dc,ra" opcional que especifica o data center e o rack do nó do Cassandra. Especifique esse modificador 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.

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 com vários data centers, para resolver problemas de firewall, CASS_HOSTS precisam ser ordenados de maneira (como mostrado no exemplo acima), de modo que os nós do data center atual sejam colocados no início. Consulte Instalação em cluster de 12 hosts para mais informações.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

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

PG_MASTER

PG_STANDBY

Defina para ativar a replicação mestre em espera do Postgres, no formato:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

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

Se as credenciais do usuário SMTP não forem necessárias, omita SMTPUSER e SMTPPASSWORD.

Ordem de instalação do componente

A ordem de instalação do componente é baseada na topologia desejada.

Todos os exemplos de instalação mostrados abaixo presumem que você está instalando:

  • Com a autenticação do Cassandra desativada (padrão). Consulte Ativar a autenticação do Cassandra para saber mais.
  • Com a replicação mestre em espera do Postgres desativada (padrão). Para saber mais, consulte Configurar a replicação Master-Standby para Postgres (em inglês).
  • o processador e o roteador de mensagens no mesmo nó. Se você instalar os processadores e roteadores de mensagens em nós diferentes, instale todos os processadores de mensagens primeiro e depois todos os roteadores.

Arquivos de registros de instalação

Por padrão, o utilitário setup.sh grava informações de registro sobre a instalação em:

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

Se o usuário que executa o utilitário setup.sh não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp como um arquivo denominado setup_username.log.

Se o usuário não tiver acesso a /tmp, o utilitário setup.sh falhará.

Instalação completa

  1. Instale todos os componentes em um único nó usando este comando:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Exclua todos os arquivos em /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  3. Reinicie o roteador de borda:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  4. Teste a instalação conforme descrito em Testar a instalação.
  5. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalação autônoma de dois hosts

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.

  1. Instalar o gateway independente e o nó 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. No nó 1:
    1. Exclua todos os arquivos em /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Reinicie o roteador de borda:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  3. Instale o Analytics no nó 2:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  4. Teste a instalação conforme descrito em Testar a instalação.
  5. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalação em cluster de 5 hosts

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.

  1. Instale o cluster do Datastore nos nós 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instale o servidor de gerenciamento no nó 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Nos nós 2 e 3:
    1. Instale o roteador e o processador de mensagens:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Exclua todos os arquivos em /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Reinicie o roteador de borda:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  4. Instale o Analytics nos nós 4 e 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Teste a instalação conforme descrito em Testar a instalação.
  6. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

Instalação em cluster com 9 hosts

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.

  1. Instale o nó do cluster do Datastore nos nós 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instale o servidor de gerenciamento da Apigee no nó 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Nos nós 4 e 5:
    1. Instale o roteador e o processador de mensagens:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Exclua todos os arquivos em /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Reinicie o roteador de borda:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  4. Instale o servidor Qpid da Apigee Analytics nos nós 6 e 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instale o servidor Postgres da Apigee Analytics nos nós 8 e 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Teste a instalação conforme descrito em Testar a instalação.
  7. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalação em cluster de 13 hosts

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.

  1. Instale o nó do cluster do Datastore nos nós 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instale o OpenLDAP nos nós 4 e 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Instale o servidor de gerenciamento da Apigee nos nós 6 e 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Instale o servidor Postgres da Apigee Analytics nos nós 8 e 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Nos nós 10 e 11:
    1. Instale o roteador e o processador de mensagens:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Exclua todos os arquivos em /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Reinicie o roteador de borda:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  6. Instale o servidor Qpid da Apigee Analytics nos nós 12 e 13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Teste a instalação conforme descrito em Testar a instalação.
  8. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

Instalação em cluster de 12 hosts

Antes de instalar o Edge em uma topologia em cluster a12 host (dois data centers), você precisa entender como definir as propriedades do ZooKeeper e do Cassandra no arquivo de configuração silenciosa.

  • ZooKeeper

    Na propriedade ZK_HOSTS dos dois data centers, especifique os endereços IP ou os nomes DNS de todos os nós do ZooKeeper de ambos os data centers, na mesma ordem, e marque todos os nós com o modificador ":observer". Os nós sem o modificador ":observer" são chamados de "voadores". É preciso ter um número ímpar de "votantes" na configuração.

    Nessa topologia, o host do ZooKeeper no host 9 é o observador:

    Na propriedade ZK_CLIENT_HOSTS de cada data center, especifique os endereços IP ou os nomes DNS somente dos nós do ZooKeeper no data center, na mesma ordem, para todos os nós do ZooKeeper no data center. No exemplo de arquivo de configuração mostrado abaixo, o nó 9 é marcado com o modificador ":observer" para que você tenha cinco eleitores: nós 1, 2, 3, 7 e 8.
  • Cassandra
    Todos os data centers precisam ter o mesmo número de nós do Cassandra.

    No CASS_HOSTS para cada data center, especifique todos os endereços IP do Cassandra (não os nomes DNS) dos dois data centers. Para o data center 1, liste primeiro os nós do Cassandra nesse data center. Para o data center 2, liste primeiro os nós do Cassandra nesse data center. Liste os nós do Cassandra na mesma ordem para todos no data center.

    Todos os nós do Cassandra precisam ter um sufixo ":<d>,<r>", por exemplo "<ip>:1,1 = data center 1 e rack/zona de disponibilidade 1 e "<ip>:2,1 = data center 2 e rack/zona de disponibilidade 1".
    Por exemplo, "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.1268.12 nó:



    Nesse modelo de implantação, a configuração do Cassandra ficará assim:

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.

  1. Instale o nó do cluster do Datastore nos nós 1, 2, 3, 7, 8 e 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instale o servidor de gerenciamento da Apigee com replicação OpenLDAP nos nós 1 e 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Nos nós 2, 3, 8 e 9:
    1. Instale o roteador e o processador de mensagens:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. Exclua todos os arquivos em /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. Reinicie o roteador de borda:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service change-router restart
  4. Instale o servidor Qpid da Apigee Analytics nos nós 4, 5, 10 e 11:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instale o servidor Postgres da Apigee Analytics nos nós 6 e 12:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Teste a instalação conforme descrito em Testar a instalação.
  7. Integre sua organização conforme descrito em Integrar uma organização.

Veja abaixo um arquivo de configuração silencioso para essa topologia. Observe que este arquivo de configuração:

  • Configura o OpenLDAP com replicação em dois nós do OpenLDAP.
  • Especifica o modificador ":observer" em um nó do ZooKeeper. Em uma única instalação de data center, omita esse modificador.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
IP12=IPorDNSnameOfNode12 
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25