Installer Edge Microgateway

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Edge Microgateway version 2.3.x

Audience

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

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

Prérequis

  • Node.js 4.5 LTS ou une version ultérieure doit être installé sur votre système. Voir les instructions Node.js supplémentaires ci-dessous.
  • Windows nécessite l'installation et l'ajout d'OpenSSL. vers PATH.
  • Si vous utilisez le cloud privé Apigee Edge pour effectuer une configuration avec Edge Microgateway, vous devez être exécutant Private Cloud version 4.15.07 ou ultérieure.

Installer Node.js

Node.js doit être installé sur votre système (version 4.5 ou ultérieure). Toi pouvez 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 téléchargez-la directement à partir du site Node.js: https://nodejs.org/download.

Installez Edge Microgateway si tu as une connexion Internet

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

  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. Pour savoir exactement où la commande suivante installe Edge Microgateway, consultez la section Où se trouve Edge Microgateway installée ? 
    npm install edgemicro -g

    Pour installer une version spécifique d'Edge Microgateway, vous devez spécifier le version number 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 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 maison dans un sous-répertoire appelé .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, si vous exécutez un shell qui n'est pas compatible avec le tilde, vous devrez remplacer le paramètre variable d'environnement pour le tilde dans les commandes qui font référence au répertoire personnel. Pour Exemple: %USERPROFILE%/.edgemicro.

  5. Suivez les étapes décrites dans la section Installer Edge Microgateway :

L'utilisation d'Edge Microgateway sous Windows Service

Vous pouvez utiliser Edge Microgateway sous Windows en tant que service. Pour plus d'informations, voir Bonnes pratiques de gestion opérationnelle de Microgateway (edgemicro) sous Windows sur le Communauté Apigee.

Puis-je installer Edge Microgateway sans connexion Internet ?

Sur les sites qui ne disposent pas d'un accès à Internet, un administrateur peut installer et gérer un registre npm privé ; sur votre réseau interne. Pour configurer un registre npm privé, suivez les instructions ci-dessous. n'entrent pas dans le cadre de ce guide. Cependant, vous pouvez rechercher et trouver des instructions utiles. Avec un dans le registre npm privé installé, suivez les instructions fournies ci-dessus.

Premiers pas

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

Emplacement 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 trouverez la valeur de [prefix] par la commande suivante:

npm config get prefix

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

Désinstaller Edge Microgateway

Si vous devez supprimer Edge Microgateway:

  1. Supprimer ou archiver le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [préfixe] correspond à npm comme expliqué dans la section 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 peut être configuré. Chèque fichier de configuration en cas de doute, comme expliqué dans la section "Gestion fichiers journaux."
  3. Supprimez ou archivez les fichiers de configuration de l'environnement d'exécution et de mise en cache: 
    ~/.edgemicro/*.yaml