Sintesi -------- Il presente documento contiene il file readme di WebSphere MQ versione 7.0.1 e la relativa manutenzione. La versione in lingua inglese di questo documento è la versione più aggiornata. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ DESCRIZIONE ----------- In questo file viene descritto quanto segue: 1. Limitazioni e problemi noti 2. Come ottenere e installare questo fix pack 3. IBM Message Service Client for .NET V2.0.0.13 4. Informazioni particolari e marchi È possibile trovare la versione più recente di questo file al seguente indirizzo: https://ibm.biz/mqreadmes La versione più recente del file di licenza del prodotto è disponibile al seguente indirizzo: http://www.ibm.com/support/docview.wss?uid=swg27006097 Oltre a questo file, è possibile trovare ulteriori informazioni sul sito web di IBM MQ: http://www.ibm.com/software/integration/wmq/ La pagina web di SupportPac è disponibile al seguente indirizzo: https://ibm.biz/mqsupportpacs Per informazioni aggiornate sui problemi noti e sulle correzioni disponibili, visitare la pagina di supporto del sito web di IBM MQ al seguente indirizzo: http://www.ibm.com/software/integration/wmq/support/ Aggiornamenti della documentazione web Gli ultimi aggiornamenti della documentazione di IBM MQ basata sul web sono disponibili sul sito web di IBM MQ al seguente indirizzo: http://www.ibm.com/software/integration/wmq/library/ Lettera di annuncio La lettera di annuncio per WebSphere MQ versione 7.0 (in lingua inglese) è disponibile all'indirizzo: http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-068 (per piattaforme distribuite) oppure http://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=an&subtype=ca&appname=GPA&htmlfid=897/ENUS208-067 (WebSphere MQ per z/OS ). Consultare la lettera di annuncio per i seguenti tipi di informazioni: - Descrizione dettagliata del prodotto, inclusa la descrizione della nuova funzione - Istruzioni sul posizionamento del prodotto - Dettagli relativi all'esecuzione dell'ordine - Requisiti hardware e software +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ CRONOLOGIA AGGIORNAMENTI 05 ago 2016 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 14 12 feb 2016 - Aggiornamenti per i CipherSpec SSLv3 obsoleti nel Fix Pack 13 01 lug 2015 - Refactoring in base a fix pack e aggiornamenti per Fix Pack 13 14 mar 2014 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 12 20 ago 2013 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 11 17 dic 2012 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 10 06 lug 2012 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 9 13 gen 2012 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 8 03 ott 2011 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 7 03 giu 2011 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 6 03 feb 2011 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 5 01 ott 2010 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 4 12 ago 2010 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 3 28 gen 2010 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 2 20 nov 2009 - Aggiornamenti per WebSphere MQ versione 7.0.1, Fix Pack 1 16 lug 2009 - Aggiornamenti per WebSphere MQ versione 7.0.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEZIONE 1: LIMITAZIONI E PROBLEMI NOTI ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 14 ============================================================= Ritiro del programma di utilità di migrazione migmbbrk ---------------------------------------- Il programma di utilità migmbbrk era stato precedentemente fornito con tutte le release di WebSphere MQ versione 7 ed è stato utilizzato per migrare i dati di configurazione di pubblicazione/sottoscrizione da WebSphere Event Broker versione 6.0 o WebSphere Message Broker versione 6.0 o 6.1 a WebSphere MQ versione 7. Per facilitarne le operazioni, sono stati forniti ulteriori componenti software con il prodotto. Considerato il ritiro del supporto per le release WebSphere Event Broker e WebSphere Message Broker applicabili, il programma di utilità migmbbrk e le relative dipendenze non viene più fornito come parte dell'installazione del prodotto MQ. Per motivi di compatibilità, sono stati invece inviati dei file sostitutivi con lo stesso nome per preservare il layout di installazione sul disco. Un'edizione autonoma del programma di utilità migmbbrk sarà resa disponibile a breve sul sito del supporto IBM. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 13 ============================================================= Deprecazione del supporto per i CipherSpec deboli --------------------------------------------- WebSphere MQ versione 7.0.1, Fix Pack 13 depreca il protocollo SSLv3 e l'utilizzo dei seguenti CipherSpec sulle definizione di canale associate con il gestore code: AES_SHA_US (solo SSLV3) RC4_SHA_US RC4_MD5_US TRIPLE_DES_SHA_US DES_SHA_EXPORT1024 RC4_56_SHA_EXPORT1024 RC4_MD5_EXPORT RC2_MD5_EXPORT DES_SHA_EXPORT TLS_RSA_WITH_DES_CBC_SHA (non SSLV3) NULL_SHA NULL_MD5 FIPS_WITH_DES_CBC_SHA FIPS_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_NULL_SHA256 (non SSLV3) Il tentativo di utilizzo o di configurazione di uno di questi CipherSpec comporta l'emissione di uno o più dei seguenti messaggi nel log di errori del gestore code: AMQ8242, AMQ9616, AMQ9635. Per continuare ad utilizzare i CipherSpec SSLv3 nel precedente elenco (tutti i CipherSpec con l'eccezione dei due contrassegnati come "non SSLV3"), configurare la variabile di ambiente AMQ_SSL_V3_ENABLE con il valore "TRUE" nell'ambiente utilizzato per avviare il gestore code. In alternativa, aggiungere la seguente voce alla stanza SSL de file qm.ini del gestore code: AllowSSLV3=Y La configurazione della variabile di ambiente sovrascrive tutti i valori specificati nel file qm.ini. Per continuare ad utilizzare i CipherSpec nel precedente elenco ad eccezione di quello contrassegnato come "solo SSLV3", esportare o impostare su "Yes" la variabile di ambiente AMQ_SSL_WEAK_CIPHER_ENABLE nell'ambiente utilizzato per avviare il gestore code. In alternativa, aggiungere la seguente voce alla stanza SSL de file qm.ini del gestore code: AllowWeakCipherSpec=Yes La configurazione della variabile di ambiente sovrascrive tutti i valori specificati nel file qm.ini. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 12 ============================================================= Questo fix pack non contiene alcuna nuova limitazione o problema che richieda attenzione da parte dell'utente. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 11 ============================================================= La sezione Introduzione del file EGA.readme.mbr fornito con il codice di base iSeries di WebSphere MQ 7.0.1 contiene un riferimento obsoleto al manuale Guida operativa disponibile sul sito di download -------------------------------------------------------------------------- "Introduzione" Queste istruzioni sono valide per l'installazione di WebSphere MQ per i5/OS versione 7.0.1 da un'immagine di installazione scaricata da IBM. Utilizzarla con il manuale Guida operativa di WebSphere MQ per i5/OS per questa release. Una versione del manuale Guida operativa è disponibile sul sito di download e contiene una descrizione del 'Documento di installazione di WebSphere MQ V7.0'." Questo documento non è più disponibile sul sito Passport Advantage. Adesso, le informazioni sono disponibili in linea nel centro informazioni di WebSphere MQ versione 7 all'interno della sezione 'Guida operativa per i5/OS': http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqwac.doc/iq10120_.htm LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 10 ============================================================= WebSphere MQ Explorer - Messaggi in lingua inglese in ambienti non in lingua inglese ------------------------------------------------------------------- Quando il Fix Pack 10 viene installato in un ambiente con impostazioni locali diverse dalla lingua inglese, è possibile che alcuni messaggi in WebSphere MQ Explorer siano ancora visualizzati in lingua inglese senza riportare la traduzione più recente. La causa di questo problema è il bug 201489 di Eclipse: https://bugs.eclipse.org/bugs/show_bug.cgi?id=201489 Per installare la correzione di Eclipse per questo problema, eseguire prima WebSphere MQ Explorer in modalità Eclipse Workbench. Per selezionare la modalità Eclipse Workbench, fare clic su Finestra > Preferenze > WebSphere MQ Explorer > in un Eclipse Workbench. Riavviare WebSphere MQ Explorer per rendere effettiva la modifica. Su piattaforme Linux, per visualizzare e installare gli aggiornamenti, eseguire WebSphere MQ Explorer come root. Avviare il gestore aggiornamenti facendo clic su Guida > Aggiornamenti software Selezionare "RCP Patch (bug:201489)" dagli aggiornamenti disponibili e seguire le istruzioni per installare la correzione. Per riportare WebSphere MQ Explorer in modalità autonoma quando necessario, selezionare l'opzione appropriata dalla pagina delle preferenze di WebSphere MQ Explorer. Supporto WebSphere Application Server su z/OS -------------------------------------------- Prima di distribuire il Fix Pack 10 su o all'interno di un ambiente WebSphere Application Server su z/OS, leggere le note tecniche che seguono riguardanti le versioni di WebSphere Application Server in uso: Versione Link -------- ------------------------------------------------------------- 7.0 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21316899.htm 8.0 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21498708.htm 8.5 http://www.ibm.com/support/knowledgecenter/prodconn_1.0.0/com.ibm.scenarios.wmqwasusing.doc/topics/swg21498708_85.htm APAR IV31952 ------------ La correzione per APAR IV31952 ha modificato i controlli sulle autorizzazioni eseguiti da WebSphere MQ sugli oggetti del canale quando si esegue il comando RESET CHANNEL. L'applicazione di questa correzione può influire sul funzionamento e potrebbe essere necessario modificare alcune autorizzazioni. I sistemi in uso vengono interessati solo se i canali sono eseguiti con un ID utente MCAUSER che restituisce un utente non mqm. I comandi di reimpostazione canale possono essere eseguiti all'interno del codice WebSphere MQ, pertanto, anche se non si è eseguito manualmente il comando di reimpostazione del canale, il sistema in uso potrebbe essere comunque interessato. Assicurarsi che l'ID utente MCAUSER del proprio canale abbia almeno le autorizzazioni +DSP e +CTRLX sull'oggetto del canale in modo che l'ID utente possa eseguire i comandi di reimpostazione del canale. Prima della correzione per IV31952, WebSphere MQ verificava che l'ID utente disponesse dell'autorizzazione +ALTUSR che veniva concessa in precedenza per far funzionare il canale. Dopo l'applicazione di WebSphere MQ fix pack 7.0.1.10 o successiva, è possibile rimuovere l'autorizzazione +ALTUSR di MCAUSER sull'oggetto del canale poiché non è richiesta per il comando di reimpostazione del canale. È inoltre necessario verificare che l'ID utente MCAUSER disponga dell'autorizzazione +DSP e +CTRLX sull'oggetto del canale. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 8 e 9 =================================================================== Questi fix pack non contengono alcuna nuova limitazione o problema che richieda attenzione da parte dell'utente. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 7 ============================================================ Installazione di un fix pack della versione 7.0.1 su HP-UX in caso di installazione preesistente di una versione 7.1 --------------------------------------------------------------------- Su HP-UX, quando si effettua un tentativo di aggiornare il Fix Pack 6 della versione 7.0.1 al Fix Pack 7 della stessa versione su una macchina che include anche un'installazione di WeSphere MQ V7.1, il log di installazione del fix pack potrebbe contenere i seguenti errori, ripetuti più volte. Tuttavia, ciò non impedisce la corretta installazione del fix pack. rm: MQSERIES.MQM-RUNTIME: inesistente ERRORE: È stata specificata più di una selezione di fileset. Specificare un unico fileset durante l'esecuzione delle modifiche al file o al file di controllo. Rimozione di un fix pack della versione 7.0.1 da Linux mentre è in esecuzione un gestore code versione 7.1 --------------------------------------------------------------------------- Su Linux (tutte le architetture), quando si tenta di rimuovere un fix pack della versione 7.0.1, la rimozione potrebbe parzialmente non riuscire se entrambe le seguenti condizioni sono vere: - la rimozione del fix pack della versione 7.0.1 lascia la versione 7.0.1 installata a una versione precedente del Fix Pack 6 - contemporaneamente nel sistema è in esecuzione un gestore code versione 7.1. L'output dei messaggi di errore del comando'rpm' hanno il seguente formato: ERRORE: Le risorse condivise di WebSphere MQ per questa installazione sono ancora in uso. Accertarsi che nessun processo WebSphere MQ sia in esecuzione prima di rimuovere il pacchetto di manutenzione errore: %preun(MQSeriesJRE-U844092-7.0.1-7.s390x) scriptlet non riuscito, stato uscita 1 Ad esempio, in un sistema in cui è stato utilizzato il seguente ordine di installazione: (1) Installare una nuova installazione di WebSphere MQ V7.0.1, Fix Pack 3. (2) Installare WebSphere MQ V7.0.1, Fix Pack 7. (3) Installare WebSphere MQ V7.1.0.0. (4) Creare e avviare un gestore code versione 7.1 (5) Disinstallare il fix pack di WebSphere MQ V7.0.1.7 Per evitare questo problema, effettuare una delle eseguenti azioni: (a) Accertarsi che lo stato di tutti i gestori code del sistema sia Arrestato prima di rimuovere il fix pack. (b) Accertarsi che il pacchetto rpm 'MQSeriesRuntime' sia l'ultimo pacchetto da rimuovere dalla disinstallazione del fix pack. La sintassi rpm varia in base alla versione rpm: potrebbe essere necessario consultare il fornitore del sistema operativo in uso per determinare tale informazione relativamente al proprio sistema. Per Red Hat Enterprise Linux Server 5.7, che utilizza la versione rpm 4.4.2.3, l'ordine di rimozione è inverso a quello specificato nella riga comandi. Pertanto, l'indicazione di 'MQSeriesRuntime' in cima alla lista di rimozione consentirà la rimozione del fix pack. Ad esempio, su Red Hat Enterprise Linux Server 5.7, utilizzare la seguente sintassi di comando per rimuovere correttamente un'istanza della versione 7.0.1, Fix Pack 7 mentre è in esecuzione un gestore code versione 7.1.0.0: rpm -e MQSeriesRuntime-U844091-7.0.1-7 MQSeriesConfig-U844091-7.0.1-7 MQSeriesMsg_es-U844091-7.0.1-7 MQSeriesMsg_ru-U844091-7.0.1-7 MQSeriesMan-U844091-7.0.1-7 MQSeriesMsg_ko-U844091-7.0.1-7 MQSeriesServer-U844091-7.0.1-7 MQSeriesJava-U844091-7.0.1- MQSeriesMsg_cs-U844091-7.0.1-7 MQSeriesMsg_hu-U844091-7.0.1-7 MQSeriesMsg_pl-U844091-7.0.1-7 MQSeriesMsg_Zh_TW-U844091-7.0.1-7 MQSeriesTXClient-U844091-7.0.1-7 MQSeriesClient-U844091-7.0.1-7 MQSeriesJRE-U844091-7.0.1-7 MQSeriesMsg_de-U844091-7.0.1-7 MQSeriesMsg_it-U844091-7.0.1-7 MQSeriesMsg_pt-U844091-7.0.1-7 MQSeriesSamples-U844091-7.0.1-7 MQSeriesKeyMan-U844091-7.0.1-7 MQSeriesMsg_ja-U844091-7.0.1-7 MQSeriesSDK-U844091-7.0.1-7 MQSeriesFTA-U844091-7.0.1-7 MQSeriesMsg_fr-U844091-7.0.1-7 MQSeriesMsg_Zh_CN-U844091-7.0.1-7 Se si riscontra questo problema, completare la rimozione del fix pack della versione 7.0.1 effettuando la seguente procedura: 1. Arrestare tutti i gestore code WebSphere MQ sul sistema. 2. Rimuovere i rimanenti pacchetti rpm associati al fix pack che non sono stati rimossi con il primo tentativo di rimozione. Modifiche all'attributo DEFXMITQ dell'oggetto gestore code --------------------------------------------------------- Nel Fix Pack 7, sono stati introdotti ulteriori controlli per impedire l'impostazione del valore "SYSTEM.CLUSTER.TRANSMIT.QUEUE" dell'attributo DEFXMITQ per l'oggetto gestore code. Un nuovo codice motivo "MQRCCF_DEF_XMIT_Q_CLUS_ERROR" (numero 3269) è stato creato per descrivere un tentativo non riuscito di impostare l'attributo DEFXMITQ dell'oggetto gestore code su "SYSTEM.CLUSTER.TRANSMIT.QUEUE". Inoltre, per evitare problemi qualora DEFXMITQ sia stato precedentemente impostato in modo errato su SYSTEM.CLUSTER.TRANSMIT.QUEUE, è stato aggiunto un nuovo controllo di validità per impedire che una chiamata MQOPEN o MQPUT1 utilizzi questo meccanismo errato. Il codice motivo in caso di errore è "MQRC_DEF_XMIT_Q_USAGE_ERROR" (numero 2199). LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 6 ============================================================ Modifiche al funzionamento predefinito dell'API MQPUT1 con MQPMO_SYNCPOINT quando utilizzata in un'applicazione client ------------------------------------------------------------------- Il funzionamento predefinito di MQPUT1 con MQPMO_SYNCPOINT è stato modificato nel Fix Pack 6, per inserire il messaggio in modo sincrono, affinché i campi di output MQMD e MQOD vengano popolati durante la chiamata MQPUT1. Il funzionamento predefinito può essere modificato impostando l'attributo Put1AsyncPut del file di configurazione client nella stanza Channels. I valori validi per Put1AsyncPut sono: (a) no : l'inserimento è sempre sincrono. Questa è l'impostazione predefinita. (b) yes : l'inserimento è sempre asincrono. (c) syncpoint : l'inserimento è asincrono se viene impostato MQPMO_SYNCPOINT, altrimenti è sincrono. Il nuovo attributo Put1AsyncPut non sostituisce Put1DefaultAlwaysSync. Se occorre modificare l'impostazione sul valore predefinito precedente al Fix Pack 6, l'attributo Put1AsyncPut del file di configurazione client deve essere impostato su "syncpoint". LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 5 ============================================================ Gestione migliorata di WebSphere MQ in esecuzione su HP-UX 11i V3 (hardware Itanium) ---------------------------------------------------------------------------- Questo elemento riguarda soltanto gli utenti di HP-UX 11i V3 (hardware Itanium) laddove il nome host del sistema superi gli 8 caratteri. Prima del Fix Pack 5, WebSphere MQ otteneva il nome host effettuando una chiamata di sistema, uname(). In HP-UX 11i V3 (hardware Itanium), la chiamata uname() potrebbe non riuscire se il nome host è maggiore di 8 caratteri. Durante il processo di installazione e anche durante la normale elaborazione del gestore code, la chiamata uname() non riuscita potrebbe quindi comportare un errore di funzionamento del codice WebSphere MQ. Le directory sotto /var/mqm che contengono il nome host potrebbero essere create in modo errato, specificando il nome "Unknown" anziché il nome host. APAR IZ87770 affronta il problema utilizzando invece la chiamata di sistema gethostname(). Dopo aver installato il Fix Pack 5 o versioni successive, rimuovere manualmente le directory denominate erroneamente "Unknown". In particolare, le directory denominate "Unknown" si troveranno sotto queste ubicazioni: - /var/mqm/ipc - /var/mqm/sockets - /var/mqm/qmgrs//@app - /var/mqm/qmgrs//@qmgr NON eliminare altre directory, ad esempio quelle che contengono i dati dei messaggi sotto /var/mqm/qmgrs//queues. Ulteriori informazioni su questo APAR sono disponibili all'indirizzo: http://www.ibm.com/support/docview.wss?uid=swg1IZ87770 Miglioramenti alla modalità di invio di informazioni dal controllo trigger all'applicazione avviata ----------------------------------------------------------------- APAR IC72003 migliora il modo un cui il controllo trigger invia le informazioni all'applicazione avviata. I caratteri percentuale e dollaro sono preceduti adesso da virgolette doppie (Windows) o da una barra rovesciata (UNIX). Questa modifica fa sì che l'espansione delle variabili di ambiente da parte del sistema operativo venga sospesa per i dati all'interno della struttura MQTMC2 passati come parametro all'applicazione avviata. Ad esempio, se il campo APPLICID di un processo era stato definito come "java cp %CLASSPATH% TriggerApp", su Windows questo verrà modificato in "java cp "%"CLASSPATH"%" TriggerApp" quando si crea MQTMC2. In questo esempio, l'applicazione riceverà "java cp %CLASSPATH% TriggerApp" come parametro di input. A partire dal Fix Pack 5, le applicazioni non riceveranno più una versione espansa delle variabili di ambiente all'interno della struttura MQTMC2. Se il contenuto è importante, dovranno utilizzare invece dei mezzi di espansione delle variabili di ambiente alternativi. Modifiche all'utilizzo di MQGMO_CONVERT nelle classi WebSphere MQ v7.0 per JMS -------------------------------------------------------------------------- APAR IC72897 modifica il modo in cui le classi WebSphere MQ V7.0 per JMS richiedono i messaggi dal gestore code. Prima del Fix Pack 5, le classi WebSphere MQ V7.0 per JMS richiedevano i messaggi dal gestore code utilizzando l'opzione API MQGMO_CONVERT di WebSphere MQ. Questa opzione richiede che il gestore code esegua la conversione dei dati dei messaggi prima di inviare il messaggio all'applicazione JMS ricevente. Le classi WebSphere MQ V6.0 per JMS non utilizzavano questa opzione. Tale modifica al comportamento del client JMS può avere effetti sulle applicazioni JMS quando si esegue la migrazione da V6.0 a V7.0. La modifica del codice associata a questo APAR ripristina l'azione predefinita delle classi V7.0 al comportamento di V6.0. Una volta installato il Fix Pack 5 o versione successiva, le classi WebSphere MQ V7.0 per le applicazioni JMS non utilizzeranno più MQGMO_CONVERT. Pertanto, il gestore code non effettuerà alcuna conversione dei dati quando vengono richiesti i messaggi. Inoltre, sono state aggiunte nuove proprietà come parte di questo APAR, per consentire all'applicazione di scegliere se è richiesta o meno la conversione dei dati del gestore code. Queste proprietà possono essere configurate a livello di programmazione utilizzando il metodo setter nella classe com.ibm.mq.jms.MQDestination, a livello di amministrazione tramite una proprietà da impostare nello spazio dei nomi JNDI per la destinazione o come variabile di ambiente a livello di sistema all'interno di JVM utilizzando la proprietà "com.ibm.msg.client.wmq.receiveConversionCCSID". Una descrizione completa di questo APAR, incluse le informazioni su come utilizzare le nuove proprietà e sulle impostazioni da utilizzare per ripristinare il comportamento delle classi V7.0 precedenti a questo fix pack, è disponibile all'indirizzo: http://www.ibm.com/support/docview.wss?uid=swg21459994 LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 4 ============================================================ Comportamento del campo di output UNCOM per DISPLAY QSTATUS ------------------------------------------------------ APAR IZ76189 ha modificato il comportamento del comando DISPLAY QSTATUS in runmqsc in modo che il comportamento di UNCOM corrisponda adesso alla descrizione nelle pagine del centro informazioni relative a runmqsc. L'interfaccia di runmqsc visualizza ora il numero di messaggi senza commit anziché semplicemente YES o NO. È possibile utilizzare UNCOM in un filtro: ad esempio, WHERE(UNCOM LT 10). Potrebbe essere necessario modificare gli script che contengono i comandi DISPLAY QSTATUS per runmqsc, se si basano su questi valori YES o NO. Miglioramento della gestione di messaggi non recapitabili all'interno delle classi WebSphere MQ v7 per JMS ------------------------------------------------------------------------------ APAR IZ78515 ha modificato il comportamento predefinito per la gestione dei messaggi non recapitabili all'interno delle classi WebSphere MQ V7 per JMS. Quando si utilizzano le classi WebSphere MQ V7 per JMS (Java Message Service) di una versione precedente al Fix Pack 4, i messaggi non elaborabili che non possono essere inviati alla coda di backout denominata venivano convertiti nel tipo JMSBytesMessage prima di essere inviati alla coda di messaggi non recapitabili del gestore code (ad esempio, SYSTEM.DEAD.LETTER.QUEUE). Questo comportamento è stato modificato a partire da WebSphere MQ V6. In V6, le classi JMS inseriscono i messaggi nella coda di messaggi non recapitabili nel formato originale, senza convertirli nel tipo JMSBytesMessage. APAR IZ78515 modifica il comportamento in modo che i messaggi non elaborabili vengano inseriti nella coda di messaggi non recapitabili senza effettuare alcuna conversione. Questo è il comportamento corretto per tale funzione e corrisponde a WebSphere MQ v6. Nuove informazioni in WebSphere MQ Explorer : testo mancante in lingua diversa dall'inglese. ------------------------------------------------------------------- Una parte del testo più recente (aggiunto in Fix Pack 4) manca nelle versioni non inglesi di WebSphere MQ Explorer. (a) La funzionalità di autorizzazione di MQ Explorer contiene adesso un nuovo pannello che consente di aggiungere autorizzazioni basate sui ruoli. Nella schermata sono presenti due link di "Ulteriori informazioni". Nel Fix Pack 4, il link posto più in basso fornisce informazioni solo se si esegue MQ Explorer in lingua inglese. (b) Alcuni elementi della funzionalità SSL/TLS introdotta di recente sono stati aggiunti in MQ Explorer nel Fix Pack 4. Tali elementi sono relativi alla configurazione dei canali e dei gestori code. In particolare, consentono la: - Configurazione di CipherSpec SHA-2 da MQ Explorer. - Specifica di un server proxy HTTP per l'utilizzo di OCSP. - Modifica configurabile alla modalità di convalida dei certificati, utile a un numero ristretto di utenti. In MQ Explorer in lingua inglese, le informazioni in tali pannelli sono state aggiornate per riflettere i nuovi valori SSL/TLS; in altre lingue alcune di queste nuove informazioni non vengono visualizzate, sebbene i pannelli principali siano stati tradotti correttamente. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACK 3 ============================================================ Client del Fix Pack 3 e versioni successive che utilizzano JMS per connettersi ai server del Fix Pack 2 ----------------------------------------------------------------------- Se si esegue l'aggiornamento al Fix Pack 3 o superiore su un'installazione in cui sono in uso le classi WebSphere MQ per JMS (Java Message Service), leggere le seguenti informazioni. Dal Fix Pack 3 in avanti, quando si utilizzano le classi WebSphere MQ per JMS (Java Message Service) per connettersi a un gestore code del Fix Pack 2, potrebbe verificarsi un problema durante l'arresto dell'istanza del canale SVRCONN. Ad esempio, si immette: STOP CHANNEL(MY.SVRCONN.CHANNEL) Se si arresta un canale utilizzato dall'applicazione Java, lo stato del canale potrebbe restare in uno stato STOPPING. Quando il canale viene riavviato, lo stato del canale passa a STARTED e viene creata un'altra istanza del canale. Questo problema è stato risolto da APAR IZ77323 e corretto nel Fix Pack 3. Pertanto, se i client utilizzano JMS, è opportuno aggiornare l'installazione del server di WebSphere MQ al Fix Pack 3 o superiore prima dei client che si connettono ad esso. Ulteriori casi di errore riscontrati nel corso delle verifiche di sicurezza di Explorer ----------------------------------------------------------- Dopo aver installato il Fix Pack 3 o superiore, se si eseguono le verifiche predefinite di Explorer probabilmente si otterranno messaggi di errore nei risultati della verifica, anche se i risultati erano precedentemente privi di errori. Ciò avviene perché le verifiche predefinite ora verificano aspetti della configurazione che non venivano verificati in precedenza. Gli errori più comuni emergono perché il sistema in entrata e i canali predefiniti (i cui nomi iniziano per "SYSTEM") non sono stati adeguatamente protetti da accessi indesiderati. Un'altra causa comune di nuovi errori è dovuta al fatto che i file di sistema di SSL/TLS consentono livelli di accesso inutilmente alti. Per rimuovere gli errori e, ove opportuno, gli avvisi dai risultati della verifica, è possibile configurare nuovamente il sistema. La sezione "Ulteriori informazioni" associata ai risultati della verifica fornisce consigli su come agire in tal senso. È possibile che si desideri utilizzare gli stessi file di sistema di SSL/TLS per conservare le chiavi e i certificati sia del gestore code che del client. Tuttavia, si scoraggia il ricorso a questa configurazione scarsamente sicura. In generale, il controllo/l'autorizzazione degli accessi necessari per tale configurazione sono incompatibili con la nuova verifica dei file di sistema di SSL/TLS. Se si persiste con la condivisione dei file di sistema di SSL/TLS tra il client e il gestore code, ma si desidera che i risultati della verifica di Explorer siano privi di errori, è possibile configurare la propria serie di verifiche standard tramite il comando "Esegui configurazione delle verifiche personalizzata..." . LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1, FIX PACKS 1 e 2 =================================================================== Questi fix pack non contengono alcuna nuova limitazione o problema che richieda attenzione da parte dell'utente. LIMITAZIONI E PROBLEMI NOTI PER LA VERSIONE 7.0.1.0 ================================================== GSKit 7 a 64 bit non aggiornato con l'installazione del fix pack MQ su Windows -------------------------------------------------------------- A causa di una limitazione nota nel codice di installazione, la versione a 64 bit di GSKit 7 su Windows non viene aggiornata quando si installano i fix pack di WebSphere MQ. Ciò significa che le applicazioni client MQ a 64 bit che utilizzano connessioni SSL/TLS su Windows non vengono eseguite al livello di correzione più aggiornato di GSKit. Tuttavia, l'installazione di GSKit 7 a 32 bit verrà aggiornata quando si installa il fix pack. Ciò vuol dire che i gestori code, i canali sul lato server e le applicazioni client SSL/TLS a 32 bit saranno ancora in grado di utilizzare i livelli di correzione più recenti di GSKit quando viene applicata la manutenzione WebSphere MQ. I client Java e JMS non utilizzano GSKit per la propria funzionalità SSL/TLS, pertanto non sono interessati da questo problema. Informazioni relative al mantenimento dei gestori code a istanza multipla ----------------------------------------------------------------- Qui è possibile trovare indicazioni per l'applicazione dei fix pack in cui vengono utilizzati gestori code a istanza multipla: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/cr00060_.htm In generale, un gestore code a istanza multipla può disporre di istanze in esecuzione con 7.0.x.y e 7.0.a.b contemporaneamente. Di seguito vengono elencate le eccezioni. Tranne queste eccezioni, secondo la regola generale l'istanza in standby può essere sull'installazione a livello di un fix pack più recente o più vecchio rispetto all'istanza attiva. Ciò consente l'aggiornamento o l'esecuzione del rollback di mantenimento con un tempo di inattività minimo. Di seguito viene riportato l'elenco di eccezioni: Windows: 7.0.1.0 e >= 7.0.1.0 non possono essere utilizzate insieme. i5/OS: 7.0.1.0 non supporta i gestori code a istanza multipla, pertanto non può essere utilizzato per l'istanza in standby o attiva. Avvio di Explorer con un'installazione precedente di WebSphere MQ versione 7.0.1 ----------------------------------------------------------------------------- Se si dispone di una precedente installazione di WebSphere MQ versione 7.0.1, ad esempio una versione Beta, è possibile che si verifichi un problema all'avvio di WebSphere MQ Explorer. Se si nota che Eclipse viene avviato ma la prospettiva di WebSphere MQ non si apre correttamente, effettuare le seguenti azioni: 1. In Explorer, fare clic sul menu Finestra e selezionare "Riavvia prospettiva". 2. Se il passo precedente non corregge il problema: a. Chiudere Explorer b. Immettere il seguente comando dalla riga comandi: strmqcfg -i c. Avviare di nuovo Explorer 3. Se il passo precedente non corregge il problema: a. Chiudere Explorer b. Controllare che non vi siano processi Eclipse in esecuzione. c. (Nota: la seguente azione rimuove i dati di Explorer, come le definizioni di gestori code remoti e gli schemi e filtri personalizzati, pertanto è opportuno prendere nota dei dati che si desidera mantenere.) Eliminare le seguenti cartelle: Su Windows: C:\Documents and Settings\\Application Data\IBM\MQ Explorer C:\Documents and Settings\\.eclipse Su Linux: /home//.mqdata /home//.eclipse d. Immettere il seguente comando nella riga comandi: strmqcfg -i e. Avviare di nuovo Explorer Supporto per WebSphere MQ su Windows Vista edizione giapponese ---------------------------------------------------------- WebSphere MQ non supporta il giapponese standard, JIS X 0213:2004. Windows Vista edizione giapponese formalmente supporta i caratteri JIS X 0213:2004. Tali caratteri JIS X 0213:2004 includono i caratteri Unicode ideogrammi CJK estensione B (caratteri coppia di surrogati (quattro byte) UTF-16). Programma di verifica di installazione per JCA con WAS CE ---------------------------------------------------------- Affinché JCA IVT funzioni su WAS CE (WebSphere Application Server Community Edition) è necessario che esista un factory di connessione denominato "qcf" e una coda con un nome di destinazione messaggio di "jmstestQ" definita in geronimo-rar.xml quando si distribuisce il file RAR. Per distribuire il file wmq.jmsra.ivt.ear sulla versione 2.0.1 o successive di WAS CE, è necessario aggiornare i seguenti file xml all'interno del file EAR come segue: geronimo-application.xml xmlns:nam="[http://geronimo.apache.org/xml/ns/naming-1.2]"> openejb-jar.xml Clustering degli argomenti -------------------- Sebbene il clustering degli argomenti sia generalmente supportato, non eseguire cluster di SYSTEM.BASE.TOPIC o SYSTEM.DEFAULT.TOPIC. Il parametro CLUSTER di questi argomenti deve essere vuoto. Argomenti in cluster sovrapposti ------------------------------ Se vengono definiti due o più argomenti, con una stringa di argomento in una versione più qualificata dell'altra (ad esempio SPORTS e SPORTS/FOOTBALL), con gli argomenti in cluster diversi ma sovrapposti, le pubblicazioni possono essere consegnate a gestori code di contenitori imprevisti. Ad esempio: - Il gestore code qmAB si trova in entrambi i cluster ClusterA e ClusterB - SPORTS è un argomento cluster in ClusterA - SPORTS/FOOTBALL è un argomento cluster in ClusterB Gli abbonati a SPORTS/FOOTBALL sui gestori code che si trovano solo in ClusterA ricevono anche le pubblicazioni dal gestore code qmAB. In modo simile, se un argomento cluster e un argomento locale condividono un nome, si potrebbero ricevere pubblicazioni impreviste. Ad esempio: - SPORTS è un argomento cluster in ClusterA - Il gestore code qmC in ClusterA definisce un argomento SPORTS senza cluster Gli abbonati a SPORTS sui gestori code in ClusterA ricevono pubblicazioni da qmC. MQ Explorer non viene eseguito correttamente utilizzando Firefox su Linux ---------------------------------------- È possibile che WebSphere MQ Explorer non sia eseguito correttamente con il messaggio "JVM terminato" durante il tentativo di avviare l'Help Center. Si verifica un problema noto durante l'esecuzione del browser SWT (Standard Widget Toolkit) in Eclipse su alcune distribuzioni di Linux quando il browser predefinito è Firefox. Per evitare questo problema, impostare il valore della variabile di ambiente MOZILLA_FIVE_HOME sulla cartella che contiene l'installazione di Firefox. Ad esempio, se Firefox è installato in /usr/lib/firefox-3.0.10, utilizzare il comando: export MOZILLA_FIVE_HOME=/usr/lib/firefox-3.0.10 o setenv MOZILLA_FIVE_HOME /usr/lib/firefox-3.0.10 in base alla shell in uso. (Questo requisito viene riportato nella sezione delle domande frequenti di SWT del sito Web di Eclipse: http://www.eclipse.org/swt/faq.php#browserlinux) Il sistema della guida per l'applicazione di trasferimento dei file non è automaticamente disponibile su Linux -------------------------------------------------------------------------- Se la Guida nella GUI non è disponibile, viene visualizzato un errore quando viene avviata l'applicazione di trasferimento dei file. È possibile trovare i file della guida html in /opt/mqm/eclipse/fta-help/plugins/com.ibm.mq.fta.doc_7.0.1.0/doc.zip I gestori code a istanza multipla non sono supportati su IBMi -------------------------------------------------------- I gestori code a istanza multipla sono stati introdotti con WebSphere MQ versione 7.0.1. L'IBM Knowledge Center indica che sono disponibili su tutte le piattaforme eccetto z/OS. Tuttavia, non sono disponibili su IBMi (in precedenza i5/OS). Il componente "Servizi Web e di messaggistica Java" adesso include XMS ------------------------------------------------------------ Su Windows, il componente in precedenza denominato "Servizi Web e di messaggistica Java" adesso è denominato "Servizi Web e di messaggistica Java e .NET". Come parte dei file aggiuntivi di questa modifica vengono installati insieme a questo componente per consentire l'utilizzo di Message Service Client per .NET, noto anche come XMS. Se si aggiorna un'installazione solo di Java verrà anche installato Message Service Client per .NET. Per ulteriori informazioni sulla messaggistica XMS, consultare l'IBM Knowledge Center. Semplificazione delle autorità di pubblicazione/sottoscrizione ----------------------------------------------- Le autorità determinate all'inizio della struttura dell'argomento sono state semplificate. Se le autorità sono definite sugli oggetti dell'argomento SYSTEM.BROKER.DEFAULT.STREAM o SYSTEM.BROKER.DEFAULT.SUBPOINT (e questi oggetti dell'argomento dispongono ancora di stringhe di argomento vuote), tali autorità non avranno più effetto. Per applicare le autorità dell'argomento all'inizio della struttura dell'argomento, è necessario applicare le autorità all'oggetto SYSTEM.BASE.TOPIC. Utilizzo di HP Hotspot JVM --------------------- Se si utilizza un HP Hotspot JVM, impostare la proprietà di sistema Java -XX:+UseGetTimeOfDay. Se non si imposta questa proprietà, l'applicazione potrebbe non rilevare le modifiche dell'ora del sistema. Assembly XMS lasciati in Global Assemblies Cache dopo la disinstallazione -------------------------------------------------------------- Su Windows, la disinstallazione di WebSphere MQ dopo l'installazione di WebSphere MQ7.0.1 tramite il fix pack potrebbe lasciare alcuni assembly (IBM.XMS.*.dll) in GAC (Global Assembly Cache) di .NET. Questo si verifica se il framework .NET è disponibile sulla macchina e la funzionalità "Servizi Web e di messaggistica Java" è stata selezionata nell'installazione originale di WebSphere MQ v7 (selezionata per impostazione predefinita). È possibile impedire questo comportamento eseguendo il rollback del pacchetto di aggiornamento di WebSphere MQ v 7.0.1 o eseguendo "amqiRegsiterdotNet.cmd /u" (disponibile nella directory "\bin") prima di disinstallare WebSphere MQ. PROBLEMI DI MIGRAZIONE PER LA VERSIONE 7.0.1 ================================== Migrazione da WebSphere MQ versione 6.0.2.3 o precedenti su Windows ----------------------------------------------------------------- Quando si esegue la migrazione da WebSphere MQ versione 6.0.2.3 o precedenti alla versione 7.0.1, la directory "exits" viene svuotata. Solitamente è c:\Program Files\IBM\WebSphere MQ\exits oppure c:\Program Files\IBM\WebSphere MQ (x86)\exits, ma è possibile che l'installazione sia stata eseguita in una directory differente. Questo problema riguarda solo le installazione di Windows. Per correggerlo prima della migrazione, applicare la patch del servizio 6.0.2.4 o successiva all'installazione della versione 6. Consultare APAR IC48397 per i dettagli. Altrimenti, eseguire il backup della directory "exits" prima di avviare la migrazione. Migrazione da WebSphere MQ Versione 6 a WebSphere MQ Versione 7 su Windows -------------------------------------------------------------------------- Quando si esegue la migrazione di WebSphere MQ da v6 a v7, se un gestore code ha una proprietà di avvio impostata su Automatico, la proprietà verrà modificata in Interattivo (manuale) durante la migrazione. Per reimpostare la proprietà di avvio del gestore code su Automatico, utilizzare il seguente comando MQ: amqmdain auto QMgrName Migrazione da WebSphere MQ versione 6 precedente a CSD 6.0.2.3 -------------------------------------------------------------- La prima volta che viene avviato WebSphere MQ Explorer dopo la migrazione, è possibile che sia visualizzato il messaggio di errore AMQ4473 e che sia scritto un file FDC che indica che il file WMQ_Schemes.xml utilizzato per salvare gli schemi è in un formato non valido e che tutti gli schemi definiti dall'utente devono essere ricreati. Prima di CSD 6.0.2.3 gli schemi non venivano salvati correttamente. Se si utilizzano gli schemi, è possibile che si sia verificato questo problema e che sia stato eseguito l'aggiornamento a un livello di CSD successivo. Se non sono stati creati schemi e si sta utilizzando una versione precedente di WebSphere MQ, verrà visualizzato questo messaggio all'avvio di WebSphere MQ Explorer. Tuttavia, MQ Explorer prosegue, creando una nuova serie predefinita di schemi, pertanto non è necessario eseguire operazioni. Migrazione: salvare JMSAdmin.config ------------------------------- Salvare il file JMSAdmin.config (nella directory /java/bin) in un altro percorso prima di eseguire l'aggiornamento a WebSphere MQ v.7.0 altrimenti verrà sovrascritto. migmbbrk potrebbe non eseguire correttamente la migrazione di ACLS quando vengono utilizzati punti di sottoscrizione --------------------------------------------------------------------------- Lo strumento di migrazione dello stato di sottoscrizione/pubblicazione di WebSphere Message Broker potrebbe non eseguire correttamente la migrazione di ACLS quando vengono utilizzati punti di sottoscrizione. Si consideri il seguente scenario: 1. Un abbonamento a un broker di WebSphere Message Broker fa riferimento alla struttura di argomenti a/b/c. 2. Una pubblicazione a a/b/c utilizza un punto di sottoscrizione denominato SB1. 3. La stringa di argomento a/b dispone di un ACL che concede la pubblicazione dell'accesso a un utente, USER1. La migrazione al gestore code crea due oggetti di argomento e un comando setmqaut. Emula i punti di sottoscrizione creando un oggetto di argomento per SB1 con la stringa di argomento SB1/a/b/c. Crea anche un oggetto di argomento per a/b con un ACL concedendo di pubblicare l'accesso a USER1. Il comando setmqaut concede di pubblicare l'accesso a USER1 per l'argomento a/b. Come risultato della migrazione la struttura dell'argomento dispone di due rami, a/b e SB1/a/b/c. L'ACL è definito per il ramo a/b ma non per il ramo SB1/a/b/c. Pertanto, l'autorizzazione di pubblicazione accesso è concessa a USER1 su a/b, ma non è concessa a USER1 per la stringa di argomento SB1/a/b/c. Se la struttura dell'argomento include sia i punti di sottoscrizione che gli ACL definiti dall'utente, esaminare entrambi per vedere se gli ACL definiti nel broker e quindi migrati al gestore code devono essere replicati manualmente per le strutture dell'argomento che si trovano sotto ai punti di sottoscrizione. Altre modifiche ============= Aggiornamenti nel makefile di esempio XA --------------------------------- Il file xaswit.mak è stato aggiornato e ora contiene riferimenti aggiornati alle directory di installazione del prodotto database. Le directory predefinite utilizzate nel makefile di esempio sono state modificate per essere maggiormente aggiornate. Qualora fosse necessario compilare nuovamente un file di switch load e continuare ad utilizzare le vecchie versioni o directory di installazione del prodotto database, controllare e modificare il file xaswit.mak in modo che contenga le informazioni corrette per la macchina di destinazione. Compilare nuovamente il file di switch load soltanto se necessario. Sarà necessario compilare nuovamente un file di switch load SOLTANTO SE la directory di installazione del prodotto database viene modificata, ad es. dopo l'installazione di una nuova versione del prodotto database. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEZIONE 2 : COME OTTENERE E INSTALLARE QUESTO FIX PACK ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Release prodotto/componente: 7.0 Nome aggiornamento: WebSphere MQ fix pack 7.0.1.13 2.1 Percorso di download --------------------- Scaricare il fix pack dal seguente indirizzo: http://www.ibm.com/support/docview.wss?uid=swg21254675 2.2 Prerequisiti e corequisiti ---------------------------------- Prima di scaricare il fix pack, completare la seguente procedura: 1. Verificare che il sistema soddisfi tutti i requisiti di sistema indicati all'indirizzo: http://www.ibm.com/software/integration/wmq/requirements/index.html In questo modo si evitano problemi tecnici che potrebbero verificarsi dopo l'installazione e la configurazione del fix pack. 2. Verificare eventuali aggiornamenti flash e gli APAR (Authorized Problem Analysis Report) relativi a WebSphere MQ per UNIX(R) e Windows(R) sul sito Web dell'assistenza al prodotto: http://www.ibm.com/software/integration/wmq/support/ Gli APAR descrivono i difetti risolti in un fix pack. Per un elenco di APAR relativi a questo fix pack, consultare: http://www.ibm.com/support/docview.wss?uid=swg27014224 3. Assicurarsi di disporre di sufficiente spazio libero per scaricare ed estrarre il fix pack. È necessario disporre di 1 Gigabyte di spazio libero per il file compresso e l'immagine di installazione decompressa. 4. Assicurarsi di disporre dello spazio sufficiente per l'installazione del fix pack. È necessario che sia disponibile spazio libero nel percorso di installazione di WebSphere MQ che si sta aggiornando. Per determinare lo spazio utilizzato dai prodotti WebSphere MQ esistenti su piattaforme UNIX, eseguire il comando: du -k -s MQDIR dove MQDIR rappresenta il percorso in cui è installato il prodotto WebSphere MQ. 5. Se già è stato installato il prodotto WebSphere MQ v7 e sono state ottenute le relative correzioni speciali, contattare l'assistenza IBM(R) per determinare se è necessaria una versione aggiornata delle correzioni prima di installare il fix pack. Ciò consente di garantire la coerenza del proprio sistema e che non vengano perdute correzioni speciali. 2.3 Installazione -------------- Prima di procedere con l'installazione, visualizzare al seguente indirizzo la versione in linea del file readme per verificare se le informazioni sono state modificate da quando è stato scaricato il file readme: https://ibm.biz/mqreadmes 2.3.1 Operazioni precedenti all'installazione --------------------------- Prima di installare il fix pack, completare la seguente procedura: 1. Leggere interamente questo file readme. Soffermarsi in particolar modo sui passi aggiuntivi necessari nel caso in cui sia è stato installato il GSKit per poter utilizzare i canali SSL con WebSphere MQ. 2. Scaricare il fix pack in un percorso appropriato. 3. Decomprimere il fix pack. 4. Arrestare tutti i processi e le relative applicazioni di WebSphere MQ. 2.3.2 Download del fix pack in un percorso appropriato ------------------------------------------------------------- Il percorso di directory in cui si prevede di scaricare e decomprimere il fix pack, non deve contenere spazi. Se sono presenti spazi nel percorso, l'installazione non verrà completata. Ad esempio, assicurarsi che il percorso di directory sia simile al seguente: /home/WMQFixPack/FP1/ ... Non deve essere come il seguente: /home/WMQ FixPack/FP1/ ... 2.3.3 Decompressione delle immagini di installazione del fix pack ---------------------------------------------------- Tutte le immagini di installazione del fix pack presenti sul sito di download sono compresse in formato gz/Z/zip. Prima di poter applicare il fix pack da tale formato, copiare il file scaricato in una directory temporanea e utilizzare i programmi di utilità gunzip/uncompress e tar per estrarre l'immagine di installazione del fix pack. 2.3.4 Estrazione dei file di installazione del fix pack ---------------------------------------- Per estrarre i file di installazione del fix pack, completare la seguente procedura: 1. Copiare l'immagine compressa in formato gzip/Z in un percorso temporaneo. 2. Passare alla directory in cui è stata copiata l'immagine. 3. Di seguito sono riportati comandi di esempio per l'estrazione dell'immagine di installazione del fix pack: gunzip -c filename.tar.gz | tar -xvf - zcat filename.tar.Z | tar -xvf - unzip filename.zip dove filename.tar.gz etc. è il nome del file scaricato. 2.3.5 Arresto di tutti i processi di WebSphere MQ ----------------------------------------- È necessario verificare che tutti i processi di WebSphere MQ siano arrestati e che non vengano avviati automaticamente durante la procedura di installazione. Per arrestare tutti i processi WebSphere MQ, attenersi alla seguente procedura: 1. Accedere come utente del gruppo mqm. 2. Utilizzare il comando endmqm per arrestare tutti i gestori code attivi. 3. Arrestare tutti i listener associati ai gestori code mediante il comando: endmqlsr -m nomegestorecode 4. Per verificare che tutti i listener siano stati arrestati, immettere: ps -ef | grep mq Controllare che non siano elencati dei processi che eseguono righe comando che iniziano con amq o runmq. Ignorare tutti quelli che iniziano con amqi. 5. Eseguire tutte le ulteriori operazioni di gestione (con i privilegi root se necessario) per arrestare tutte le applicazioni che utilizzano i gestori code nel sistema e impedire che vengano riavviate automaticamente durante la procedura di installazione. 2.3.6 Installazione ------------------ Per ulteriori informazioni su come installare il fix pack, consultare la sezione Guida operativa appropriata delle informazioni sul prodotto WebSphere MQ: AIX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10720_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10790_.htm Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10860_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10780_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11230_.htm 2.4 Operazioni successive all'installazione --------------------- 2.4.1 Ulteriori informazioni sulle installazioni di GSKit e JRE ------------------------------------------------------------ Per informazioni sui livelli di GSKit e JRE inclusi con questo prodotto, consultare il seguente link: http://www.ibm.com/support/docview.wss?uid=swg27038676 Esecuzione delle attività necessarie dopo l'installazione ---------------------------------------------- Dopo aver installato questo fix pack, completare la seguente procedura: 1. Verificare l'installazione. Fare riferimento alla sezione Guida operativa della documentazione del prodotto WebSphere MQ per la piattaforma appropriata. 2. Riavviare i gestori code. Dopo aver applicato un fix pack, non è obbligatorio ricompilare le applicazioni. 2.4.2 Ulteriori informazioni sulle installazioni di GSKit, JDK, JRE e IA9H (client IBM Service per .NET) ------------------------------------------------------------------- Per informazioni sui livelli di GSKit e JRE inclusi con questo prodotto, consultare il seguente link: http://www.ibm.com/support/docview.wss?uid=swg27038676 2.4.3 Installazione di GSKit ----------------------- Per informazioni sull'installazione di GSKit, fare riferimento alla sezione Guida operativa della documentazione del prodotto WebSphere MQ per la piattaforma appropriata: AIX:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq20040_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10870_.htm Linux:http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10980_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10860_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq12150_.htm 2.4.4 Risoluzioni dei problemi di installazione disponibili sul sito dell'assistenza ------------------------------------------------- Prima di contattare IBM, si consiglia di consultare il sito Web all'indirizzo http://www.ibm.com/support/docview.wss?uid=swg21229861 in cui sono disponibili consigli specifici per la risoluzione dei problemi e la raccolta dati relativi a WebSphere MQ. 2.5 Disinstallazione ---------------- Per ulteriori informazioni su come rimuovere il fix pack, consultare la sezione Guida operativa appropriata della documentazione del prodotto WebSphere MQ: AIX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqaac.doc/aq10740_.htm HP-UX: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqcac.doc/hq10810_.htm Linux: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amq1ac.doc/lq10880_.htm Solaris: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqdac.doc/sq10800_.htm Windows: http://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.amqtac.doc/wq11270_.htm 2.6 Elenco di correzioni ----------------- Correzioni incluse in questo fix pack: http://www.ibm.com/support/docview.wss?uid=swg27014224 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEZIONE 3 : IBM MESSAGE SERVICE CLIENT FOR .NET V2.0.0.13 ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3.1 Modifiche in questa release --------------------------- Questa versione di XMS .NET è stata verificata per l'interazione con IBM WebSphere MQ 7.0.1.13. Inoltre, sono state applicate diverse soluzioni ai problemi evidenziati dai test e dai commenti dei clienti. Se Microsoft .NET Framework versione 4.0 è installato sulla macchina, potrebbe essere necessario creare o impostare la chiave di registro HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework nel seguente modo: "OnlyUseLatestCLR"=dword:00000001 3.2 Risoluzione dei problemi XMS .NET -------------------------------- a) L'autenticazione utente per WebSphere MQ viene eseguita utilizzando i dettagli dell'utente connesso e non le informazioni fornite nei campi XMSC.USERID e XMSC.PASSWORD. Questo è stato progettato per mantenere la coerenza con WebSphere MQ. Per ulteriori informazioni sull'autenticazione, consultare l'IBM Knowledge Center. b) Su una piattaforma Windows a 64 bit, l'impostazione o l'acquisizione di valori per il tipo di proprietà "doppio" che utilizza i metodi SetDoubleProperty() o GetDoubleProperty() potrebbe non funzionare correttamente, se i valori interessati sono inferiori rispetto a Double.Epsilon. Ad esempio, se si tenta di impostare un valore 4.9E-324 per una proprietà di tipo doppio, le piattaforme Windows a 64 bit lo considereranno come 0.0. Pertanto, in un ambiente di messaggistica distribuito, se un JMS o un'altra applicazione imposta il valore 4.9E-324 per una proprietà doppia su una qualsiasi macchina Unix o Windows a 32 bit, e XMS .NET è in esecuzione su una macchina a 64 bit, il valore restituito da GetDoubleProperty() è 0.0. Questo è un problema noto di Microsoft .NET 2.0 Framework. Per ulteriori dettagli, fare riferimento al seguente link: http://support.microsoft.com/kb/970495 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ++ ++ ++ SEZIONE 4 : COPYRIGHT, INFORMAZIONI PARTICOLARI E MARCHI ++ ++ ++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 4.1 Informazioni sul copyright e sui marchi --------------------------------------- http://www.ibm.com/legal/copytrade.shtml 4.2 Informazioni particolari ----------- L'INTERNATIONAL BUSINESS MACHINES CORPORATION FORNISCE QUESTA PUBBLICAZIONE NELLO STATO IN CUI SI TROVA SENZA ALCUNA GARANZIA, ESPLICITA O IMPLICITA, IVI INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITÀ ED IDONEITÀ AD UNO SCOPO PARTICOLARE. Alcune giurisdizioni non consentono la rinuncia a garanzie esplicite o implicite in determinate transazioni; quindi la presente dichiarazione potrebbe non essere a voi applicabile. Questa pubblicazione potrebbe contenere imprecisioni tecniche o errori tipografici. Le informazioni incluse in questo documento vengono modificate su base periodica; tali modifiche vengono incorporate nelle nuove edizioni della pubblicazione. IBM riserva il diritto di apportare miglioramenti e/o modifiche al prodotto o al programma descritto nel manuale in qualsiasi momento e senza preavviso. DISPOSIZIONI, INFORMAZIONI PARTICOLARI E INFORMAZIONI RELATIVE A LICENZE DI TERZE PARTI L'accordo di licenza per questo prodotto fa riferimento al presente documento per i dettagli relativi alle disposizioni applicabili al codice software di terze parti incluso in questo prodotto e per determinate informazioni particolari e altre informazioni IBM deve fornire all'utente in base a una propria licenza per determinato codice software. Le disposizioni, le istruzioni e le altre informazioni di pertinenza, sono fornite. Notare che qualsiasi versione non in inglese delle licenze non è ufficiale e viene fornita solo per consultazione. La versione inglese delle licenze, fornita come parte della versione inglese di questo file, è l'unica versione ufficiale. Nonostante le disposizioni di qualsiasi altro accordo stipulato con IBM o qualsiasi sua consociata o affiliata (collettivamente "IBM"), il codice software di terze parti identificato di seguito rappresenta le "Componenti Escluse" ed è soggetto alle seguenti disposizioni: * le Componenti Escluse sono fornite "NELLO STATO IN CUI SI TROVANO"; * IBM NON FORNISCE ALCUNA GARANZIA E CONDIZIONE ESPRESSA E IMPLICITA RELATIVA ALLE COMPONENTI ESCLUSE INCLUSE, A TITOLO ESEMPLIFICATIVO, GARANZIE DI FUNZIONAMENTO ININTERROTTO O SENZA INTERFERENZE E GARANZIE IMPLICITE E CONDIZIONI DI COMMERCIABILITÀ ED IDONEITÀ PER UNO SCOPO PARTICOLARE * IBM non sarà responsabile o indennizzerà l'utente per qualsiasi reclamo relativo alle Componenti Escluse * IBM non sarà responsabile per alcun danno diretto, indiretto, incidentale o consequenziale relativo alle Componenti Escluse. 4.3 Marchi -------------- I seguenti termini sono marchi di International Business Machines Corporation negli Stati Uniti, in altri paesi o entrambi: AIX FFST i5/OS IBM MQSeries SupportPac WebSphere z/OS Microsoft e Windows sono marchi di Microsoft Corporation negli Stati Uniti, in altri paesi o entrambi. Java e tutti i marchi e i logo Java sono marchi registrati di Oracle e/o di società affiliate. UNIX è un marchio registrato di The Open Group negli Stati Uniti e/o in altri paesi Linux è un marchio registrato di Linus Torvalds negli Stati Uniti, in altri paesi o entrambi. Nomi di altri prodotti, società e servizi possono essere marchi di altre società.