Installazione di Edge Microgateway

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Edge Microgateway versione 2.3.x

Pubblico

Utilizza questa guida se devi installare o disinstallare Edge Microgateway.

Prerequisiti

  • È necessario che nel sistema sia installato Node.js versione 4.5 LTS o successiva. Consulta le istruzioni aggiuntive per Node.js riportate di seguito.
  • Windows richiede l'installazione e l'aggiunta di OpenSSL al PATH.
  • Se utilizzi il cloud privato di Apigee Edge per eseguire la configurazione con Edge Microgateway, devi avere che esegue Private Cloud 4.15.07 o versioni successive.

Installazione di Node.js

È necessario che sul sistema sia installato Node.js versione 4.5 o successiva. Tu puoi eseguire questa operazione:

node -v

Esistono molti modi per ottenere o aggiornare Node.js. Ad esempio, puoi utilizzare HomeBrew, yum o scaricalo direttamente dal sito Node.js: https://nodejs.org/download.

Installazione di Edge Microgateway se disponi di una connessione a internet

Questa sezione spiega come installare Edge Microgateway e inizializzare un oggetto predefinito configurazione.

  1. Installa la versione più recente di Edge Microgateway con npm utilizzando il seguente comando. Questo comando installa il software l'eseguibile edgemicro nel percorso. Per scoprire esattamente dove si trova il seguente comando installa Edge Microgateway; consulta Where is Edge Microgateway installato?
    npm install edgemicro -g

    Per installare una versione specifica di Edge Microgateway, devi specificare il version number nel comando di installazione. Se non specifichi il numero di versione, verrà installata la versione più recente. Ad esempio, per installare versione 2.3.1, utilizzare il seguente comando.

    npm install edgemicro@2.3.1 -g
  2. Controlla il numero di versione. Ad esempio, se hai installato la versione 2.3.5:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
  3. Esegui questo comando per creare un file di configurazione predefinito nella tua directory home.
    edgemicro init
  4. (Facoltativo) Nella tua casa è stato inserito un file di configurazione denominato default.yaml in una sottodirectory chiamata .edgemicro. Verifica ora che questo file esiste:
    ls ~/.edgemicro
    default.yaml

    Nota: nella documentazione di Edge Microgateway, facciamo riferimento alla home directory con la tilde (~), una scorciatoia UNIX. Su Windows, se invece sono in esecuzione una shell che non supporta la tilde, dovrai sostituire il valore variabile di ambiente per la tilde nei comandi che fanno riferimento alla home directory. Per esempio: %USERPROFILE%/.edgemicro.

  5. Segui i passaggi descritti in Installazione di Edge Microgateway.

Utilizzo di Edge Microgateway su Windows come Servizio

Puoi utilizzare Edge Microgateway su Windows come servizio. Per maggiori dettagli, vedi Best practice per la gestione operativa di Microgateway (edgemicro) su Windows sul Community Apigee

Posso installare Edge Microgateway senza una connessione a internet?

Sui siti che non hanno un accesso a internet pronto, l'amministratore può installare e gestire un registro npm privato sulla tua rete interna. Le istruzioni per configurare un registro npm privato sono: che esulano dall'ambito di questa guida; ma puoi cercare e trovare istruzioni utili. Con un registro npm privato installato, puoi seguire le istruzioni di installazione fornite in alto.

Per iniziare

Se non hai mai utilizzato Edge Microgateway, il riquadro Installazione di Edge Microgateway è il punto di partenza migliore dopo aver completato l'installazione. Configurazione e la guida alla configurazione illustra tutti i passaggi da eseguire per installare, configurare, avviare e utilizzare un'istanza di Edge Microgateway.

Dove Edge Microgateway è installato?

Quando utilizzi npm con l'opzione globale (npm install -g edgemicro), il software è installato in [prefix]/lib/node_modules/edgemicro. Puoi trovare valore di [prefix] con questo comando:

npm config get prefix

Il valore di [prefix] è configurabile. Per ulteriori informazioni, vedi npm-folders.

Disinstallazione di Edge Microgateway

Se devi rimuovere Edge Microgateway:

  1. Elimina o archivia la directory di installazione. [prefix]/lib/node_modules/edgemicro, dove [prefisso] è il numero npm come spiegato in Dove è installato Edge Microgateway?
  2. Elimina o archivia i file di log. Per impostazione predefinita, edgemicro-*.log i file si trovano in /var/tmp/, ma questa posizione è configurabile. Controllo di configurazione in caso di dubbi, come spiegato in "Gestione di log."
  3. Elimina o archivia la configurazione di runtime e i file di configurazione della cache:
    ~/.edgemicro/*.yaml