Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Actualiza Apigee Edge 4.16.09 a 4.18.01

Edge para nube privada v4.18.01

¿A qué versiones de Edge puedes actualizar a la 4.18.01?

Puedes actualizar la versión 4.16.09.0x de Apigee Edge a la 4.18.01 con este procedimiento.

Si tienes una versión de Edge anterior a la 4.16.01, primero debes migrar a la versión 4.16.01.x y, luego, actualizar a la versión 4.18.01.

Quién puede realizar la actualización

El usuario que ejecuta la actualización debe ser el mismo que instaló Edge originalmente o un usuario que se ejecuta como raíz.

Después de instalar los RPM de Edge, cualquier usuario puede configurarlos.

¿Qué componentes debes actualizar?

Debes actualizar todos los componentes de Edge. Edge no admite una configuración que contenga componentes de varias versiones.

Actualización obligatoria a Qpid 1.35

Esta versión contiene una actualización obligatoria a Qpid 1.35. Como parte de la actualización de un nodo de Qpid, debes hacer lo siguiente:

Impide de forma temporal que los routers y los Message Processors escriban en el nodo de Qpid bloqueando el puerto 5672 en el nodo de Qpid. Puedes usar el siguiente comando para bloquear este puerto en el nodo de Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Espera a que la cola de Qpid se vacíe de mensajes para asegurarte de que el nodo de Qpid haya procesado todos los mensajes antes de la actualización. Usa el siguiente comando para asegurarte de que la cola de mensajes de Qpid esté vacía:
> qpid-stat -q
Actualiza el nodo de Qpid.
Desbloquea el puerto 5672 en el nodo de Qpid para permitir el acceso desde los routers y los Message Processors. Puedes usar el siguiente comando para desbloquear este puerto:
> sudo iptables -F

Ten en cuenta que, si usas iptables para otras reglas, puedes usar la opción -D para revertir el cambio específico:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Este proceso se describe en detalle a continuación para cada topología de Edge.

Actualización obligatoria a Postgres 9.6

Esta versión de Edge incluye una actualización a Postgres 9.6. Como parte de esa actualización, todos los datos de Postgres se migran a Postgres 9.6.

Durante el proceso de actualización, mientras los nodos de Postgres están inactivos para la actualización, los datos de estadísticas se siguen escribiendo en los nodos de Qpid. Después de que los nodos de Postgres se actualizan y vuelven a estar en línea, los datos de estadísticas se envían a los nodos de Postgres.

El nodo de espera de Postgres adicional es necesario si tienes que revertir la actualización por cualquier motivo. Si tienes que revertir la actualización, el nuevo nodo de Postgres en espera se convierte en el nodo de Postgres principal después de la reversión. Por lo tanto, cuando instales el nuevo nodo en espera de Postgres, debe estar en un nodo que cumpla con todos los requisitos de hardware de un servidor de Postgres, como se define en los Requisitos de instalación de Edge.

Instala un nuevo nodo en espera de Postgres

Este procedimiento crea un servidor en espera de Postgres en un nodo nuevo. Asegúrate de instalar un nuevo servidor en espera de Postgres para tu versión existente de Edge (4.16.09), no para la versión 4.18.01.

Para realizar la instalación, usa el mismo archivo de configuración que usaste para instalar la versión actual de Edge.

Para crear un nuevo nodo de Postgres en espera, sigue estos pasos:

En la instancia principal actual de Postgres, edita el archivo /opt/apigee/customer/application/postgresql.properties para configurar el siguiente token. Si ese archivo no existe, créalo:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

donde existing_slave_ip es la dirección IP del servidor en espera de Postgres actual y new_slave_ip es la dirección IP del nuevo nodo en espera.
Reinicia apigee-postgresql en la instancia principal de Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Para verificar que se haya agregado el nuevo nodo en espera, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Deberías ver las siguientes líneas en ese archivo:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Instala el nuevo servidor en espera de Postgres:
1. Edita el archivo de configuración que usaste para instalar la versión actual de Edge a fin de especificar lo siguiente:
  
  # dirección IP del master actual:
  PG_MASTER=192.168.56.103
  # dirección IP del nuevo nodo en espera
  PG_STANDBY=192.168.56.102
2. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
3. Descarga el archivo bootstrap_4.16.09.sh de Edge en /tmp/bootstrap_4.16.09.sh:
  > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
4. Instala la utilidad apigee-service de Edge y las dependencias:
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
5. Usa apigee-service para instalar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Instala Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. En el nuevo nodo en espera, ejecuta el siguiente comando:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Valida que indique que está en espera.

Retira un nodo de Postgres

Una vez que se complete la actualización, retira el nuevo nodo en espera:

Asegúrate de que Postgres se esté ejecutando:
> /opt/apigee/apigee-service/bin/apigee-all status

Si Postgres no se está ejecutando, inícialo:
> /opt/apigee/apigee-service/bin/apigee-all start
Ejecuta el siguiente comando de cURL en el nodo en espera nuevo para obtener su UUID:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Deberías ver el UUID del nodo al final del resultado, con el siguiente formato:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Detén el nodo en espera nuevo ejecutando el siguiente comando en el nodo en espera nuevo:
> /opt/apigee/apigee-service/bin/apigee-all stop
En el nodo principal de Postgres, edita /opt/apigee/customer/application/postgresql.properties para quitar el nuevo nodo en espera de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Reinicia apigee-postgresql en la instancia principal de Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Para verificar que se haya quitado el nodo en espera nuevo, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Solo deberías ver la siguiente línea en ese archivo:
host replication apigee existing_slave_ip/32 trust
Borra el UUID del nodo en espera de ZooKeeper realizando la siguiente llamada a la API de administración de Edge en el nodo del servidor de administración:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Obligatorio para habilitar el repo de EPEL

Debes habilitar los paquetes adicionales para Enterprise Linux (o EPEL) para instalar o actualizar Edge. El comando que uses dependerá de tu versión de RedHat o CentOS:

Para RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
Para RedHat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Se requiere agregar el parámetro de configuración SMTPMAILFROM

En Edge 4.17.05, se agregó un parámetro obligatorio nuevo al archivo de configuración que se usa cuando habilitas un servidor SMTP. Si actualizas desde la versión 4.17.01, debes configurar SMTPMAILFROM en el archivo de configuración cuando habilites el servidor SMTP.

La versión 4.17.09 de la API de BaaS también agregó compatibilidad con la propiedad SMTPMAILFROM. Cuando actualices la API de BaaS, debes configurar SMTPMAILFROM en el archivo de configuración.

Este parámetro tiene el siguiente formato:

SMTPMAILFROM="My Company <myco@company.com>"

Es obligatorio si se actualiza cuando se usa la autenticación externa

Puedes integrar un servicio de directorio externo en una instalación existente de Apigee Edge para la nube privada. Esta función está diseñada para funcionar con cualquier servicio de directorio que admita LDAP, como Active Directory, OpenLDAP y otros. Una solución de LDAP externa permite que los administradores del sistema administren las credenciales de los usuarios desde un servicio de administración de directorios centralizado, externo a los sistemas como Apigee Edge que los usan.

Consulta Configuración de la autenticación externa para obtener más información.

Cuando la autenticación externa está habilitada, la mayoría de los clientes usan el campo de nombre de la cuenta de SAM de Active Directory como el nombre de usuario para la autenticación, en lugar de una dirección de correo electrónico que usa el servidor de OpenLDAP de Edge.

Si te integraste con un servicio de directorio externo, agrega la siguiente línea a tu archivo de configuración cuando actualices Edge a la versión 4.17.09:

IS_EXTERNAL_AUTH="true"

Esta línea configura Edge para que admita un nombre de cuenta, en lugar de una dirección de correo electrónico, como el nombre de usuario.

Propagación automática de la configuración de propiedades

Si configuraste alguna propiedad editando los archivos .properties en /opt/apigee/customer/application, la actualización conservará estos valores.

Requisitos previos de la actualización

Ten en cuenta los siguientes requisitos previos antes de actualizar Apigee Edge:

Crea una copia de seguridad de todos los nodos
Antes de actualizar, se recomienda realizar una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento para tu versión actual de Edge para realizar la copia de seguridad.

Esto te permite tener un plan de respaldo en caso de que la actualización a una versión nueva no funcione correctamente. Para obtener más información sobre la copia de seguridad, consulta Copia de seguridad y restablecimiento.
Asegúrate de que Edge se esté ejecutando
Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:

> /opt/apigee/apigee-service/bin/apigee-all status

Cómo controlar una actualización con errores

En caso de que falle la actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces y esta continuará desde donde se detuvo por última vez.

Si la falla requiere que reviertas la actualización a la versión anterior, consulta Proceso de reversión de la versión 4.18.01 para obtener más información.

Información de actualización de Logging

De forma predeterminada, la utilidad update.sh escribe la información de registro en la siguiente ubicación:

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

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

Si el usuario no tiene acceso a /tmp, la utilidad update.sh falla.

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar tu instalación de Edge sin desactivar Edge.

La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos o más.

La clave para la actualización sin tiempo de inactividad es quitar cada router, uno a la vez, del balanceador de cargas. Luego, actualiza el router y cualquier otro componente en la misma máquina que el router y, luego, vuelve a agregar el router al balanceador de cargas.

Actualiza las máquinas en el orden correcto para tu instalación, como se describe a continuación en "Orden de actualización de la máquina".
Cuando sea el momento de actualizar los routers, selecciona uno y haz que no se pueda acceder a él, como se describe en Habilita o inhabilita la accesibilidad del servidor (Message Processor o router).
Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todas las configuraciones de Edge muestran un router y un Message Processor en el mismo nodo.
Vuelve a hacer que el router sea accesible.
Repite los pasos 2 a 4 para los routers restantes.
Continúa con la actualización de las máquinas restantes de tu instalación.

Ten en cuenta lo siguiente antes y después de la actualización:

En el nodo combinado de Router y Message Processor:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router no sea accesible.
  2. Haz que no se pueda acceder al Message Processor.
- Después de la actualización, haz lo siguiente:
  1. Haz que se pueda acceder al Message Processor.
  2. Haz que se pueda acceder al router.
En un solo nodo de router:
- Antes de la actualización, haz que el router no esté disponible.
- Después de la actualización, haz que se pueda acceder al router.
En un solo nodo de Message Processor:
- Antes de la actualización, haz que el Message Processor no esté disponible.
- Después de la actualización, haz que se pueda acceder al Message Processor.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando de actualización. El archivo de configuración silenciosa debe ser el mismo que usaste para instalar Edge 4.16.09.

Procedimiento para actualizar a la versión 4.18.01 en un nodo con una conexión a Internet externa

Usa el siguiente procedimiento para actualizar los componentes de Edge en un nodo:

Si actualmente usas la replicación principal-en espera de Postgres, instala un nodo en espera de Postgres nuevo, como se describió anteriormente en Instala un nodo en espera de Postgres nuevo.
Si están presentes, inhabilita los trabajos cron configurados para realizar una operación de reparación en Cassandra hasta que se complete la actualización.
Accede a tu nodo como raíz para instalar los RPM de Edge.
Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
Instala yum-utils y yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
Habilita el repositorio de EPEL como se describió anteriormente.
Si realizas la instalación en Oracle 7.x, ejecuta el siguiente comando:
> sudo yum-config-manager --enable ol7_optional_latest
Si realizas la instalación en AWS, ejecuta los siguientes comandos yum-configure-manager:
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Descarga el archivo bootstrap_4.18.01.sh de Edge 4.18.01 en /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Instala la utilidad apigee-service de Edge 4.18.01 y las dependencias:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

Donde uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que la ingreses.

De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. Si no lo tienes, se instalará por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX toma los siguientes valores:

I = Instalar OpenJDK 1.8 (predeterminado)
C = Continuar sin instalar Java
Q = Salir. Para esta opción, debes instalar Java por tu cuenta.
Usa apigee-service para actualizar la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Actualiza la utilidad apigee-validate en el servidor de administración:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Actualiza la utilidad apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización de la máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo.

Usa la opción “-c” para especificar el componente que se actualizará. La lista de componentes posibles incluye lo siguiente:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = IU de Edge
all = Actualiza todos los componentes de la máquina (solo se usa para un perfil de instalación de Edge aio o un perfil de instalación de API BaaS asa)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack y API BaaS Portal en el mismo nodo
Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.
Si instalaste un nodo en espera de Postgres nuevo, retira el nodo como se describió anteriormente en Retira un nodo de Postgres.

Para revertir la actualización más adelante, usa el procedimiento que se describe en Proceso de reversión de la versión 4.18.01.

Procedimiento para actualizar a la versión 4.18.01 desde un repositorio local

Si tus nodos de Edge están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local o una duplicación del repositorio de Apigee.

Después de crear un repositorio local de Edge, tienes dos opciones para actualizar Edge desde el repositorio local:

Crea un archivo .tar del repositorio, copia el archivo .tar en un nodo y, luego, actualiza Edge desde el archivo .tar.
Instala un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él. Apigee proporciona el servidor web de Nginx para que lo uses, o puedes usar tu propio servidor web.

Para actualizar desde un repositorio local 4.18.01, haz lo siguiente:

Si actualmente usas la replicación principal-en espera de Postgres, instala un nodo en espera de Postgres nuevo como se describió anteriormente en Instala un nodo en espera de Postgres nuevo.
Crea un repositorio local 4.18.01 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
Nota: Si ya tienes un repositorio 4.16.09, puedes agregarle el repositorio 4.18.01 como se describe en "Actualiza un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
Para instalar apigee-service desde un archivo .tar, haz lo siguiente:
1. En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Copia el archivo .tar en el nodo en el que deseas actualizar Edge. Por ejemplo, cópialo en el directorio /tmp del nodo nuevo.
3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
  > tar -xzf apigee-4.18.01.tar.gz
  
  Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
4. Instala la utilidad apigee-service de Edge y las dependencias de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Ten en cuenta que debes incluir la ruta de acceso al directorio repos en este comando.
Para instalar apigee-service con el servidor web de Nginx, haz lo siguiente:
1. Configura el servidor web Nginx como se describe en "Instala desde el repositorio con el servidor web Nginx" en Instala la utilidad apigee-setup de Edge.
2. En el nodo remoto, descarga el archivo bootstrap_4.18.01.sh de Edge en /tmp/bootstrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.
3. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  en el que uName:pWord son el nombre de usuario y la contraseña del repositorio.
Usa apigee-service para actualizar la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Actualiza la utilidad apigee-validate en el servidor de administración.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Actualiza la utilidad apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización de la máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo.

Usa la opción “-c” para especificar el componente que se actualizará. La lista de componentes posibles incluye lo siguiente:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = IU de Edge
all = Actualiza todos los componentes de la máquina (solo se usa para un perfil de instalación de Edge aio o un perfil de instalación de API BaaS asa)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack y API BaaS Portal en el mismo nodo
Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.
Si instalaste un nodo de Postgres en espera nuevo, retira el nodo como se describió anteriormente en Retira un nodo de Postgres.

Para revertir la actualización más adelante, usa el procedimiento que se describe en Proceso de reversión de la versión 4.18.01.

Orden de actualización de la máquina

El orden en el que actualizas las máquinas en una instalación de Edge es importante. Las consideraciones más importantes para una actualización son las siguientes:

Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar cualquier otro nodo.
Para cualquier máquina con varios componentes de Edge (servidor de administración, Message Processor, router, servidor de QPID, pero no servidor de Postgres), usa la opción "-c edge" para actualizarlos todos al mismo tiempo.
Si un paso especifica que se debe realizar en varias máquinas, hazlo en el orden de máquinas especificado.
No hay un paso independiente para actualizar la monetización. Se actualiza cuando especificas la opción "-c edge".