Cette page a été traduite par l'API Cloud Translation.

Installer Edge Microgateway

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Edge Microgateway version 2.3.x

Audience

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

Conditions préalables

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

Installer Node.js

Node.js 4.5 ou version ultérieure doit être 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 ou yum, ou les télécharger directement à partir du 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.

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 le chemin d'accès. Pour savoir exactement où la commande suivante installe Edge Microgateway, consultez la section Où Edge Microgateway est-elle installée ?.
```
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
```

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

Exécutez cette commande pour créer un fichier de configuration par défaut dans votre répertoire d'accueil.
```
edgemicro init
```
(Facultatif) Un fichier de configuration nommé default.yaml a été placé dans votre répertoire d'accueil, 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 et exécutez une interface système qui n'est pas compatible avec le tilde, vous devez remplacer ce dernier par la variable d'environnement appropriée dans les commandes qui font référence au répertoire d'accueil. Exemple: %USERPROFILE%/.edgemicro.
Suivez la procédure décrite dans Installer Edge Microgateway.

Operating Edge Microgateway sur Windows en tant que service

Vous pouvez utiliser Edge Microgateway sous Windows en tant que service. Pour en savoir plus, consultez les bonnes pratiques pour la gestion opérationnelle de Microgateway (edgemicro) sous 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, un administrateur peut installer et gérer un registre npm privé sur votre réseau interne. Les instructions pour configurer un registre npm privé sortent du cadre de ce guide. Toutefois, vous pouvez rechercher et trouver des instructions utiles. Avec un registre npm privé installé, vous pouvez suivre les instructions d'installation ci-dessus.

Premiers pas

Si vous débutez avec Edge Microgateway, l'étape Installer Edge Microgateway est le meilleur point de départ une fois l'installation terminée. Le guide de configuration et d'installation décrit 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 obtenir la valeur de [prefix] à l'aide de 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 retirer Edge Microgateway:

Supprimez ou archivez le répertoire d'installation [prefix]/lib/node_modules/edgemicro, où [prefix] correspond au préfixe npm, comme expliqué dans la section Où Edge Microgateway est-elle installée ?
Supprimez ou archivez les fichiers journaux. Par défaut, les fichiers edgemicro-*.log se trouvent dans /var/tmp/, mais cet emplacement peut être configuré. En cas de doute, vérifiez le fichier de configuration, comme expliqué dans la section Gérer les fichiers journaux.
Supprimez ou archivez les fichiers de configuration d'exécution et de mise en cache :
```
~/.edgemicro/*.yaml
```