En esta sección, se describe cómo actualizar Apigee Edge 4.19.06 o 4.50.00 a 4.51.00.
Quién puede realizar la actualización
La persona que ejecuta la actualización debe ser la misma que instaló Edge originalmente o la persona que ejecuta la actualización con permisos de administrador.
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.
Propagación automática de la configuración de la propiedad
Si estableciste propiedades mediante la edición de archivos .properties
en /opt/apigee/customer/application
, la actualización conservará estos valores.
Actualización obligatoria a Postgres 10.17
Esta versión de Edge incluye una actualización a Postgres 10.17. Como parte de esa actualización, todos los datos de Postgres se migran a Postgres 10.17.
La mayoría de los sistemas de producción de Edge usan dos nodos de Postgres configurados para la replicación de instancia principal en espera. Durante el proceso de actualización, mientras los nodos de Postgres no se actualizan, los datos de estadísticas aún se escriben en los nodos de Qpid. Después de que los nodos de Postgres se actualizan y se vuelven a poner en línea, los datos de estadísticas se envían a los nodos de Postgres.
La forma en la que realizas la actualización de Postgres depende de cómo configuraste el almacenamiento de datos para tus nodos de Postgres:
- Si usas el almacenamiento de datos local para los nodos de Postgres, debes instalar un nodo en espera de Postgres nuevo mientras dure la actualización. Una vez que
se complete la actualización, puedes retirar el nuevo nodo en espera de Postgres.
Se requiere el nodo en espera adicional de Postgres si tienes que revertir la actualización por algún motivo. Si tienes que revertir la actualización, el nuevo nodo en espera de Postgres se convierte en el nodo principal de Postgres después de la reversión. Por lo tanto, cuando instalas el nuevo nodo en espera de Postgres, este 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 y 2 nodos de Edge, topologías que se usan para el prototipado 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 almacenamiento en red para tus nodos de Postgres, como lo recomienda Apigee, no tienes que instalar un nodo nuevo de Postgres. En los procedimientos que aparecen a continuación, puedes omitir los pasos que especifican la instalación y posterior retiro de un nodo en espera de Postgres nuevo.
Antes de comenzar el proceso de actualización, toma una instantánea de la 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 realizar una reversión, podrás restablecer el nodo de Postgres a partir de esa instantánea.
Instala un nodo en espera de Postgres nuevo
En este procedimiento, se crea un servidor en espera de Postgres en un nodo nuevo. Asegúrate de instalar un servidor en espera de Postgres nuevo para la versión existente de Edge (4.19.06 o 4.50.00), no para la versión 4.51.00.
A fin de realizar la instalación, usa el mismo archivo de configuración que usaste para instalar la versión actual de Edge.
Para crear un nodo en espera de Postgres nuevo, haz lo siguiente:
- En la instancia principal actual de Postgres, edita el archivo
/opt/apigee/customer/application/postgresql.properties
para configurar 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
Donde 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
- Verifica que el nuevo nodo en espera se haya agregado mediante la visualización del archivo
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
en la instancia 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:
- Edita el archivo de configuración que usaste para instalar tu 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
- Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
- Según la versión de Edge a la que realices la actualización, realiza una de las siguientes acciones:
- Si actualizas desde Edge 4.19.06, descarga el archivo Boot_4.19.06.sh de Edge a
/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
.A continuación, instala la utilidad
apigee-service
de Edge y las dependencias:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- Si actualizas desde Edge 4.50.00, descarga el archivo Boot_4.50.00.sh de Edge a
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
.A continuación, instala la utilidad
apigee-service
de Edge y las dependencias:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Si actualizas desde Edge 4.19.06, descarga el archivo Boot_4.19.06.sh de Edge a
- Usa
apigee-service
para instalar la utilidadapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Instala Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- En el nuevo nodo en espera, ejecuta el siguiente comando:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Valida que indique que es en espera.
- Edita el archivo de configuración que usaste para instalar tu versión actual de Edge a fin de especificar
lo siguiente:
Realiza una actualización in situ de Postgres
Para realizar una actualización in situ a Postgres 10.17, 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 de configuración en el host principal:
apigee-service apigee-postgresql configure
- Reinicia el host principal:
apigee-service apigee-postgresql restart
- Configúralo como instancia 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 el modo en espera:
apigee-service apigee-postgresql stop
- Actualiza el modo de espera.
Nota: Si este paso falla o falla, se puede ignorar.
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 10.17, se puede ignorar el error./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Asegúrate de que el modo en espera esté detenido:
apigee-service apigee-postgresql stop
- Quita la configuración anterior en espera:
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
Después de completar este procedimiento, el modo en espera se iniciará correctamente.
Retiro de servicio de un nodo de Postgres
Una vez que se complete la actualización, retira el nodo en espera nuevo:
- 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
- Obtén el UUID del nodo en espera nuevo mediante la ejecución del siguiente comando
curl
en el nodo en espera nuevo: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 mediante la ejecución del siguiente comando en el nodo en espera nuevo:
/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 deconf_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
- Verifica que el nodo en espera nuevo se haya quitado. Para ello, visualiza el archivo
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
en la instancia principal. En ese archivo, solo deberías ver la siguiente línea:host replication apigee existing_standby_ip/32 trust
- Borra el UUID del nodo en espera de ZooKeeper mediante la siguiente llamada a la API de administración
perimetral en el nodo del servidor de administración:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Actualiza los requisitos previos
Ten en cuenta los siguientes requisitos previos antes de actualizar Apigee Edge:
- Crea una copia de seguridad de todos los nodos
Antes de 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 Copia de seguridad y restablecimiento.
- Asegúrate de que Edge esté en ejecución
Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:/opt/apigee/apigee-service/bin/apigee-all status
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 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 la 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 actualizas:
- De 4.19.06 o 4.50.00 a 4.51.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
.
Actualizar con Apigee mTLS
Para actualizar Apigee mTLS , sigue estos pasos:
Revierte una actualización
En caso de que falle una actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh
. Puedes ejecutar la actualización varias veces para continuarla desde donde se interrumpió por última vez.
Si la falla requiere que reviertas la actualización a tu versión anterior, consulta Revertir 4.51.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 la siguiente ubicación:
/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
, falla la utilidad update.sh
.
Actualización sin tiempo de inactividad
Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar la instalación de Edge sin detener Edge.
La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos o más.
La clave para actualizar 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 este y, luego, 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 máquina.
- Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, como se describe en Cómo habilitar o inhabilitar 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 del paso 2 al 4 para los routers restantes.
- Continúa la actualización para 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 del router y el procesador de mensajes, haz lo siguiente:
- Antes de la actualización, haz lo siguiente:
- Haz que el router sea inaccesible.
- Hacer que el procesador de mensajes sea inaccesible.
- 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 la actualización, haz que no se pueda acceder al router.
- Después de la actualización, haz que el router sea accesible.
- En nodos de un solo Message Processor, haz lo siguiente:
- Antes de la actualización, haz que no se pueda acceder al procesador de mensajes.
- Después de la actualización, haz 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.19.06 o 4.50.00.
Actualiza a 4.51.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á presente, inhabilita cualquier trabajo
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.
- 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 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
- Descarga el archivo
bootstrap_4.51.00.sh
de Edge 4.51.00 en/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Instala la utilidad
apigee-service
y las dependencias de Edge 4.51.00 mediante la ejecución del siguiente comando:sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.
De forma predeterminada, el instalador verifica que tengas Java 1.8 instalado. De lo contrario, el instalador la 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
- Ejecuta la utilidad
update
en tus nodos mediante el siguiente comando:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Hazlo en el orden descrito en Actualización del orden de máquina.
Donde:
- 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 instaló el SSO)ue
: Nueva IU de Edgeui
: IU de Edge clásicazk
: Arquitecto
- configFile es el mismo archivo de configuración que usaste para definir los componentes de Edge durante la instalación 4.19.06 o 4.50.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.
Si luego decides revertir la actualización, usa el procedimiento que se describe en Revertir 4.51.00.
Actualiza a la versión 4.51.00 desde un repositorio local
Si tus nodos perimetrales están detrás de un firewall o se les prohíbe de alguna otra manera acceder al repositorio de Apigee en Internet, puedes realizar la actualización desde un repositorio o una duplicación local 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 bien puedes usar tu propio servidor web.
Para actualizar desde un repositorio local 4.51.00, haz lo siguiente:
- Crea un repositorio local 4.51.00 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:
- 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.51.00.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.51.00.tar.gz
Con este comando, se crea 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.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observa que incluyes la ruta de acceso al directorio de repositorios 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 mediante el servidor web NGINX” en Instala la utilidad Edge apigee-setup.
- En el nodo remoto, descarga el archivo
bootstrap_4.51.00.sh
de Edge en/tmp/bootstrap_4.51.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
Donde 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
de Edge y las dependencias:sudo bash /tmp/bootstrap_4.51.00.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 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, se actualizan los siguientes componentes:
cs
: Cassandraedge
: Todos los componentes de Edge, excepto la IU de Edge, (servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres)ldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO de Apigee (si instaló el SSO)ue
Nueva IU de Edgeui
: IU de Edge clásicazk
: Arquitecto
- configFile es el mismo archivo de configuración que usaste para definir los componentes de Edge durante la instalación 4.19.06 o 4.50.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, se actualizan los siguientes componentes:
- Reinicia los componentes de IU en todos los nodos que lo 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.51.00.
Actualización del orden 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.
- En el caso de cualquier máquina con varios componentes de Edge (servidor de administración, procesador de mensajes, router, servidor de QPID y servidor de Postgres, pero no servidor de Postgres), usa la opción
-c edge
para actualizarlos todos al mismo tiempo. - Si un paso especifica que debe realizarse en varias máquinas, hazlo en el orden especificado de la máquina.
- No hay un paso separado 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.51.00, 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 obtener una instalación independiente de 2 nodos:
Consulta Topologías de instalación para ver 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 Qpid y Postgres en la máquina 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,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 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 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 Qpid y Postgres en la máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Actualiza Qpid y Postgres en la máquina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, 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 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 agrupada 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 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 Qpid en los equipos 6 y 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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 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 agrupada 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 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 Qpid en las máquinas 12 y 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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 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 Apigee SSO), 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 agrupada 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 de Edge y números 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 qpidd:
- Machines 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
- Machines 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
- Actualiza
qpidd
en la máquina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
- Machines 4, 5 en el 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 el LDAP:
- Máquina 1 en el centro de datos 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Machine 7 en Data Center 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:
- Machines 4, 5, 6, 1, 2, 3 en el centro de datos 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Machines 10, 11, 12, 7, 8, 9 en el centro de datos 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Machines 4, 5, 6, 1, 2, 3 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
) Se actualizó 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:
- (Si instalaste el SSO de Apigee), actualiza el SSO de Apigee:
- 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 el nuevo componente de IU de Edge (
edge-management-ui
) o de 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
- qpidd, ps
- LDAP
- Edge, que significa el perfil “-c perimetral” en todos los nodos del orden: nodos con el servidor Qpid, servidor Edge Postgres, servidor de administración, procesador de mensajes y router.
- 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 IU de Edge en todas las máquinas que lo ejecutan.