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.50.00 o 4.51.00 a la versión 4.52.00

Apigee admite la actualización de Edge para nube privada de la versión 4.50.00 o la versión 4.51.00 directamente a la versión 4.52.00. En esta página, se describe cómo realizar cualquiera de las actualizaciones.

Quién puede realizar la actualización

La persona que ejecuta la actualización debe ser la misma que instaló Edge originalmente o una persona que se ejecuta como raíz.

Después de instalar los RPM de Edge, cualquier persona 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.

Requisitos previos de la actualización

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

Crea una copia de seguridad de todos los nodos
Antes de actualizar, te recomendamos que crees 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 copia de seguridad en caso de que la actualización a una versión nueva 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 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
```
Asegúrate de que la estrategia de compactación de Cassandra sea LeveledCompactionStrategy
Asegúrate de que la estrategia de compactación de Cassandra esté configurada en LeveledCompactionStrategy, como se describe en Cambia la estrategia de compactación de Cassandra.

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

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

Actualización obligatoria a Zookeeper 3.8.0

Esta versión de Edge para nubes privadas incluye una actualización a Zookeeper 3.8.0. Como parte de esa actualización, todos los datos de Zookeeper se migrarán a Zookeeper 3.8.0.

Antes de actualizar ZooKeeper, lee la guía de mantenimiento de ZooKeeper. La mayoría de los sistemas de producción de Edge usan un clúster de nodos de ZooKeeper distribuidos en varios centros de datos. Algunos de estos nodos se configuran como votantes que participan en la elección de líder de ZooKeeper, y el resto se configura como observadores. Consulta Acerca de los líderes, seguidores, votantes y observadores para obtener más detalles. Los nodos votantes eligen un líder, después de lo cual los nodos votantes se convierten en seguidores.

Durante el proceso de actualización, puede haber un retraso momentáneo o una falla de escritura en ZooKeeper cuando se apaga el nodo líder. Esto podría afectar las operaciones de Management que escriben en Zookeeper, como la operación de implementación de un proxy y los cambios en la infraestructura de Apigee, como la adición o eliminación de un Message Processor, etc. No debería haber ningún impacto en las APIs del entorno de ejecución de Apigee (a menos que estas APIs del entorno de ejecución llamen a las APIs de Management) durante la actualización de Zookeeper mientras se sigue el procedimiento que se indica a continuación.

En términos generales, el proceso de actualización implica realizar una copia de seguridad de cada nodo. Luego, se actualizan todos los observadores y seguidores y, por último, se actualiza el nodo líder.

Crea una copia de seguridad

Realiza una copia de seguridad de todos los nodos de ZooKeeper para usarla en caso de que se requiera una reversión. Ten en cuenta que una reversión restablecerá ZooKeeper al estado en el que se realizó la copia de seguridad. Nota: Cualquier implementación o cambio de infraestructura en Apigee desde que se realizó la copia de seguridad (cuya información se almacena en Zookeeper) se perderá durante el restablecimiento.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Si usas máquinas virtuales y tienes la capacidad, también se pueden tomar instantáneas o copias de seguridad de las VMs para la restauración o la reversión (si es necesario).

Identifica al líder, los seguidores y los observadores

Nota: Los siguientes comandos de ejemplo usan la utilidad nc para enviar datos a ZooKeeper. También puedes usar utilidades alternativas para enviar datos a ZooKeeper.

Si no está instalado en el nodo de ZooKeeper, instala nc:
```
  sudo yum install nc
```
Ejecuta el siguiente comando nc en el nodo, en el que 2181 es el puerto de ZooKeeper:
```
  echo stat | nc localhost 2181
```
Deberías ver un resultado como el siguiente:
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
En la línea Mode del resultado de los nodos, deberías ver observador, líder o seguidor (es decir, un votante que no es el líder) según la configuración del nodo. Nota: En una instalación independiente de Edge con un solo nodo de ZooKeeper, el Mode se establece en independiente.
Repite los pasos 1 y 2 en cada nodo de ZooKeeper.

Actualiza ZooKeeper en los nodos observadores y seguidores

Actualiza ZooKeeper en cada uno de los nodos observadores y seguidores de la siguiente manera:

Descarga y ejecuta el arranque de Edge para nube privada 4.52, como se describe en Actualiza a la versión 4.52.00 en un nodo con una conexión a Internet externa. Es probable que el proceso varíe según si el nodo tiene una conexión a Internet externa o si estás realizando una instalación sin conexión.
Actualiza el componente de ZooKeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Nota: Si estos nodos tienen otros componentes instalados (como Cassandra), también puedes actualizarlos ahora (como con el perfil cs,zk) o puedes actualizar los otros componentes más adelante. Apigee recomienda que primero actualices solo ZooKeeper y te asegures de que el clúster funcione correctamente antes de actualizar otros componentes.
Repite los pasos anteriores en cada uno de los nodos observadores y seguidores de ZooKeeper.

Cierra el líder

Una vez que se hayan actualizado todos los nodos observadores y seguidores, apaga el líder. En el nodo identificado como líder, ejecuta el siguiente comando:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Ten en cuenta que, durante este evento, antes de que se elija un líder nuevo, podría haber retrasos momentáneos o fallas de escritura en ZooKeeper. Esto podría afectar las operaciones que escriben en ZooKeeper, como la acción de implementación de proxies o los cambios en la infraestructura de Apigee, como la adición o eliminación de Message Processors, etc.

Verifica que se elija al nuevo líder

Sigue los pasos de la sección Identifica al líder, los seguidores y los observadores que se encuentra más arriba para verificar que se haya elegido un líder nuevo entre los seguidores, una vez que se detenga el líder existente. Ten en cuenta que el líder podría haberse elegido en un centro de datos diferente del líder actual.

Líder de actualización

Sigue los mismos pasos que se indican en Actualiza ZooKeeper en los nodos observador y seguidor más arriba.

Una vez que el nodo líder anterior también se haya actualizado, verifica el estado del clúster y asegúrate de que haya un nodo líder.

Revertir

En caso de que se requiera una reversión, haz lo siguiente:

Primero, realiza los pasos de reversión en los observadores y seguidores.
Descarga y ejecuta el arranque de la versión a la que quieres volver, ya sea la 4.50 o la 4.51. Es probable que el proceso varíe según si el nodo tiene una conexión a Internet externa o si estás siguiendo la instalación sin conexión.

Detén ZooKeeper si se está ejecutando en el nodo:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Desinstala el ZooKeeper existente:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Instala ZooKeeper como de costumbre:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Una vez que se hayan revertido todos los seguidores y observadores, revierte el nodo líder siguiendo los pasos del 2 al 5 en el nodo líder.

Después de que se hayan revertido todos los nodos, verifica el estado del clúster y asegúrate de que haya un nodo líder en el clúster.

Restaurar copia de seguridad

Consulta Cómo restablecer datos desde una copia de seguridad. Ten en cuenta que las copias de seguridad de ZooKeeper tomadas de versiones anteriores de Edge para nube privada, como 4.50 y 4.51, deben ser compatibles con la versión de ZooKeeper en Edge para nube privada 4.52.

Actualización obligatoria a Postgres 14

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

La mayoría de los sistemas de producción de Edge usan dos nodos de Postgres configurados para la replicación de principal-en espera. 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.

La forma en que realizas la actualización de Postgres depende de cómo configuraste el almacenamiento de datos para tus nodos de Postgres:

Si usas el almacén de datos local para tus nodos de Postgres, debes instalar un nodo de Postgres en espera nuevo durante la actualización. Después de que se complete la actualización, puedes retirar el nodo en espera de Postgres nuevo.
El nodo de Postgres en espera adicional es obligatorio 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 instalas 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.

En una configuración de 1 nodo y 2 nodos de Edge, las topologías que se usan para la creación de prototipos y las pruebas, solo tienes un nodo de Postgres. Puedes actualizar estos nodos de Postgres directamente sin tener que crear un nodo de Postgres nuevo.
Si usas el almacenamiento de red para tus nodos de Postgres, como recomienda Apigee, no es necesario que instales un nodo de Postgres nuevo. En los procedimientos que se indican a continuación, puedes omitir los pasos que especifican instalar y, luego, retirar un nuevo nodo en espera de Postgres.
Antes de comenzar el proceso de actualización, toma una instantánea de red del almacén de datos que usa Postgres. Luego, si se produce algún error durante la actualización y te ves obligado a revertir, puedes restablecer el nodo de Postgres desde esa instantánea.

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 servidor de Postgres en espera nuevo para tu versión existente de Edge (4.50.00 o 4.51.00), no para la versión 4.52.00.

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 de Postgres actual, edita el archivo /opt/apigee/customer/application/postgresql.properties para establecer el siguiente token. Si ese archivo no existe, créalo:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
En el ejemplo anterior, existing_standby_ip es la dirección IP del servidor en espera de Postgres actual y new_standby_ip es la dirección IP del nodo en espera nuevo.

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_standby_ip/32 trust
host replication apigee new_standby_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:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
3. Si actualmente usas Edge 4.51.00, sigue estos pasos:
  1. Descarga el archivo bootstrap_4.51.00.sh de Edge en /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Instala la utilidad apigee-service de Edge y las dependencias:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Si actualmente usas Edge 4.50.00, haz lo siguiente:
  1. Descarga el archivo bootstrap_4.50.00.sh de Edge en /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Instala la utilidad apigee-service de Edge y las dependencias:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Usa apigee-service para instalar la utilidad apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Instala Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. En el nuevo nodo en espera, ejecuta el siguiente comando:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Verifica que sea la instancia en espera.

Realiza una actualización in situ de Postgres

Nota: Debes realizar el siguiente paso preliminar antes de realizar una actualización in situ de Postgres.

Nota: Con Postgres 14, ya no se admite el parámetro de configuración de Postgres wal_keep_segments. Si agregaste o modificaste este parámetro de Postgres, debes quitarlo antes de realizar la actualización de Postgres. Para ello, sigue estos pasos:

Abre el archivo $APIGEE_ROOT/customer/application/postgresql.properties.
Quita la configuración relacionada con wal_keep_segments.
Reinicia Postgres.

Consulta la documentación de Postgres para conocer las propiedades alternativas disponibles en Postgres 14, como wal_keep_size, que se pueden usar en su lugar.

Paso preliminar

Antes de realizar una actualización local a Postgres, sigue estos pasos en el host principal y en el de espera para actualizar la propiedad max_locks_per_transaction en apigee-postgresql:

Si no está presente, crea el archivo /opt/apigee/customer/application/postgresql.properties.

Cambia la propiedad de este archivo a apigee:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Agrega la siguiente propiedad al archivo:

conf/postgresql.conf+max_locks_per_transaction=30000

Configura apigee-postgresql:

apigee-service apigee-postgresql configure

Reinicia apigee-postgresql:

apigee-service apigee-postgresql restart

Realiza la actualización in situ.

Para realizar una actualización local a Postgres 14, sigue estos pasos:

Actualiza Postgres en el host principal

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Ejecuta el comando de configuración en el host principal:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Ejecuta el comando configure en el host principal:
```
apigee-service apigee-postgresql configure
```

Reinicia el host principal:

apigee-service apigee-postgresql restart

Configúralo como principal:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Asegúrate de que se haya iniciado el host principal:
```
apigee-service apigee-postgresql wait_for_ready
```
Detén la instancia en espera:
```
apigee-service apigee-postgresql stop
```
Actualiza la instancia en espera.
Nota: Si este paso genera un error o falla, puedes ignorarlo. update.sh intentará iniciar el servidor en espera con una configuración incorrecta. Siempre que la instalación de Postgres se actualice a la versión 14, se puede ignorar el error.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Asegúrate de que la instancia en espera esté detenida:
```
apigee-service apigee-postgresql stop
```
Quita la configuración de espera anterior:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Configura la replicación en el servidor en espera:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Quita la línea conf/postgresql.conf+max_locks_per_transaction=30000 del archivo /opt/apigee/customer/application/postgresql.properties tanto en el host principal como en el de espera. Esta línea se agregó en el paso preliminar.

Después de completar este procedimiento, la instancia en espera se iniciará correctamente.

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 curl en el nuevo nodo en espera 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 é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 replication apigee existing_standby_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_standby_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_standby_uuid
```

Pasos posteriores a la actualización para Postgres

Después de una actualización importante de Postgres, se borran las estadísticas internas de Postgres. Estas estadísticas ayudan al planificador de consultas de Postgres a usar los índices y las rutas más óptimos para ejecutar consultas.

Postgres puede volver a compilar sus estadísticas de forma gradual con el tiempo a medida que se ejecutan las consultas y cuando se ejecuta el daemon de autovacuum. Sin embargo, hasta que se vuelvan a compilar las estadísticas, es posible que tus consultas sean lentas.

Para solucionar este problema, ejecuta ANALYZE en todas las tablas de la base de datos en el nodo principal de Postgres. Como alternativa, puedes ejecutar ANALYZE para algunas tablas a la vez.

NOTA: ANALYZE puede tardar mucho tiempo en ejecutarse, pero solo aplica un bloqueo de lectura en la tabla, lo que permite que otras operaciones en Postgres sigan ejecutándose mientras se ejecuta ANALYZE.

Nueva IU de Edge

En esta sección, se enumeran las consideraciones relacionadas con la IU de Edge. Para obtener más información, consulta La nueva IU de Edge para la nube privada.

Instala la IU de Edge

Después de completar la instalación inicial, Apigee recomienda que instales la IU de Edge, que es una interfaz de usuario mejorada para desarrolladores y administradores de Edge para nube privada de Apigee.

Ten en cuenta que la IU de Edge requiere que inhabilites la autenticación básica y uses un IDP, como SAML o LDAP.

Para obtener más información, consulta Instala la nueva IU de Edge.

Actualiza la IU de Edge

Para actualizar el componente de la IU de Edge, ten en cuenta la versión de Edge para la nube privada desde la que actualizas:

De la versión 4.51.00 a la 4.52.00 (con la nueva IU de Edge ya instalada): Usa las instrucciones de actualización de esta sección para el componente edge-management-ui.

Actualiza con mTLS de Apigee

Para actualizar mTLS de Apigee , sigue estos pasos:

Revierte una actualización

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 Revierte la versión 4.52.00 para obtener instrucciones detalladas.

Información de actualización de Logging

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

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

Si la persona 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 la persona 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 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 nodos de router únicos:
- Antes de la actualización, haz que el router no sea accesible.
- Después de la actualización, haz que se pueda acceder al router.
En nodos de Message Processor únicos:
- 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.50.00 o 4.51.00.

Actualiza a 4.52.00 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án presentes, inhabilita los trabajos de 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:
Nota: Si tu sistema operativo es RHEL 8.0 - 8.6, omite este paso.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
Si estás instalando 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 de 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

Si actualmente usas Edge 4.51.00, sigue estos pasos:
1. Descarga el archivo bootstrap_4.52.00.sh de Edge en /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Instala la utilidad apigee-service de Edge 4.52.00 y las dependencias ejecutando el siguiente comando:
```
sudo bash /tmp/bootstrap_4.52.00.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 lo ingreses.
  
  De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. De lo contrario, el instalador lo hará 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: Instala OpenJDK 1.8 (predeterminado).
  - C: Continúa sin instalar Java.
  - Q: Salir. Para esta opción, debes instalar Java por tu cuenta.
3. Usa apigee-service para actualizar la utilidad apigee-setup, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Actualiza la utilidad apigee-validate en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Actualiza la utilidad apigee-provision en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Ejecuta la utilidad update en tus nodos con el siguiente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Hazlo en el orden que se describe en Orden de actualización de la máquina.
  
  Donde:
  - component es el componente de Edge que se actualizará. Entre los valores posibles, se incluyen los siguientes:
    - cs: Cassandra
    - edge: Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server y Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO de Apigee (si instalaste el SSO)
    - ue: Nueva IU de Edge
    - ui: IU clásica de Edge
    - zk: Zookeeper
  - configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de la versión 4.50.00 o 4.51.00.
  Puedes ejecutar update.sh en todos los componentes si configuras component como "all", pero solo si tienes un perfil de instalación todo en uno (AIO) de Edge. Por ejemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Reinicia los componentes de la IU de Edge en todos los nodos que los ejecutan, si aún no lo hiciste:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. 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 más adelante decides revertir la actualización, usa el procedimiento que se describe en Revierte la versión 4.52.00.

Actualiza a la versión 4.52.00 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, cópialo 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.52.00, haz lo siguiente:
1. Crea un repositorio local 4.52.00 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
  NOTA: Si ya tienes un repositorio, puedes agregarle el repositorio 4.52.00 como se describe en "Actualiza un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
2. 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.52.00.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.52.00.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.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Ten en cuenta que debes incluir la ruta de acceso al directorio repos en este comando.
3. Para instalar apigee-service con el servidor web 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.52.00.sh de Edge en /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.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-setup de Edge y las dependencias:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Donde uName:pWord son el nombre de usuario y la contraseña del repositorio.
4. Usa apigee-service para actualizar la utilidad apigee-setup, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Actualiza la utilidad apigee-validate en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Actualiza la utilidad apigee-provision en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Ejecuta la utilidad update en tus nodos en el orden que se describe en Orden de actualización de la máquina:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Donde:
  - component es el componente de Edge que se actualizará. Por lo general, actualizas los siguientes componentes:
    - cs: Cassandra
    - edge: Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, Message Processor, router, servidor de QPID y servidor de Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO de Apigee (si instalaste el SSO)
    - Nueva IU de Edge de ue
    - ui: IU clásica de Edge
    - zk: Zookeeper
  - configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de la versión 4.50.00 o 4.51.00.
    NOTA: El usuario "apigee" debe poder leer el archivo de configuración. Para cambiar el propietario, usa el siguiente comando:
    chown apigee:apigee configFile
  Puedes ejecutar update.sh en todos los componentes si configuras component como "all", pero solo si tienes un perfil de instalación todo en uno (AIO) de Edge. Por ejemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Reinicia los componentes de la IU en todos los nodos que la ejecutan, si aún no lo hiciste:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. 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 más adelante decides revertir la actualización, usa el procedimiento que se describe en Revierte la versión 4.52.00.

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:
- 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.
NOTA: Después de actualizar el componente de la IU de Edge, debes reiniciar el servicio de la IU de Edge, como se describe en las instrucciones de instalación de la actualización.

Actualización independiente de 1 nodo

Para actualizar una configuración independiente de 1 nodo a la versión 4.52.00, sigue estos pasos:
1. Actualiza todos los componentes:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Actualización independiente de 2 nodos

Actualiza los siguientes componentes para una instalación independiente de 2 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
1. Actualiza Cassandra y ZooKeeper en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Actualiza Qpid y Postgres en la máquina 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Actualiza LDAP en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Actualiza los componentes de Edge en las máquinas 2 y 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Actualiza la IU en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
8. Reinicia el componente de la IU de Edge en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Actualización de 5 nodos

Actualiza los siguientes componentes para una instalación de 5 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
1. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Actualiza Qpid y Postgres en la máquina 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Actualiza Qpid y Postgres en la máquina 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Actualiza LDAP en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Actualiza los componentes de Edge en las máquinas 4, 5, 1, 2 y 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Actualiza la IU de Edge:
  - IU clásica: Si usas la IU clásica, actualiza el componente ui en la máquina 1, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - IU de Edge nueva: Si instalaste la IU de Edge nueva, actualiza el componente ue en la máquina adecuada (puede que no sea la máquina 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
9. Reinicia el componente de la IU:
  - IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en la máquina 1, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en la máquina adecuada (puede que no sea la máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Actualización de clústeres de 9 nodos

Actualiza los siguientes componentes para una instalación agrupada en clústeres de 9 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
1. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Actualiza Qpid en las máquinas 6 y 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Actualiza Postgres en la máquina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Actualiza Postgres en la máquina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Actualiza LDAP en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Actualiza los componentes de Edge en las máquinas 6, 7, 8, 9, 1, 4 y 5 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Actualiza la IU nueva (ue) o la IU clásica (ui) en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
10. Reinicia el componente de la IU:
  - IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en la máquina 1, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en la máquina adecuada (puede que no sea la máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Actualización de clústeres de 13 nodos

Actualiza los siguientes componentes para una instalación en clúster de 13 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
1. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Actualiza Qpid en las máquinas 12 y 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Actualiza Postgres en la máquina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Actualiza Postgres en la máquina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Actualiza LDAP en las máquinas 4 y 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Actualiza los componentes de Edge en las máquinas 12, 13, 8, 9, 6, 7, 10 y 11 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Actualiza la IU nueva (ue) o la IU clásica (ui) en las máquinas 6 y 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi en las máquinas 6 y 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en las máquinas 6 y 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
10. Reinicia el componente de la IU:
  - IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en las máquinas 6 y 7, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en las máquinas 6 y 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Actualización de clústeres de 12 nodos

Actualiza los siguientes componentes para una instalación agrupada en clústeres de 12 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
1. Actualiza Cassandra y ZooKeeper:
  1. En las máquinas 1, 2 y 3 del centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. En las máquinas 7, 8 y 9 del centro de datos 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Actualiza qpidd:
  1. Máquinas 4 y 5 en el centro de datos 1
    1. Actualiza qpidd en la máquina 4:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Actualiza qpidd en la máquina 5:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. Máquinas 10 y 11 en el centro de datos 2
    1. Actualiza qpidd en la máquina 10:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Actualiza qpidd en la máquina 11:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Actualiza Postgres:
  1. Máquina 6 en el centro de datos 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Máquina 12 en el centro de datos 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Actualiza LDAP:
  1. Máquina 1 en el centro de datos 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Máquina 7 en el centro de datos 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Actualiza los componentes de Edge:
  1. Máquinas 4, 5, 6, 1, 2 y 3 en el centro de datos 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Máquinas 10, 11, 12, 7, 8 y 9 en el centro de datos 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Actualiza la IU nueva (ue) o la IU clásica (ui):
  1. Máquina 1 en el centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Máquina 7 en el centro de datos 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi:
  1. Máquina 1 en el centro de datos 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Máquina 7 en el centro de datos 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee:
  1. Máquina 1 en el centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Máquina 7 en el centro de datos 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Reinicia el componente de la IU de Edge nueva (edge-management-ui) o de la IU de Edge clásica (edge-ui) en las máquinas 1 y 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Para una configuración no estándar

Si tienes una configuración no estándar, actualiza los componentes de Edge en el siguiente orden:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, es decir, el perfil "-c edge" en todos los nodos en el orden: nodos con el servidor de Qpid, Edge Postgres Server, Management Server, Message Processor y Router.
  NOTA: Si un nodo tiene instalados el servidor de Qpid y el servidor de Edge Postgres, ejecuta el paso del perfil “-c edge”.
6. IU de Edge (clásica o nueva)
7. apigee-adminapi
8. SSO de Apigee
Después de terminar la actualización, asegúrate de reiniciar el componente de la IU de Edge en todas las máquinas que lo ejecutan.