Configurazione di un nodo di integrazione modificando il file node.conf.yaml

È possibile configurare un nodo di integrazione impostando le proprietà nel file di configurazione node.conf.yaml per il nodo di integrazione.

Prima di iniziare

Eseguire le attività qui riportate:

Assicurarsi che l'ID utente abbia le autorizzazioni corrette per eseguire l'attività; consultare Requisiti di sicurezza per le attività amministrative.
Creare un nodo di integrazione.

Informazioni su questa attività

Quando si crea un nodo di integrazione, un file di configurazione node.conf.yaml predefinito viene creato automaticamente per il nodo di integrazione e memorizzato nella directory di lavoro per il nodo di integrazione; ad esempio: C:\ProgramData\IBM\MQSI\components\acev11node\node.conf.yaml. È quindi possibile configurare l'operazione del nodo di integrazione e delle risorse associate, modificando le proprietà nel file node.conf.yaml . Ad esempio, è possibile impostare una porta di amministrazione REST e una porta HTTPS , abilitare la sicurezza di gestione ed è possibile configurare il livello di traccia, la registrazione attività, la JVM e la creazione di report di statistiche e dati di account.

Quando si crea un nodo di integrazione, viene creata anche una sottodirectory sovrastante sotto la directory di lavoro del nodo di integrazione. Questa directory di sovrascritture contiene un ulteriore file di configurazione node.conf.yaml , che contiene i valori delle proprietà impostati dai comandi IBM App Connect Enterprise , incluso il comando mqsicreatebroker . Questi valori sovrascrivono i valori impostati per le stesse proprietà nel file node.conf.yaml di base del nodo di integrazione.

Quando vengono eseguiti comandi che modificano le impostazioni per il nodo di integrazione, queste impostazioni modificate vengono salvate in un file node.conf.yaml nella directory di sovrascritture (ad esempio, C:\ProgramData\IBM\MQSI\components\acev11node\overrides\node.conf.yaml).

Se una proprietà è stata impostata nel file node.conf.yaml di base del nodo di integrazione e anche nella directory di sovrascritture (\overrides\node.conf.yaml), viene utilizzato il valore della proprietà impostato nella directory di sovrascritture. Pertanto, se un nodo di integrazione non sembra utilizzare le impostazioni previste, verificare il file node.conf.yaml nella directory overrides per verificare se il valore della proprietà previsto è stato sovrascritto da un comando. Se si desidera sovrascrivere manualmente le impostazioni risultanti da un comando, è possibile modificare la proprietà nel file node.conf.yaml nella directory overrides oppure rimuovere la voce dalla directory overrides e modificare il file node.conf.yaml di base.

Quando si creano server di integrazione di proprietà del nodo di integrazione, viene creato un file di configurazione server.conf.yaml predefinito per ciascuno dei server di integrazione e vengono memorizzati nel file system nelle sottodirectory sotto la directory del nodo di integrazione. Tutte le proprietà impostate per il nodo di integrazione, nel file node.conf.yaml , vengono ereditate dai server di integrazione di cui è proprietario. Tuttavia, è possibile modificare qualsiasi proprietà del server di integrazione modificandole nel file server.conf.yaml appropriato. Per ulteriori informazioni relative alla configurazione dei server di integrazione gestiti da un nodo di integrazione, consultare Configurazione di un server di integrazione modificando il file server.conf.yaml.

Procedura

Modificare le proprietà di un nodo di integrazione, seguendo questi passaggi:

Utilizzare un editor YAML per aprire il file node.conf.yaml per il nodo di integrazione che si desidera modificare.
Se non si ha accesso ad un editor YAML, è possibile modificare il file utilizzando un editor di testo semplice; tuttavia, è necessario assicurarsi di non includere alcun carattere di scheda, che non siano accettati in YAML e causerà la mancata riuscita della configurazione del nodo di integrazione. Se si sceglie di utilizzare un editor di testo semplice, assicurarsi di utilizzare uno strumento di validazione YAML per convalidare il contenuto del proprio file.

Per ulteriori informazioni sull'utilizzo di YAML, vedi http://www.yaml.org/start.html.
Modificare le proprietà che si desidera modificare:
1. Impostare la porta API REST di amministrazione per l'interfaccia utente web App Connect Enterprise e il toolkit App Connect Enterprise , impostando un valore per la proprietà port . È possibile lasciare questa proprietà impostata sul valore predefinito di 4414.
2. Specificare un valore per la proprietà host .
3. Abilita autenticazione per il nodo di integrazione, impostando la proprietà basicAuth su true:
```
basicAuth: true
```
4. Abilitare la sicurezza di amministrazione e specificare una modalità di autorizzazione, impostando le proprietà adminSecurity e authMode .
  Ad esempio:
```
adminSecurity: active 
authMode: file 
```
5. Si possono anche modificare le proprietà per abilitare il listener del nodo di integrazione, per configurare il server MQTT e per specificare un gestore code predefinito.
Specificare le credenziali di protezione che il nodo di integrazione deve utilizzare quando si connette a una risorsa protetta (ad esempio un database) utilizzando il comando mqsisetdbparms . Quando si esegue questo comando, l'ID utente e la password vengono memorizzati in modo sicuro nell'archivio delle credenziali IBM App Connect Enterprise . Per ulteriori informazioni sull'utilizzo di questo comando, consultare Comando mqsisetdbparms.
Riavviare il nodo di integrazione.
Le proprietà impostate nel file node.conf.yaml diventano effettive quando viene avviato il nodo di integrazione. Se si modificano di nuovo queste proprietà, è necessario avviare nuovamente il nodo di integrazione per le ultime modifiche ad effetto. Per ulteriori informazioni, consultare Avvio e arresto di un nodo di integrazione.