Portail des services pour les développeurs v. 4.16.09
Cette procédure explique comment mettre à niveau une installation sur site existante des services de canal de développement Apigee.
Répertoire d'installation par défaut
Le processus de mise à niveau suppose que le Developer Portal a été installé dans /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 comme décrit dans 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-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
- OPDK-16-05.x
Pour déterminer la version de votre portail, ouvrez l'URL suivante dans un navigateur:
http://yourportal.com/buildInfo
Avant d'installer
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 ce qui se trouve en dehors du répertoire /sites appartient à Drupal. Le fichier robots.txt constitue une exception à cette règle. Si ce fichier existe à la racine Web, il sera conservé pour vous.
Avant de procéder à l'installation, créez 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. Après avoir suivi la procédure d'installation décrite ci-dessous, vous pouvez restaurer vos personnalisations à partir de la sauvegarde.
Mise à niveau des services Apigee Developer Channel vers une nouvelle version
- Sauvegarde de votre instance MySQL Drupal.
Pour en savoir plus, consultez http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.- Option 1: Utiliser Drush
La commande Drush sql-dump crée une copie de la base de données. Dans votre répertoire Drupal, /var/www/html par défaut, exécutez la commande:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
Pour en savoir plus, utilisez drush help sql-dump. - Option 2: Utilisez MySQLdump
Utilisez la commande mysqldump pour créer une copie de la base de données:
mysqldump -u NOM D'UTILISATEUR -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. Des guillemets simples autour du mot de passe sont obligatoires s'il contient des caractères spéciaux.
Vous avez défini les valeurs des champs USERNAME et DATABASENAME lors de l'installation du portail. Par défaut, les deux sont devportal.
- Option 1: Utiliser Drush
- 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 avez peut-être modifié cet emplacement au moment de l'installation.
- Téléchargez le fichier DeveloperServices_x.y.z.tar des services de canal 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 qui vous a été envoyé par Apigee dans un navigateur, ou en le copiant et en l'ajoutant à la commande cURL suivante:
> curl -kOL <coller le lien ici>
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 au portail d'assistance pour demander le fichier .tar de mise à niveau des services du canal de développement. Si vous ne possédez pas de compte sur le portail d'assistance, sélectionnez Se connecter au portail d'assistance, puis sur la page de connexion, sélectionnez Vous êtes pressé ? Déposez une demande d'assistance ici. -
Pour effectuer une mise à niveau sur un serveur connecté à Internet:
- Extrayez le fichier de mise à niveau du portail:
> tar -xvf <tar file>
Cette commande d'extraction crée un répertoire appelé DeveloperServices-4.x.y.z. - Accédez au répertoire DeveloperServices-4.x.y.z.
- Téléchargez la dernière version de Drupal à l'aide de 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. - Exécutez le script networked-update.sh:
> ./networked-update.sh
En fonction des autorisations de fichiers, vous devrez peut-être utiliser sudo pour exécuter cette commande ou l'exécuter en tant qu'administrateur. - 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, puis faites défiler la page jusqu'au module Gestionnaire de mises à jour. Si ce n'est pas le cas, activez-la.
Une fois l'option activée, vous pouvez afficher les mises à jour disponibles à l'aide de l'élément de menu Rapports > Mises à jour disponibles.
Utilisez l'élément de menu Reports > Available Updates > Settings (Rapports > Mises à jour disponibles > Paramètres) pour configurer le module afin qu'il vous envoie un e-mail lorsque des mises à jour sont disponibles et pour définir la fréquence de recherche de mises à jour.
- Extrayez le fichier de mise à niveau du portail:
-
Pour effectuer une mise à niveau sur un serveur sans connexion Internet:
- Sur le serveur sur lequel vous avez téléchargé le fichier DeveloperServices_x.y.z.tar des services de chaînes pour les développeurs, 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. - Accédez au répertoire DeveloperServices-4.x.y.z.
- Exécutez le script non-networked-update.sh:
> ./non-networked-update.sh
En fonction des autorisations de fichiers, 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, les regroupe dans un seul fichier nommé devportal-update.tgz et l'écrit à un emplacement de votre choix. - Copiez devportal-update.tgz sur le serveur cible, celui qui exécute le portail.
Remarque: Ne copiez pas le fichier devportal-update.tgz dans le répertoire racine Web du serveur cible. - Décompressez le fichier devportal-update.tgz dans le répertoire actuel:
> tar -xzf /path/to/devportal-update.tgz - Accédez au répertoire developer-update.
- Exécutez la commande suivante pour installer la mise à jour:
> ./install-update.sh - Répondez aux invites.
- Sur le serveur sur lequel vous avez téléchargé le fichier DeveloperServices_x.y.z.tar des services de chaînes pour les développeurs, extrayez le fichier de mise à niveau du portail:
La migration est maintenant terminée.