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

Actualiza Apigee Edge 4.16.01 a 4.16.05

Edge for Private Cloud v. 4.16.05

¿Qué versiones de Edge puedes actualizar a la 4.16.05?

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

Si tienes una versión de Edge anterior a la versión 4.16.01.x, primero debes migrar a 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ó originalmente Edge. usuario que se ejecuta con permisos de administrador.

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

Actualización necesaria a Java JDK versión 8

Esta versión de Edge requiere que hayas instalado la versión 8 de Java JDK en todos los dispositivos de Edge en los nodos de procesamiento. Puedes instalar el Oracle JDK 8 o el OpenJDK 8. Si Java JDK 8 no está instalado ya, la secuencia de comandos de actualización puede instalarla por ti.

Como parte de la actualización a Java 8, algunos cifrados de TLS ya no están disponibles en Oracle JDK 8. Para 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 estás con JDK 7, debes actualizar a JDK 8. Si reviertes la instalación de Edge 4.16.05, puedes Opcionalmente, reconfigura Edge para usar Java JDK 7.

Cambiando 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 versiones posteriores de Edge, la versión de Zookeeper se cambió a apigee-zookeeper-3.4.5-0.0.948. Esto evita yum de actualizar Zookeeper a una versión posterior a partir de la 4.16.01. La manera de corregir esta situación es ejecutar el comando yum switch apigee-zookeeper antes de actualizar Zookeeper.

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

> rpm -qa |grep apigee-zookeeper

Si este comando devuelve la versión de Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Luego, debes cambiar a una versión inferior.

Requisitos de espacio en el 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 propiedad Configuración de la versión 4.16.01.x

Si configuró alguna propiedad mediante la edición de archivos .properties en /opt/apigee/customer/application, estos valores que conserve la actualización.

Actualiza la utilidad apigee-validate

En la versión 4.16.01, instalaste y ejecutaste la utilidad apigee-validate en un Message del procesador. En la versión 4.16.05, se incluyó la utilidad apigee-validate se actualicen para ejecutarse en el nodo del servidor de administración.

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

Se recomienda Apigee: instalar y ejecutar la utilidad apigee-validate en el del servidor de administración.

De manera opcional, puedes desinstalar la utilidad apigee-validate desde los nodos de Message Processor. Si lo dejas en el nodo Message Processor, debes actualizarlo. al 16/4/05.
Como alternativa, actualiza la utilidad apigee-validate en la Nodo del procesador de mensajes y ejecútalo desde allí. Sin embargo, Apigee recomienda instalar y ejecutarla desde el servidor de administración.

Actualizar 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
Por motivos de seguridad, antes de la actualización, se recomienda realizar una copia de seguridad completa de todos los nodos y otras razones. 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 nueva versión funcionen correctamente. Para obtener más información sobre las copias de seguridad, consulta Copia de seguridad y restablecimiento.
Asegúrate de que Edge se esté ejecutando
Asegúrate de que Edge esté funcionando durante el proceso de actualización con el siguiente comando:

> Estado de /<inst_root>/apigee/apigee-service/bin/apigee-all

Cómo manejar una actualización con errores

Si se produce 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 la actualización desde donde se detuvo la última vez.

Si el error requiere que reviertas la actualización a tu versión anterior, consulta 4.16.05 Proceso de reversión para obtener más información.

Información de actualización de Logging

De manera predeterminada, el archivo update.sh escribe la información de registro en lo siguiente:

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

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

Si el usuario 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 necesidad de derribando 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, de la carga. 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 la instalación como se describe a continuación en "Orden de la actualización de máquina”.
Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, ya que se describe en Habilitar/Inhabilitar el servidor (Procesador de mensajes/router) Accesibilidad.
Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todos los parámetros de configuración de Edge muestran un router y un procesador de mensajes en el mismo nodo.
Haz que el router sea accesible de nuevo.
Repite los pasos 2 al 4 para los routers restantes.
Continúa la actualización en las máquinas restantes de la instalación.

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

En el router combinado del nodo del procesador de los mensajes:
- 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, haz lo siguiente:
  1. Permite que el procesador de mensajes sea accesible.
  2. Haz que el router sea accesible.
En un solo nodo de router:
- 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:
- Antes de la actualización, haz que no se pueda acceder al procesador de mensajes.
- Después de la actualización, permite que el procesador de mensajes sea accesible.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando update. El archivo de configuración silencioso debería ser la misma que usaste para instalar Edge 4.16.01.

Procedimiento para actualización a 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 de CRON configurados para realizar una operación de reparación en Cassandra. hasta que finalice 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 una implementación de Edge sin acceso con permisos de administrador.
Inhabilita SELinux como se describe en Instala la configuración de Apigee de Edge utilidad.
Descarga el archivo bootstrap_4.16.05.sh de Edge 4.16.05 a /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Instalar la utilidad apigee-service de Edge 4.16.05 y dependencias:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
en el que uName:pWord son el nombre de usuario y la contraseña de los que recibiste Apigee Si omites pWord, se te pedirá que lo ingreses.
De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo manejar el archivo. Instalación de Java. JAVA_FIX tiene los siguientes valores:
I = Instala 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 el comando apigee-setup utilidad:
1. Si instalaste la versión 4.16.01 actualizando Edge 4.15.07.0x, debes Instala la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service Instalación de apigee-setup
  Este comando instala la utilidad update.sh en <inst_dir>/apigee/apigee-setup/bin.
  
  Si ya instalaste la utilidad apigee-setup, actualiza ella:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Si instalaste 4.16.01 directamente, lo que significa que no realizaste una actualización desde 4.15.07.0x, debes actualizar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta actualización de apigee-service instala los la utilidad update.sh en <inst_dir>/apigee/apigee-setup/bin.
Instala apigee-validate en el servidor de administración:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Nota: Si instalaste la utilidad apigee-validate en un Message Processor, puedes actualizarlo 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 instalar y ejecutar 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 usaba apigee-validate requería la siguientes propiedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGIÓN=dc-1
En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar el elemento otras dos propiedades del archivo.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el “Apigee” usuario. Por ejemplo, coloca el archivo en el directorio /tmp de la el nodo de inicio de sesión.
Usa la opción “-c” para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todo el perímetro excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID, Servidor de Postgres
- ui = IU de Edge
- todo = actualizar todo componentes en la máquina (solo usar para un perfil de instalación de Edge aio o una API BaaS asa) perfil de instalación)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = BaaS de API Portal
- ebp = ElasticSearch, Pila de BaaS de APIs y un portal de BaaS de APIs en el mismo nodo
Probar la actualización ejecutando la utilidad apigee-validate en el servidor de administración, como como se describe en Cómo probar la instalación.

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

Procedimiento para actualizar a la versión 4.16.05 desde una ubicación local repositorio

Si los nodos perimetrales están detrás de un firewall o tienen prohibido acceder, el repositorio de Apigee por Internet, puedes actualizar desde un repositorio local del repositorio de Apigee.

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

Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, actualiza Edge desde el .tar.
Instalar un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él Apigee te proporciona el servidor web Nginx, o puedes usar tu propio servidor web web.

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 el entorno de Apigee-setup de Edge utilidad.
Nota: Si ya tienes un repositorio 4.16.01, puedes agregar el repositorio 4.16.05. repo.
Para instalar apigee-service desde un archivo .tar, haz lo siguiente:
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:
  > Paquete /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
2. Copia el archivo .tar en el nodo en el que quieres actualizar Edge. Por ejemplo, cópialo en el directorio /tmp en la 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, con el nombre repos, en el directorio que contiene el archivo .tar. Por ejemplo: /tmp/repos.
4. Instala la utilidad y las dependencias de Edge apigee-service desde /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Ten en cuenta que incluyes la ruta a el directorio de repositorios de este comando.
Para instalar apigee-service mediante el servidor web Nginx, sigue estos pasos:
1. Configura el servidor web NGINX como se describe en "Instala desde el repositorio con el servidor webserver" en Install the Edge apigee-setup.
2. En el nodo remoto, descarga el archivo Edge bootstrap_4.16.05.sh para /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
  donde uName:pWord son el nombre de usuario y la contraseña que configuró anteriormente para el repo, y remoteRepo es la dirección IP o el nombre de DNS del repositorio el nodo de inicio de sesión.
3. En el nodo remoto, instala la utilidad y las dependencias del servicio de Apigee de Edge:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  donde uName:pWord son el nombre de usuario del repositorio y contraseña.
Usa apigee-service para actualiza la utilidad apigee-setup:
1. Si instalaste la versión 4.16.01 actualizando Edge 4.15.07.0x, debes Instala la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service Instalación de apigee-setup
  Este comando instala la utilidad update.sh. en <inst_dir>/apigee/apigee-setup/bin.
  
  Si ya instalaste la utilidad apigee-setup, actualiza ella:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Si instalaste 4.16.01 directamente, lo que significa que no realizaste una actualización desde 4.15.07.0x, debes actualizar la utilidad apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta actualización de las instalaciones de apigee-service la utilidad update.sh. en <inst_dir>/apigee/apigee-setup/bin.
Instala la utilidad apigee-validate en el nodo del servidor de administración:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Nota: Si instalaste la utilidad apigee-validate en un Nodo del procesador de mensajes, puedes actualizarlo 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 instalar y ejecutar el comando apigee-validate en el servidor de administración.
Edita el archivo de configuración que se pasa a la utilidad apigee-validate. En en la versión anterior de Edge, el archivo de configuración que usaba apigee-validate requería la siguientes propiedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGIÓN=dc-1
En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar el elemento otras dos propiedades del archivo.
Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación en "Orden de actualización” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el “Apigee” usuario. Por ejemplo, coloca el archivo en el directorio /tmp de la el nodo de inicio de sesión.
Usa la opción “-c” para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Todo el perímetro excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID, Servidor de Postgres
- ui = IU de Edge
- todo = actualizar todo componentes en la máquina (solo usar para un perfil de instalación de Edge aio o una API BaaS asa) perfil de instalación)
- e = ElasticSearch
- b = Pila de BaaS de la API
- p = BaaS de API Portal
- ebp = ElasticSearch, Pila de BaaS de APIs y un portal de BaaS de APIs en el mismo nodo
Probar la actualización ejecutando la utilidad apigee-validate en el servidor de administración, como como se describe en Cómo probar la instalación.

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

Orden de actualización de la máquina

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

Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar alguno. otros nodos.
Debes actualizar todos los nodos qpidd y postgresql antes de actualizar cualquier nodo en los nodos del router y del procesador de mensajes.
Para cualquier máquina con varios componentes de Edge (Management Server, Message Processor, router, servidor QPID, servidor Postgres), usa el comando “-c Edge” la opción de actualizarlos todos de forma simultánea tiempo.
Si un paso especifica que debe realizarse en varias máquinas, ejecútalo en el orden de máquina especificado.
No existe un paso aparte para actualizar la Monetización. Se actualiza cuando especificas el valor "-c borde" de 12 a 1 con la nueva opción de compresión.
Después de actualizar un nodo Router, debes quitar todos los archivos del directorio /opt/nginx/conf.d y, luego, reiniciar el router.