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

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 un servicio de canal para desarrolladores de Apigee existente instalación local.

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

Nginx/Postgres para todas las instalaciones nuevas del 17/4/17
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 una versión posterior para todos los sistemas operativos 7.x actualizados a 4.17.01

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

Cómo determinar 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 desde un sistema actualizada a la versión 4.17.01 y, luego, usa el campo Actualización portal con un archivo .tar.
Si tu instalación usa Nginx/Postgres de una nueva versión 4.17.01 instalación, luego usa Cómo actualizar un portal con los RPM.

Determinación tu tipo de instalación actual

Si no estás seguro de tu tipo de instalación actual, usa el siguiente comando para determinar de la siguiente manera:

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 deben presente.
/opt/apigee/apigee-service/bin/apigee-all estado
Si usas Nginx/Postgres, verás el siguiente resultado:

+ servicio de Apigee Estado del portal de apigee-drupal-dev
El portal de apigee-drupal-dev está activo
+ estado de apigee-service apigee-lb
apigee-service: apigee-lb: Correcto
+ estado de apigee-postgresql de apigee-service
apigee-service: apigee-postgresql: correcto
apachectl -S
Si usas Apache/MySQL o Apache/MariaDB, este comando debería mostrar el directorio raíz del portal, con el formato:

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

Directorio de instalación predeterminado

El proceso de actualización asume 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 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 común.

Nuevo directorio de instalación predeterminado después de la actualización de Nginx/Postgres a partir de una nueva versión 4.17.01. instalación

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

/opt/apigee/apigee-drupal

/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 las instalaciones existentes, si modificaste algún código en Drupal Core o en cualquier código no personalizado módulos, tus modificaciones se sobrescribirán. Esto incluye, entre otras cosas, cualquier cambio que hayas creado en .htaccess. Debes suponer que todo lo que está fuera del directorio /sites es propiedad de Drupal. Los la excepción a esta regla es robots.txt; si este archivo existe en la Web raíz, se conservará para ti.

Antes de continuar con la instalación, crea una copia de seguridad de toda la raíz web de Drupal . Luego de realizar los pasos de instalación que se describen a continuación, puedes restablecer tu de la copia de seguridad.

Actualiza el portal con un archivo .tar

Crea una copia de seguridad de tu instancia de MySQL/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 la función de pincel
  
  El comando Paleta sql-dump crea una copia de la base de datos. Desde tu directorio de Drupal, /var/www/html de forma predeterminada, ejecuta el comando comando:
  > drush sql-dump > /path/to/backup_dir/database-backup.sql
  
  Usa drush help sql-dump para 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 DE LA BASE DE DATOS > /path/to/backup_dir/database-backup.sql
  
  No debe haber espacio entre la opción -p y la contraseña. Soltero/a las comillas que encierran la contraseña si esta contiene caracteres especiales.
  
  Estableces USERNAME y 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 quizás lo hayan cambiado en el momento de la instalación.
Descarga el archivo DeveloperServices_x.y.z.tar de los servicios de canal para desarrolladores. archivo de 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 y, luego, agregarla al siguiente comando cURL:
> curl -kOL <paste link here>

Nota: Si el portal se encuentra 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 al Portal de asistencia para solicitar el Canal del desarrollador. Archivo .tar de actualización de servicios. Si no tienes una cuenta en el Portal de asistencia, selecciona Accede al Portal de asistencia y, luego, en la página de acceso, selecciona In a ¿Date prisa? Envía un ticket de asistencia aquí.
Para actualizar un servidor con conexión a Internet, haz lo siguiente:
1. Extrae el archivo de actualización del portal:
  > tar -xvf <tar file>
  
  Con este comando de extracción, se crea un directorio nuevo llamado DeveloperServices-4.x.y.z.
2. Cambia a 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 al directorio de Drupal.
4. Ejecuta la secuencia de comandos networked-update.sh:
  > ./networked-update.sh
  
  Según los permisos del archivo, es posible que debas usar el comando sudo para ejecutar este comando o ejecutarlo como un administrador.
5. Para recibir notificaciones sobre actualizaciones de Drupal, asegúrate de que el administrador módulo 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 habilitado, puedes ver las actualizaciones disponibles en Informes > Disponibles Actualizaciones del menú.
  
  Usa la pestaña Informes > Actualizaciones disponibles > un elemento de menú de configuración configurar el módulo para que te envíe un correo electrónico cuando haya actualizaciones disponibles y para establecer la frecuencia de buscar actualizaciones.
Para actualizar un servidor sin conexión a Internet, haz lo siguiente:
1. En el servidor en el que descargaste el archivo DeveloperServices_x.y.z.tar de los Servicios de canal para desarrolladores, haz lo siguiente: Extrae el archivo de actualización del portal:
  > tar -xvf <tar file>
  
  Con este comando de extracción, se crea un directorio nuevo llamado DeveloperServices-4.x.y.z.
2. Cambia a DeveloperServices-4.x.y.z .
3. Ejecuta la secuencia de comandos non-networked-update.sh:
  > ./non-networked-update.sh
  
  Según los permisos del archivo, es posible que debas usar el comando sudo para ejecutar este comando o ejecutarlo como un administrador.
  
  Este comando descarga todos los archivos de actualización necesarios y los empaqueta en un solo archivo. con el nombre devportal-update.tgz y lo escribe en la ubicación que elijas.
4. Copia devportal-update.tgz en el destino. un servidor web, el que ejecuta el portal.
  Nota: No copies devportal-update.tgz en la raíz web de el servidor de destino.
5. Descomprime el archivo devportal-update.tgz en 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.

Actualiza un portal con los RPM

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

Cambia al directorio de Drupal, /opt/apigee/apigee-drupal, valor predeterminado:
> 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 del base de datos:

pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp

En el ejemplo anterior, se ilustra lo siguiente:
- dbname especifica el nombre de la base de datos según lo especifica la propiedad PG_NAME en el portal de instalación del proyecto.
- host especifica la IP del nodo del portal.
- username especifica el nombre de usuario de Postgres que usa el portal para acceder a la base de datos según lo especificado en el DRUPAL_PG_USER en el el archivo de configuración de instalación del portal.
- Se te solicita la contraseña de usuario de Postgres como lo define la propiedad DRUPAL_PG_PASS en el el archivo de configuración de instalación del portal.
Si más adelante necesitas 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 lo hayas cambiado.

Si no sabes con certeza la ubicación de este directorio, usa el comando drush status o el Configuración > Contenido multimedia > File 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 la siguiente paso).
Realiza una copia de seguridad de los archivos en /opt/apigee/data/apigee-drupal-devportal/private.
Inhabilita SELinux como se describe en Instalación la utilidad de configuración de Apigee de Edge
Para actualizar un servidor con conexión a Internet, haz lo siguiente:
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. Instalar la utilidad apigee-service de Edge 4.17.05 y dependencias:
  > sudo bash /tmp/bootstrap_4.17.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. Puedes usar la “C” la opción de continuar sin instalar Java.
Para actualizar un servidor sin conexión a Internet, haz lo siguiente:
1. Crea un repositorio local 4.17.05 como se describe en "Crea un repositorio local de Apigee" en Instala el Apigee-setup de Edge utilidad.
  Nota: Si ya tienes un repositorio 4.17.01, puedes agregar el 4.17.05 Repositorio, como se describe en “Actualiza un repositorio local de Apigee” en Instala la utilidad de Apigee-setup de Edge.
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 archivo Repo en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.17.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 al directorio /tmp en el 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. Instalar la utilidad apigee-service de Edge y dependencias de /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    Ten en cuenta que incluyes la ruta de acceso al directorio de repositorios en este comando.
3. 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 web NGINX" en Install the Edge apigee-setup.
  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 ejemplo anterior, 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 de el nodo del repo.
  3. En el nodo remoto, instala la utilidad apigee-service de Edge y dependencias:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
    
    En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña del repositorio.
Usa apigee-service para actualizar el comando apigee-setup utilidad:
> /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 ejemplo anterior, 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 la configuración el archivo debe ser accesible y legible por el “Apigee” usuario.
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 ejemplo anterior, configFile es el archivo de configuración que usaste para instalar. el portal. El único requisito del archivo de configuración es que este debe ser accesible o legible por el “Apigee” usuario.

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

/opt/apigee/apigee-drupal/wwwroot

Se completó la actualización.