Apigee admite la actualización de Edge para la nube privada desde la versión 4.51.00 o la versión 4.52.00 directamente a la versión 4.52.01. 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 que ejecute la cuenta 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 contiene componentes de varias versiones.
Actualiza los 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
Antes de realizar la actualización, te recomendamos que realices una copia de seguridad completa de todos los nodos por motivos de seguridad. 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 versión nueva no funcione correctamente. Para obtener más información sobre las copias de seguridad, consulta Copias de seguridad y restablecimiento.
- Asegúrate de que Edge esté en ejecución
Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:/opt/apigee/apigee-service/bin/apigee-all status
- Asegúrate de que la estrategia de comptificación de Cassandra sea
LeveledCompactionStrategy
Asegúrate de que la estrategia de compatificación de Cassandra esté configurada enLeveledCompactionStrategy
, como se describe en Cambia la estrategia de compactación de Cassandra.
Propagación automática de la configuración de la propiedad
Si configuraste propiedades editando archivos .properties
en /opt/apigee/customer/application
, la actualización conservará estos valores.
Actualización obligatoria a Zookeeper 3.8.3
Esta versión de Edge para la nube privada incluye una actualización a Zookeeper 3.8.3. Como parte de esa actualización, todos los datos de Zookeeper se migrarán a Zookeeper 3.8.3.
Antes de actualizar Zookeeper, lee la guía de mantenimiento de Zookeeper. La mayoría de los sistemas de producción perimetrales 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 las elecciones de líderes de Zookeeper y el resto se configuran como observadores. Consulta Acerca de líderes, seguidores, votantes y observadores para obtener más información. Los nodos votantes eligen a un líder, luego, 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 cierra el nodo líder. Esto podría afectar las operaciones de administración 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 procesador de mensajes, etc. No debería afectar las APIs de entorno de ejecución de Apigee (a menos que estas APIs de entorno de ejecución llamen a las APIs de administración) durante la actualización de Zookeeper mientras se sigue el procedimiento que se indica a continuación.
En un nivel alto, el proceso de actualización implica realizar una copia de seguridad de cada nodo. Luego, se actualiza a todos los observadores y seguidores, y, por último, se actualiza el nodo líder.
Crear una copia de seguridad
Realiza una copia de seguridad de todos los nodos de Zookeeper para usar en caso de que se requiera una reversión. Ten en cuenta que una reversión restablecerá a 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 está almacenada 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 VM para su restablecimiento o reversión (si es necesario).
Identificar líderes, seguidores y observadores
Nota: Los siguientes comandos de muestra 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.3-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 un observador, un líder o un seguidor (es decir, un votante que no es líder) según la configuración del nodo. Nota: En una instalación independiente de Edge con un solo nodo de ZooKeeper,Mode
se configura como independiente. - Repite los pasos 1 y 2 en cada nodo de ZooKeeper.
Actualiza Zookeeper en los nodos del observador y de los seguidores
Actualiza Zookeeper en cada uno de los nodos del observador y de los seguidores de la siguiente manera:
- Descarga y ejecuta el arranque de Edge para la nube privada 4.52, como se describe en Actualiza a 4.52.01 en un nodo con una conexión a Internet externa. Es probable que el proceso varíe en función de si el nodo tiene una conexión a Internet externa o si realizas una instalación sin conexión.
- Actualiza el componente 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 Zookeeper y te asegures de que tu clúster funcione correctamente antes de actualizar otros componentes. - Repite los pasos anteriores en cada nodo de seguimiento y observador de Zookeeper.
Cerrar la lista de líderes
Una vez que se hayan actualizado todos los nodos del observador y del seguidor, cierra 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 a un nuevo líder, 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 procesadores de mensajes, etcétera.
Verifica que se elija al nuevo líder
Sigue los pasos detallados en la sección anterior Identifica líderes, seguidores y observadores para verificar que se haya elegido un nuevo líder entre los seguidores una vez que se haya detenido al existente. Ten en cuenta que se podría haber elegido un líder en un centro de datos diferente al actual.
Actualizar líder
Sigue los mismos pasos que se indican en Cómo actualizar Zookeeper en los nodos del observador y de los seguidores más arriba.
Una vez que también se actualice el nodo líder anterior, 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 a los observadores y a los seguidores.
- Descarga y ejecuta el arranque de la versión a la que estás revirtiendo, ya sea 4.50 o 4.51. Es probable que el proceso varíe en función de si el nodo tiene una conexión a Internet externa o si sigues una 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 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, sigue los pasos 2 a 5 para revertir el nodo líder.
- Después de que todos los nodos se hayan revertido, verifica el estado del clúster y asegúrate de que haya un nodo líder en él.
Restaurar copia de seguridad
Consulta Cómo restablecer 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 para la nube privada incluye una actualización a Postgres 14. Como parte de esta actualización, todos los datos de Postgres se migran a Postgres 14.
- Si estás actualizando de Edge para la nube privada 4.51.00 a 4.52.01, es necesario seguir los pasos de actualización adicionales de Postgres. Consulta la sección Actualización requerida a Postgres 14 si actualizas de la versión 4.51.00 a la 4.52.01.
- Si actualizas de Edge para la nube privada 4.52.00 a la versión 4.52.01, no es necesario realizar pasos de actualización complementarios de Postgres.
Actualizar Qpid
Esta versión de Edge para nube privada incluye una actualización a Qpid J-Broker.
Te recomendamos que selecciones uno de los siguientes métodos para realizar la actualización de Qpid:
Actualización in situ sin tiempo de inactividad
Este método garantiza que no haya tiempo de inactividad para tu entorno de ejecución perimetral y minimiza la pérdida de datos del entorno de ejecución, si los hubiera, adquiridos para las estadísticas.
Para realizar una actualización in situ sin tiempo de inactividad, actualiza a Qpid:
- Elige un nodo de Qpid para comenzar.
- Detén el agente de Qpid en el nodo:
apigee-service apigee-qpidd stop
- Bloquea el tráfico entrante en el puerto del agente 5672 de todos los procesadores de mensajes mediante la aplicación de un firewall. Puedes aplicar este firewall a nivel de la instancia de nodo de Qpid o algún otro
componente externo de firewall o red.
Recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para las solicitudes DROP provenientes de direcciones IP del procesador de mensajes al nodo de Qpid en el puerto 5672 mediante IPTables, puedes usar un comando como el siguiente:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Vuelve a iniciar el agente de Qpid para desviar los mensajes existentes, si los hay:
apigee-service apigee-qpidd start
- Comprueba que las colas existentes estén vacías:
qpid-stat -q
Si los mensajes están atascados en la cola de mensajes no entregados (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), vacía la cola con los pasos para resolver datos de estadísticas atascados en la cola de mensajes no entregados.
- Después de verificar que las colas se hayan vaciado en el nodo anterior, detén
apigee-qpidd
:apigee-service apigee-qpidd stop
- Actualiza Qpid en el nodo:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Reiniciar
edge-qpid-server
:apigee-service edge-qpid-server restart
Quita la regla de firewall aplicada en el paso 3.
Quita todas las direcciones IP del procesador de mensajes a las que se aplicó el firewall. Una vez que se quiten los firewalls, se aceptarán las solicitudes provenientes de direcciones IP del procesador de mensajes al nodo Qpid en el puerto 5672. Si usaste
iptables
para agregar el firewall, quitarlo y enumerar la configuración existente, puedes usar comandos como los siguientes:iptables -F iptables -L
- Usa la supervisión web para verificar que las colas de Qpid reciban mensajes:
http://QPID_NODE_IP:8090
- Repite los pasos del 1 al 9 para cada nodo de Qpid.
Asigna un nodo de Qpid nuevo
Este método configura e instala apigee-qpidd
y edge-qpid-server
en un nodo nuevo.
- Agrega un nodo de Qpid nuevo. En este paso, se configura un nodo de Qpid con J-broker. Para ver los pasos detallados, consulta Cómo agregar un servidor de Qpid.
- Elige un nodo de Qpid existente (un nodo de la versión desde la que realizas la actualización).
- Detén el agente de Qpid en el nodo:
apigee-service apigee-qpidd stop
- Bloquea el tráfico entrante en el puerto del agente 5672 de todos los procesadores de mensajes mediante la aplicación de un firewall. Puedes aplicar este firewall a nivel de la instancia de nodo de Qpid o algún otro
componente externo de firewall o red.
Recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para las solicitudes DROP provenientes de direcciones IP del procesador de mensajes al nodo de Qpid en el puerto 5672 mediante IPTables, puedes usar un comando como el siguiente:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Vuelve a iniciar el agente de Qpid para desviar los mensajes existentes, si los hay:
apigee-service apigee-qpidd start
- Asegúrate de que las colas existentes estén vacías:
qpid-stat -q
Si los mensajes están atascados en la cola de mensajes no entregados (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), sigue los pasos que se indican en el tema de solución de problemas Datos de Analytics atascados en la cola de mensajes no entregados de Qpidd.
- Después de verificar que las colas se hayan vaciado en el nodo anterior, detén
apigee-qpidd
apigee-service apigee-qpidd stop
- Anula el registro del nodo de Qpid anterior mediante los pasos que se indican en Cómo quitar un servidor de Qpid.
- Sigue agregando un nodo nuevo y quitando uno antiguo, uno a la vez, hasta que se actualicen todos los nodos de Qpid.
Revertir
Para revertir a una versión de funciones anterior, asegúrate de descargar el archivo bootstrap.sh
de la versión a la que quieres revertir. Para revertir a la versión 4.52.00, descarga bootstrap_4.52.00.sh
.
Para revertir Qpid, sigue estos pasos en todos los hosts de Qpid:
- Detener el agente de Qpid existente
apigee-service apigee-qpidd stop
- Bloquea el tráfico entrante en el puerto del agente 5672 de todos los procesadores de mensajes mediante la aplicación de un firewall. Puedes aplicar este firewall a nivel de la instancia de nodo de Qpid o algún otro
componente externo de firewall o red.
Recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para las solicitudes DROP provenientes de direcciones IP del procesador de mensajes al nodo de Qpid en el puerto 5672 mediante IPTables, puedes usar un comando como el siguiente:
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Vuelve a iniciar el agente de qpid para desviar los mensajes existentes, si los hay:
apigee-service apigee-qpidd start
- Asegúrate de que las colas existentes estén vacías. Para comprobarlo, accede al portal de administración de Qpid:
http://QPID_NODE_IP:8090
Nota: Si no se puede acceder a este puerto 8090 en el nodo QPID, puedes usar mecanismos alternativos, como la redirección de puertos SSH, para acceder a esta URL. - Después de verificar que se hayan vaciado las colas, detén y desinstala Qpid:
apigee-service apigee-apidd uninstall
- Borra el directorio de datos de Qpid:
rm -r APIGEE_ROOT/data/apigee-qpidd
- Reinstala el agente de Qpid:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Una vez que se reinstale el agente de Qpid, quita la configuración de firewall y enumera la configuración existente con los siguientes comandos:
iptables -F
iptables -L
Nueva IU de Edge
En esta sección, se enumeran las consideraciones relacionadas con la IU de Edge. Si deseas obtener más información, consulta La nueva IU perimetral para la nube privada.
Instala la IU de Edge
Después de completar la instalación inicial, Apigee recomienda instalar la IU de Edge, que es una interfaz de usuario mejorada para desarrolladores y administradores de Apigee Edge para 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 Instala la nueva IU de Edge.
Actualiza la IU de Edge
A fin de actualizar el componente de IU de Edge, considera 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 en esta sección para el componente
edge-management-ui
.
Actualizar con Apigee mTLS
Para actualizar Apigee mTLS , sigue estos pasos:
Revierte una actualización
En caso de que se produzca un error en la actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh
. Puedes ejecutar la actualización varias veces y continúa desde donde se detuvo la última vez.
Si el error requiere que reviertas la actualización a la versión anterior, consulta Revertir 4.52.00 para obtener instrucciones detalladas.
Información de actualización de registros
De forma predeterminada, la utilidad update.sh
escribe información de registro en:
/opt/apigee/var/log/apigee-setup/update.log
Si la persona que ejecuta la utilidad update.sh
no tiene acceso a ese directorio, escribirá el registro en el directorio /tmp
como un archivo llamado update_username.log
.
Si la persona no tiene acceso a /tmp
, fallará la utilidad update.sh
.
Actualización sin tiempo de inactividad
La actualización sin tiempo de inactividad, o una actualización progresiva, te permite actualizar la instalación de Edge sin interrumpir Edge.
La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos o superior.
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 vuelve a agregarlo al balanceador de cargas.
- Actualiza las máquinas en el orden correcto para la instalación, como se describe en Actualización del orden de la máquina.
- Cuando llegue el momento de actualizar los routers, selecciona cualquier router para que sea inaccesible, como se describe en Habilita o inhabilita la accesibilidad del servidor (procesador de mensajes/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.
- Vuelve a establecer la conexión con el router.
- Repite los pasos 2 a 4 para los routers restantes.
- Continúa la actualización para las máquinas restantes en la instalación.
Ten en cuenta lo siguiente antes y después de la actualización:
- En el nodo combinador del router y del procesador de mensajes, haz lo siguiente:
- Antes de la actualización, haz lo siguiente:
- Haz que el router sea inaccesible.
- Hacer que Message Processor no esté disponible.
- Después de la actualización, haz lo siguiente:
- Permite el acceso al Message Processor.
- Haz que el router sea accesible.
- Antes de la actualización, haz lo siguiente:
- En nodos de un solo router, haz lo siguiente:
- Antes de realizar la actualización, haz que el router sea inaccesible.
- Después de la actualización, haz que el router sea accesible.
- En los nodos de un solo Message Processor, haz lo siguiente:
- Antes de realizar la actualización, haz que no sea posible acceder a Message Processor.
- Después de la actualización, permite que se pueda acceder a Message Processor.
Usar 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 4.52.01 en un nodo con una conexión a Internet externa
Usa el siguiente procedimiento para actualizar los componentes de Edge de un nodo:
- Si existe, inhabilita los trabajos
cron
configurados para realizar una operación de reparación en Cassandra hasta que se complete la actualización. - Accede a tu nodo como raíz para instalar los RPM de Edge.
- Instala
yum-utils
yyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Inhabilita SELinux como se describe en Instala la utilidad de apigee-setup de Edge.
- Si instalas 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 estás en Edge 4.51.00, haz lo siguiente:
- Descarga el archivo
bootstrap_4.52.01.sh
de Edge en/tmp/bootstrap_4.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- Instala la utilidad
apigee-service
y las dependencias de Edge 4.52.01 mediante la ejecución del siguiente comando:sudo bash /tmp/bootstrap_4.52.01.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 solicitará que lo ingreses.
De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. De lo contrario, el instalador lo instalará por ti.
Usa la opción
JAVA_FIX
para especificar cómo controlar la instalación de Java.JAVA_FIX
toma los siguientes valores:I
: Instala OpenJDK 1.8 (predeterminado).C
: Continúa sin instalar Java.Q
: Salir. Para esta opción, debes instalar Java por tu cuenta.
- Usa
apigee-service
para actualizar la utilidadapigee-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
- Para ejecutar la utilidad
update
en tus nodos, ejecuta el siguiente comando:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Haz esto en el orden descrito en Actualización del orden de la máquina.
Aquí:
- component es el componente de Edge que se actualizará. Entre los valores posibles, se incluyen los siguientes:
cs
: Cassandraedge
: Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO de Apigee (si instalaste el SSO)ue
: Nueva IU de Edgeui
: IU de Edge clásicazk
: cuidador del zoológico
- configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de las versiones 4.50.00 o 4.51.00.
Puedes ejecutar
update.sh
en todos los componentes si configuras component como "todos", pero solo si tienes un perfil de instalación de Edge todo en uno (AIO). Por ejemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component es el componente de Edge que se actualizará. Entre los valores posibles, se incluyen los siguientes:
- Reinicia el componente de 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
- Prueba la actualización mediante la ejecución de la utilidad
apigee-validate
en el servidor de administración, como se describe en Prueba la instalación.
- Descarga el archivo
Si luego decides revertir la actualización, usa el procedimiento que se describe en Revertir 4.52.01.
Actualización a la versión 4.52.01 desde un repositorio local
Si tus nodos perimetrales 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 ese repositorio:
- Crea un archivo .tar del repositorio, copia el archivo .tar en un nodo y, luego, actualiza Edge desde el archivo .tar.
- Instala un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él. Apigee proporciona el servidor web Nginx para que lo uses, o que puedes usar tu propio servidor web.
Sigue estos pasos para actualizar desde un repositorio local 4.52.01:
- Crea un repositorio local 4.52.01 como se describe en “Crea un repositorio local de Apigee” en Instala la utilidad Edge apigee-setup.
- Para instalar apigee-service desde un archivo .tar, haz lo siguiente:
- 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.01.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia el archivo .tar en el nodo en el que deseas actualizar Edge. Por ejemplo, cópialo en el directorio
/tmp
del nodo nuevo. - En el nodo nuevo, descomprime el archivo en el directorio
/tmp
:tar -xzf apigee-4.52.01.tar.gz
Con este comando, se creará un directorio nuevo, llamado
repos
, en el directorio que contiene el archivo .tar. Por ejemplo,/tmp/repos
. - Instala la utilidad
apigee-service
de Edge y las dependencias desde/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Ten en cuenta que incluyes la ruta de acceso al directorio repos en este comando.
- En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un solo archivo .tar llamado
- Para instalar apigee-service mediante el servidor web Nginx, sigue estos pasos:
- 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.
- En el nodo remoto, descarga el archivo
bootstrap_4.52.01.sh
de Edge en/tmp/bootstrap_4.52.01.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.
- En el nodo remoto, instala la utilidad
apigee-setup
y las dependencias de Edge:sudo bash /tmp/bootstrap_4.52.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 actualizar la utilidadapigee-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 descrito 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, los siguientes componentes se actualizan:
cs
: Cassandraedge
: Todos los componentes de Edge, excepto la IU perimetral: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO de Apigee (si instalaste el SSO)ue
Nueva IU de Edgeui
: IU de Edge clásicazk
: cuidador del zoológico
- configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de las versiones 4.50.00 o 4.51.00.
Puedes ejecutar
update.sh
en todos los componentes si configuras component como "todos", pero solo si tienes un perfil de instalación de Edge todo en uno (AIO). Por ejemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component es el componente de Edge que se actualizará. Por lo general, los siguientes componentes se actualizan:
- 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
- Prueba la actualización mediante la ejecución de la utilidad
apigee-validate
en el servidor de administración, como se describe en Prueba la instalación.
Si luego decides revertir la actualización, usa el procedimiento que se describe en Revertir 4.52.01.
Actualización del orden 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.
- En cualquier máquina con varios componentes perimetrales (servidor de administración, procesador de mensajes, router, servidor QPID, pero no el servidor Postgres), usa la opción
-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 la máquina especificado.
- No hay un paso adicional 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 4.52.01, 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 utilidadapigee-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 ver la lista de topologías perimetrales y la cantidad 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 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
) Se actualizó la utilidadapigee-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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de 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 ver la lista de topologías perimetrales y la cantidad 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 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
- IU clásica: Si usas la IU clásica, actualiza el componente
- (Si instalaste
apigee-adminapi
) Se actualizó la utilidadapigee-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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de 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
- IU clásica: Si usas la IU clásica, reinicia el componente
Actualización en 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 ver la lista de topologías perimetrales y la cantidad 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 la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Actualiza los componentes de Edge de 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 utilidadapigee-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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de 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
- IU clásica: Si usas la IU clásica, reinicia el componente
Actualización en clústeres de 13 nodos
Actualiza los siguientes componentes para una instalación agrupada en clústeres de 13 nodos:
Consulta Topologías de instalación para ver la lista de topologías perimetrales y la cantidad 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 utilidadapigee-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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de 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
- IU clásica: Si usas la IU clásica, reinicia el componente
Actualización en 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 ver la lista de topologías perimetrales y la cantidad de nodos.
- Actualiza Cassandra y ZooKeeper:
- 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
- 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
- En las máquinas 1, 2 y 3 del centro de datos 1:
- 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
- Máquina 6 en el centro de datos 1
- 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
- Máquina 1 en el centro de datos 1
- Actualiza los componentes de Edge:
- Máquinas 4, 5, 6, 1, 2, 3 en el centro de datos 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 10, 11, 12, 7, 8, 9 en el centro de datos 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 4, 5, 6, 1, 2, 3 en el centro de datos 1
- Actualiza qpidd:
- Máquinas 4, 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
- Actualiza
- Máquinas 10, 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
- Actualización
qpidd
en la máquina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
- Máquinas 4, 5 en el centro de datos 1
- Actualiza la IU nueva (
ue
) o la IU 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
- Máquina 1 en el centro de datos 1:
- (Si instalaste
apigee-adminapi
) Actualiza la utilidadapigee-adminapi
:- Máquina 1 en el centro de datos 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máquina 7 en el centro de datos 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máquina 1 en el centro de datos 1:
- Actualiza el SSO de Apigee (si instalaste Apigee SSO):
- Máquina 1 en el centro de datos 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Máquina 7 en el centro de datos 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
En el ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Máquina 1 en el centro de datos 1:
- Reinicia la nueva IU de Edge (
edge-management-ui
) o el componente de 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, que se refiere al perfil “-c Edge” en todos los nodos del orden: nodos con el servidor Qpid, servidor Edge Postgres, servidor de administración, procesador de mensajes y router.
- qpidd
- IU de Edge (clásica o nueva)
apigee-adminapi
- SSO de Apigee
Después de completar la actualización, asegúrate de reiniciar el componente de IU de Edge en todas las máquinas que lo ejecutan.