Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Actualiza Apigee Edge 4.16.05.x a la versión más reciente 4.16.05

Edge para nube privada v. 4.16.05

En este documento, se incluye el procedimiento que usas para actualizar tu instalación 4.16.05 existente con los RPM y los archivos de asistencia más recientes de Apigee. En este procedimiento, se usa la utilidad update.sh para realizar la actualización.

¿Qué versiones de Edge puedes actualizar a la versión 4.16.05 más reciente?

Solo puedes actualizar una instalación existente de Apigee Edge versión 4.16.05.x a la versión más reciente 4.16.05.

Si actualmente ejecutas la versión 4.16.01.0x o una anterior de Edge, primero debes migrar a la versión 4.16.05. Consulta Actualiza Apigee Edge 4.16.01 a 4.16.05 para obtener información sobre cómo migrar a la versión 4.16.05.

Quién puede realizar la actualización

El usuario que ejecuta la actualización debe ser el mismo que instaló Edge originalmente o un usuario que se ejecuta como raíz.

Después de instalar los RPM de Edge, cualquier usuario puede configurarlos.

Requisitos de espacio en el disco para la actualización

Asegúrate de tener al menos 1 GB de espacio libre en el disco antes de realizar la actualización.

Propagación automática de la configuración de propiedades desde la versión 4.16.05.x

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

Requisitos previos de la actualización

Ten en cuenta los siguientes requisitos previos antes de actualizar Apigee Edge:

Crea una copia de seguridad de todos los nodos
Antes de actualizar, se recomienda realizar una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento para tu versión actual de Edge para realizar la copia de seguridad.

Esto te permite tener un plan de respaldo en caso de que la actualización a una versión nueva no funcione correctamente. Para obtener más información sobre la copia de seguridad, consulta Copia de seguridad y restablecimiento.
Asegúrate de que Edge se esté ejecutando
Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Cómo controlar una actualización con errores

En caso de que falle la actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces y esta continuará desde donde se detuvo por última vez.

Si la falla requiere que reviertas la actualización a la versión anterior, consulta Proceso de reversión de la versión 4.16.05.

Información de actualización de Logging

De forma predeterminada, la utilidad update.sh escribe la información de registro en la siguiente ubicación:

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

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

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

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar tu instalación de Edge sin desactivar Edge.

La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos o más.

La clave para la actualización sin tiempo de inactividad es quitar cada router, uno a la vez, del balanceador de cargas. Luego, actualiza el router y cualquier otro componente en la misma máquina que el router y, luego, vuelve a agregar el router al balanceador de cargas.

Actualiza las máquinas en el orden correcto para tu instalación, como se describe a continuación en "Orden de actualización de la máquina".
Cuando sea el momento de actualizar los routers, selecciona uno y haz que no se pueda acceder a él, como se describe en la siguiente sección "Cómo hacer que no se pueda acceder a un router y un Message Processor".
Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todas las configuraciones de Edge muestran un router y un Message Processor en el mismo nodo.
Vuelve a hacer que el router sea accesible.
Repite los pasos 2 a 4 para los routers restantes.
Continúa con la actualización de las máquinas restantes de tu instalación.

Haz que un router y un Message Processor no estén disponibles

En una configuración de producción, tendrás varios routers y Message Processors para lograr un rendimiento óptimo, y debes habilitar o inhabilitar la accesibilidad de estos routers y Message Processors antes o después de la actualización.

La siguiente llamada a la API configura un nodo como accesible o inaccesible:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

Donde UUID es el UUID del Message Processor o del router, y reachable se establece en verdadero o falso.

Si necesitas determinar el UUID del router, usa el siguiente comando de cURL:

> curl http://<routerIP>:8081/v1/servers/self

Si necesitas determinar el UUID del Message Processor, usa el siguiente comando de cURL:

> curl http://<mpIP>:8082/v1/servers/self

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

En el nodo combinado de Router y Message Processor:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router no esté disponible con la llamada a la API que se muestra más arriba.
  2. Haz que no se pueda acceder al Message Processor.
- Después de la actualización, haz lo siguiente:
  1. Haz que se pueda acceder al Message Processor.
  2. Haz que se pueda acceder al router.
En un solo nodo de router:
- Antes de la actualización, asegúrate de que se pueda acceder al router.
- Después de la actualización, haz que se pueda acceder al router.
En un solo nodo de Message Processor:
- Antes de la actualización, haz que el Message Processor no esté disponible.
- Después de la actualización, haz que se pueda acceder al Message Processor.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando de actualización. El archivo de configuración silenciosa debe ser el mismo que usaste para instalar Edge 4.16.05.

Procedimiento para actualizar la versión 4.16.05 en un nodo con una conexión a Internet externa

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

Si están presentes, inhabilita los trabajos cron configurados para realizar una operación de reparación en Cassandra hasta que se complete la actualización.
Accede a tu nodo como raíz para instalar los RPM de Edge
Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
Borra todas las cachés de Yum:
> sudo yum clean all
Descarga el archivo bootstrap_4.16.05.sh de Edge más reciente en /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Actualiza la utilidad y las dependencias de apigee-service de Edge:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

Donde uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que la ingreses.
Usa apigee-service para actualizar la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Esta actualización de apigee-service instala la utilidad update.sh en /<inst_dir>/apigee/apigee-setup/bin.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización de la máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

Usa la opción “-c” para especificar el componente que se actualizará. La lista de componentes posibles incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, Message Processor, router, servidor de QPID y servidor de Postgres
- ui = IU de Edge
- all = actualiza todos los componentes de la máquina (solo se usa para un perfil de instalación de Edge aio o un perfil de instalación de API BaaS asa)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = Portal de API BaaS
- ebp = ElasticSearch, pila de API BaaS y portal de API BaaS en el mismo nodo
Prueba la actualización ejecutando la utilidad apigee-validate, Prueba la instalación.

Procedimiento para actualizar la versión 4.16.05 desde un repositorio local

Si tus nodos de Edge están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local o una duplicación del repositorio de Apigee.

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

Crea un archivo .tar del repositorio, 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 de Nginx para que lo uses, o puedes usar tu propio servidor web.

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

Asegúrate de tener un repositorio local 4.16.05 como se describe en Instala componentes de Edge en un nodo.
Actualiza el repositorio local:
1. Descarga el archivo bootstrap_4.16.05.sh de Edge más reciente en /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Realiza la sincronización:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Para instalar apigee-service desde un archivo .tar, sigue estos pasos:
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.16.05.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.16.05.tar.gz
  
  Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
4. Accede a tu nodo como raíz para instalar los RPM de Edge
  Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
5. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
6. Instala la utilidad apigee-service de Edge y las dependencias de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.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 de Nginx, haz lo siguiente:
1. Configura el servidor web Nginx como se describe en "Instala desde el repositorio con el servidor web Nginx" en Instala componentes de Edge en un nodo.
2. En el nodo remoto, descarga el archivo bootstrap_4.16.05.sh de Edge en /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  en el que uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.
3. Accede a tu nodo como raíz para instalar los RPM de Edge
  Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
4. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
5. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  en el que uName:pWord son el nombre de usuario y la contraseña del repositorio.
Si están presentes, inhabilita los trabajos cron configurados para realizar una operación de reparación en Cassandra hasta que se complete la actualización.
Usa apigee-service para actualizar la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Esta actualización de apigee-service instala la utilidad update.sh en <inst_dir>/apigee/apigee-setup/bin.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización de la máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

Usa la opción “-c” para especificar el componente que se actualizará. La lista de componentes posibles incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, Message Processor, router, servidor de QPID y servidor de Postgres
- ui = IU de Edge
- all = actualiza todos los componentes de la máquina (solo se usa para un perfil de instalación de Edge aio o un perfil de instalación de API BaaS asa)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = Portal de API BaaS
- ebp = ElasticSearch, pila de API BaaS y portal de API BaaS en el mismo nodo
Para probar la actualización, ejecuta la utilidad apigee-validate, Prueba la instalación.

Orden de actualización de la máquina

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

Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar cualquier otro nodo.
Debes actualizar todos los nodos qpidd y postgresql antes de actualizar cualquier nodo de Router y Message Processor.
Para cualquier máquina con varios componentes de Edge (servidor de administración, Message Processor, router, servidor de QPID, 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".
Después de actualizar un nodo de Router, debes quitar todos los archivos del directorio /opt/nginx/conf.d y, luego, reiniciar el Router.