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

Actualiza Apigee Edge 4.16.09 a 4.17.09

Edge para la nube privada v. 4.17.09

A qué versiones de Edge puedes actualizar a la 4.17.09

Puedes actualizar Apigee Edge de la versión 4.16.09.0x a la 4.17.09 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.17.09.

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 ejecute como root.

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 requerida a Qpid 1.35

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

Bloquea el puerto 5672 en el nodo Qpid para evitar temporalmente que los routers y los procesadores de mensajes escriban en el nodo Qpid. Puedes usar el siguiente comando para bloquear este puerto en el nodo Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Espera a que la cola de Qpid quede vacía para asegurarse 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 Qpid.
Desbloquea el puerto 5672 en el nodo Qpid para permitir el acceso desde routers y procesadores de mensajes. 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 a fin de revertir el cambio específico:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP

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

Obligatorio para habilitar el repositorio EPEL

Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge. El comando que uses depende de la versión de Red Hat o CentOS que tengas:

Para Red Hat/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 Red Hat/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 agregó el parámetro de configuración SMTPMAILFROM de forma obligatoria

Edge 4.17.05 agregó un nuevo parámetro obligatorio 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 los BaaS de la API, debes configurar SMTPMailFROM en el archivo de configuración.

Este parámetro tiene la siguiente forma:

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

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 Private Cloud. 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 a los administradores del sistema administrar las credenciales de los usuarios desde un servicio de administración de directorios centralizado, externo a sistemas como Apigee Edge que las usan.

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

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

Si realizaste la integración con un servicio de directorio externo, agrega la siguiente línea al 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 nombre de usuario.

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

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

Actualiza los requisitos previos

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 crear una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento de la versión actual de Edge para crear la copia de seguridad.

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

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

Cómo manejar una actualización fallida

En caso de que se produzca un error de 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 4.17.09 para obtener más información.

Información de actualización de registro

De forma predeterminada, la utilidad update.sh escribe la información de registro en los siguientes lugares:

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

Si el usuario que ejecuta la utilidad update.sh no tiene acceso a ese directorio, el registro se escribe 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 la instalación de Edge sin dejar de usar Edge.

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

La clave para realizar 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 vuelve a agregarlo al balanceador de cargas.

Actualiza las máquinas en el orden correcto para la instalación como se describe a continuación en “Orden de actualización de máquinas”.
Cuando llegue 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 (procesador de mensajes 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 procesador de mensajes en el mismo nodo.
Haz que el router sea accesible de nuevo.
Repite los pasos del 2 al 4 para los routers restantes.
Continúa la actualización de las máquinas restantes de la instalación.

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

En los nodos combinados del router y el procesador de mensajes, haz lo siguiente:
- Antes de la actualización, haz lo siguiente:
  1. Hacer que el router no sea accesible
  2. Hacer que el procesador de mensajes sea inaccesible.
- Después de la actualización, haz lo siguiente:
  1. Permite que el procesador de mensajes sea accesible.
  2. Haz que el router sea accesible.
En un solo nodo del router:
- Antes de la actualización, haz que no se pueda acceder al router.
- Después de la actualización, asegúrate de que se pueda acceder al router.
En un solo nodo de Message Processor:
- Antes de la actualización, haz que el procesador de mensajes no sea accesible.
- Después de la actualización, permite que el procesador de mensajes sea accesible.

Usa un archivo de configuración silencioso

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

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

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

Si está presente, inhabilita cualquier trabajo de CRON configurado 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 de raíz, puedes realizar la configuración de Edge sin acceso de 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 EPEL como se describió anteriormente.
Si realizas la instalación en AWS, ejecuta el siguiente comando yum-configure-manager:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Descarga el archivo bootstrap_4.17.09.sh de Edge 4.17.09 a /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Instala la utilidad apigee-service y las dependencias de Edge 4.17.09:
> sudo bash /tmp/bootstrap_4.17.09.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. De lo contrario, la instalará por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX puede tener los siguientes valores:

I = Instala OpenJDK 1.8 (predeterminado)
C = Continúa 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" pueda 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: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
ui = IU de Edge
all = Actualiza todos los componentes de la máquina (solo úsalo para un perfil de instalación de aio de Edge o un perfil de instalación de BaaS de API)
e = ElasticSearch
b = API BaaS Stack
p = Portal de API BaaS
ebp = ElasticSearch, API BaaS Stack y el portal de API BaaS en el mismo nodo
Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Cómo probar la instalación.

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

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

Si los nodos de Edge están detrás de un firewall o, de alguna otra manera, no tienen permitido acceder al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local, o duplicado, 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 Nginx para que lo uses, o bien puedes usar tu propio servidor web.

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

Crea un repositorio local 4.17.09 como se describe en "Crea un repositorio de Apigee local" en Instala la utilidad apigee-setup de Edge.
Nota: Si ya tienes un repositorio 4.16.09 existente, puedes agregar el repositorio 4.17.09 a él, como se describe en “Cómo actualizar un repositorio de Apigee local” en Cómo instalar la utilidad apigee-setup de Edge.
Para instalar apigee-service desde un archivo .tar, sigue estos pasos:
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.17.09.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.17.09.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 y las dependencias de Edge apigee-service desde /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Ten en cuenta que incluyes la ruta de acceso al directorio de repositorios en este comando.
Para instalar apigee-service con el servidor web Nginx, sigue estos pasos:
1. Configura el servidor web Nginx como se describe en “Instala desde el repositorio mediante el servidor web Nginx” en Instala la utilidad apigee-setup de Edge.
2. En el nodo remoto, descarga el archivo bootstrap_4.17.09.sh de Edge a /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  donde uName:pWord son el nombre de usuario y la contraseña que estableciste anteriormente para el repo, y remoteRepo es la dirección IP o el nombre DNS del nodo del repo.
3. En el nodo remoto, instala la utilidad y las dependencias de apigee-service de Edge:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  donde 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 máquinas” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

El único requisito del archivo de configuración es que el usuario de “apigee” debe poder acceder o leer el archivo de configuración.

Usa la opción “-c” para especificar el componente que se actualizará. y la lista de posibles componentes incluye lo siguiente:
ldap =..
Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Cómo probar la instalación.

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

Orden de actualización de la máquina

El orden en 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, procesador de mensajes, router, servidor 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".

Para una instalación independiente de 1 host

Establece SMTPMailFROM en el archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
SMTPMailFROM="Mi empresa <myco@company.com>"
Actualiza Cassandra y ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Establece la siguiente regla de iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
Verifica la cola de mensajes de Qpid:
> qpid-stat -q

Sigue verificando la cola hasta que el recuento en la columna "msg" sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
Actualiza qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Borra iptables:
> sudo iptables -F
Actualiza postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Inicia postgresql:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Actualiza LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Actualiza los componentes restantes de Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Actualiza la IU de Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para una instalación independiente de 2 hosts

Consulta Topologías de instalación para ver la lista de topologías de Edge y cantidad de nodos.

Establece SMTPMailFROM en el archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
Actualiza Cassandra y ZooKeeper en la máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Establece la siguiente regla de iptables en la máquina 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Verifica la cola de mensajes de Qpid en la máquina 2:
> qpid-stat -q

Sigue verificando la cola hasta que el recuento en la columna "msg" sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
Actualiza qpidd en la máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Borra iptables en la máquina 2:
> sudo iptables -F
Actualiza postgresql en la máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Inicia postgresql en la máquina 2:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Actualiza LDAP en la máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Actualiza los componentes de Edge en las máquinas 2 y 1:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Actualiza la IU en la máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile