Installer Edge Microgateway

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**.
info

Edge Microgateway v. 2.4.x

Audience

Consultez ce guide si vous devez installer ou désinstaller Edge Microgateway.

Prérequis

  • Vous devez disposer de Node.js version 4.5 LTS ou ultérieure installé sur votre système. Consultez les instructions supplémentaires concernant Node.js ci-dessous.
  • Windows nécessite l'installation de OpenSSL et son ajout au PATH.
  • Si vous utilisez Apigee Edge Private Cloud pour configurer Edge Microgateway, vous devez être exécuter la version 4.16.01 ou une version ultérieure de Private Cloud.

Installer Node.js

Vous devez disposer de Node.js version 4.5 ou ultérieure installé sur votre système. Vous pouvez le vérifier en exécutant la commande suivante :

node -v

Il existe de nombreuses façons d'obtenir ou de mettre à jour Node.js. Par exemple, vous pouvez utiliser HomeBrew, yum ou le télécharger directement depuis le site Node.js : https://nodejs.org/download.

Installer Edge Microgateway si vous disposez d'une connexion Internet

Cette section explique comment installer Edge Microgateway et initialiser une configuration par défaut.

  1. Installez la dernière version d'Edge Microgateway avec npm à l'aide de la commande suivante. Cette commande installe le logiciel et place l'exécutable edgemicro dans votre chemin d'accès. Consultez également la section Où Edge Microgateway est-il installé ?.
    npm install edgemicro -g

    Pour installer une version spécifique d'Edge Microgateway, vous devez spécifier le numéro de version dans la commande d'installation. Si vous ne spécifiez pas le numéro de version, la dernière version sera installée. Par exemple, pour installer la version 2.3.1, utilisez la commande suivante.

    npm install edgemicro@2.3.1 -g
  2. Vérifiez le numéro de version. Par exemple, si vous avez installé la version 2.3.5 :
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. Exécutez cette commande pour créer un fichier de configuration par défaut dans votre répertoire d'accueil.
    edgemicro init
  4. (Facultatif) Un fichier de configuration nommé default.yaml a été placé dans votre répertoire d'accueil dans un sous-répertoire nommé .edgemicro. Vérifiez maintenant que ce fichier existe :
    ls ~/.edgemicro
    default.yaml

    Remarque : Dans la documentation Edge Microgateway, nous faisons référence au répertoire d'accueil avec le tilde (~), qui est un raccourci UNIX. Si vous utilisez Windows et que vous exécutez un shell qui ne prend pas en charge le tilde, vous devrez remplacer la variable d'environnement appropriée par le tilde dans les commandes qui font référence au répertoire d'accueil. Par exemple : %USERPROFILE%/.edgemicro.

  5. Suivez les étapes décrites dans Configurer Edge Microgateway.

Exécuter Edge Microgateway sur Windows en tant que service

Vous pouvez exécuter Edge Microgateway sur Windows en tant que service. Pour en savoir plus, consultez les bonnes pratiques pour la gestion opérationnelle de Microgateway (edgemicro) sur Windows dans la communauté Apigee.

Puis-je installer Edge Microgateway sans connexion Internet ?

Sur les sites qui ne disposent pas d'un accès Internet prêt à l'emploi, un administrateur peut installer et gérer un registre npm privésur votre réseau interne. Les instructions de configuration d'un registre npm privé ne sont pas abordées dans ce guide. Toutefois, vous pouvez rechercher et trouver des instructions utiles. Une fois le registre npm privé installé, vous pouvez suivre les instructions d'installation ci-dessus.

Premiers pas

Si vous débutez avec Edge Microgateway, la section Configurer Edge Microgateway est le meilleur point de départ une fois l'installation terminée. Le guide de configuration couvre toutes les étapes à suivre pour installer, configurer, démarrer et utiliser une instance d'Edge Microgateway.

Où Edge Microgateway est-il installé ?

Lorsque vous utilisez npm avec l'option globale (npm install -g edgemicro), le logiciel est installé dans [prefix]/lib/node_modules/edgemicro. Vous pouvez trouver la valeur de [prefix] avec la commande suivante :

npm config get prefix

La valeur de [prefix] est configurable. Pour en savoir plus, consultez la section npm-folders.

Désinstaller Edge Microgateway

Si vous devez supprimer Edge Microgateway :

  1. Supprimez ou archivez le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [prefix] est le préfixe npm, comme expliqué dans Où Edge Microgateway est-il installé ?
  2. Supprimez ou archivez les fichiers journaux. Par défaut, edgemicro-*.log fichiers se trouvent dans /var/tmp/, mais cet emplacement est configurable. En cas de doute, consultez le fichier de configuration, comme expliqué dans la section "Gérer les fichiers journaux."
  3. Supprimez ou archivez les fichiers de configuration d'exécution et de configuration du cache :
    ~/.edgemicro/*.yaml