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 for Private Cloud v. 4.16.05

Este documento contiene el procedimiento que debes usar para actualizar tu instalación 4.16.05 existente. los RPM y los archivos de soporte de Apigee más recientes. En este procedimiento, se usa la utilidad update.sh para realizar la actualización.

Las versiones de Edge que puedes actualizar a la versión más reciente 4.16.05

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

Si ejecutas la versión 4.16.01.0x o anterior de Edge, primero debes migrar a 4.16.05. Consulta Actualiza Apigee Edge de 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 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.

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.05.x

Si configuró alguna propiedad mediante la edición de archivos .properties en /opt/apigee/customer/application, estos valores que conserve la actualizació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

En caso de que falle la actualización, puedes intentar corregir el problema y, luego, ejecutar update.sh de nuevo. Puedes ejecutar la actualización varias veces para que continúe la actualización desde donde quedó la última vez. desactivado.

Si el error requiere que reviertas la actualización a tu versión anterior, consulta 4.16.05 Proceso de reversió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, usa 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 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 que se describe en la siguiente sección: “Cómo hacer que un router y un procesador de mensajes sean inaccesibles”.
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.

Hacer un router y No se puede acceder al procesador de mensajes

En una configuración de producción, tendrá varios routers y procesadores de mensajes para lograr lo siguiente: un rendimiento óptimo, y debes habilitar o inhabilitar la accesibilidad de estos routers y mensajes Procesadores antes y después de la actualización.

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

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

en el que UUID es el UUID del procesador de mensajes o router Reachable está configurado en true o false.

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

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

Si necesita determinar el UUID del procesador de mensajes, use la siguiente cURL :

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

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 mediante la llamada a la API que se mostró anteriormente.
  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 el router sea accesible.
- 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 debe ser la misma que usaste para instalar Edge 4.16.05.

Procedimiento de actualizació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 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.
Limpia todas las cachés de Yum:
> sudo yum clean all
Descarga el archivo bootstrap_4.16.05.sh 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 del servicio de Apigee de Edge:
> 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.
Usa apigee-service para actualizar la utilidad de configuración de Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Con esta actualización de apigee-service, se 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” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -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 = Cassandr
- zk = cuidador del zoológico
- 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, servidor Postgres
- ui = IU de Edge
- Todo = 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 API
- p = Portal de BaaS de API
- ebp = ElasticSearch, API BaaS Stack y API BaaS Portal en el mismo nodo
Para probar la actualización, ejecuta la utilidad apigee-validate, prueba la instalación.

Procedimiento para actualizar 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:

Asegúrate de tener un repositorio local 4.16.05, como se describe en Instala componentes de Edge en un en la nube.
Actualiza el repositorio local:
1. Descarga el último archivo bootstrap_4.16.05.sh de Edge 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, 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, 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 con permisos de administrador, puedes realizar una implementación de Edge sin acceso con permisos de administrador.
5. Inhabilita SELinux como se describe en Instala Edge apigee-setup.
6. 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 de acceso al directorio de repositorios en 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 Instalar Componentes perimetrales de un nodo.
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
  
  en los que uName:pWord son el nombre de usuario y la contraseña que configuraste anteriormente para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del repo.
3. 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.
4. Inhabilita SELinux como se describe en Instala Edge apigee-setup.
5. 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=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña del repositorio.
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.
Usa apigee-service para actualizar la utilidad de configuración de Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Con esta actualización de apigee-service, se 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” a continuación:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -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 = Cassandr
- zk = cuidador del zoológico
- 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, servidor Postgres
- ui = IU de Edge
- Todo = 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 API
- p = Portal de BaaS de API
- ebp = ElasticSearch, API BaaS Stack y API BaaS Portal 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 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, reinicia el router.