Installazione e configurazione WebSphere MQ

WebSphere MQ è il software di messaggistica che consente le comunicazioni tra InterChange Server e gli adattatori. InterChange Server accede al server WebSphere MQ come un client MQI Java o JMS.

Installare WebSphere MQ sulla stessa rete di InterChange Server. Per installare WebSphere MQ, è necessario essere l'amministratore ICS.

E' possibile anche configurare WebSphere MQ in modo da utilizzarlo come provider JMS. Per istruzioni di configurazione specifiche relative a questa opzione, consultare "Configurazione WebSphere MQ per JMS".
HA

Per HA (high availability), installare WebSphere MQ su ciascuna macchina presente nel cluster. Fare riferimento alla documentazione di WebSphere MQ per ulteriori informazioni.

Installazione WebSphere MQ

Le sezioni seguenti descrivono il modo in cui installare WebSphere MQ:

"Aggiornamento WebSphere MQ"

Installazione software WebSphere MQ

Aggiornamento WebSphere MQ

Se si aggiorna WebSphere MQ ed è in esecuzione come servizio Windows, è necessario arrestare il servizio prima di eseguire l'aggiornamento alla versione nuova o prima di applicare una patch all'installazione. se il servizio non viene arrestato, potrebbero essere generate delle serie di errori di WebSphere MQ al riavvio di InterChange Server. Per arrestare WebSphere MQ quando viene eseguito come un servizio, seguire le indicazioni:

  1. Fare clic su Start > Impostazioni > Pannello di controllo quindi fare due volte clic sugli Strumenti di amministrazione.
  2. Fare due volte clic su Servizio. Viene visualizzata la finestra di dialogo Servizi.
  3. Fare clic con il tastino destro del mouse su IBM WebSphere MQ quindi su Arresta.
Nota:
Per verificare la versione di WebSphere MQ contenuta nell'ambiente corrente, immettere mqver al prompt dei comandi.

Fare riferimento alla documentazione WebSphere MQ per le informazioni specifiche sul modo in cui preservare i dati esistenti nelle code durante un aggiornamento.

Installazione software WebSphere MQ

L'IBM distribuisce la versione 5.3.0.2 del software WebSphere MQ su un CD-ROM separato.

  1. Inserire il CD WebSphere MQ 5.3.0.2. (scaricare CSD da: https://www6.software.ibm.com/dl/wsmqcsd/wsmqcsd-p )
  2. Seguire le istruzioni contenute nel Launch Pad d'installazione di WebSphere MQ. Per ulteriori informazioni, consultare

    http://www.ibm.com/software/ts/mqseries/messaging/v53/.

  3. Alla fine dell'esecuzione del Launch Pad, fare clic su Avvia programma di installazione WebSphere MQ.
  4. Dopo i pannelli di Benvenuto e dell'Accordo di licenza, fare clic su Personalizza nel pannello Tipo di impostazione quindi fare clic su Avanti.
  5. Accettare le ubicazioni delle cartelle predefinite per il programma, i file dei dati ed i file di log.
  6. Selezionare la Messaggistica Java nel pannello di selezione Funzioni quindi fare clic su Avanti. Questa funzione installa MQ JCL (Java Client Library).
    Nota:
    Se si pianifica l'installazione di un agente remoto e non si installa il server, è necessario selezionare la funzione Client Windows per fornire i file client necessari.
  7. Fare clic su Installa nel pannello Avvio del programma di installazione di WebSphere MQ.
  8. Fare clic su Fine quando viene visualizzato il pannello di completamento della procedura guidata di installazione.
  9. Fare clic su Annulla quando viene visualizzato il pannello Preparazione procedura guidata WebSphere MQ.
  10. Fare clic su OK quando viene richiesta la conferma di uscita dal programma.
    Nota:
    Una volta completato il processo d'installazione di WebSphere MQ per la prima volta, MQ verrà avviato automaticamente. Prima di installare il fix pack CSD 5, è necessario arrestare MQ facendo clic sull'icona WebSphere MQ nella barra delle applicazioni quindi fare clic su Arresta WebSphere MQ. Se MQ non viene arrestato, il programma di installazione CSD non avrà esito positivo.
  11. Installare CSD 5 fix pack.
  12. Riavviare la macchina.
    Importante:
    Passare a Installazione InterChange Server, System Monitor e software associato. Si tornerà direttamente a questo capitolo per configurare WebSphere MQ una volta completate l'installazione e la configurazione di InterChange Server.

Configurazione code messaggi WebSphere MQ

Le code WebSphere MQ trasferiscono i messaggi dal connettore a InterChange Server. InterChange Server richiede una coda messaggi per ogni connettore attivo. Il file configure_mq.bat crea il gestore code e crea tutte le code specificate nel filecrossworlds_mq.tst. Tali file sono ubicati in \IBM\WebSphereICS\mqseries.

Potrebbe essere necessario modificare la configurazione predefinita delle code messaggi WebSphere MQ per gestire oggetti di dimensioni maggiori o un numero maggiore di messaggi. Queste operazioni potrebbero richiedere la modifica della dimensione del file di log della coda messaggi di WebSphere MQ, delle proprietà delle code messaggi o di entrambi.

Modifica dimensione file di log

Per modificare la dimensione del file di log di una coda messaggi WebSphere MQ, modificare il file configure_mq.bat.

  1. Eseguire una copia del file ProductDir\mqseries\configure_mq.bat. Ridenominare la copia, ad esempio, ibm_mq_orig.bat.
  2. Aprire il file copiato configure_mq.bat. Utilizzare il comando WebSphere MQ crtmqm per impostare i valori relativi alle proprietà, in questo formato:
    crtmqm -lp integer -ls integer -lf integer -q "%QUEUE%"
     

    I parametri sono i seguenti:

    -lp
    Specifica il numero dei file di log principali. Il valore predefinito è 3, il minimo è 2 ed il massimo 62.

    -ls
    Specifica il numero dei file di log secondari da allocare. Il valore predefinito è 2, il minimo 1 ed il massimo 61.

    -lf
    Specifica la dimensione dei file di log nelle unità di4 KB.Il valore predefinito è 1024, con una dimensione log predefinita di 4 MB.

    -q
    Specifica che questo gestore code deve essere il gestore code predefinito. Il nuovo gestore code sostituisce qualsiasi gestore code predefinito esistente.

    Ad esempio, si potrebbe modificare un'istruzione esistentecrtmqm -q "%QUEUE%" nel modo seguente:

    crtmqm -lp 20 -ls 10 -lf 2048 -q "%QUEUE%" 
     

Modifica proprietà coda messaggi

Per modificare la lunghezza massima consentita della coda messaggi, impostare i valori delle proprietà MAXDEPTH, MAXMSGL, AND MAXUMSGS nel file crossworlds_mq.tst come descritto nella procedura seguente:

  1. Passare a ProductDir\mqseries\crossworlds_mq.tst ed eseguire una copia del file crossworlds_mq.tst. Ridenominare la copia. ad esempio, ibm_mq_orig.tst.
  2. Aprire il file crossworlds_mq.tst copiato. Utilizzare il comando WebSphere MQ ALTER per impostare i valori delle proprietà MAXDEPTH o MAXMSGL come descritto nelle sezioniModifica del valore MAXDEPTH e Modifica del valore MAXMSGL di seguito riportate.
  3. Salvare il file, quindi riavviare la macchina.
  4. Configurare nuovamente il gestore MQ facendo clic su Start > Programmi > IBM WebSphere InterChange Server > IBM WebSphere MQ > Configura gestore code.
  5. Passare a Avvio di InterChange Server per la prima volta.

Modifica del valore MAXDEPTH

Le code messaggi di WebSphere MQ per impostazione predefinita sono in grado di contenere fino a 5000. Quando i volumi di traffico sono molto elevati o durante una conversione iniziale del sistema di integrazione aziendale WebSphere, questo valore predefinito potrebbe essere superato, provocando errori ed impedendo ai connettori di inviare i messaggi a ICS. Per evitare tutto ciò, è possibile aumentare il numero massimo di messaggi consentito in una coda ed il numero massimo di messaggi non confermati consentito attraverso tutte le code. I valori preferiti potrebbero variare a seconda delle circostanze specifiche. Ad esempio, Se si esegue una conversione iniziale del sistema di integrazione aziendale WebSphere, si raccomanda di impostare la massima ampiezza di coda di almeno 20,000 messaggi.

Per modificare l'impostazione MAXDEPTH, dopo ogni definizione di coda, aggiungere quanto segue:

ALTER QLOCAL (QUEUENAME) MAXDEPTH (DEPTH DESIRED

Ad esempio:

DEFINE QLOCAL(AP/EMailConnector/Server_Name)
  
 ALTER QLOCAL(AP/EMailConnector/Server_Name) MAXDEPTH(20000)
 

E' inoltre possibile modificare il gestore code in modo da consentire un numero maggiore di messaggi non confermati standard attraverso tutte le code. E' necessario che il numero dei messaggi non confermati consentiti, sia la somma dell'ampiezza messaggi massima (MAXDEPTH) di ogni coda. E' necessario che la memoria utilizzata da InterChange Server non aumenti a meno che non aumenti il numero dei messaggi non confermati.

Per modificare l'impostazione MAXUMSGS, aggiungere la riga seguente:

ALTER QMGR MAXUMSGS (NUMBER)
 

Ad esempio:

ALTER QMGR MAXUMSGS (400000)
 

Modifica del valore MAXMSGL

Modificare questo valore solo se si dispone di oggetti business più ampi del valore predefinito MAXMSG di 4 MB. Per modificare il valore MAXMSGL aggiungere il comando seguente dopo ogni definizione di coda:

ALTER QLOCAL (QUEUENAME) MAXMSGL (Numero massimo di byte consentiti in un messaggio)
 

Passare al passo 3.

Definizione code (solo JMS)

ICS richiede di configurare le code con le proprietà di seguito elencate. Specificare il nome di ciascuna coda come proprietà standard nel file di configurazione del connettore'.

Configurazione code per adattatori

E' possibile configurare le code WebSphere MQ necessarie per l'adattatore utilizzando uno dei metodi seguenti:

Suggerimenti

Per semplificare l'identificazione dell'adattatore con cui è associata una codautilizzare il nome dell'adattatore come prefisso nel nome della coda. Ad esempio denominare l'adattatore per la coda di distribuzione eventi Clariy': ClarifyConnector/deliveryqueue.

Utilizzo dei file batch per configurare le code di WebSphere MQ

WebSphere Business Integration Adapters fornisce i file batch per configurare le code WebSphere MQ necessarie per gli adattatori in distribuzione.

I file seguenti sono ubicati in ProductDir\mqseries:

configure_mq.bat
Eseguire questo file batch per configurare le code WebSphere MQ specificate in crossworlds_mq.tst.

crossworlds_mq.tst
Modificare questo file per specificare le code di WebSphere MQ nel sistema ICS. Questo file viene letto come input da configure_mq.bat.

Il contenuto del file crossworlds_mq.tst è riportato di seguito. E' necessario modificare questo file manualmente. La parte superiore del file contiene le informazioni relative a MQ nativo e la parte inferiore quelle specifiche di JMS. Utilizzare questo file per definire le code necessarie per ogni adattatore che si sta configurando. Modificare il file nel modo seguente:

  1. Nella parte del file di WebSphere MQ nativa, eliminare le seguenti istruzioni:
    DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter)
     DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME)
     

    Queste, infatti, si applicano solo ai sistemi di integrazione aziendale utilizzati da WebSphere InterChange Server.

  2. Per ogni adattatore in distribuzione, creare una serie separata di istruzioni di definizione delle code nella parte JMS del file, utilizzando come maschera le istruzioni che iniziano con DEFINE QLOCAL(AdapterName/AdminInQueue).

***************************************************************/
 *                                                                 */
 *   Define the local queues for all Server/Adapter pairs.         */
 *   For MQ queues, they must have the following definition:       */
 *       Application = DEFINE QLOCAL (AP/AdapterName/ServerName)    */
 *                                                                  */
 *   Example:                                                       */
 *   DEFINE QLOCAL(AP/ClarifyConnector/CrossWorlds)                 */
 *                                                                  */
 *   DEFINE QLOCAL(AP/SAPConnector/CrossWorlds)                     */
 *                                                                  */
 *   If your server is named something different than 'CrossWorlds' */
 *   make sure to change the entries to reflect that.               */
 ********************************************************************/
     DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter)
     DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME)
 ********************************************************************/
 *   For each JMS queue (delivery Transport is JMS), 
 *   default values follow the convention:
 *           AdapterName/QueueName
 ********************************************************************/
     DEFINE QLOCAL(AdapterName/AdminInQueue)
     DEFINE QLOCAL(AdapterName/AdminOutQueue)
     DEFINE QLOCAL(AdapterName/DeliveryQueue)
     DEFINE QLOCAL(AdapterName/RequestQueue)
     DEFINE QLOCAL(AdapterName/ResponseQueue)
     DEFINE QLOCAL(AdapterName/FaultQueue)
     DEFINE QLOCAL(AdapterName/SynchronousRequestQueue)
     DEFINE QLOCAL(AdapterName/SynchronousResponseQueue)
 ********************************************************************/
 *   Define the default CrossWorlds channel type                    */
 ********************************************************************/
     DEFINE CHANNEL(CHANNEL1) CHLTYPE(SVRCONN) TRPTYPE(TCP)
 ********************************************************************/
 *   End of CrossWorlds MQSeries Object Definitions                 */
 ********************************************************************/
 

Utilizzo di WebSphere MQ Explorer per configurare le code di WebSphere MQ

Per informazioni sulla configurazione delle code utilizzando WebSphere MQ Explorer, aprire WebSphere MQ Explorer e fare riferimento alla guida in linea relativa.

Utilizzo dei comandi WebSphere MQ per configurare le code di WebSphere MQ

Per informazioni sulla configurazione delle code utilizzando i comandi di WebSphere MQ, consultare i manuali WebSphere MQ: System Administration Guide e WebSphere MQ: Script (MQSC) Command Reference.

Nota:
Se non è necessario riesaminare la configurazione predefinita delle code messaggi di WebSphere MQ, passare a Configurazione WebSphere MQ per JMS o a Avvio di InterChange Server per la prima volta.Una volta definite le code, non rieseguire il file configure_mq.bat mentre sono in esecuzione ICS ed il gestore code. Ciò potrebbe provocare errori nelle code esistenti.

Configurazione WebSphere MQ

E' necessario configurare un gestore code di WebSphere MQ e WebSphere MQ listener.

Configurazione WebSphere MQ gestore code

E' necessario creare un gestore code la prima volta che viene configurato un sistema InterChange Server. Fare clic su Start > Programmi > IBM WebSphere InterChange Server > IBM WebSphere MQ > Configura gestore code.

Un gestore code predefinito viene creato e denominato durante l'installazione.

Aggiunta di un listener al servizio di WebSphere MQ

Dopo aver creato un gestore code, è necessario aggiungere il listener WebSphere MQ come servizio Windows e configurarlo per l'avvio automatico:

  1. Fare clic su Start > Programmi > IBM WebSphere MQ > WebSphere MQ Explorer per avviare WebSphere MQ Explorer.
  2. Nel pannello di sinistra di WebSphere MQ Explorer, selezionare la cartella dei gestori code con il nome del gestore code. Lo stato del gestore code nel pannello di destra dovrebbe mostrare lo stato del gestore code come In esecuzione. In caso contrario, fare clic sul nome del gestore code quindi selezionare Start dall'elenco a discesa. E' necessario modificare lo stato del gestore code In esecuzione.
  3. Aprire i servizi WebSphere MQ facendo clic con il tastino destro del mouse sul nome del gestore code nel pannello di destra quindi selezionare Tutte le attività> Servizi dall'elenco a discesa.
  4. Nella struttura ad albero Console Root della finestra di MQServices, espanderei servizi WebSphere MQ quindi selezionare il gestore code.

    E' necessario che vi siano tre voci elencate per la coda particolare selezionata nel pannello di destra: Gestore code, Server dei comandi e Programma di iniziazione canale. (Se in un primo momento non viene visualizzato il Programma di iniziazione canale, verrà visualizzato dopo il riavvio del sistema.)

  5. Per le tre voci contenute nel pannello di destra--Gestore code, Server dei comandi, Programma di iniziazione canale--configurare la modalità di avvio su Automatico facendo clic con il tastino destro del mouse su ciascuna, quindi selezionare Tutte le attività > Automatico.
  6. Aggiungere una voce listener facendo clic con il tastino destro del mouse sul nome del gestore code nella struttura ad albero Console Root quindi selezionare Nuovo > listener dall'elenco a discesa.
  7. Nella scheda Parametri della casella di dialogo Crea servizio listener, selezionare TCP come protocollo e 1414 come numero di porta quindi fare clic su OK.

    E' necessario utilizzare un numero di porta univoco per ciascun listener. Assegnare alla porta un numero diverso da quello definito: 1414,quindi fare clic su OK.

  8. Configurare il listener per l'avvio automatico facendo clic con il tastino destro del mouse sul listener quindi selezionare Tutte le attività > Automatico.
  9. Chiudere IBM WebSphere MQ Explorer. Fare clic su Sì quando viene richiesto se salvare le modifiche.
  10. Riavviare la macchina.
  11. Verificare che il Programma di iniziazione canale sia stato avviato seguendo le istruzioni:
    1. Start > Programmi > IBM WebSphere MQ > Servizi WebSphere MQ. (In alternativa, fare clic con il tastino destro sull'icona WebSphere MQ nella barra delle applicazioni quindi selezionare servizi MQ.)
    2. Nella finestra Servizi MQ, verificare che il Programma di iniziazione canale sia in esecuzione e che sia impostato su Automatico.
    3. Chiudere la finestra Servizi MQ.

Configurazione WebSphere MQ per JMS

Per ogni connettore configurato per l'utilizzo con WebSphere MQ per il trasporto JMS, utilizzare lo strumento di configurazione connettore per modificare il file di configurazione locale del connettore'.

E' necessario che WebSphere MQ utilizzi il trasporto JMS poichè WebSphere MQ si basa su CORBA per la gestione relativa e per gli altri componenti. Quando viene utilizzato come provider JMS non esistono più dipendenze da CORBA. Inoltre l'MQ nativo continua solo ad inviare eventi al server.

Specificare un gestore code e configurare i valori delle proprietà come elencato in Tabella 5. In questo esempio, JmsConnector è il connettore che viene configurato

Tabella 5. Valori delle proprietà per il trasporto JMS
Proprietà Valore
AdminInQueue JMSCONNECTOR\ADMININQUEUE
AdminOutQueue JMSCONNECTOR\ADMINOUTQUEUE
DeliveryQueue JMSCONNECTOR\DELIVERYQUEUE
FaultQueue JMSCONNECTOR\FAULTQUEUE
RequestQueue JMSCONNECTOR\REQUESTQUEUE
ResponseQueue JMSCONNECTOR\RESPONSEQUEUE
SynchronousRequestQueue JMSCONNECTOR\SYNCHRONOUS
REQUESTQUEUE
SynchronousResponseQueue JMSCONNECTOR\SYNCHRONOUS
RESPONSEQUEUE

E' possibile lasciare i campi Nome utente e Password in bianco fino a che non si accede al gestore code utilizzando la modalità client.

Importante:
Se si configura WebSphere MQ per JMS in un ambiente internazionalizzato, è necessario installare la versione internazionalizzata delle classi WebSphere MQ per JMS.

Specificare il file di configurazione locale aggiornato per il connettore specifico nell'ubicazione seguente:

  1. Passare a Start > Programmi > IBM WebSphere Integration Adapters > Adattatori > Connettori > Nome connettore.
  2. fare clic con il tastino destro del mouse sul nome del connettore e selezionare Proprietà.
  3. Inserire il comando -c filename alla fine del percorso Campi' di destinazione.

    Dove filename è il percorso completamente qualificato per il file di configurazione che dispone delle voci relative a quel connettore.

Ricaricare il repository e riavviare InterChange Server ed il connettore dopo aver eseguito queste modifiche. Passare a Avvio di InterChange Server per la prima volta.

Copyright IBM Corp. 1997, 2004