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

Actualiza Apigee Edge 4.16.01 a 4.16.05

Edge para nube privada v. 4.16.05

Qué versiones de Edge puedes actualizar a la versión 4.16.05

Solo puedes actualizar Apigee Edge versión 4.16.01.x a 4.16.05.

Si tienes una versión de Edge anterior a la 4.16.01.x, primero debes migrar a la versión 4.16.01.x y, luego, actualizar 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 el que instaló Edge o el usuario con permisos de administrador.

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

Actualización obligatoria a la versión 8 del JDK de Java

Para esta versión de Edge, debes tener instalada la versión 8 del JDK de Java en todos los nodos de procesamiento de Edge. Puedes instalar Oracle JDK 8 o OpenJDK 8. Si Java JDK 8 no está instalado, la secuencia de comandos de actualización puede instalarlo por ti.

Como parte de la actualización a Java 8, algunos algoritmos de cifrado de TLS ya no están disponibles en Oracle JDK 8. Para ver la lista completa, consulta la sección "Conjuntos de algoritmos de cifrado inhabilitados de forma predeterminada" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Advertencia: Esta versión de Edge no es compatible con JDK 7. Si actualmente usas JDK 7, debes actualizarlo a JDK 8. Si reviertes la instalación de Edge 4.16.05, tienes la opción de volver a configurar Edge para usar Java JDK 7.

Cómo cambiar a una versión inferior de Zookeeper

La versión de RPM de Zookeeper en Edge para la nube privada 4.16.01 es apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. En las versiones posteriores de Edge, la versión de Zookeeper se volvió a cambiar a apigee-zookeeper-3.4.5-0.0.948. Esto evita que yum actualice Zookeeper a versiones posteriores de 4.16.01. La forma de administrar esta situación es ejecutar yum revertir apigee-zookeeper antes de actualizar Zookeeper.

Puedes comprobar tu versión de Zookeeper con el siguiente comando:

> rpm -qa |grep apigee-zookeeper

Si este comando muestra la versión Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Luego, debes cambiar a una versión inferior.

Requisitos del espacio en 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 desde 4.16.01.x

Si configuraste alguna propiedad mediante la edición de los archivos .properties en /opt/apigee/customer/application, la actualización retiene estos valores.

Actualiza la utilidad apigee-validate

En la versión 4.16.01, instalaste y ejecutaste la utilidad apigee-validate en un nodo de Message Processor. En la versión 4.16.05, se actualizó la utilidad apigee-validate para que se ejecute en el nodo Management Server.

Cuando actualizas a la versión 4.16.05, tienes dos opciones para actualizar la utilidad apigee-validate:

Se recomienda Apigee: Instala y ejecuta la utilidad apigee-validate en el nodo del servidor de administración.

De forma opcional, puedes desinstalar la utilidad apigee-validate de los nodos de Message Processor. Si lo dejas en el nodo de Message Processor, debes actualizarlo a la versión 4.16.05.
Como alternativa, actualiza la utilidad apigee-validate en el nodo de Message Processor y ejecútala desde allí. Sin embargo, Apigee recomienda que lo instales y ejecutes desde el servidor de administración.

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, se recomienda realizar 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é activo durante el proceso de actualización con el siguiente comando:

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

Manejo de actualizaciones con errores

En caso de que se produzca una falla en la 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 Proceso de reversión 4.16.05 para obtener más información.

Información de actualización de registros

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

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

Si el usuario 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 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 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 a continuación en “Orden de actualización 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/routers).
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 del procesador de mensajes, haz lo siguiente:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router sea inaccesible.
  2. Hacer que el procesador de mensajes sea inaccesible.
- Después de la actualización, realiza lo siguiente:
  1. Permite el acceso al Message Processor.
  2. Haz que el router sea accesible.
En un solo nodo de 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 un solo nodo de 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 el procesador de mensajes esté accesible.

Con 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.16.01.

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

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

Si está presente, 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 con permisos de administrador, puedes realizar la configuración de Edge sin acceso a la raíz.
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
Descarga el archivo bootstrap_4.16.05.sh de Edge 4.16.05 a bootstrap_4.16.05.sh:
> curl https://software.apigee.com/Boot_4.16.05.sh -o /tmp/Boot_4.16.05.sh.
Instala la utilidad y las dependencias de apigee-service de Edge 4.16.05:
> sudo bash /tmp/Boot_4.16.05.sh apigeeuser=uName apigeepassword=pWord
, en el que 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 verifica si tienes Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX acepta los siguientes valores:
I = Instalar OpenJDK 1.8 (predeterminado)
C = Continuar sin instalar Java
Q = Salir. Para esta opción, debes instalar Java por tu cuenta.
Usa apigee-service para actualizar la utilidad apigee-setup:
1. Si instalaste 4.16.01 mediante la actualización de la versión 4.15.07.0x de Edge, debes instalar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Este comando instala la utilidad update.sh en <inst_dir>/apigee/apigee-setup/bin.
  
  Si ya instalaste la utilidad apigee-setup, actualízala:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
2. Si instalaste la versión 4.16.01 de forma directa, lo que significa que no realizaste una actualización desde la versión 4.15.07.0x, debes actualizar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta actualización a apigee-service/Apigee.
Instala la utilidad apigee-validate en el servidor de administración:
apigee-validate
Nota: Si instalaste la utilidad apigee-validate en un nodo de Message Processor, puedes actualizarla con el siguiente comando en ese nodo:
apigee-validate.
Edita el archivo de configuración que se pasa a la utilidad apigee-validate. En la versión anterior de Edge, el archivo de configuración que usa apigee-validate requería las siguientes propiedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1

En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar las otras dos propiedades del archivo.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en “Actualización del orden de la máquina” a continuación:
>/opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
El único requisito del archivo de configuración es que el usuario de “apigee” debe poder acceder al archivo de configuración 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á. En la lista de componentes posibles, se incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
- ui = IU de Edge
- all: Actualiza todos los componentes en 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 API BaaS
- p = Portal de BaaS de la API
- ebp = ElasticSearch, API BaaS Stack y API BaaS Portal en el mismo nodo
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.

Para revertir la actualización más tarde, usa el procedimiento descrito en Proceso de reversión 4.16.05.

Procedimiento para actualizar a la versión 4.16.05 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 el tuyo propio.

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

Crea un repositorio local 4.16.05 como se describe en “Crea un repositorio local de Apigee” en Instala la utilidad Edge apigee-setup.
Nota: Si ya tienes un repositorio 4.16.01 existente, puedes agregarle el repositorio 4.16.05.
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
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
  Con este comando, se crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
4. 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
  Ten en cuenta que incluyes la ruta de acceso al directorio de repositorios en este comando.
Para instalar apigee-service con el servidor web Nginx, sigue estos pasos:
1. Configura el servidor web Nginx como se describe en “Instala desde el repositorio mediante el servidor web Nginx” en Instala la utilidad apigee-setup de Edge.
2. En el nodo remoto, descarga el archivo de Edge Boot_4.16.05.sh a /tmp/Boot_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/remoteRepo_4.16.05.sh -repositorio de la dirección-repoco.16.05.sh
3. En el nodo remoto, instala las dependencias y la utilidad apigee-service de Edge:
  > sudo bash /tmp/Boot_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  en.
Usa apigee-service para actualizar la utilidad apigee-setup:
1. Si instalaste 4.16.01 mediante la actualización de la versión 4.15.07.0x de Edge, debes instalar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Este comando instala la utilidad update.sh en <inst_dir>/apigee/apigee-setup/bin.
  
  Si ya instalaste la utilidad apigee-setup, actualízala:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
2. Si instalaste la versión 4.16.01 de forma directa, lo que significa que no realizaste una actualización desde la versión 4.15.07.0x, debes actualizar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta actualización a apigee-service instala la utilidad apigee-setup/apigee.sh .
Instala la utilidad apigee-validate en el nodo de Management Server:
apigee-validate
Nota: Si instalaste la utilidad apigee-validate en un nodo de Message Processor, puedes actualizarla con el siguiente comando en ese nodo:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Sin embargo, para la versión 4.16.05, Apigee recomienda que instales y ejecutes la utilidad apigee-validate en el servidor de administración.
Edita el archivo de configuración que se pasa a la utilidad apigee-validate. En la versión anterior de Edge, el archivo de configuración que usa apigee-validate requería las siguientes propiedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar las otras dos propiedades del archivo.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en “Actualización del orden de la máquina” a continuación:
>/opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
El único requisito del archivo de configuración es que el usuario de “apigee” debe poder acceder al archivo de configuración 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á. En la lista de componentes posibles, se incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
- ui = IU de Edge
- all: Actualiza todos los componentes en 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 API BaaS
- p = Portal de BaaS de la API
- ebp = ElasticSearch, API BaaS Stack y API BaaS Portal en el mismo nodo
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.

Para revertir la actualización más tarde, usa el procedimiento descrito en Proceso de reversión 4.16.05.

Actualización del orden de la máquina

El orden en 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 procesador de mensajes.
En cualquier máquina con varios componentes de Edge (servidor de administración, procesador de mensajes, router, servidor de QPID o servidor de Postgres), usa la opción “-c perimetral” 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 perimetral".
Después de actualizar un nodo de router, debes quitar todos los archivos del directorio /opt/nginx/conf.d y, luego, reiniciar el router.