Edge para nuvem privada v. 4.17.09
Depois de instalar o utilitário Edge apigee-setup em um nó, use o utilitário apigee-setup para instalar um ou mais componentes Edge no nó.
O utilitário de configuração da Apigee usa um comando no formato a seguir:
> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
em que component é o componente Edge a ser instalado e configFile é o arquivo de configuração silenciosa que contém as informações de instalação. O arquivo de configuração precisa ser acessível ou legível para o usuário "apigee". Por exemplo, é possível criar um novo diretório para os arquivos, colocá-los no diretório /usr/local ou /usr/local/share ou em qualquer outro lugar no nó acessível pelo usuário "apigee".
Por exemplo, para instalar o Edge Management Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig
Considerações sobre a instalação
Ao gravar seu arquivo de configuração, considere as opções a seguir.
Como configurar a replicação de espera mestre do Postgres
Por padrão, o Edge instala todos os nós do Postgres no modo mestre. No entanto, em sistemas de produção com vários nós do Postgres, é preciso configurá-los para usar a replicação de espera mestre. 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 de mestre em espera no momento da instalação usando propriedades no arquivo de configuração silenciosa. Também é possível ativar a replicação de espera principal após a instalação. Para mais informações, consulte Configurar replicação do Master-Standby para 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 depois de instalar o Edge ou como parte do processo de instalação.
Para mais informações, consulte Ativar a autenticação do Cassandra.
Como usar uma porta protegida ao criar um host virtual
Se você quiser criar um host virtual que vincule o roteador a uma porta protegida, como números de porta menores que 1.000, será necessário configurar 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 privilegiadas.
Para informações sobre como configurar um host virtual e um roteador para acessar portas abaixo de 1.000, consulte Como configurar um host virtual.
Como especificar os componentes a serem instalados
A tabela a seguir lista as opções passadas para a opção -p do utilitário apigee-service a fim de especificar quais componentes serão instalados no nó:
Componente |
Descrição |
---|---|
c |
Instale apenas o Cassandra. |
zk | instalar apenas o ZooKeeper. |
ds |
Instale o ZooKeeper e o Cassandra. |
l |
Instale apenas o OpenLDAP. |
ms |
Instale o Edge Management Server, 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 somente o roteador de borda. |
mp |
Instale apenas o Edge Message Processor. |
rmp |
Instale o roteador de borda e o processador de mensagens. |
iu |
Instale a IU do Edge. |
qs |
Instale apenas o servidor Qpid. |
ps |
Instale somente o servidor do Postgres. |
PDB | Instale apenas o banco de dados do Postgres: usado apenas ao instalar o portal dos Serviços do desenvolvedor. Consulte Instalação do portal de serviços para desenvolvedores. |
sax |
Instale os componentes de análise, ou seja, o Qpid e o Postgres. Use essa opção apenas para desenvolvimento e testes, não para produção. |
sso | Instale o módulo SSO de borda. |
mês |
Instale a monetização. |
sa |
Instale o Edge autônomo, ou seja, Cassandra, ZooKeeper, servidor de gerenciamento, OpenLDAP, IU do Edge, roteador e processador de mensagens. Essa opção omite os componentes do Edge Analytics: Qpid e Postgres. Use essa opção apenas para desenvolvimento e testes, não para produção. |
io |
Instale todos os componentes em um único nó. Use essa opção apenas para desenvolvimento e testes, não para produção. |
dp |
Instale o portal de serviços para desenvolvedores. |
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.
Cada topologia de instalação descrita abaixo mostra um exemplo de arquivo de configuração para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
Arquivos de registro 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 (em inglês)
Se o usuário que executa o utilitário setup.sh não tem acesso a esse diretório, ele grava o registro no diretório /tmp como um arquivo chamado setup_username.log.
Se o usuário não tiver acesso a /tmp, o utilitário setup.sh falhará.
Instalar componentes do Edge
Esta seção descreve como instalar os componentes do Edge para as diferentes topologias. A ordem de instalação do componente é baseada na topologia que você quer usar.
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 de espera mestre do Postgres desativada (padrão). Consulte Configurar replicação de mestre em espera para Postgres para saber mais.
- Processador de mensagens e roteador no mesmo nó. Se você instalar os processadores e mensagens de roteador em nós diferentes, primeiro instale todos os processadores de mensagens e, em seguida, todos os roteadores.
Instalação completa
- Instale todos os componentes em um único nó usando o comando:
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
Instalação autônoma de dois hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Instale o gateway independente e o nó 1
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - Instale o Analytics no nó 2:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
Instalação em cluster de cinco hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Instale o cluster do Datastore nos nós 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Instale o servidor de gerenciamento no nó 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Instale o roteador e o processador de mensagens nos nós 2 e 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Instale o Google Analytics nos nós 4 e 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
Instalação em cluster de nove hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- 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 - Instale o Apigee Management Server no nó 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Instale o roteador e o processador de mensagens nos nós 4 e 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Instale o Apigee Qpid Server no nó 6 e 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Instale o servidor Postgres do Apigee Analytics nos nós 8 e 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>"
Instalação em cluster de 13 hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- 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 - Instale o OpenLDAP nos nós 4 e 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - Instale o Apigee Management Server no nó 6 e 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Instale o servidor Postgres do Apigee Analytics nos nós 8 e 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Instale o roteador e o processador de mensagens nos nós 10 e 11:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Instale o Apigee Qpid Server nos nós 12 e 13:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
# 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) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.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 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |
# 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) ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.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 na topologia em cluster de 12 hosts (dois data centers), você precisa entender como definir as propriedades do ZooKeeper e do Cassandra no arquivo de configuração silenciosa.
- ZooKeeper
Para a propriedade ZK_HOSTS dos dois data centers, especifique os endereços IP ou os nomes DNS de todos os nós do ZooKeeper dos dois data centers, na mesma ordem, e marque os nós com o modificador ":observer". Os nós sem o modificador ":observer" são chamados de "voters". Você precisa ter um número ímpar de "eleitores" em sua configuração.
Nesta topologia, o host do ZooKeeper no host 9 é o observador:
Para a propriedade ZK_CLIENT_HOSTS de cada data center, especifique os endereços IP ou os nomes de DNS apenas dos nós do ZooKeeper no data center, na mesma ordem, para todos os nós do ZooKeeper no data center. No arquivo de configuração de exemplo 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.
Para CASS_HOSTS para cada data center, certifique-se de especificar todos os endereços IP do Cassandra (não nomes DNS) para os 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 os nós do Cassandra no data center.
Todos os nós do Cassandra precisam ter um sufixo ':<d>,<r>', por exemplo, '<ip>:1,1 = data center 1 e zona de rack/disponibilidade 1 e '<ip>:2,1 = datacenter 2 e zona de rack/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.204:2,1 192.168.124.124.124.124.124116611111111111111111111111
Neste modelo de implantação, a configuração do Cassandra será semelhante a esta:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- 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 - Instale o Apigee Management Server com replicação OpenLDAP nos nós 1 e 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Instale o roteador e o processador de mensagens nos nós 2, 3, 8 e 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Instale o servidor Qpid do Apigee Analytics no nó 4, 5, 10 e 11:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Instale o servidor Postgres do Apigee Analytics no nó 6 e 12:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Teste a instalação conforme descrito em Testar a instalação.
- Faça a integração da organização conforme descrito em Integrar uma organização.
Veja abaixo um arquivo de configuração silenciosa para essa topologia. Observe que esse arquivo de configuração. Para uma referência completa sobre o arquivo de configuração, consulte Referência do arquivo de configuração do Edge.
- 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 ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.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 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP7 ENABLE_SYSTEM_CHECK=y ADMIN_EMAIL=opdk@google.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 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" # Default is postgres PG_PWD=postgres 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 SMTPMAILFROM="My Company <myco@company.com>" |