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

Portail des services pour les développeurs version 4.17.05

Cette procédure explique comment mettre à niveau un service Apigee Developer Channel Services existant l'installation sur site.

<ph type="x-smartling-placeholder">

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:

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 état
    Si vous utilisez Nginx/Postgres, vous obtenez le résultat suivant:

    + apigee-service État de apigee-drupal-devportal
    OK: apigee-drupal-devportal est opérationnel
    + État apigee-service apigee-lb
    apigee-service: apigee-lb: OK
    + État apigee-service apigee-postgresql
    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

La mise à niveau suppose que le portail des développeurs a été installé à l'adresse suivante:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Si vous ne connaissez pas le répertoire d'installation, vous pouvez le déterminer comme décrit dans la section Commandes Drush courantes.

Nouveau répertoire d'installation par défaut après la mise à jour de Nginx/Postgres à partir de la nouvelle version 4.17.01 installation

Après la mise à jour d'une nouvelle installation de la version 4.17.01 qui utilise Nginx/Postgres, le répertoire racine modifié à partir de:

/opt/apigee/apigee-drupal

par :

/opt/apigee/apigee-drupal/wwwroot

Versions de mise à niveau compatibles

Cette procédure de mise à niveau est disponible pour les versions suivantes du portail:

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • panthéon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

<ph type="x-smartling-placeholder">

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 au fichier .htaccess. Vous devez partir du principe que tout ce qui se trouve en dehors du répertoire /sites appartient à Drupal. Une le fichier robots.txt constitue une exception à cette règle. si ce fichier existe sur le Web racine, il est conservé 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 le portail à l'aide d'un fichier .tar

  1. Sauvegardez votre instance Drupal MySQL/MariaDB.
    Pour en savoir plus, consultez la page http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ <ph type="x-smartling-placeholder">
      </ph>
    1. 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 commande:
      &gt; drush sql-dump > /path/to/backup_dir/database-backup.sql

      Utilisez la commande drush help sql-dump pour plus d'informations.
    2. Option 2: Utiliser MySQLdump
      Utiliser la commande mysqldump pour créer une copie de la base de données:
      mysqldump -u NOM D'UTILISATEUR -p'MOT DE PASSE' NOMDEBASE DE DONNÉES > /path/to/backup_dir/database-backup.sql

      Il ne doit pas y avoir d'espace entre l'option -p et le mot de passe. Célibataire Le mot de passe doit être entouré par des guillemets si ce dernier contient des caractères spéciaux.

      Vous définissez les champs USERNAME et DATABASENAME. lors de l'installation du portail. Par défaut, les deux noms sont "devportal".
  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 pourriez l'avez modifié au moment de l'installation.
  3. Téléchargez le fichier DeveloperServices_x.y.z.tar des services de chaînes pour les développeurs. de ftp.apigee.com, où x.y.z correspond au numéro de version du portail. Lorsque vous y êtes invité, saisissez les identifiants que vous avez reçus. d'Apigee.

    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 puis en l'ajoutant à la commande cURL suivante:
    &gt; curl -kOL <coller le lien here&gt;

    Remarque: Si votre portail se trouve sur un serveur sans connexion Internet externe, effectuer cette étape sur un serveur avec accès.

    Accédez à l'assistance Apigee Edge. et sélectionnez Se connecter à votre portail d'assistance pour demander la chaîne développeur Fichier .tar de mise à niveau des services. Si vous n'avez pas de compte sur le portail d'assistance, sélectionnez Connectez-vous à votre portail d'assistance, puis sélectionnez Dans un vous êtes pressé ? Déposez une demande d'assistance ici.
  4. Pour la mise à niveau sur un serveur doté d'une connexion Internet: <ph type="x-smartling-placeholder">
      </ph>
    1. Extrayez le fichier de mise à niveau du portail:
      &gt; tar -xvf <tar file&gt;

      Cette extraction de commande crée un répertoire appelé DeveloperServices-4.x.y.z.
    2. Modification de DeveloperServices-4.x.y.z. .
    3. Téléchargez la dernière version de Drupal à l'aide de la commande suivante:
      &gt; drush dl drupal

      Cette commande crée un répertoire nommé drupal-x.y, où x.y correspond au répertoire actuel de Drupal.
    4. Exécutez le script networked-update.sh:
      &gt; ./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 que un administrateur.
    5. Pour recevoir des notifications de mises à jour Drupal, assurez-vous que le gestionnaire des mises à jour Drupal est activé. Dans le menu Drupal, sélectionnez Modules et faites défiler vers le bas jusqu'à le module Gestionnaire de mises à jour. Si ce n'est pas le cas, activez-la.

      Une fois les mises à jour disponibles, vous pouvez les consulter en cliquant sur Rapports > Disponible Éléments de menu "Mises à jour".

      Utilisez le menu Rapports > Mises à jour disponibles > Élément de menu "Paramètres" pour configurez le module de sorte qu'il vous envoie un e-mail lorsque des mises à jour sont disponibles et que vous définissez la fréquence recherchant des mises à jour.
  5. Pour une mise à niveau sur un serveur sans connexion Internet: <ph type="x-smartling-placeholder">
      </ph>
    1. 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:
      &gt; tar -xvf <tar file&gt;

      Cette extraction de commande crée un nouveau répertoire appelé DeveloperServices-4.x.y.z.
    2. Modification de DeveloperServices-4.x.y.z. .
    3. Exécutez le script non-networked-update.sh:
      &gt; ./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 que un administrateur.

      Cette commande télécharge tous les fichiers de mise à jour nécessaires et les empaquette en un seul fichier nommé devportal-update.tgz et écrit le fichier à l'emplacement de votre choix.
    4. Copiez devportal-update.tgz sur la cible celui qui exécute le portail.
      Remarque: Ne copiez pas le fichier devportal-update.tgz dans la racine Web du le serveur cible.
    5. Décompressez le fichier devportal-update.tgz dans le fichier répertoire actuel:
      &gt; 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:
      &gt; ./install-update.sh
    8. Répondez aux invites.

La mise à niveau est maintenant terminée.

Mettre à niveau un portail à l'aide de RPM

Procédez comme suit pour mettre à jour le RPM du portail sur un nœud:

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

    où:
      .
    • dbname spécifie Nom de la base de données, tel que spécifié par la propriété PG_NAME dans le portail fichier de configuration d'installation.
    • host spécifie l'adresse IP adresse 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 Propriété DRUPAL_PG_USER dans 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 restaurer à 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. Emplacement d'installation par défaut est /opt/apigee/apigee-drupal mais vous l'avez peut-être modifiée.

    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).
  4. Effectuez une sauvegarde des fichiers dans /opt/apigee/data/apigee-drupal-devportal/private.
  5. Désactivez SELinux comme décrit dans la section Installer l'utilitaire de configuration Edge Apigee.
  6. Pour la mise à niveau sur un serveur doté d'une connexion Internet: <ph type="x-smartling-placeholder">
      </ph>
    1. Téléchargez le fichier bootstrap_4.17.05.sh Edge 4.17.05 pour /tmp/bootstrap_4.17.05.sh:
      &gt; curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Installez l'utilitaire Edge 4.17.05 apigee-service et dépendances:
      &gt; sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez reçus 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.
  7. Pour une mise à niveau sur un serveur sans connexion Internet: <ph type="x-smartling-placeholder">
      </ph>
    1. Créez un dépôt 4.17.05 local comme décrit dans la section "Créer un dépôt Apigee local". à Installer Edge apigee-setup utilitaire.
      Remarque: Si vous disposez déjà d'un dépôt 4.17.01, vous pouvez ajouter le fichier 4.17.05, comme décrit dans la section "Mettre à jour un dépôt Apigee local" dans Installez l'utilitaire de configuration Edge apigee.
    2. Pour installer apigee-service à partir d'un fichier .tar: <ph type="x-smartling-placeholder">
        </ph>
      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.17.05.tar.gz:
        &gt; /opt/apigee/apigee-service/bin/apigee-service package apigee-mirror
      2. Copiez le fichier .tar sur le nœud où vous souhaitez mettre à jour Edge. Par exemple, copiez-le dans le répertoire /tmp. sur le nouveau nœud.
      3. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
        &gt; tar -xzf apigee-4.17.05.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 dépendances de /tmp/repos:
        &gt; sudo bash /tmp/repos/bootstrap_4.17.05.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">
        </ph>
      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.17.05.sh pour /tmp/bootstrap_4.17.05.sh:
        &gt; /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis ci-dessus du dépôt, et remoteRepo est l'adresse IP ou le nom DNS le nœud du dépôt.
      3. Sur le nœud distant, installez l'utilitaire Edge apigee-service et dépendances:
        &gt; sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        où uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.
  8. Utilisez apigee-service pour mettez à jour apigee-setup utilitaire:
    &gt; /opt/apigee/apigee-service/bin/apigee-service mise à jour de apigee-setup
  9. Exécutez l'utilitaire de mise à jour sur votre nœud pour mettre à jour la base de données Postgres:
    &gt; /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.
  10. Démarrez Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service démarrage apigee-postgresql
  11. Exécutez l'utilitaire de mise à jour sur votre nœud pour mettre à jour le portail:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    où configFile correspond au fichier de configuration que vous avez utilisé pour installer le portail. La seule condition requise concernant le fichier de configuration est que le fichier de configuration doit être accessible ou lisible par l'"apigee" utilisateur.

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

/opt/apigee/apigee-drupal/wwwroot

La mise à niveau est maintenant terminée.