Cómo actualizar el portal de servicios para desarrolladores

Portal de servicios para desarrolladores v. 4.16.09

En este procedimiento, se describe cómo actualizar una instalación existente de los servicios de canal para desarrolladores de Apigee en las instalaciones.

Directorio de instalación predeterminado

El proceso de actualización supone que el portal para desarrolladores se instaló en /var/www/html. Si no instalaste el portal en el directorio predeterminado, modifica las rutas de acceso en el siguiente procedimiento para usar el directorio de instalación.

Si no conoces el directorio de instalación, puedes determinarlo como se describe en Comandos de Drush de uso general.

Versiones de actualización compatibles

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x

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

http://yourportal.com/buildInfo

Antes de instalar

En las instalaciones existentes, si modificaste algún código en Drupal Core o en módulos no personalizados, se reemplazarán las modificaciones. Esto incluye, entre otros, cualquier cambio que puedas haber realizado en el archivo .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. La ubicación de instalación predeterminada es /var/www/html, pero es posible que la hayas cambiado durante la instalación. 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 los servicios de canal del desarrollador de Apigee a una versión nueva

  1. Una copia de seguridad de tu instancia de MySQL de Drupal
    Para obtener más información, consulta http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opción 1: Usa Drush

      El comando Drush sql-dump crea una copia de la base de datos. Desde el directorio de Drupal, /var/www/html de forma predeterminada, ejecuta el comando:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Usa drush help sql-dump para obtener más información.
    2. Opción 2: Usa MySQLdump
      Usa el comando mysqldump para crear una copia de la base de datos:
      mysqldump -u NOMBRE_DE_USUARIO -p'CONTRASEÑA' NOMBRE_BASE_DATOS > /ruta/a/directorio_de_copia_de_seguridad/copia_de_seguridad_de_base_de_datos.sql

      No debe haber espacios entre la opción -p y la contraseña. Se requieren comillas simples alrededor de la contraseña si esta contiene caracteres especiales.

      Cuando instalaste el portal, configuraste USERNAME y DATABASENAME. De forma predeterminada, ambos son devportal.
  2. Crea una copia de seguridad de todo el directorio raíz web de Drupal. La ubicación de instalación predeterminada es /var/www/html, pero es posible que la hayas cambiado en el momento de la instalación.
  3. Descarga el archivo DeveloperServices_x.y.z.tar de los servicios del Canal para desarrolladores, en el que x.y.z corresponde al número de versión del portal.

    Puedes descargar un archivo del vínculo que te envió Apigee en un navegador o cópialo y, luego, agrégalo al siguiente comando cURL:
    > curl -kOL <paste link here>

    Nota: Si tu portal se encuentra en un servidor sin conexión a Internet externa, realiza este paso en un servidor con acceso.

    Ve a http://community.apigee.com/content/apigee-customer-support y selecciona Acceder a tu portal de asistencia para solicitar el archivo .tar de actualización de los servicios del Canal para desarrolladores. Si no tienes una cuenta en el Support Portal, selecciona Accede al Support Portal y, luego, en la página de acceso, selecciona ¿Tienes prisa? Envía un ticket de asistencia aquí.
  4. Para realizar una actualización en un servidor con conexión a Internet, sigue estos pasos:
    1. Extrae el archivo de actualización del portal:
      > tar -xvf <tar file>

      Este comando de extracción crea un directorio nuevo llamado DeveloperServices-4.x.y.z.
    2. Cambia al directorio DeveloperServices-4.x.y.z.
    3. Descarga la versión más reciente de Drupal con el siguiente comando:
      > drush dl drupal

      Este comando crea un directorio llamado drupal-x.y, donde x.y corresponde a la versión actual de Drupal.
    4. Ejecuta la secuencia de comandos networked-update.sh:
      > ./networked-update.sh

      Según los permisos de archivo, es posible que debas usar sudo para ejecutar este comando o ejecutarlo como administrador.
    5. Para recibir notificaciones de actualizaciones de Drupal, asegúrate de que el módulo del administrador de actualizaciones de Drupal esté habilitado. En el menú de Drupal, selecciona Módulos y desplázate hacia abajo hasta el módulo Administrador de actualizaciones. Si no está habilitada, habilítala.

      Una vez habilitada, puedes ver las actualizaciones disponibles en el elemento de menú Informes > Actualizaciones disponibles.

      Usa el elemento de menú Informes > Actualizaciones disponibles > Configuración para configurar el módulo de modo que te envíe correos electrónicos cuando haya actualizaciones disponibles y establecer la frecuencia de la búsqueda de actualizaciones.
  5. Para realizar una actualización en un servidor sin conexión a Internet, sigue estos pasos:
    1. En el servidor en el que descargaste el archivo de servicios del Canal para desarrolladores DeveloperServices_x.y.z.tar, extrae el archivo de actualización del portal:
      > tar -xvf <tar file>

      Este comando de extracción crea un directorio nuevo llamado DeveloperServices-4.x.y.z.
    2. Cambia al directorio DeveloperServices-4.x.y.z.
    3. Ejecuta la secuencia de comandos non-networked-update.sh:
      > ./non-networked-update.sh

      Según los permisos de archivo, es posible que debas usar sudo para ejecutar este comando o ejecutarlo como administrador.

      Este comando descarga todos los archivos de actualización necesarios y los empaqueta en un solo archivo llamado devportal-update.tgz y lo escribe en la ubicación que elijas.
    4. Copia devportal-update.tgz en el servidor de destino, el que ejecuta el portal.
      Nota: No copies el devportal-update.tgz en la raíz web del servidor de destino.
    5. Descomprime el archivo devportal-update.tgz en el directorio actual:
      > tar -xzf /path/to/devportal-update.tgz
    6. Cambia al directorio developer-update.
    7. Ejecuta el siguiente comando para instalar la actualización:
      > ./install-update.sh
    8. Responde las indicaciones.

Se completó la actualización.