Actualiza el portal

Edge para nube privada v4.19.01

En este procedimiento, se describe cómo actualizar una instalación local existente del portal de servicios para desarrolladores de Apigee (o simplemente, el portal).

Determina el procedimiento de actualización correcto

El procedimiento que usas para actualizar el portal se basa en tu instalación actual:

Determina tu tipo de instalación actual

Si no tienes certeza sobre el tipo de instalación actual, usa el siguiente comando para determinarlo:

  • ls /opt

    Si usas Nginx o Postgres, verás los siguientes directorios: /opt/apigee y /opt/nginx.

    Si usas Apache/MySQL o Apache/MariaDB, estos directorios no deberían estar presentes.

  • /opt/apigee/apigee-service/bin/apigee-all status

    Si usas Nginx o Postgres, verás el siguiente resultado:

    + apigee-service
apigee-drupal-devportal status
OK: apigee-drupal-devportal is up and running
+ apigee-service apigee-lb status
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql status
apigee-service: apigee-postgresql: OK
     
  • apachectl -S

    Si usas Apache/MySQL o Apache/MariaDB, este comando debería devolver el directorio raíz web del portal, con el siguiente formato:

    *:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

Directorio de instalación predeterminado

En el proceso de actualización, se supone que el portal se instaló en la siguiente ubicación:

  • 4.17.05 y versiones posteriores: /opt/apigee/apigee-drupal/wwwroot
  • Antes de la versión 4.17.05: /opt/apigee/apigee-drupal (Nginx) o /var/www/html (Apache)

Si no instalaste el portal en el directorio predeterminado, modifica las rutas de acceso en el siguiente procedimiento para usar tu directorio de instalación.

Versiones de actualización compatibles

Este procedimiento de actualización es compatible con las siguientes versiones del portal:

  • OPDK-17-01.x
  • OPDK-17-05.x
  • OPDK-17-09.x
  • OPDK-18-01.x
  • OPDK-18-05.x

Para determinar la versión de tu portal, abre la siguiente URL en un navegador:

http://yourportal.com/buildInfo

Antes de actualizar

En el caso de las instalaciones existentes, si modificaste algún código en el núcleo de Drupal o en cualquier módulo no personalizado, se reemplazarán tus modificaciones. Esto incluye, entre otras cosas, cualquier cambio que hayas realizado en .htaccess. Debes suponer que todo lo que esté fuera del directorio /sites es propiedad de Drupal. Una excepción a esta regla es robots.txt; si este archivo existe en la raíz web, se conservará.

Antes de continuar con la instalación, crea una copia de seguridad de todo el directorio raíz web de Drupal. Después de realizar los pasos de instalación que se describen a continuación, puedes restablecer tus personalizaciones desde la copia de seguridad.

Actualiza un portal con RPM

Para actualizar el RPM del portal en un nodo, haz lo siguiente:

  1. Cambia al directorio de Drupal, /opt/apigee/apigee-drupal de forma predeterminada: 
    cd /opt/apigee/apigee-drupal
  2. Crea una copia de seguridad de tu instancia de base de datos de Drupal. El comando pg_dump crea una copia de la base de datos: 
    pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp

    Donde:

    • devportal es el nombre de la base de datos, como lo especifica la propiedad PG_NAME en el archivo de configuración de instalación del portal.
    • host_IP_address es la dirección IP del nodo del portal.
    • drupaladmin es el nombre de usuario de Postgres que usa el portal para acceder a la base de datos, como se especifica en la propiedad DRUPAL_PG_USER del archivo de configuración de instalación del portal.

    Se te solicitará la contraseña del usuario de Postgres, como se define en la propiedad DRUPAL_PG_PASS del archivo de configuración de instalación del portal.

    Si más adelante quieres restablecer desde la copia de seguridad, usa el siguiente comando:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. Crea una copia de seguridad de todo el directorio raíz web de Drupal. La ubicación de instalación predeterminada es /opt/apigee/apigee-drupal, pero es posible que la hayas cambiado.

    Si no sabes con certeza la ubicación de este directorio, usa el comando drush status o la entrada Configuración > Contenido multimedia > Archivo en el menú de Drupal para determinar la ubicación del sistema de archivos público y la ruta de acceso del sistema de archivos privado (para el siguiente paso).

  4. Crea una copia de seguridad de los archivos en /opt/apigee/data/apigee-drupal-devportal/private.
  5. Configura Drupal en modo de mantenimiento:
    1. Selecciona Configuration en el menú de Drupal.
    2. En la página Configuración, selecciona Modo de mantenimiento en Desarrollo.
    3. Selecciona la casilla Put site into maintenance mode.
    4. Ingresa un mensaje que los usuarios verán durante el mantenimiento.
    5. Selecciona Guardar configuración.
  6. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
  7. Cambia al directorio /opt: 
    cd /opt
  8. Para actualizar un servidor con conexión a Internet, sigue estos pasos:
    1. Descarga el archivo bootstrap_4.19.01.sh de Edge 4.19.01 en /tmp/bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    2. Instala la utilidad apigee-service de Edge 4.19.01 y las dependencias: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      En el ejemplo anterior, uName y pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que lo ingreses.

      De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. Puedes usar la opción "C" para continuar sin instalar Java.

  9. Para realizar una actualización en un servidor sin conexión a Internet, sigue estos pasos:
    1. Crea un repositorio local 4.19.01 como se describe en Crea un repositorio local de Apigee.
    2. 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.19.01.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.19.01.tar.gz

        Este comando 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/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Ten en cuenta que debes incluir la ruta de acceso al directorio repos en este comando.

    3. 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 la utilidad apigee-setup de Edge.
      2. En el nodo remoto, descarga el archivo bootstrap_4.19.01.sh de Edge en /tmp/bootstrap_4.19.01.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
  -o /tmp/bootstrap_4.19.01.sh

        En el ejemplo anterior, uName y pWord son el nombre de usuario y la contraseña que configuraste para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.

      3. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias: 
        sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Donde uName y pWord son el nombre de usuario y la contraseña del repositorio.

  10. Usa apigee-service para actualizar la utilidad apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Ejecuta la utilidad de actualización en tu nodo de Postgres: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    Donde configFile es el archivo de configuración que usaste para instalar la base de datos de Postgres. El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo.

  12. Ejecuta la utilidad de actualización en tu nodo para actualizar el portal: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    Donde configFile es el archivo de configuración que usaste para instalar el portal. El único requisito del archivo de configuración es que el usuario "apigee" debe poder acceder a él o leerlo.

  13. Ejecuta la secuencia de comandos update.php de Drupal abriendo la siguiente URL en una ventana del navegador: 
    http://portal_IP_DNS:8079/update.php
  14. Inhabilita el modo de mantenimiento:
    1. Selecciona Configuration en el menú de Drupal.
    2. En la página Configuración, selecciona Modo de mantenimiento en Desarrollo.
    3. Anula la selección de la casilla Put site into maintenance mode.
    4. Selecciona Guardar configuración.

Ten en cuenta que el directorio raíz después de la actualización es el siguiente:

/opt/apigee/apigee-drupal/wwwroot

Se completó la actualización. Si la utilidad de actualización de Apigee cambió a una versión anterior de Drupal, es posible que debas volver a ejecutar la utilidad de actualización de Drupal. Para obtener más información, consulta Vuelve a ejecutar la actualización de Drupal.

Vuelve a ejecutar la actualización de Drupal

Si ejecutas la utilidad de actualización de Apigee para actualizar Edge para la nube privada, se produce una baja de versión de tu versión de Drupal, vuelve a instalar la actualización de Drupal. Este podría ser el caso si actualizaste solo Drupal entre las actualizaciones de la nube privada.

Por ejemplo:

  1. Ejecutabas la versión 4.18.05 de Edge para la nube privada, que incluía Drupal 7.59.
  2. Actualizaste Drupal a la versión 7.64 debido a una actualización de seguridad obligatoria.
  3. Ahora, actualizarás la nube privada a la versión 4.19.01, que incluye Drupal 7.61.

Como se ilustra en este caso, es posible que la versión de Drupal que usa la utilidad de actualización de Apigee no haga referencia a la actualización más reciente de Drupal. Como resultado, ahora debes volver a ejecutar la actualización de Drupal para devolver la instalación de Drupal a la versión posterior.