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

Portail des services pour les développeurs version 4.16.05

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

Répertoire d'installation par défaut

La procédure de mise à niveau suppose que le portail des développeurs a été installé à l'adresse /var/www/html. 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.

Si vous ne connaissez pas le répertoire d'installation, vous pouvez le déterminer en suivant les instructions de la section Commandes Drush couramment utilisées.

Versions de mise à niveau compatibles

Cette procédure de mise à niveau est compatible avec les versions suivantes du portail:

  • pantheon-4.24.216
  • pantheon-4.24.246
  • 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

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

http://yourportal.com/buildInfo

Mise à niveau des services de canaux de développement Apigee vers une nouvelle version

  1. Sauvegarde de votre instance MySQL Drupal.
    Pour en savoir plus, consultez la page http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.
    1. Option 1: utiliser Drush

      La commande Drush sql-dump crée une copie de la base de données. Depuis votre répertoire Drupal, /var/www/html par défaut, exécutez la commande suivante:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Pour en savoir plus, utilisez drush help sql-dump.
    2. Option 2: utiliser MySQLdump
      Utilisez la commande mysqldump pour créer une copie de la base de données:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
      Il ne doit pas y avoir d'espace entre l'option -p et le mot de passe.
      Le mot de passe doit être entouré de guillemets simples s'il contient des caractères spéciaux.

      Vous avez défini les paramètres USERNAME et DATABASENAME lors de l'installation du portail. Par défaut, les deux sont le portail de développement.
  2. Effectuez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. L'emplacement d'installation par défaut est /var/www/html, mais vous l'avez peut-être modifié au moment de l'installation.
  3. Téléchargez le fichier DeveloperServices_x.y.z.tar des services de canaux pour les développeurs, où x.y.z correspond au numéro de version du portail.

    Vous pouvez télécharger un fichier à partir du lien qu'Apigee vous a envoyé dans un navigateur ou en le copiant, puis en l'ajoutant à la commande cURL suivante:
    > curl -kOL <paste link here>

    Remarque: Si votre portail se trouve sur un serveur sans connexion Internet externe, effectuez cette étape sur un serveur disposant d'un accès.

    Accédez à http://community.apigee.com/content/apigee-customer-support et sélectionnez Se connecter à votre portail d'assistance pour demander le fichier .tar de la mise à niveau des services de canaux pour les développeurs. Si vous ne possédez pas de compte sur le portail d'assistance, sélectionnez Login to your Support Portal (Se connecter au portail d'assistance), puis sur la page de connexion, sélectionnez Vous êtes pressé ? Envoyez une demande d'assistance ici.
  4. Pour effectuer une mise à niveau sur un serveur avec connexion Internet:
    1. Extrayez le fichier de mise à niveau du portail:
      > tar -xvf <tar file>

      Cet extrait de commande crée un répertoire nommé DeveloperServices-4.x.y.z.
    2. Passez au répertoire DeveloperServices-4.x.y.z.
    3. Téléchargez la dernière version de Drupal en utilisant la commande suivante:
      > drush dl drupal

      Cette commande crée un répertoire nommé drupal-x.y, où x.y correspond à la version actuelle de Drupal.
    4. Exécutez le script networked-update.sh:
      > ./networked-update.sh

      En fonction des autorisations des fichiers, vous devrez peut-être utiliser sudo pour exécuter cette commande ou l'exécuter en tant qu'administrateur.
    5. Pour recevoir des notifications de mises à jour Drupal, assurez-vous que le module du gestionnaire de mises à jour Drupal est activé. Dans le menu Drupal, sélectionnez Modules et faites défiler la page jusqu'au module Update manager (Gestionnaire de mises à jour). S'il n'est pas activé, activez-le.

      Une fois la fonctionnalité activée, vous pouvez voir les mises à jour disponibles à l'aide de l'élément de menu Rapports > Mises à jour disponibles.

      Utilisez l'élément de menu Rapports > Mises à jour disponibles > Paramètres pour configurer le module de sorte qu'il vous envoie un e-mail lorsque des mises à jour sont disponibles et pour définir la fréquence de recherche des mises à jour.
  5. Pour une mise à niveau sur un serveur sans connexion Internet:
    1. Sur le serveur sur lequel vous avez téléchargé le fichier DeveloperServices_x.y.z.tar de Developer Channel Services, extrayez le fichier de mise à niveau du portail:
      > tar -xvf <tar file>

      Cette extraction de commande crée un répertoire nommé DeveloperServices-4.x.y.z.
    2. Passez au répertoire DeveloperServices-4.x.y.z.
    3. Exécutez le script non-networked-update.sh:
      > ./non-networked-update.sh

      En fonction des autorisations de fichier, vous devrez peut-être utiliser sudo pour exécuter cette commande ou l'exécuter en tant qu'administrateur.

      Cette commande télécharge tous les fichiers de mise à jour nécessaires et les empaquette dans un seul fichier nommé devportal-update.tgz, et écrit le fichier à l'emplacement de votre choix.
    4. Copiez devportal-update.tgz sur le serveur cible, celui qui exécute le portail.
      Remarque: Ne copiez pas le fichier devportal-update.tgz à la racine Web du serveur cible.
    5. Décompressez le fichier devportal-update.tgz dans le répertoire actuel:
      > tar -xzf /path/to/devportal-update.tgz
    6. Accédez au répertoire developer-update.
    7. Exécutez la commande suivante pour installer la mise à jour:
      > ./install-update.sh
    8. Répondez aux invites.

La migration est maintenant terminée.