Se usó la API de Cloud Translation para traducir esta página.

Instala componentes de Edge en un nodo

Edge for Private Cloud v. 4.16.05

Después de instalar la utilidad apigee-setup de Edge en un nodo, usa el apigee-setup para instalar uno o más componentes de Edge en el nodo.

La utilidad apigee-setup usa un comando con el siguiente formato:

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

donde component es el componente de Edge que se instalará y configFile es el archivo de configuración silencioso que contiene la información de instalación. El archivo de configuración debe ser accesible y legible por el “Apigee” usuario. Para Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

Por ejemplo, para instalar el servidor de administración perimetral, sigue estos pasos:

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

Consideraciones sobre la instalación

Cuando escribas tu archivo de configuración, ten en cuenta las siguientes opciones.

Configura Postgres replicación en espera de instancia principal

De forma predeterminada, Edge instala todos los nodos de Postgres en el modo principal. Sin embargo, en los sistemas de producción con varios nodos de Postgres, debes configurarlos para usar la replicación en espera de instancia principal a fin de que si el nodo principal falla, el nodo en espera puede continuar entregando tráfico.

Puedes habilitar y configurar la replicación maestra en espera en el momento de la instalación con las propiedades del archivo de configuración silencioso. O bien, puedes habilitar la replicación en espera de instancia principal después de la instalación. Para más en Cómo configurar Master-Standby Replication for Postgres (Replicación para Postgres)

Habilita la autenticación de Cassandra

De forma predeterminada, Cassandra instala sin autenticación habilitada. Eso significa que cualquier persona puede acceder Cassandra. Puedes habilitar la autenticación después de instalar Edge o como parte de la instalación. el proceso de administración de recursos.

Puedes habilitar la autenticación de Cassandra como tiempo de instalación mediante el uso de propiedades en el modo silencioso. de configuración de Terraform. También puedes habilitarlo después de la instalación.

Para obtener más información, consulta Habilita la autenticación de Cassandra.

Cómo vincular el router a un puerto protegido

Si deseas vincular el router a un puerto protegido, como números de puerto inferiores a 1024, entonces debes configurar el router para que se ejecute como un usuario con acceso a esos puertos. De forma predeterminada, el El router se ejecuta como el usuario “apigee” que no tiene acceso a puertos con privilegios.

Para ejecutar el router como un usuario diferente, haz lo siguiente:

Como raíz, crea el archivo /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Agrega la siguiente entrada al archivo:
RUN_USER=root
Si no quieres ejecutar el router como root, especifica un usuario con acceso al puerto.
Guarda el archivo.
Si especificaste un usuario que no sea raíz, cambia el propietario del archivo por ese usuario:
> chown USUARIO:USUARIO /opt/apigee/etc/edge-router.d/RUN_USER.sh
Reinicia el router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Cómo especificar los componentes que se instalarán

En la siguiente tabla, se enumeran las opciones que pasa a la opción -p de la utilidad apigee-service para especificar qué componentes instalar en el nodo:

Componente	Descripción
c	Instala solo Cassandra.
ZK	instalar solo ZooKeeper.
ds	Instala ZooKeeper y Cassandra.
ld	Solo instala OpenLDAP.
ms	Instala Edge Management Server, que también instala la IU de Edge y OpenLDAP. Si configuras USE_LDAP_REMOTE_HOST=y en la configuración entonces se omite la instalación de OpenLDAP y el servidor de administración usa OpenLDAP instalada en un nodo diferente.
r	Solo instala el router perimetral.
mp	Solo instala el procesador de mensajes de Edge.
rmp	Instala el router perimetral y el procesador de mensajes.
ui	Instala la IU de Edge.
qs	Instalar solo el servidor Qpid
ps	Instala solo el servidor de Postgres.
saxofón	Instala los componentes de estadísticas, es decir, Qpid y Postgres. Usa esta opción solo para el desarrollo y las pruebas, no para la producción.
mes	Instala Monetización.
sa	Instala Edge independiente, es decir, Cassandra, ZooKeeper, Management Server, OpenLDAP IU de Edge, router y procesador de mensajes Esta opción omite los componentes de analítica de Edge: Qpid y Postgres. Usa esta opción solo para el desarrollo y las pruebas, no para la producción.
IAio	Instalar todos los componentes en un solo nodo Usa esta opción solo para el desarrollo y las pruebas, no para la producción.

Crea un archivo de configuración

El archivo de configuración contiene toda la información necesaria para instalar Edge. A menudo, puedes Usar el mismo archivo de configuración para instalar todos los componentes en una instalación de Edge

Sin embargo, deberás usar diferentes archivos de configuración o modificar tu configuración si:

Instalas varios servidores OpenLDAP y debes configurar la replicación como parte de un Instalación de 13 nodos. Cada archivo requiere valores diferentes para LDAP_SID y LDAP_PEER.
Estás creando varios centros de datos como parte de una instalación de 12 nodos. Cada centro de datos requiere una configuración diferente para propiedades como ZK_CLIENT_HOSTS y CASS_HOSTS.

Archivo de configuración de ejemplo

A continuación, se muestra un ejemplo de un archivo de configuración silencioso completo para una instalación de Edge de 9 nodos. Edita este archivo según sea necesario para tu configuración. Usa la opción -f para setup.sh incluir este archivo. También se muestra a continuación, se muestran archivos de configuración de ejemplo para cada topología de 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 siguiente tabla contiene información adicional sobre estas propiedades:

Propiedad	Nota
Nombres de IP/DNS	No uses una asignación de nombre de host a 127.0.0.1 o una dirección IP de 127.0.0.1 cuando especificando la dirección IP de un nodo.
ADMIN_EMAIL APIGEE_ADMINPW	La contraseña del administrador del sistema debe tener al menos 8 caracteres y debe incluir uno una letra mayúscula, una letra minúscula, un dígito o un carácter especial. Si omites contraseña, se te solicitará que la ingreses.
LICENSE_FILE	La ubicación del archivo de licencia, a la que debe poder acceder el servicio de Apigee usuario. Por ejemplo, almacénalo en el directorio /tmp y chmod 777 en el archivo. Se copió el archivo al directorio de instalación de Edge.
USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT	Si USE_LDAP_REMOTE_HOST es n, Edge instala OpenLDAP automáticamente cuando lo instala el servidor de administración. Establece USE_LDAP_REMOTE_HOST en y si te conectas a un servidor LDAP remoto. OpenLDAP no está instalado con el servidor de administración. Si te conectas a un servidor OpenLDAP remoto, usa LDAP_HOST y LDAP_PORT para especificar la dirección IP o el nombre de DNS y el número de puerto del host.
LDAP_TYPE LDAP_SID LDAP_PEER	Configura LDAP_TYPE=1 para OpenLDAP sin replicación. LDAP_TYPE=2 corresponde a OpenLDAP con la replicación. Si tu topología perimetral usa un solo servidor OpenLDAP, especifica 1. Si tu instalación de Edge usa varios nodos OpenLDAP, como en una instalación de producción de 13 nodos, especifica 2. Si habilitas la replicación, configura las siguientes propiedades: LDAP_SID=1: ID único para este servidor LDAP. Cada nodo de LDAP usa un ID diferente. Por ejemplo, configúralo en 2 para el intercambio de tráfico de LDAP. LDAP_PEER=10.0.0.1 - Nombre de IP o DNS del par de LDAP.
BIND_ON_ALL_INTERFACES	Si se establece en "y", el router o Message Processor se vincula (escucha) en todas las interfaces (IP). Si se configura en “n”, el router/procesador de mensajes se vincula (escucha) en un de host, la IP devuelta por el “nombre de host -i” ).
MP_POD	Especifica el nombre del Message Processor y el Pod del router. De forma predeterminada, el nombre es puerta de enlace.
REGIÓN	Es el nombre de la región. Por convención, los nombres suelen tener el formato dc-#, en el que # corresponde en un valor entero. Por ejemplo, dc-1, dc-2, etc. Puedes usar dc-1 a menos que instales un entorno de varios centros de datos. En una instalación de varios centros de datos, el valor es dc-1, o dc-2, etc., según qué centro de datos estás instalando. Sin embargo, no estás limitado a usar solo nombres en el formato dc-#. Puedes usar cualquier nombre para la región.
ZK_HOSTS	Las direcciones IP o los nombres de DNS de los nodos de ZooKeeper. Las direcciones IP o nombres de DNS deben aparecer en el mismo orden en todos los nodos de ZooKeeper. En un entorno de varios centros de datos, enumera todos los nodos de ZooKeeper de ambos datos. locales. Especificar el modificador “:observer” en los nodos de ZooKeeper solo cuando creando varios centros de datos, como se describe en una instalación de 12 hosts. En una sola instalación de centro de datos, omítelo. Consulta en clústeres de 12 hosts instalación para obtener más información.
ZK_CLIENT_HOSTS	Son las direcciones IP o los nombres de DNS de los nodos de ZooKeeper que usa este centro de datos. La IP las direcciones o los nombres de DNS deben estar enumerados en el mismo orden en todos los nodos de ZooKeeper. En una única instalación de centro de datos, estos son los mismos nodos especificados por ZK_HOSTS En un entorno de varios centros de datos, enumera solo los nodos de ZooKeeper en este centro de datos. Consulta en clústeres de 12 hosts instalación para obtener más información.
CASS_HOSTS	Las direcciones IP (no los nombres de DNS) de los nodos de Cassandra. Los primeros dos nodos se usarán como servidores de origen. Las direcciones IP deben estar enumeradas en el mismo orden en todas las nodos. Los nodos de Cassandra pueden tener un sufijo “:dc,ra” opcional que especifique la el centro de datos y el rack del nodo de Cassandra. Especifica este modificador solo cuando crees varios centros de datos, como se describe en una instalación de 12 hosts. En un solo centro de datos o la instalación, omite ese modificador. Por ejemplo, '192.168.124.201:1,1 = centro de datos 1 y zona de bastidor/disponibilidad 1, y '192.168.124.204:2,1 = centro de datos 2 y zona de bastidor/disponibilidad 1. En un entorno de varios centros de datos, para superar los problemas del firewall, CASS_HOSTS debe de forma tal que los nodos de la instancia centro de datos se sitúan al principio. Consulta en clústeres de 12 hosts instalación para obtener más información.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Si habilitas la autenticación de Cassandra, CASS_AUTH=y, puedes pasar el nombre y la contraseña del usuario de Cassandra con estas propiedades.
PG_MASTER PG_STANDBY	Configurado para habilitar la replicación en espera de instancia principal de Postgres de la siguiente forma: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Configura SMTP para que Edge pueda enviar correos electrónicos de contraseñas perdidas y otras notificaciones. Si no se requieren credenciales de usuario de SMTP, omite SMTPUSER y SMTPPASSWORD.

Orden de instalación de los componentes

El orden de instalación de los componentes se basa en la topología deseada.

En todos los ejemplos de instalación que se muestran a continuación, se presupone que estás instalando:

Con la autenticación de Cassandra inhabilitada (predeterminada). Consulta Habilitar la autenticación de Cassandra para obtener más información.
Con la replicación maestra-de reserva de Postgres inhabilitada (predeterminada). Consulta Configura la replicación maestra-en espera para Postgres para obtener más información.
El procesador de mensajes y el router están en el mismo nodo. Si instalas Message Processor y Los routers ubicados en nodos diferentes instalan primero los Message Processor y, luego, Routers.

Archivos de registro de la instalación

De forma predeterminada, la utilidad setup.sh escribe información de registro sobre la instalación en:

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

Si el usuario que ejecuta la utilidad setup.sh no tiene acceso a ese escribe el registro en el directorio /tmp como un archivo llamado setup_username.log.

Si el usuario no tiene acceso a /tmp, fallará la utilidad setup.sh.