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

Actualiza Apigee Edge 4.16.09 a 4.18.01

Edge for Private Cloud v4.18.01

¿Qué versiones de Edge puedes actualizar a la 4.18.01?

Con este procedimiento, puedes actualizar la versión 4.16.09.0x a la 4.18.01 de Apigee Edge.

Si tienes una versión de Edge anterior a la 4.16.01, primero debes migrar a 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 el que instaló originalmente Edge. usuario que se ejecuta con permisos de administrador.

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 incluye componentes de varias versiones.

Actualización requerida a Qpid 1.35

Esta versión incluye una actualización obligatoria de Qpid 1.35. Como parte de la actualización de un nodo Qpid, deberá:

Evita temporalmente que los routers y procesadores de mensajes escriban en el nodo Qpid de la siguiente manera: bloqueando el puerto 5672 en el nodo Qpid. Puedes usar el siguiente comando para bloquear este puerto el nodo de Qpid:
> sudo iptables -A ENTRADA -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 mensajes antes de la actualización. Usa el siguiente comando para asegurarte de que la cola de mensajes Qpid esté vacío:
> qpid-stat -q
Actualizar el nodo Qpid
Desbloquea el puerto 5672 en el nodo Qpid para permitir el acceso de los 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 para revertir el resultado cambio específico:
> sudo iptables -D ENTRADA -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 necesaria a Postgres 9.6

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

Durante el proceso de actualización, mientras los nodos de Postgres no están disponibles para su actualización, los datos de estadísticas que aún se escribe en los nodos Qpid. Después de que los nodos de Postgres se actualicen y vuelvan a estar en línea, las estadísticas los datos se envían a los nodos de Postgres.

El nodo en espera adicional de Postgres es obligatorio si tienes que revertir la actualización para cualquier y por una buena razón. Si tienes que revertir la actualización, el nuevo nodo en espera de Postgres se convierte en el principal Nodo de Postgres 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 Postgres nodo en espera

En este procedimiento, se crea un servidor en espera de Postgres en un nodo nuevo. Asegúrate de instalar una nueva Servidor en espera Postgres para tu versión existente de Edge (4.16.09), no para 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 nodo en espera de Postgres nuevo, haz lo siguiente:

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

conf_pg_hba_replication.connection=host replicaciones de Apigee existing_slave_ip/32 trust\ \nreplicación de host Apigee new_slave_ip/32 trust

en el que existing_slave_ip es la dirección IP del Postgres actual servidor en espera y new_slave_ip es la dirección IP del servidor en espera nuevo el nodo de inicio de sesión.
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 nodo en espera nuevo, consulte el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia principal. Deberías ver las siguientes líneas en ese archivo:
Apigee de replicación de host ip_eslave_existente/32 relación de confianza
Replicación de host Apigee new_slave_ip/32 trust
Instala el nuevo servidor de Postgres en espera:
1. Edita el archivo de configuración que usaste para instalar tu versión actual de Edge y especifica el parámetro lo siguiente:
  
  # dirección IP del principal:
  PG_MASTER=192.168.56.103
  # dirección IP del nodo en espera nuevo
  PG_STANDBY=192.168.56.102
2. Inhabilita SELinux como se describe en Instala la utilidad de configuración de Apigee de Edge.
3. Descarga el archivo bootstrap_4.16.09.sh de Edge a /tmp/bootstrap_4.16.09.sh:
  > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
4. Instalar la utilidad apigee-service de Edge y dependencias:
  > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
5. Usa apigee-service para instala apigee-setup utilidad:
  > /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 nodo en espera nuevo, ejecuta el siguiente comando:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-waitby
  
  Valida que indique que es el modo de espera.

Retiro de un servicio de Postgres nodo

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

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

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

Deberías ver el UUID del nodo al final del resultado, en el siguiente formato:
"tipo" : [ "postgres-server" ],
“uUID” : “599e8ebf-5d69-4ae4-aa71-154970a8ec75”
Para detener el nodo en espera nuevo, ejecuta el siguiente comando en él:
> /opt/apigee/apigee-service/bin/apigee-all stop
En el nodo principal de Postgres, edita /opt/apigee/customer/application/postgresql.properties para quitar el nodo en espera nuevo de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host Replicación de 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, consulte el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia principal. En ese archivo, solo deberías ver la siguiente línea:
Apigee de replicación de host existing_slave_ip/32 relación de confianza
Para borrar el UUID del nodo en espera de ZooKeeper, realiza la siguiente administración de Edge Llamada a la API en el nodo del servidor de administración:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Se requiere para habilitar el repositorio EPEL

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

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

Adición obligatoria de SMTPmailFROM parámetro de configuración

Edge 4.17.05 agregó un nuevo parámetro obligatorio al archivo de configuración que se usa cuando habilitas la función un servidor SMTP. Si estás actualizando desde la versión 4.17.01, debes establecer SMTPMailFROM en el archivo de configuración. cuando habilites el servidor SMTP.

La versión 4.17.09 de la API BaaS también agregó compatibilidad con la propiedad SMTPMailFROM. Cuando actualices los BaaS de la API, debes configurar SMTPMailFROM en el de Terraform.

Este parámetro tiene la siguiente forma:

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

Obligatorio si se actualiza cuando se usa autenticación externa

Puedes integrar un servicio de directorio externo en una nube privada de Apigee Edge existente instalación. 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 LDAP externa permite que el sistema para administrar credenciales de usuarios desde un servicio centralizado de administración de directorios, externas a sistemas como Apigee Edge que los usan.

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

Cuando se habilita la autenticación externa, la mayoría de los clientes usa 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 OpenLDAP perimetral.

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

Si configuró alguna propiedad mediante la edición de archivos .properties en /opt/apigee/customer/application, estos valores que conserve la actualización.

Actualizar requisitos previos

Asegúrate de cumplir con los siguientes requisitos previos antes de actualizar Apigee Edge:

Crea una copia de seguridad de todos los nodos
Por motivos de seguridad, antes de la actualización, se recomienda realizar una copia de seguridad completa de todos los nodos y otras razones. Usa el procedimiento de tu versión actual de Edge para realizar la copia de seguridad.

Esto te permite tener un plan de copia de seguridad, en caso de que la actualización a una nueva versión funcionen correctamente. Para obtener más información sobre las copias de seguridad, consulta Copias de seguridad y Restablecer.
Asegúrate de que Edge se esté ejecutando
Asegúrate de que Edge esté funcionando durante el proceso de actualización con el siguiente comando:

> Estado de /opt/apigee/apigee-service/bin/apigee-all

Cómo manejar una actualización con errores

En caso de que falle la actualización, puedes intentar corregir el problema y, luego, ejecutar update.sh de nuevo. Puedes ejecutar la actualización varias veces para que continúe la actualización desde donde quedó la última vez. desactivado.

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

Información de actualización de Logging

De manera predeterminada, el archivo update.sh escribe la información de registro en lo siguiente:

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

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

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

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 necesidad de derribando 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, de la carga. 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 la instalación como se describe a continuación en "Orden de la actualización de máquina”.
Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, ya que se describe en Habilitar/Inhabilitar el servidor (Procesador de mensajes/router) Accesibilidad.
Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todos los parámetros de configuración 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 2 al 4 para los routers restantes.
Continúa la actualización en las máquinas restantes de la instalación.

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

En el router combinado del nodo del procesador de los mensajes:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router sea inaccesible.
  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 de router:
- Antes de la actualización, haz que no se pueda acceder al router.
- Después de la actualización, haz que el router sea accesible.
En un solo nodo de Message Processor:
- Antes de la actualización, haz que no se pueda acceder al procesador de mensajes.
- 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 debería ser la misma que usaste para instalar Edge 4.16.09.

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

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

Si actualmente usas la replicación en espera principal de Postgres, instala una instancia nueva de Postgres nodo en espera, como se describe en Instala un nuevo en espera.
Si está presente, inhabilita los trabajos de CRON configurados para realizar una operación de reparación en Cassandra. hasta que finalice 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 con permisos de administrador, puedes realizar una implementación de Edge sin acceso con permisos de administrador.
Instala yum-utils y yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Inhabilita SELinux como se describe en Instalación la utilidad de configuración de Apigee de Edge
Habilita el repositorio EPEL como se describió anteriormente.
Si estás instalando en Oracle 7.x, ejecuta el siguiente comando:
> sudo yum-config-manager --enable ol7_optional_latest
Si instalas la app en AWS, ejecuta los siguientes comandos yum-configure-manager:
> actualización deliciosa rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGIÓN-rhel-server-optional
Descarga el archivo bootstrap_4.18.01.sh de Edge 4.18.01 a /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 dependencias:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo manejar el archivo. Instalación de Java. JAVA_FIX tiene los siguientes valores:

I = Instala 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 apigee-setup utilidad:
> Actualización de /opt/apigee/apigee-service/bin/apigee-service apigee-setup
Actualiza apigee-validate en el servidor de administración:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Actualiza apigee-provision utilidad:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Ejecuta la utilidad de actualización en tus nodos en el orden descrito a continuación en "Orden de actualización". a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el “Apigee” usuario.

Usa la opción “-c” para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:
ldap = OpenLDAP
cs = Cassandra
zk = Zoológico
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, servidor Postgres
ui = IU de Edge
all: Se actualizan todos los componentes en (solo se debe usar para un perfil de instalación de Edge aio o una API BaaS asa) perfil)
e = ElasticSearch
b = Pila de BaaS de la API
p = Portal de BaaS de la API
ebp = ElasticSearch, BaaS de API Stack y API BaaS Portal en el mismo nodo
Probar la actualización ejecutando la utilidad apigee-validate en el servidor de administración, como como se describe en Cómo probar la instalación.
Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describió anteriormente en Retiro de servicio de Postgres en la nube.

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

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

Si tus nodos perimetrales están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder el repositorio de Apigee por Internet, puedes actualizar desde un repositorio local del repositorio de Apigee.

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

Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, actualiza Edge desde el .tar.
Instalar un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él Apigee te proporciona el servidor web Nginx, o puedes usar tu propio servidor web web.

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

Si actualmente usas la replicación en espera principal de Postgres, instala un nuevo nodo en espera de Postgres como se describe en Instalación nuevo nodo en espera de Postgres.
Crea un repositorio local 4.18.01 como se describe en “Crea un repositorio local de Apigee” en Instala la utilidad de Apigee-setup de Edge.
Nota: Si ya tienes un repositorio 4.16.09 existente, puedes agregar el repositorio 4.18.01. como se describe en “Actualiza un repositorio local de Apigee” en Instala la utilidad de 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:
  > Paquete /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
2. Copia el archivo .tar en el nodo en el que quieres actualizar Edge. Por ejemplo, cópialo en el directorio /tmp en la 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 y las dependencias de Edge apigee-service desde /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.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 mediante el servidor web Nginx, sigue estos pasos:
1. Configura el servidor web NGINX como se describe en "Instala desde el repositorio con el servidor webserver" en Install the Edge apigee-setup.
2. En el nodo remoto, descarga el archivo bootstrap_4.18.01.sh de Edge en /tmp/arranque_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  donde uName:pWord son el nombre de usuario y la contraseña que configuraste anteriormente para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del repo.
3. En el nodo remoto, instala la utilidad y las dependencias del servicio de Apigee de Edge:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña del repositorio.
Usa apigee-service para actualiza la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Actualiza apigee-validate en el servidor de administración.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Actualiza apigee-provision utilidad:
> /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” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el “Apigee” usuario.

Usa la opción “-c” para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:
ldap = OpenLDAP
cs = Cassandra
zk = Zoológico
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, servidor Postgres
ui = IU de Edge
all: Se actualizan todos los componentes en (solo se debe usar para un perfil de instalación de Edge aio o una API BaaS asa) perfil)
e = ElasticSearch
b = Pila de BaaS de la API
p = Portal de BaaS de la API
ebp = ElasticSearch, BaaS de API Stack y API BaaS Portal en el mismo nodo
Probar la actualización ejecutando la utilidad apigee-validate en el servidor de administración, como como se describe en Cómo probar la instalación.
Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describe arriba en Retiro de servicio un nodo de Postgres.

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

Orden de actualización de la máquina

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

Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar alguno. otros nodos.
Para cualquier máquina con varios componentes de Edge (Management Server, Message Processor, router, servidor QPID pero no servidor Postgres), usa "-c Edge" para actualizarlos todos al mismo tiempo.
Si un paso especifica que debe realizarse en varias máquinas, ejecútalo en el orden de máquina especificado.
No existe un paso aparte para actualizar la Monetización. Se actualiza cuando especificas el valor "-c borde" de 12 a 1 con la nueva opción de compresión.