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

Actualiza Apigee Edge 4.51.00 o 4.52.00 o 4.52.01 a 4.52.02

Apigee admite la actualización de Edge para la nube privada directamente de la versión 4.51.00, 4.52.00 o 4.52.01 a la versión 4.52.02. En esta página, se describe cómo realizar esas 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 ejecute el comando como root.

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.

Actualiza los requisitos previos

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 de la versión actual de Edge para crear 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 las copias de seguridad, consulta Copia de seguridad y restablecimiento.
Asegúrate de que Edge esté en ejecución
Para asegurarte de que Edge esté en funcionamiento durante el proceso de actualización, usa el siguiente comando:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Asegúrate de que la estrategia de compactación de Cassandra sea LeveledCompactionStrategy
Según tu versión actual, realiza los cambios necesarios en la estrategia de compactación de Cassandra. Sigue los pasos que se indican a continuación y, luego, regresa al procedimiento de actualización principal:
- Si actualizas desde la versión 4.51.00, consulta el documento de estrategia de compactación de Cassandra para la versión 4.51.00.
- Si actualizas desde la versión 4.52.00, consulta el documento de estrategia de compactación de Cassandra para la versión 4.52.00.
- Si actualizas desde la versión 4.52.01, consulta el documento de estrategia de compactación de Cassandra para la versión 4.52.01.

Qué pasos especiales debes tener en cuenta para la actualización

Para actualizar a Edge para la nube privada 4.52.02, considera ejecutar pasos específicos para actualizar cierto software. Los pasos necesarios dependen de tu versión actual. Consulta la siguiente tabla para ver los diversos softwares que requieren pasos adicionales y sigue las instrucciones detalladas para cada uno. Después de completar las tareas necesarias, vuelve al procedimiento de actualización principal para continuar con el proceso.

Versión actual	Software que requiere pasos especiales para actualizar a la versión 4.52.02	Referencia
4.52.01	Cassandra	Cambia la estrategia de compactación de Cassandra
4.52.00	Cassandra, Zookeeper y Qpid	Cambia la estrategia de compactación de Cassandra
4.51.00	Cassandra, Zookeeper, Qpid y Postgres	Cambia la estrategia de compactación de Cassandra

Después de realizar los pasos necesarios según tu versión, vuelve al procedimiento de actualización principal para continuar.

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

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

Actualización obligatoria a Cassandra 3.11.16

Apigee Edge para la nube privada 4.52.02 incluye una actualización de Cassandra a la versión 3.11.16. Cassandra es un componente fundamental de Apigee, y esta actualización también incluye actualizaciones del software del controlador en varios componentes de administración y entorno de ejecución que se usan para consultar y escribir en Cassandra.

Como se trata de una actualización importante, se necesitaron ciertos cambios en el modelo de datos de Apigee en Cassandra para garantizar un rendimiento óptimo en las versiones más recientes. Aunque estos cambios son mínimos, el proceso de actualización interrumpe ciertas APIs de administración, lo que afecta tanto a la IU de Apigee como al portal para desarrolladores. En el siguiente documento, se especifican las APIs exactas que no funcionarán y se describen los pasos durante la actualización cuando comienza y termina la interrupción. Es importante que no haya interrupciones en el tráfico del entorno de ejecución durante la actualización.

Nota: La herramienta cassandra-cli ya no es compatible con Cassandra 3.X y no está disponible para su uso.

Reversión de alto nivel

Aplica las actualizaciones de Cassandra de a un nodo por vez. En cuanto se actualiza un nodo, se aplican ciertos cambios de esquema que no se pueden revertir directamente. Lee la sección sobre la reversión en detalle, ya que se pueden usar diferentes técnicas según la cantidad de clúster que se actualizó.

Si necesitas revertir la actualización después de que se actualice todo el clúster de Cassandra, la única opción es restablecer las copias de seguridad. Prepárate para esto y familiarízate con el restablecimiento de copias de seguridad de Cassandra. Si puedes restablecer instantáneas a nivel de la VM más rápido que las copias de seguridad de Apigee, usa las instantáneas de VM para restablecer tus VMs de Cassandra a un estado anterior.

Para obtener más detalles, consulta la sección Cómo revertir la actualización de Cassandra 3.11.16.

Documentación de las APIs en el portal para desarrolladores

El portal para desarrolladores de Drupal de Apigee ofrece varias funciones para documentar tus APIs. Si bien se recomienda dejar de usar el portal para desarrolladores basado en Drupal 7, si aún lo usas y utilizas su función SmartDocs, se aplica el documento Cómo usar las APIs de SmartDocs. Si usas versiones más recientes del portal para desarrolladores, no habrá ningún impacto en la documentación de tu API durante esta actualización.

Cuando actualices Apigee a la versión 4.52.02, los modelos de API creados con la función SmartDocs del portal para desarrolladores de Drupal 7 no se migrarán automáticamente a la versión más reciente. Se espera que exportes cada modelo de forma manual con el portal para desarrolladores y lo vuelvas a importar después de completar la actualización.

Terminología que se usa en las siguientes secciones

Entorno de ejecución: El entorno de ejecución abarca el control del tráfico de proxy del entorno de ejecución. Incluye todas las operaciones que realizan tus routers y procesadores de mensajes para procesar de manera eficaz una solicitud de API de tiempo de ejecución para proxies existentes. Sin embargo, no incluye la implementación de proxies nuevos ni revisiones de proxies nuevas.

Administración: La administración incluye la administración de tu sistema de Apigee Edge. Esto incluye, sin limitaciones, implementaciones, modificaciones de apps, productos, servidores de destino, almacenes de claves, etcétera. Todas las APIs de administración (y sus clientes, como la IU de Apigee y el portal para desarrolladores) se incluyen en este alcance.

En cada paso que se indica a continuación, se describe el estado del entorno de ejecución y la administración a medida que avanzas en las distintas etapas del procedimiento de actualización. Ten en cuenta que no hay ningún impacto en el tráfico del entorno de ejecución durante la actualización. Sin embargo, se produjo una interrupción en un pequeño subconjunto de APIs de administración y en la funcionalidad del portal para desarrolladores.

Paso 0: Estado inicial

Cassandra en Apigee se ejecuta con la versión 2.1.22.
Componentes de Edge for Private Cloud 4.52.02:

Servidor de administración que se comunica con Cassandra a través de un protocolo Thrift más antiguo
Servidores de tiempo de ejecución (procesadores y routers de mensajes) que se comunican con Cassandra a través de un protocolo Thrift anterior

Estado del entorno de ejecución en esta etapa	Estado de administración en esta etapa
Tiempo de ejecución completamente funcional	Administración completamente funcional

Paso 1: Prepárate para la actualización

Los pasos que se indican a continuación se suman a los archivos estándar que sueles crear, como el archivo de configuración estándar de Apigee para habilitar las actualizaciones de componentes.

Cambia Cassandra para que use LeveledCompactionStrategy.
Crea una copia de seguridad de Cassandra con Apigee.
Crea instantáneas de VM de los nodos de Cassandra (si es posible).
Crea un archivo de configuración de actualización de Cassandra en cada nodo de Cassandra en /opt/apigee/apigee-cassandra/cass_upgrade.conf con el siguiente contenido:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
Si no se puede crear el archivo en /opt/apigee/apigee-cassandra/cass_upgrade.conf, crea el archivo /opt/silent.conf con el mismo contenido en cada nodo de Cassandra.
Precaución: El instalador de actualización de Apigee buscará el archivo en las ubicaciones mencionadas anteriormente. Si el archivo no está presente en ninguna de las ubicaciones mencionadas anteriormente, la actualización fallará y mostrará un mensaje como el siguiente:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
Si esto sucede, la actualización fallará, pero es probable que el servicio de Cassandra en el nodo esté detenido. Puedes iniciar el servicio de Cassandra como de costumbre y volver a intentar la actualización colocando el archivo de configuración en cualquiera de las ubicaciones esperadas. Además, si se encuentra el archivo, pero las configuraciones proporcionadas son incorrectas (por ejemplo, las credenciales de Cassandra son incorrectas), la actualización fallará con un error como el siguiente:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
En este caso, de manera similar, inicia el servicio de Cassandra si se detiene cuando falla la actualización y vuelve a intentar la actualización después de corregir la configuración en el archivo.

Si usas la función SmartDocs del portal para desarrolladores de Apigee Drupal 7, exporta cada uno de tus modelos descargándolos en formato JSON desde la IU del portal para desarrolladores. Estos modelos deberán volver a importarse a Apigee después de que se actualicen los servidores de administración.
Asegúrate de que se pueda acceder a los puertos 9160 y 9042 desde todos los componentes de Edge para nube privada 4.52.02 a los nodos de Cassandra si aún no están presentes. Consulta los requisitos de los puertos para obtener más información.

Paso 2: Actualiza todos los nodos de Cassandra

Actualiza todos los nodos de Cassandra en todas las regiones de uno en uno. Ejecuta los siguientes comandos en cada nodo:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Una vez que se actualice un nodo, ejecuta el siguiente comando en él para realizar algunas validaciones antes de continuar:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

Lo anterior mostrará un resultado similar al siguiente:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Estado del entorno de ejecución en esta etapa	Estado de administración en esta etapa
Tiempo de ejecución completamente funcional	La siguiente función de administración se degrada después de actualizar Cassandra: API de Management para crear un producto de API con un entorno API de Management para actualizar un producto de API con el entorno API de Management para borrar una organización

Nota: Si actualizas desde Edge Private Cloud 4.51.00 o 4.52.00, también deberás seguir pasos adicionales para actualizar Zookeeper. Aunque ZooKeeper y Cassandra pueden estar ubicados en los mismos nodos, se recomienda actualizarlos por separado.

Puedes usar el siguiente comando en un nodo para actualizar Zookeeper:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

El siguiente comando se puede usar en un nodo para actualizar Cassandra:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Si actualizas de Edge Private Cloud 4.52.01 a 4.52.02, la actualización de Zookeeper es menor y se puede realizar junto con Cassandra. Para actualizar Cassandra y Zookeeper con un solo comando en los nodos en los que se encuentran, usa el siguiente comando. Se recomienda hacerlo solo si ya ejecutas la versión 3.8.3 de Zookeeper en la versión 4.52.01 de la nube privada:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

Paso 3: Actualiza todos los nodos de administración

Actualiza todos los nodos de administración en todas las regiones de uno en uno:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Estado del entorno de ejecución	Estado de administración
Tiempo de ejecución completamente funcional	Degradación de la API de Management: La función SmartDocs del portal para desarrolladores de Drupal 7 no muestra datos.

Paso 3a: [Opcional] Importa los SmartDocs que se exportaron anteriormente

Una vez que se hayan actualizado todos los servidores de administración, puedes importar los modelos de SmartDocs que exportaste en el paso 1. También puedes hacerlo más adelante.

Estado del entorno de ejecución	Estado de administración
Tiempo de ejecución completamente funcional	Administración completamente funcional

Paso 4: Actualiza todos los nodos del entorno de ejecución

Actualiza todos los nodos de routers y procesadores de mensajes en todas las regiones de uno en uno:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Estado del entorno de ejecución	Estado de administración
Tiempo de ejecución completamente funcional	Administración completamente funcional

Paso 5: Actualiza todos los componentes restantes de Edge for Private Cloud 4.52.02

Actualiza todos los nodos edge-qpid-server y edge-postgres-server restantes en todas las regiones de uno en uno.

En esta etapa, si actualizas desde versiones anteriores a Edge for Private Cloud 4.52.01 y sigues pasos adicionales para actualizar Qpid o Postgres, sigue los pasos correspondientes para actualizarlos.

Estado del entorno de ejecución	Estado de administración
Tiempo de ejecución completamente funcional	Administración completamente funcional

Paso 6: Pasos posteriores a la actualización

Ejecuta el siguiente comando en cada nodo de Cassandra uno por uno después de que se complete la actualización:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Ejecuta el siguiente comando para quitar las tablas antiguas que no se usan del clúster de Cassandra. Hasta que se ejecute, no podrás usar ciertas funciones de Cassandra (como configurar una autenticación nueva; los mecanismos de autenticación anteriores seguirán funcionando). Este comando solo se puede ejecutar en 1 nodo del clúster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Completa el paso 3a si aún no lo hiciste.

Estado del entorno de ejecución	Estado de administración
Tiempo de ejecución completamente funcional	Administración completamente funcional

Actualización obligatoria a Zookeeper 3.8.3

Aunque Edge for Private Cloud 4.52.02 no incluye una actualización a Zookeeper, si actualizas desde versiones anteriores a 4.52.01, debes seguir los pasos para actualizar Zookeeper.

Si actualizas desde las versiones 4.51.00 o 4.52.00 de Edge para la nube privada, consulta los pasos que se indican en Actualización obligatoria a Zookeeper 3.8.3 para actualizar Zookeeper.
Si actualizas desde la versión 4.52.01 de Edge para una nube privada, ya deberías estar usando la versión 3.8.3 de Zookeeper y no necesitas seguir ningún paso especial para actualizarlo.

Actualización obligatoria a Postgres 14

Si actualizas de Edge para una nube privada 4.51.00 a 4.52.02, debes seguir los pasos para actualizar Postgres, aunque Edge para una nube privada 4.52.02 no incluya una actualización de Postgres. La actualización de Edge para la nube privada de 4.51.00 a 4.52.02 requiere pasos adicionales de actualización de Postgres. Consulta la sección Actualización obligatoria a Postgres 14.
Si actualizas de Edge para la nube privada 4.52.00 o 4.52.01 a 4.52.02, no se requieren pasos adicionales de actualización de Postgres.

Actualización obligatoria a Qpid J-Broker

Aunque Edge for Private Cloud 4.52.02 no incluye una actualización a QPID, si actualizas desde versiones anteriores a la 4.52.01, debes seguir los pasos para actualizar QPID.

Si actualizas de Edge para una nube privada 4.51.00 o 4.52.00 a 4.52.02, debes seguir pasos adicionales de actualización de QPID. Consulta la sección Actualiza Qpid si actualizas de la versión 4.51.00 o 4.52.00 a la 4.52.02.
Si actualizas de Edge for Private Cloud 4.52.01 a 4.52.02, ya deberías estar usando la versión más reciente del agente de Qpid, y no se requieren pasos adicionales de actualización de QPID.

IU de Edge nuevo

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 Apigee Edge para una nube privada.

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 Cómo instalar la nueva IU de Edge.

Cómo actualizar 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 realizas la actualización:

De 4.51.00 a 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 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 la última vez.

Si la falla requiere que reviertas la actualización a la versión anterior, consulta Cómo revertir la versión 4.52.00 para obtener instrucciones detalladas.

Información de actualización de registro

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

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

Si la persona 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 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 cerrarlo.

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, luego, vuelve a agregarlo 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 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 Habilitación o inhabilitación de 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 vuelva a estar accesible.
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 el nodo combinado de router y procesador de mensajes:
- Antes de la actualización, haz lo siguiente:
  1. Hacer que el router no sea accesible
  2. Hacer que el procesador de mensajes no sea accesible
- Después de la actualización, haz lo siguiente:
  1. Haz que se pueda acceder al procesador de mensajes.
  2. Haz que el router sea accesible.
En nodos de router individuales:
- Antes de la actualización, haz que el router no sea accesible.
- Después de la actualización, asegúrate de que se pueda acceder al router.
En nodos de Message Processor únicos:
- Antes de la actualización, haz que el procesador de mensajes no sea accesible.
- Después de la actualización, asegúrate de que se pueda acceder al procesador de mensajes.

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.50.00 o 4.51.00.

Actualiza a la versión 4.52.02 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:
Nota: Si tu sistema operativo es RHEL 8.0 a 8.6, omítelo.
```
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 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 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, haz lo siguiente:
1. Descarga el archivo bootstrap_4.52.02.sh de Edge a /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Ejecuta el siguiente comando para instalar la utilidad y las dependencias de apigee-service de Edge 4.52.02:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  En el ejemplo anterior, 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: Continuar 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.
  
  Aquí:
  - 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: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
    - 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 4.50.00 o 4.51.00.
  Para ejecutar update.sh en todos los componentes, configura component como "todo", 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 el componente de la IU de Edge en todos los nodos que lo ejecutan, si aún no lo hiciste:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. 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.

Si más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.52.02.

Actualiza a la versión 4.52.02 desde un repositorio local

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

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

Crea un repositorio local 4.52.02 como se describe en "Crea un repositorio de Apigee local" en Instala la utilidad apigee-setup de Edge.
NOTA: Si ya tienes un repositorio existente, puedes agregar el repositorio 4.52.02 como se describe en “Actualiza un repositorio de Apigee local” 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.52.02.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.02.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 y las dependencias de Edge desde /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Ten en cuenta que debes incluir 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 "Install from the repo using the Nginx webserver" en Install the Edge utility apigee-setup.
2. En el nodo remoto, descarga el archivo bootstrap_4.52.02.sh de Edge a /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  En el que uName:pWord son el nombre de usuario y la contraseña que estableciste anteriormente 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 y las dependencias de Edge:
```
sudo bash /tmp/bootstrap_4.52.02.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, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
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
```
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
```
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
```
Aquí:
- 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, procesador de mensajes, router, servidor QPID y servidor Postgres
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: SSO de Apigee (si instalaste el SSO)
  - ue IU de Edge nuevo
  - 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 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
```
Para ejecutar update.sh en todos los componentes, configura component como "todo", 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
```
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
```
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.

Si más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.52.02.

Orden de actualización de la máquina

El orden en 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, 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.

Actualización independiente de 1 nodo

Para actualizar una configuración independiente de 1 nodo a la versión 4.52.02, haz lo siguiente:

Actualiza todos los componentes:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(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.

Actualiza Cassandra y ZooKeeper en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Actualiza Postgres en la máquina 2:

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

Actualiza el 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 Qpid en la máquina 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza la IU en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(Si instalaste apigee-adminapi) Actualizaste la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(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
```
En el que sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

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.

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Actualiza Postgres en la máquina 4:

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

Actualiza Postgres en la máquina 5:

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

Actualiza el 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 4, 5, 1, 2 y 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza Qpid en la máquina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Qpid en la máquina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
- Nueva IU de Edge: Si instalaste la nueva IU de Edge, actualiza el componente ue en la máquina adecuada (es posible que no sea la máquina 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(Si instalaste apigee-adminapi) Actualizaste la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(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
```
En el que sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
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 (es posible que no sea la máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Actualización del clúster de 9 nodos

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

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Actualiza Postgres en la máquina 8:

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

Actualiza Postgres en la máquina 9:

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

Actualiza el 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 6, 7, 8, 9, 1, 4 y 5 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza Qpid en las máquinas 6 y 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(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
```
En el que sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
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 (es posible que no sea la máquina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

Actualización del clúster 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.

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Actualiza Postgres en la máquina 8:

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

Actualiza Postgres en la máquina 9:

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

Actualiza LDAP en las máquinas 4 y 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

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
```

Actualiza Qpid en las máquinas 12 y 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
```
(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
```
(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
```
En el que sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
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 del clúster de 12 nodos

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

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

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
```

Actualiza Postgres:

Máquina 6 en el centro de datos 1

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

Máquina 12 en el centro de datos 2

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

Actualiza LDAP:

Máquina 1 en el centro de datos 1

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Máquina 7 en el centro de datos 2

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

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
```

Actualiza qpidd:

Máquinas 4 y 5 en el centro de datos 1

Actualiza qpidd en la máquina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza qpidd en la máquina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Máquinas 10 y 11 en el centro de datos 2

Actualiza qpidd en la máquina 10:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza qpidd en la máquina 11:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza la IU nueva (ue) o la clásica (ui):

Máquina 1 en el centro de datos 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

Máquina 7 en el centro de datos 2:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(Si instalaste apigee-adminapi) Actualizaste 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
```
(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
```
Reinicia el componente de la IU nueva de Edge (edge-management-ui) o la IU clásica de Edge (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:

ZooKeeper
Cassandra
ps
LDAP
Edge, es decir, el perfil "-c edge" en todos los nodos en el orden: nodos con servidor Qpid, servidor Postgres de Edge, servidor de administración, procesador de mensajes y router.
NOTA: Si un nodo tiene instalado el servidor Qpid y el servidor Postgres de Edge, ejecuta el paso de perfil "-c edge".
qpidd
IU de Edge (clásica o nueva)
apigee-adminapi
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.