Mettre à niveau le portail des services pour les développeurs

Edge for Private Cloud v4.18.01

Cette procédure explique comment mettre à niveau une installation sur site de la solution Apigee Developer Channel Services.

Déterminer la procédure de mise à jour correcte

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

Déterminer le type d'installation actuel

Si vous n'êtes pas sûr de 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 doivent 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, au format suivant:

    *: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 des développeurs 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 compatible avec les versions suivantes du portail:

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

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

http://yourportal.com/buildInfo

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 pu apporter à .htaccess. Vous devez partir du principe que tout ce qui se trouve en dehors du répertoire /sites appartient à Drupal. Cette règle fait exception à cette règle : robots.txt. Si ce fichier existe à la racine Web, il sera conservé.

Avant de procéder à l'installation, effectuez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. Après avoir suivi les étapes d'installation décrites 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:

  1. Accédez au répertoire Drupal, /opt/apigee/apigee-drupal par défaut :
    cd /opt/apigee/apigee-drupal
  2. 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=192.168.56.101 --username=drupaladmin
      --password --format=c > /tmp/portal.dmp

    où :

    • dbname spécifie 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 spécifie l'adresse IP du nœud du portail.
    • username spécifie 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 devez ultérieurement effectuer une restauration à partir de la sauvegarde, utilisez la commande suivante:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. Effectuez 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 n'êtes pas sûr de l'emplacement de ce répertoire, utilisez la commande drush status ou l'entrée Configuration > Médias > Fichier du 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).

  4. Sauvegardez les fichiers dans /opt/apigee/data/apigee-drupal-devportal/private.
  5. Configurez Drupal en mode maintenance :
    1. Sélectionnez Configuration dans le menu Drupal.
    2. Sur la page Configuration, sélectionnez le mode Maintenance sous Développement.
    3. Cochez la case Mettre le site en mode de maintenance.
    4. Saisissez un message que les utilisateurs voient pendant la maintenance.
    5. Sélectionnez Enregistrer la configuration.
  6. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  7. Accédez au répertoire /opt :
    > cd /opt
  8. Pour effectuer une mise à niveau sur un serveur avec connexion Internet:
    1. Téléchargez le fichier bootstrap_4.18.01.sh Edge 4.18.01 dans /tmp/bootstrap_4.18.01.sh :
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    2. Installez l'utilitaire et les dépendances apigee-service d'Edge 4.18.01 :
      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

      uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous êtes invité à le faire.

      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.

  9. Pour une mise à niveau sur un serveur sans connexion Internet:
    1. Créez un dépôt local 4.18.01 comme décrit dans la section "Créer un dépôt Apigee local" de la section Installer l'utilitaire de configuration d'Apigee Edge.
    2. Pour installer apigee-service à partir d'un fichier .tar :
      1. Sur le nœud contenant le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.18.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.18.01.tar.gz

        Cette commande crée un répertoire, nommé "dépôt", dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.

      4. Installez l'utilitaire et les dépendances Edge apigee-service de /tmp/repos :
        sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Notez que vous avez inclus dans cette commande le chemin d'accès au répertoire des 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 de configuration Edge apigee-setup.
      2. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh :
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
          -o /tmp/bootstrap_4.18.01.sh

        uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo à l'adresse IP ou au nom DNS du nœud de dépôt.

      3. Sur le nœud distant, installez l'utilitaire et les dépendances Edge apigee-service :
        sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
            apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.

  10. Utilisez apigee-service pour mettre à jour l'utilitaire apigee-setup :
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Exécutez l'utilitaire de mise à jour sur votre nœud Postgre :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    configFile est le fichier de configuration que vous avez utilisé pour installer la base de données Postgres. La seule condition requise sur le fichier de configuration est qu'il soit accessible ou lisible par l'utilisateur "apigee".

  12. Mettez à jour la base de données Postgres :
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  13. 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

    configFile est le fichier de configuration que vous avez utilisé pour installer le portail. La seule condition requise sur le fichier de configuration est qu'il soit accessible ou lisible par l'utilisateur "apigee".

  14. Exécutez le script update.php de Drupal en ouvrant l'URL suivante dans une fenêtre de navigateur :
    http://portalIP_DNS:8079/update.php
  15. Désactivez Drupal en mode maintenance :
    1. Sélectionnez Configuration dans le menu Drupal.
    2. Sur la page Configuration, sélectionnez le mode Maintenance sous Développement.
    3. Décochez la case Mettre le site en mode de maintenance.
    4. Sélectionnez Enregistrer la configuration.

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

/opt/apigee/apigee-drupal/wwwroot

La migration est maintenant terminée.