Installazione di Edge Microgateway

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Microgateway Edge v. 2.3.x

Pubblico

Utilizza questa guida se devi installare o disinstallare Edge Microgateway.

Prerequisiti

  • Devi avere installato sul sistema la versione Node.js 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 Apigee Edge per la configurazione con Edge Microgateway, devi eseguire il cloud privato versione 4.15.07 o successiva.

Installazione di Node.js

Sul sistema deve essere installato Node.js 4.5 o versioni successive. Puoi verificarlo eseguendo:

node -v

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

Installazione di Edge Microgateway se è disponibile una connessione a internet

Questa sezione spiega come installare Edge Microgateway e inizializzare una configurazione predefinita.

  1. Installa la versione più recente di Edge Microgateway con npm utilizzando il comando seguente. Questo comando installa il software e inserisce l'eseguibile edgemicro nel tuo percorso. Per scoprire esattamente dove viene installato Edge Microgateway il seguente comando, vedi Dove è installato Edge Microgateway?.
    npm install edgemicro -g
    

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

    npm install edgemicro@2.3.1 -g
    
  2. Controlla il numero della 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) Un file di configurazione denominato file default.yaml è stato inserito nella home directory in una sottodirectory denominata .edgemicro. Verifica ora che questo file esista:
    ls ~/.edgemicro
    default.yaml
    

    Nota: nei documenti di Edge Microgateway, facciamo riferimento alla home directory con la tilde (~), che è una scorciatoia UNIX. Se usi Windows, se esegui una shell che non supporta la tilde, dovrai sostituire la variabile di ambiente appropriata per la tilde nei comandi che fanno riferimento alla home directory. Ad esempio: %USERPROFILE%/.edgemicro.

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

Operating Edge Microgateway su Windows as a Service

Puoi utilizzare Edge Microgateway su Windows as a Service. Per maggiori dettagli, consulta le best practice per la gestione operativa di Microgateway (edgemicro) su Windows nella community Apigee.

Posso installare Edge Microgateway senza una connessione a internet?

Sui siti che non dispongono di un accesso a internet pronto, un amministratore può installare e gestire un registro npm privato sulla tua rete interna. Le istruzioni per configurare un registro npm privato non rientrano nell'ambito di questa guida; tuttavia, puoi cercare e trovare istruzioni utili. Con un registro npm privato installato, puoi seguire le istruzioni di installazione fornite sopra.

Come iniziare

Se è la prima volta che utilizzi Edge Microgateway, l'Installazione di Edge Microgateway è il punto di partenza ideale dopo aver completato l'installazione. La guida alla configurazione e alla configurazione illustra tutti i passaggi da eseguire per installare, configurare, avviare e utilizzare un'istanza di Edge Microgateway.

Dove è installato Edge Microgateway?

Quando utilizzi npm con l'opzione globale (npm install -g edgemicro), il software viene installato in [prefix]/lib/node_modules/edgemicro. Puoi trovare il 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 [prefix] è il prefisso npm, come spiegato in Dove è installato Edge Microgateway?
  2. Elimina o archivia i file di log. Per impostazione predefinita, i file edgemicro-*.log sono in /var/tmp/, ma questa posizione è configurabile. In caso di dubbi, controlla il file di configurazione, come spiegato nella sezione "Gestione dei file di log".
  3. Elimina o archivia i file di configurazione della cache e della configurazione di runtime:
    ~/.edgemicro/*.yaml