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

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

Edge para la nube privada v. 4.16.05

Este documento contiene el procedimiento que usas para actualizar tu instalación 4.16.05 existente a fin de usar los últimos RPM y archivos de compatibilidad de Apigee. En este procedimiento, se usa la utilidad update.sh para realizar la actualización.

Qué versiones de Edge se pueden actualizar a la última versión 4.16.05

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

Si actualmente ejecutas la versión 4.16.01.0 de Edge o una anterior, 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énes pueden realizar la actualización

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

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

Requisitos del espacio del disco para la actualización

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

Propagación automática de la configuración de la propiedad a partir de la versión 4.16.05.x

Si editó archivos .properties en /opt/apigee/customer/application para configurar alguna propiedad, la actualización retiene estos valores.

Actualiza los requisitos previos

Cumpla con los siguientes requisitos previos antes de actualizar Apigee Edge:

Crea una copia de seguridad de todos los nodos
Por motivos de seguridad, antes de realizar la actualización, se recomienda realizar una copia de seguridad completa de todos los nodos. Usa el procedimiento en 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 mediante el siguiente comando:

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

Cómo manejar una actualización con errores

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

Si el error requiere que reviertas la actualización a tu versión anterior, consulta 4.16.05 Rollback Process.

Información de actualización del registro

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

/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 la instalación de Edge sin desconectar Edge.

La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos y 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 agregarlo al balanceador de cargas.

Actualiza las máquinas en el orden correcto para la instalación como se describe a continuación en “Orden de actualización de la máquina”.
Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, como se describe en la siguiente sección, "Cómo quitar el acceso de un router y un procesador de mensajes".
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 conectar el router.
Repite los pasos 2 a 4 para los routers restantes.
Continúa la actualización de las máquinas restantes en la instalación.

Haz que un router y el procesador de mensajes sean inaccesibles

En una configuración de producción, tendrás varios routers y procesadores de mensajes para lograr un rendimiento óptimo. Además, debes habilitar o inhabilitar la accesibilidad de estos routers y procesadores de mensajes antes y 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 procesador de mensajes o del router, y se puede establecerlo como verdadero o falso.

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

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

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

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

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

En el router combinado y el nodo del procesador de mensajes:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router sea inaccesible mediante la llamada a la API que se muestra arriba.
  2. Haz que el procesador de mensajes sea inaccesible.
- Después de la actualización, realiza lo siguiente:
  1. Haz que el procesador de mensajes sea accesible.
  2. Haz que el router sea accesible.
En un solo nodo del router:
- Antes de actualizar, haz que el router sea accesible.
- Después de la actualización, haz que el router sea accesible.
En un único nodo del procesador de mensajes:
- Antes de actualizar, haz que el procesador de mensajes sea inaccesible.
- Después de la actualización, haz que Message Processor se pueda acceder a ella.

Usa un archivo de configuración silenciosa

Debes pasar un archivo de configuración silencioso al comando update. El archivo de configuración silencioso debe ser el mismo que usaste en la instalación de Edge 4.16.05.

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

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

Si está presente, inhabilita los trabajos de CRON configurados para realizar una operación de reparación en Cassandra hasta después de 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 de configuración de Apigee de Edge.
Borra todas las cachés de Yum:
> sudo yum clean all
Descarga el archivo boot_4.16.05.sh de Edge más reciente en /tmp/boot_4.16.05.sh:
> curl https://software.apigee.com/boot_4.16.05.sh -o /tmp/boot_4.16.05.sh
Actualiza la utilidad y las dependencias de apigee-service de Edge:
> sudo bash /tmp/boot_4.16.05.sh apigeeuser=uName apigeepassword=pWord

, donde uName:pWord es el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo 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 el “Orden de actualización de la máquina” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

El único requisito en el archivo de configuración es que el usuario de Apigee debe poder acceder a la herramienta o leerla. Por ejemplo, coloca el archivo en el directorio /tmp en el nodo.

Use la opción "-c" para especificar el componente que desea 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 el de Edge: el servidor de administración, el procesador de mensajes, el router, el servidor QPID y el servidor de Postgres
- IU: IU de Edge
- Todos = actualiza todos los componentes en la máquina (solo úsalo para un perfil de instalación de IAio de Edge o un perfil de instalación de BAaS de API)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = Portal de BaaS de la API
- ebp = ElasticSearch, la pila de BaaS de la API y el portal de BaaS de la API en el mismo nodo
Ejecute la herramienta apigee-validate para probar la actualización: Pruebe la instalación.

Procedimiento para actualizar 4.16.05 desde un repositorio local

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

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

Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, actualiza Edge desde el archivo .tar.
Instale 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 uses. También 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 boot_4.16.05.sh de Edge más reciente en /tmp/boot_4.16.05.sh:
  > curl https://software.apigee.com/boot_4.16.05.sh -o /tmp/boot_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, siga estos pasos:
1. En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un único 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, en el nodo nuevo.
3. En el nodo nuevo, descarta el archivo en el directorio /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  
  Este comando crea un directorio nuevo, llamado repositorios, 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 de configuración de Apigee de Edge.
6. Instala la utilidad apigee-service de Edge y las dependencias de /tmp/repos:
  > sudo bash /tmp/repos/boot_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Observa que incluyes la ruta de acceso al directorio de repositorios en este comando.
Para instalar apigee-service con el servidor web Nginx:
1. Configura el servidor web Nginx como se describe en "Instala desde el repositorio mediante el servidor web Nginx" en Cómo instalar componentes de Edge en un nodo.
2. En el nodo remoto, descarga el archivo boot_4.16.05.sh de Edge en /tmp/boot_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/boot_4.16.05.sh -o .
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 de configuración de Apigee de Edge.
5. En el nodo remoto, instala la utilidad y las dependencias del apigee-service de Edge:
  > sudo bash /tmp/boot_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  nombre y nombre de usuario
Si está presente, inhabilita los trabajos de CRON configurados para realizar una operación de reparación en Cassandra hasta después de 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 el “Orden de actualización de la máquina” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

El único requisito en el archivo de configuración es que el usuario de Apigee debe poder acceder a la herramienta o leerla. Por ejemplo, coloca el archivo en el directorio /tmp en el nodo.

Use la opción "-c" para especificar el componente que desea 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 el de Edge: el servidor de administración, el procesador de mensajes, el router, el servidor QPID y el servidor de Postgres
- IU: IU de Edge
- Todos = actualiza todos los componentes en la máquina (solo úsalo para un perfil de instalación de IAio de Edge o un perfil de instalación de BAaS de API)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = Portal de BaaS de la API
- ebp = ElasticSearch, la pila de BaaS de la API y el portal de BaaS de la API en el mismo nodo
Ejecute el servicio apigee-validate para probar la actualización: Test the install.

Orden de la 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 de 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 del router y del procesador de mensajes.
Para cualquier máquina con varios componentes de Edge (servidor de administración, procesador de mensajes, router, servidor 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 especificado.
No existe un paso aparte 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 reiniciar el router.