Cette page a été traduite par l'API Cloud Translation.

Mettre à niveau le portail

Cette procédure explique comment mettre à niveau un portail de services pour les développeurs Apigee existant (ou simplement le portail) sur site l'installation.

REMARQUE:Toutes les nouvelles installations du portail à partir de la version à partir de 4.17.01, utilisait Postgres comme la base de données et Nginx comme serveur Web. Cependant, les versions précédentes du portail MySQL/MariaDB en tant que base de données et serveur Web Apache. Cela signifie que votre portail actuel peut être en utilisant l'une des configurations suivantes: <ph type="x-smartling-placeholder">

Nginx/Postgres pour toutes les nouvelles installations 4.17.0x, 4.18.0x et 4.19.06
Apache/MySQL 5.0.15 ou version ultérieure pour tous les systèmes d'exploitation 6.x antérieurs à la version 4.17.01
Apache/MariaDB 5.1.38 ou version ultérieure pour tous les systèmes d'exploitation 7.x antérieurs à la version 4.17.01

Avant de lancer le processus de mise à jour, vous devez déterminer votre configuration actuelle, puis suivre la procédure de mise à jour correcte.

Déterminer la procédure de mise à jour appropriée

La procédure à suivre pour mettre à jour le portail est basée sur votre installation actuelle:

Si votre installation utilise Nginx/Postgres, utilisez Mettre à niveau un portail à l'aide de RPM ci-dessous.
Si votre installation utilise Apache/MySQL ou Apache/MariaDB, consultez Convertir un vers un portail basé sur RPM.

Déterminer votre type d'installation actuel

Si vous n'êtes pas sûr de votre type d'installation actuel, utilisez la commande suivante pour déterminer comme suit:

```
ls /opt
```
Si vous utilisez Nginx/Postgres, les répertoires suivants s'affichent: /opt/apigee et /opt/nginx.

Si vous utilisez Apache/MySQL ou Apache/MariaDB, ces répertoires ne doivent pas être à l'heure actuelle.

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

Si vous utilisez Nginx/Postgres, vous obtenez le résultat suivant:

+ 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 vous utilisez Apache/MySQL ou Apache/MariaDB, cette commande doit renvoyer le code répertoire racine du portail, sous la forme:
```
*:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
```

Répertoire d'installation par défaut

Le processus de mise à niveau suppose que le portail a été installé à l'adresse suivante:

4.17.05 et versions ultérieures: /opt/apigee/apigee-drupal/wwwroot
Avant la version 4.17.05: /opt/apigee/apigee-drupal (Nginx) ou /var/www/html (Apache)

Si vous n'avez pas installé le portail dans le répertoire par défaut, modifiez les chemins d'accès dans la procédure ci-dessous pour utiliser votre répertoire d'installation.

Versions de mise à niveau compatibles

Cette procédure de mise à niveau est disponible sur les versions du portail OPDK-17-01.x et ultérieures.

Pour déterminer la version de votre portail, ouvrez l'URL suivante dans un navigateur:

http://yourportal.com/buildInfo

REMARQUE:Si, pour une raison quelconque, vous avez supprimé le buildInfo, vous pouvez déterminer à partir du fichier profiles/apigee/apigee.info. La l'emplacement d'installation par défaut est /var/www/html/profiles/apigee/apigee.info, mais vous l'avez peut-être modifié au moment de l'installation si vous avez installé le portail dans un répertoire que /var/www/html. Le fichier apigee.info contient un dans le formulaire ci-dessous contenant la version:

version = "OPDK-4.17.05"

Avant la mise à jour

Pour les installations existantes, si vous avez modifié du code dans Drupal Core ou dans tout autre code modules, vos modifications seront écrasées. Cela inclut, entre autres, toute modification que vous avez peut-être apportées à .htaccess. Vous devez partir du principe que tout ce qui se trouve en dehors du répertoire /sites appartient à Drupal. Une l'exception à cette règle est robots.txt. si ce fichier existe à la racine Web, il sera conservées pour vous.

Avant de procéder à l'installation, effectuez une sauvegarde de l'ensemble de votre racine Web Drupal. . Après avoir suivi la procédure d'installation décrite ci-dessous, vous pouvez restaurer votre personnalisées à partir de la sauvegarde.

Mettre à niveau un portail à l'aide de RPM

Pour mettre à jour le RPM du portail sur un nœud:

Accédez au répertoire Drupal, /opt/apigee/apigee-drupal par défaut:
```
cd /opt/apigee/apigee-drupal
```
Sauvegardez votre instance de base de données Drupal. La commande pg_dump crée une copie base de données:
```
pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp
```
Où :
- devportal est le nom de la base de données tel que spécifié par PG_NAME dans le fichier de configuration d'installation du portail.
- host_IP_address est l'adresse IP du nœud du portail.
- drupaladmin est le nom d'utilisateur Postgres utilisé par le portail pour accéder à base de données comme spécifié par la propriété DRUPAL_PG_USER de l'installation du portail fichier de configuration.
Vous êtes invité à saisir le mot de passe utilisateur Postgres tel que défini par le DRUPAL_PG_PASS dans le fichier de configuration d'installation du portail.

Si vous souhaitez ultérieurement restaurer à partir d'une sauvegarde, exécutez la commande suivante:
```
pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
```
Effectuez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. Emplacement d'installation par défaut est /opt/apigee/apigee-drupal, mais vous l'avez peut-être modifié.
Si vous n'êtes pas sûr de l'emplacement de ce répertoire, utilisez la commande drush status ou la commande Configuration > Médias > File dans le menu Drupal pour déterminer l'emplacement du système de fichiers public et du chemin d'accès au système de fichiers privé (pour les étape).
CONSEIL:Avant d'effectuer une sauvegarde, vérifiez si la cible de la sauvegarde est un lien symbolique (ou symbolique) vers les fichiers eux-mêmes. Pour ce faire, recherchez le type de fichier l lorsque vous affichez le contenu d'un répertoire. Dans l'exemple suivant, la deuxième Les quatrièmes répertoires sont des liens symboliques (le type de fichier est indiqué au début du d'autorisation):
```
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 la cible que vous souhaitez sauvegarder est un lien symbolique, vous devez déréférencer les liens. pour sauvegarder le contenu réel. La procédure à suivre dépend de l'outil que vous utilisez la sauvegarde. Par exemple, si vous utilisez tar, utilisez l'option -h, comme suit : l'exemple suivant montre:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
Effectuez une sauvegarde des fichiers dans /opt/apigee/data/apigee-drupal-devportal/private.
Définissez Drupal en mode maintenance: <ph type="x-smartling-placeholder">
1. Sélectionnez Configuration dans le menu Drupal.
2. Sur la page Configuration, sélectionnez Mode maintenance. dans Développement.
3. Cochez la case Mettre le site en mode maintenance.
4. Saisissez un message que les utilisateurs verront pendant la maintenance.
5. Sélectionnez Enregistrer la configuration.
Désactivez SELinux comme décrit dans la section Installez l'utilitaire de configuration Edge apigee.
Accédez au répertoire /opt :
```
cd /opt
```
Pour la mise à niveau sur un serveur doté d'une connexion Internet: <ph type="x-smartling-placeholder">
1. Téléchargez le fichier bootstrap_4.19.06.sh Edge 4.19.06 pour /tmp/bootstrap_4.19.06.sh:
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
2. Installez l'utilitaire Edge 4.19.06 apigee-service et les dépendances:
```
sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
```
  Où uName et pWord correspondent au nom d'utilisateur et au mot de passe que vous avez reçus. d'Apigee. Si vous omettez pWord, vous serez invité à le faire.
  
  Par défaut, le programme d'installation vérifie que Java 1.8 est bien installé. Vous pouvez utiliser "C" pour continuer sans installer Java.
Pour une mise à niveau sur un serveur sans connexion Internet: <ph type="x-smartling-placeholder">
1. Créez un dépôt 4.19.06 local comme décrit dans Créez un dépôt Apigee local.
  REMARQUE: Si vous disposez déjà d'un dépôt, vous pouvez y ajouter le dépôt 4.19.06 comme décrit dans la section "Mettre à jour un dépôt Apigee local". à Installez l'utilitaire de configuration Edge Apigee.
2. Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
  1. Sur le nœud contenant le dépôt local, empaquetez le fichier local à l'aide de la commande suivante : dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
  3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
```
tar -xzf apigee-4.19.06.tar.gz
```
    Cette commande crée un répertoire nommé "repos" dans le répertoire contenant le fichier .tar. . Par exemple, /tmp/repos.
  4. Installez l'utilitaire Edge apigee-service et les dépendances à partir de /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Notez que vous incluez dans cette commande le chemin d'accès au répertoire "dépôts".
3. Pour installer apigee-service à l'aide du serveur Web Nginx: <ph type="x-smartling-placeholder">
  1. Configurez le serveur Web Nginx comme indiqué dans la section "Installer à partir du dépôt à l'aide du Serveur Web Nginx dans la section Installer Edge utilitaire de configuration apigee.
  2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.19.06.sh pour /tmp/bootstrap_4.19.06.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh
  -o /tmp/bootstrap_4.19.06.sh
```
    Où uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez définis. ci-dessus pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS du de votre nœud de dépôt.
  3. Sur le nœud distant, installez l'utilitaire Edge apigee-service et dépendances:
```
sudo bash /tmp/bootstrap_4.19.06.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Où uName et pWord correspondent au nom d'utilisateur et au mot de passe du dépôt.
Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Exécutez l'utilitaire update sur votre nœud Postgres:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Où configFile correspond au fichier de configuration que vous avez utilisé pour installer dans la base de données Postgres. La seule condition requise pour le fichier de configuration est que le fichier de configuration doit être accessible ou lisible par l'"apigee" utilisateur.