Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo actualizar el portal de servicios para desarrolladores

Portal de servicios para desarrolladores v. 4.17.05

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

Nota: En todas las instalaciones nuevas del portal para la versión 4.17.01, se usó Postgres como base de datos y Nginx como servidor web. Sin embargo, una actualización a la versión 4.17.01 desde una versión anterior del portal conservó la base de datos y el servidor web Apache que se usaron en la versión anterior. Esto significa que tu portal 4.17.1 actual puede usar cualquiera de las siguientes configuraciones:

Nginx/Postgres para todas las instalaciones nuevas de la versión 4.17.01
Apache/MySQL 5.0.15 o posterior para todos los sistemas operativos 6.x actualizados a 4.17.01
Apache/MariaDB 5.1.38 o posterior para todos los sistemas operativos 7.x actualizados a 4.17.01

Antes de comenzar el proceso de actualización, debes determinar tu configuración actual y, luego, realizar el procedimiento de actualización correcto.

Determina el procedimiento de actualización correcto

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

Si tu instalación usa Apache/MySQL o Apache/MariaDB de un sistema actualizado a la versión 4.17.01, usa Actualiza el portal con un archivo .tar.
Si tu instalación usa Nginx/Postgres de una instalación nueva de 4.17.01, usa Actualiza un portal con RPM.

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/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/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 mostrar 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 para desarrolladores se instaló en la siguiente ubicación:

/opt/apigee/apigee-drupal (Nginx)
/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.

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

Nuevo directorio de instalación predeterminado después de la actualización de Nginx/Postgres desde una nueva instalación 4.17.01

Después de actualizar una instalación nueva de 4.17.01 que usa Nginx/Postgres, el directorio raíz cambió de:

/opt/apigee/apigee-drupal

para:

/opt/apigee/apigee-drupal/wwwroot

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
OPDK-16-09.x
OPDK-17-01.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 el portal con un archivo .tar

Crea una copia de seguridad de tu instancia de MySQL o MariaDB 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 sql-dump de Drush crea una copia de la base de datos. Desde tu 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 USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
  
  No debe haber espacio entre la opción -p y la contraseña. Se requieren comillas simples alrededor de la contraseña si esta contiene caracteres especiales.
  
  Configuraste el USERNAME y el DATABASENAME cuando instalaste el portal. De forma predeterminada, ambos son devportal.
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.
Descarga el archivo DeveloperServices_x.y.z.tar de los servicios del canal para desarrolladores desde ftp.apigee.com, en el que x.y.z corresponde al número de versión del portal. Cuando se te solicite, ingresa las credenciales que recibiste de Apigee.

Puedes descargar un archivo desde el vínculo que te envió Apigee en un navegador o copiarlo y, luego, agregarlo al siguiente comando de cURL:
> curl -kOL <paste link here>

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

Ve a Asistencia de Apigee Edge 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 Portal de asistencia, selecciona Accede a tu Portal de asistencia y, luego, en la página de acceso, selecciona ¿Tienes prisa? Envía un ticket de asistencia aquí.
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 extrae 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, en el que 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 las actualizaciones de Drupal, asegúrate de que el módulo del administrador de actualizaciones de Drupal esté habilitado. En el menú de Drupal, selecciona Modules y desplázate hacia abajo hasta el módulo Update manager. Si no está habilitada, habilítala.
  
  Una vez habilitada, puedes ver las actualizaciones disponibles con el elemento de menú Reports > Available Updates.
  
  Usa el elemento de menú Informes > Actualizaciones disponibles > Configuración para configurar el módulo de modo que te envíe un correo electrónico cuando haya actualizaciones disponibles y para establecer la frecuencia con la que se buscan actualizaciones.
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 DeveloperServices_x.y.z.tar de los servicios del canal para desarrolladores, extrae el archivo de actualización del portal:
  > tar -xvf <tar file>
  
  Este comando extrae 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 escribe el archivo 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 archivo 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 preguntas.

Se completó la actualización.

Actualiza un portal con RPM

Usa el siguiente procedimiento para actualizar el RPM del portal en un nodo:

Cambia al directorio de Drupal, /opt/apigee/apigee-drupal de forma predeterminada:
> cd /opt/apigee/apigee-drupal
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=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp

en el que:
- dbname especifica el nombre de la base de datos como se especifica en la propiedad PG_NAME en el archivo de configuración de la instalación del portal.
- host especifica la dirección IP del nodo del portal.
- username especifica 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 en el archivo de configuración de instalación del portal.
Si más adelante tienes que restablecer desde la copia de seguridad, usa el siguiente comando:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
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 tienes certeza de 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).
Crea una copia de seguridad de los archivos en /opt/apigee/data/apigee-drupal-devportal/private.
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
Para realizar una actualización en un servidor con conexión a Internet, sigue estos pasos:
1. Descarga el archivo bootstrap_4.17.05.sh de Edge 4.17.05 en /tmp/bootstrap_4.17.05.sh:
  > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
2. Instala la utilidad apigee-service de Edge 4.17.05 y las dependencias:
  > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
  
  Donde uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que la ingreses.
  
  De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. Puedes usar la opción "C" para continuar sin instalar Java.
Para realizar una actualización en un servidor sin conexión a Internet, sigue estos pasos:
1. Crea un repositorio local 4.17.05 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
  Nota: Si ya tienes un repositorio 4.17.01, puedes agregarle el repositorio 4.17.05 como se describe en "Actualiza un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
2. Para instalar apigee-service desde un archivo .tar:
  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.17.05.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.17.05.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.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    Ten en cuenta que debes incluir la ruta de acceso al directorio de repositorios en este comando.
3. Para instalar apigee-service con el servidor web 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.17.05.sh de Edge en /tmp/bootstrap_4.17.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    
    en el que uName:pWord son el nombre de usuario y la contraseña que configuraste antes 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.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
    
    en el que uName:pWord son el nombre de usuario y la contraseña del repositorio.
Usa apigee-service para actualizar la utilidad apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Ejecuta la utilidad de actualización en tu nodo para actualizar la base de datos de Postgres:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

en el que 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.
Inicia Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Ejecuta la utilidad de actualización en tu nodo para actualizar el portal:
> /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

en el que 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.

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

/opt/apigee/apigee-drupal/wwwroot

Se completó la actualización.