Configurazione di un server di integrazione modificando il file server.conf.yaml

È possibile configurare il server di integrazione IBM® App Connect Enterprise modificando le proprietà in un file di configurazione server.conf.yaml . L'ubicazione del file server.conf.yaml che è necessario modificare dipende dal fatto che si stia configurando un server di integrazione indipendente o un server di integrazione gestito da un nodo di integrazione.

Prima di iniziare

Assicurarsi di impostare l'ambiente di comando, come descritto in Impostazione di un ambiente di comando.

Informazioni su questa attività

Una volta creato un server di integrazione, è possibile impostare le proprietà nel file server.conf.yaml per configurare il funzionamento del server di integrazione e le risorse associate. Ad esempio, è possibile impostare una porta di amministrazione REST e una porta HTTPS. È anche possibile configurare il livello di traccia, la registrazione delle attività, la JVM e la segnalazione dei dati statistici per il proprio server di integrazione.

Per un server di integrazione indipendente, il file di configurazione server.conf.yaml viene creato automaticamente quando si utilizza il comando mqsicreateworkdir per creare una directory di lavoro del server di integrazione. Il file server.conf.yaml viene creato nella root della directory di lavoro specificata: <work directory>/server.conf.yaml.

Se si utilizzano qualsiasi comando che modificasse il server di integrazione, viene creata una directory overrides sotto la directory di lavoro per il server di integrazione. Questa directory di sovrascrittura contiene un ulteriore file di configurazione server.conf.yaml , che contiene i valori delle proprietà impostati dai comandi; ad esempio, <work directory>/overrides/server.conf.yaml. I valori delle proprietà in questo file overrides/server.conf.yaml sovrascrivono i valori impostati nel file server.conf.yaml del server di integrazione (<work directory>/server.conf.yaml).

Se una proprietà è stata impostata nel file server.conf.yaml del server di integrazione e anche nella directory di sovrascritture (/overrides/server.conf.yaml), viene utilizzato il valore della proprietà impostato nella directory di sovrascritture. Pertanto, se un server di integrazione non sembra utilizzare le impostazioni previste, controllare il file server.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 server.conf.yaml nella directory overrides oppure rimuovere la voce dalla directory overrides e modificare il file server.conf.yaml di base.

Per server di integrazione gestiti da un nodo di integrazione, ogni server ha il proprio server.conf.yaml file di configurazione che sovrascrive impostazioni comuni dal file di configurazione node.conf.yaml del nodo di integrazione. Quando si crea un nodo di integrazione, il file node.conf.yaml si trova in: $MQSI_WORKPATH/components/<Node name>/node.conf.yaml.

Se si utilizzano i comandi per modificare il nodo di integrazione, le modifiche vengono salvate nel file node.conf.yaml di sovrascrittura dei nodi di integrazione. Questo file si trova in: $MQSI_WORKPATH/components/<Node name>/overrides/node.conf.yaml, come descritto in Creazione di un nodo di integrazione utilizzando la riga di comando. Quando si crea un server di integrazione gestito per un nodo di integrazione, le impostazioni specifiche del server vengono create per esso nel relativo file server.conf.yaml . Il file specifico del server si trova in: $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/server.conf.yaml.

Se si utilizzano i comandi per modificare questo server di integrazione, le modifiche vengono salvate in: $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/overrides/server.conf.yaml. I valori delle proprietà in questo file overrides/server.conf.yaml sovrascrivono i valori impostati nel file <Node name>/servers/<Server name>/server.conf.yaml .

Procedura

Se il server di integrazione non esiste già, è possibile crearlo seguendo le istruzioni in Creazione di un server di integrazione.
Utilizzare un editor YAM per aprire il file server.conf.yaml .
Se non si dispone di 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 provocherebbero la mancata riuscita della configurazione del server 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 e quindi salvare il file.
Ad esempio:
- Nella sezione Listener RestAdmin, impostare un valore per la proprietà Port che deve essere utilizzata dalla porta di amministrazione REST, che è il metodo primario di comunicazione con il server di integrazione. (Valore predefinito di 7600.)
- Nella sezione ResourceManagers / HTTPConnector, impostare un valore per ListenerPort in modo che sia possibile inviare messaggi a un flusso che utilizza un nodo HTTPInput . (valore predefinito di 7800.)
- Nella sezione ResourceManagers / JVM, impostare un valore per jvmDebugPort in modo da poter utilizzare il programma di debug del flusso. Ad esempio, impostare questa proprietà su 6511.
Se si eseguono comandi che modificano il server di integrazione in qualsiasi momento dopo aver impostato le proprietà nel file server.conf.yaml , viene creata una directory di sovrascritture nella directory di lavoro per il server di integrazione. Questa directory di sovrascrittura contiene un altro file di configurazione server.conf.yaml , che contiene i valori delle proprietà impostati dai comandi; ad esempio, <work directory>/overrides/server.conf.yaml. I valori delle proprietà in questo file overrides/server.conf.yaml sovrascrivono i valori impostati nel file server.conf.yaml del server di integrazione (<work directory>/server.conf.yaml). Se si desidera sovrascrivere manualmente le impostazioni risultanti da un comando, è possibile modificare la proprietà nel file server.conf.yaml nella directory overrides oppure rimuovere la voce dalla directory overrides e modificare il file server.conf.yaml di base.
Specificare le credenziali di sicurezza da utilizzare dal server di integrazione quando ci si collega ad una risorsa protetta (come ad esempio un database).
- È possibile configurare un server di integrazione indipendente per connettersi alle risorse protette utilizzando le credenziali che vengono memorizzate in forma crittografata in un vault App Connect Enterprise . È possibile configurare le credenziali di sicurezza utilizzando il comando mqsicredentials o l'API REST di gestione. Specificare la directory di lavoro del server di integrazione creato al passo 1. Le credenziali crittografate sono memorizzate nel vault del server di integrazione, che si configura utilizzando il comando mqsivault. Per ulteriori informazioni, consultare Configurazione delle credenziali di sicurezza crittografate. Ad esempio, per creare il vault del server delle integrazioni:
```
mqsivault --work-dir c:\myaceworkdir --vault-key vaultKey --create
```
  Per configurare le credenziali di sicurezza:
```
mqsicredentials --work-dir c:\myaceworkdir --vault-key vaultkey --create --credential-type jdbc --credential-name secID --username iibuser --password password
```
- In alternativa, è possibile utilizzare il comando mqsisetdbparms . Utilizzare il parametro -w per specificare la directory di lavoro del server di integrazione creata al passo 1. Ad esempio:
```
mqsisetdbparms -w c:\myaceworkdir -n jdbc::secID -u iibuser -p password
```
  Quando si esegue questo comando, l'ID utente e la password vengono memorizzati in modo sicuro nel negozio di credenziali IBM App Connect Enterprise . Per ulteriori informazioni sull'utilizzo del comando mqsisetdbparms , consultare Comando mqsisetdbparms.
Facoltativo: è possibile configurare le applicazioni da eseguire all'avvio del server di integrazione, precaricando il file BAR nella cartella run della directory di lavoro del server di integrazione. Per informazioni, consultare Comando mqsibar.
Riavviare il server di integrazione. Le proprietà impostate nel file server.conf.yaml diventano effettive quando viene avviato il server di integrazione. Se si modificano di nuovo queste proprietà, è necessario avviare nuovamente il server di integrazione per le successive modifiche di effetto. Per ulteriori informazioni, consultare Avvio di un server di integrazione.

Se il server di integrazione non riesce a riavviare, verificare se il guasto è stato causato da un errore di parsing di YAML. Per un server di integrazione indipendente, gli errori di analisi vengono riportati nel log stderr . Per il server di integrazione gestito da un nodo di integrazione, gli errori di analisi YAML sono riportati nel file console.txt del server di integrazione. Per ulteriori informazioni, consultare Log di sistema standard.