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

Actualiza el portal

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

NOTA: Todas las instalaciones nuevas del portal desde la versión 4.17.01 en adelante utilizó Postgres como la base de datos y NGINX como el servidor web. Sin embargo, las versiones anteriores del portal usan MySQL/MariaDB como base de datos y servidor web Apache. Eso significa que tu portal actual podría estar con una de las siguientes configuraciones:

NGINX/Postgres para todas las instalaciones nuevas 4.17.0x, 4.18.0x y 4.51.00
Apache/MySQL 5.0.15 o una versión posterior para todos los sistemas operativos 6.x anteriores a 4.17.01
Apache/MariaDB 5.1.38 o una versión posterior para todos los sistemas operativos 7.x anteriores 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 NGINX/Postgres, usa Actualiza un portal con los RPM a continuación.
Si tu instalación usa Apache/MySQL o Apache/MariaDB, consulta Convierte un Portal basado en tar a un portal basado en RPM.

Determinar 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 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 del portal, con el siguiente formato:
```
*:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
```

Directorio de instalación predeterminado

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

4.17.05 y 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 procedimiento. para usar el directorio de instalación.

Versiones de actualización compatibles

Este procedimiento de actualización es compatible con las versiones del portal OPDK-17-01.x y posteriores.

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

http://yourportal.com/buildInfo

NOTA: Si, por alguna razón, quitaste los buildInfo, puedes determinar la versión del archivo profiles/apigee/apigee.info. El la ubicación de instalación predeterminada es /var/www/html/profiles/apigee/apigee.info, pero es posible que lo hayas cambiado en el momento de la instalación si instalaste el portal en un directorio que que /var/www/html. El archivo apigee.info contiene un línea del formulario que aparece a continuación que contiene la versión:

version = "OPDK-4.17.05"

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 hiciste en .htaccess. Debes suponer que todo lo fuera del directorio /sites es propiedad de Drupal. Los excepción a esta regla es robots.txt; si este archivo existe en la raíz web, será 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 un portal con los RPM

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

Cambia al directorio de Drupal, /opt/apigee/apigee-drupal de forma predeterminada:
```
cd /opt/apigee/apigee-drupal
```
Crea una copia de seguridad de la instancia de base de datos de Drupal. El comando pg_dump crea una copia del base de datos:
```
pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp
```
Aquí:
- devportal es el nombre de la base de datos tal como lo especifica el 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 especificada por la propiedad DRUPAL_PG_USER en la instalación del portal de Terraform.
Se te solicita la contraseña de usuario de Postgres según lo define la La propiedad DRUPAL_PG_PASS en el archivo de configuración de instalación del portal.

Si más adelante deseas 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 estás seguro de la ubicación de este directorio, usa el comando drush status o 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).
SUGERENCIA: Antes de crear una copia de seguridad, comprueba si su destino es un vínculo simbólico (o simbólico) a los archivos reales. Para ello, busca el tipo de archivo l cuando muestras el contenido de un directorio. En el siguiente ejemplo, la segunda y el cuarto directorio son vínculos simbólicos (el tipo de archivo se indica al principio de la lista de permisos):
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.06-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.06-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.06-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.06-0.0.20115
```
Si el destino del que deseas crear una copia de seguridad es un vínculo simbólico, debes anular la referencia a los vínculos para respaldar el contenido. La forma de hacerlo depende de la herramienta que uses para realizar la copia de seguridad. Por ejemplo, si usas tar, usa la opción -h, como en el siguiente ejemplo:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
Realiza una copia de seguridad de los archivos de /opt/apigee/data/apigee-drupal-devportal/private.
Configura Drupal en el modo de mantenimiento:
1. Selecciona Configuración en el menú de Drupal.
2. En la página Configuración, selecciona Modo de mantenimiento. en Desarrollo.
3. Selecciona la casilla Poner el sitio en modo de mantenimiento.
4. Ingresa un mensaje que los usuarios verán durante el mantenimiento.
5. Selecciona Guardar configuración.
Inhabilita SELinux como se describe en Instala la utilidad de Apigee-setup de Edge.
Cambia al directorio /opt:
```
cd /opt
```
Para actualizar un servidor con conexión a Internet, haz lo siguiente:
1. Descarga el archivo bootstrap_4.51.00.sh de Edge 4.51.00 en /tmp/bootstrap_4.51.00.sh
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Instala la utilidad apigee-service y las dependencias de Edge 4.51.00:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Donde uName y pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te solicitará 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.51.00 como se describe en Crea un repositorio local de Apigee.
  NOTA: Si ya tienes un repositorio, puedes agregarle el repositorio 4.51.00 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 en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copia el archivo .tar en el nodo en el que quieres actualizar Edge. Por ejemplo, cópialo al directorio /tmp del nodo nuevo.
  3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
```
tar -xzf apigee-4.51.00.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 y las dependencias apigee-service de Edge desde /tmp/repos
```
sudo bash /tmp/repos/bootstrap_4.51.00.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 de NGINX, sigue estos pasos:
  1. Configura el servidor web NGINX como se describe en “Instala desde el repositorio con el servidor web de NGINX" en Install the Edge apigee-setup.
  2. En el nodo remoto, descarga el archivo bootstrap_4.51.00.sh de Edge para /tmp/bootstrap_4.51.00.sh
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh
  -o /tmp/bootstrap_4.51.00.sh
```
    Donde uName y pWord son el nombre de usuario y la contraseña que estableciste arriba para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del repo.
  3. En el nodo remoto, instala la utilidad apigee-service de Edge y dependencias:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    En el ejemplo anterior, uName y 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 update en tu nodo 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.