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

Mettre à niveau le portail

Edge pour Private Cloud v4.19.01

Cette procédure explique comment mettre à niveau une installation sur site existante du portail Apigee Developer Services (ou simplement le portail).

REMARQUE:Toutes les nouvelles installations du portail à partir de la version 4.17.01 utilisaient Postgres comme base de données et Nginx comme serveur Web. Toutefois, les versions précédentes du portail utilisent MySQL/MariaDB comme base de données et Apache comme serveur Web. Cela signifie que votre portail actuel utilise peut-être l'une des configurations suivantes :

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

Avant de commencer le processus de mise à jour, vous devez déterminer votre configuration actuelle, puis effectuer la procédure de mise à jour appropriée.

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 la section Mettre à niveau un portail à l'aide de RPM ci-dessous.
Si votre installation utilise Apache/MySQL ou Apache/MariaDB, consultez la section Convertir un portail basé sur tar en portail basé sur RPM.

Déterminer votre type d'installation actuel

Si vous ne savez pas quel est votre type d'installation actuel, utilisez la commande suivante pour le déterminer:

```
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 devraient pas être présents.

/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 répertoire racine Web du portail, sous la forme suivante:
```
*: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'emplacement suivant:

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 pour les versions suivantes du portail:

OPDK-17-01.x
OPDK-17-05.x
OPDK-17-09.x
OPDK-18-01.x
OPDK-18-05.x

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

http://yourportal.com/buildInfo

REMARQUE:Si vous avez supprimé le fichier buildInfo pour une raison quelconque, vous pouvez déterminer la version à partir du fichier profiles/apigee/apigee.info. 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 autre que /var/www/html. Le fichier apigee.info contient une ligne sous la forme 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 le noyau Drupal ou dans des modules non personnalisés, vos modifications seront écrasées. Cela inclut, entre autres, toutes les modifications que vous avez apportées à .htaccess. Vous devez supposer que tout élément en dehors du répertoire /sites appartient à Drupal. robots.txt est une exception à cette règle. Si ce fichier existe dans la racine du site Web, il sera conservé.

Avant de procéder à l'installation, créez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. Après avoir suivi la procédure d'installation décrite ci-dessous, vous pouvez restaurer vos personnalisations à 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 de la 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 la propriété 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 à la base de données, comme spécifié par la propriété DRUPAL_PG_USER dans le fichier de configuration d'installation du portail.
Vous êtes invité à saisir le mot de passe utilisateur Postgres tel que défini par la propriété 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
```
Créez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. L'emplacement d'installation par défaut est /opt/apigee/apigee-drupal, mais vous l'avez peut-être modifié.
Si vous ne connaissez pas l'emplacement de ce répertoire, utilisez la commande drush status ou l'entrée Configuration > Médias > Fichier 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 l'étape suivante).
ASTUCE:Avant de créer une sauvegarde, vérifiez si la cible de votre sauvegarde est un lien symbolique (ou lien symbolique) vers les fichiers réels. Pour ce faire, recherchez le type de fichier l lorsque vous répertoriez le contenu d'un répertoire. Dans l'exemple suivant, les deuxième et quatrième répertoires sont des liens symboliques (le type de fichier est indiqué au début de la liste des autorisations) :
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.01-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.01-0.0.20115
```
Si la cible que vous souhaitez sauvegarder est un lien symbolique, vous devez désindexer les liens pour sauvegarder le contenu réel. La procédure à suivre dépend de l'outil que vous utilisez pour effectuer la sauvegarde. Par exemple, si vous utilisez tar, choisissez l'option -h, comme le montre l'exemple suivant:
```
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 :
1. Sélectionnez Configuration dans le menu Drupal.
2. Sur la page Configuration, sélectionnez Mode maintenance sous Développement.
3. Cochez la case Mettre le site en mode maintenance.
4. Saisissez le message que les utilisateurs verront pendant la maintenance.
5. Sélectionnez Enregistrer la configuration.
Désactivez SELinux comme décrit dans la section Installer l'utilitaire apigee-setup Edge.
Accédez au répertoire /opt :
```
cd /opt
```
Pour une mise à niveau sur un serveur disposant d'une connexion Internet:
1. Téléchargez le fichier bootstrap_4.19.01.sh d'Edge 4.19.01 dans /tmp/bootstrap_4.19.01.sh :
```
curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
```
2. Installez l'utilitaire Edge 4.19.01 apigee-service et les dépendances :
```
sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
```
  Où uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.
  
  Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Vous pouvez utiliser l'option "C" pour continuer sans installer Java.
Pour effectuer une mise à niveau sur un serveur sans connexion Internet:
1. Créez un dépôt local 4.19.01 comme décrit dans la section Créer 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.01 comme décrit dans la section "Mettre à jour un dépôt Apigee local" de la page Installer l'utilitaire apigee-setup Edge.
2. Pour installer apigee-service à partir d'un fichier .tar :
  1. Sur le nœud avec le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.19.01.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.01.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.01.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:
  1. Configurez le serveur Web Nginx comme décrit dans la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" de la section Installer l'utilitaire Edge de configuration Apigee.
  2. Sur le nœud distant, téléchargez le fichier bootstrap_4.19.01.sh Edge dans /tmp/bootstrap_4.19.01.sh :
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
  -o /tmp/bootstrap_4.19.01.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 nœud du dépôt.
  3. Sur le nœud distant, installez l'utilitaire apigee-service Edge et les dépendances :
```
sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Où uName et pWord sont le nom d'utilisateur et le 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 de mise à jour sur votre nœud Postgres :
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
où configFile est le fichier de configuration que vous avez utilisé pour installer la base de données Postgres. La seule exigence concernant le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee".
Exécutez l'utilitaire de mise à jour sur votre nœud pour mettre à jour le portail :
```
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
```
où configFile est le fichier de configuration que vous avez utilisé pour installer le portail. La seule exigence concernant le fichier de configuration est qu'il doit être accessible ou lisible par l'utilisateur "apigee".
Exécutez le script update.php de Drupal en ouvrant l'URL suivante dans une fenêtre de navigateur :
```
http://portal_IP_DNS:8079/update.php
```
Désactivez le mode de maintenance :
1. Sélectionnez Configuration dans le menu Drupal.
2. Sur la page Configuration, sélectionnez Mode de maintenance sous Développement.
3. Désélectionnez la case Mettre le site en mode de maintenance.
4. Sélectionnez Enregistrer la configuration.

Notez que le répertoire racine après la mise à jour est le suivant:

/opt/apigee/apigee-drupal/wwwroot

La migration est maintenant terminée. Si l'utilitaire de mise à jour d'Apigee a rétrogradé votre version de Drupal, vous devrez peut-être relancer l'utilitaire de mise à niveau de Drupal. Pour en savoir plus, consultez la section Réexécuter la mise à niveau de Drupal.

Réexécuter la mise à niveau Drupal

Si l'exécution de l'utilitaire de mise à jour Apigee pour mettre à niveau Edge pour Private Cloud entraîne une rétrogradation de votre version de Drupal, réinstallez la mise à niveau de Drupal. Cela peut être le cas si vous n'avez mis à niveau que Drupal entre les mises à jour de Private Cloud.

Exemple :

Vous exécutiez la version 4.18.05 d'Edge pour Private Cloud, qui incluait Drupal 7.59.
Vous avez mis à niveau Drupal vers la version 7.64 en raison d'une mise à jour de sécurité requise.
Vous passez maintenant à la version 4.19.01 de Private Cloud, qui inclut Drupal 7.61.

Comme le montre ce cas, la version de Drupal utilisée par l'utilitaire de mise à jour d'Apigee ne fait peut-être pas référence à la dernière mise à niveau de Drupal. Vous devez donc relancer la mise à niveau de Drupal pour rétablir la version ultérieure de votre installation Drupal.