Benvenuti in IBM WebSphere Message Broker. Questo è il file readme per la Versione 6.1.0.3 dei componenti tooling e runtime.
Questo readme descrive i problemi noti e contiene aggiornamenti al livello disponibile di documentazione del prodotto.
Utilizzare sempre la versione più aggiornata di questo file readme,
disponibile (solo in lingua inglese) all'indirizzo:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
I file readme tradotti
sono disponibili all'indirizzo:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/
Per completare l'installazione, fare riferimento alla pubblicazione Guida per l'installazione di WebSphere Message Broker. Include le informazioni sulle attività da dover completare prima di installare il prodotto.
Se si sta applicando il servizio V6.1.0.3 al Message Broker Toolkit, fare riferimento alla Guida all'installazione per istruzioni volte a garantire il corretto completamento di questo processo.
Accedere alla guida all'installazione in linea nell'IBM Publications Center all'indirizzo:
http://publib.boulder.ibm.com/epubs/pdf/c3468662.pdf
Un documento che descrive specifici problemi di migrazione notificati mediante il Supporto IBM viene regolarmente aggiornato sul sito Web di supporto di WebSphere Message Broker all'indirizzo: http://www.ibm.com/software/integration/wbimessagebroker/support/. Fare clic su Troubleshoot > View all Troubleshooting documents e cercare un documento intitolato "Problems and solutions when migrating to WebSphere Message Broker 6.0 and 6.1".
Il centro informazioni autonomo per WebSphere Message Broker viene fornito nel CD della Guida di avvio rapido e può essere consultato anche online all'indirizzo: http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp
Inoltre, può essere scaricato all'indirizzo:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz (versione Linux®)
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip
(versione Windows®)
Leggere il file quickstart_welcome.html, incluso nel cartella ibm_help all'interno dei file wmb_help_linux.tgz e wmb_help_win.zip.
Gli argomenti contenuti nel file pdf
(Portable Document Format) sono disponibili all'indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/library/
Difetti: questo file readme contiene riferimenti ai numeri di difetto. Tali numeri si riferiscono ai numeri di problema IBM interni; è possibile che questi numeri siano utili durante la discussione dei problemi con l'assistenza tecnica IBM.
Note tecniche: per informazioni aggiornate
relative ai problemi noti ed alle correzioni disponibili, consultare il sito Web di supporto di WebSphere Message
Broker all'indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/support/
Per
trovare informazioni:
Vengono visualizzate tutte le relative note tecniche, che possono essere ordinate e in cui è possibile effettuare ulteriori ricerche.
Per informazioni sul download delle immagini di installazione di Message Broker Versione 6.1 dal sito Web Passport Advantage® consultare il documento di download Passport Advantage downloads for WebSphere Message Broker V6.1 disponibile all'indirizzo:
http://www.ibm.com/support/docview.wss?rs=849&uid=swg24017456
Versioni: Per aggiornamenti relativi a particolari
versioni di sistemi operativi e database supportati da
WebSphere Message Broker, consultare la pagina
System requirements all'indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Questa sezione indica le restrizioni e le limitazioni di WebSphere Message Broker, per componente.
Quando si crea il percorso di installazione, assicurarsi che la lunghezza del percorso non superi la lunghezza massima di caratteri consentita dal sistema di cui si dispone. Ad esempio, in Windows la lunghezza massima consentita è di 256 caratteri.
L'installazione di WebSphere Message Broker versione 6.1.0.2 o anteriore su Windows Vista o su Windows Server 2008 non funziona correttamente e crea elementi anomali nel file system e nel registro che potrebbero richiederne la rimozione manuale.
Soluzione:
Installare WebSphere Message Broker Fix Pack 3, che è supportato su Windows Vista e Windows Server 2008.
Se si decide di installare i componenti runtime in modalità non presidiata e viene generato un modello o registrato un file di risposte, gli esempi riportati nel Capitolo 7, "Scelta di un'interfaccia di installazione" della Guida per l'installazione non sono corretti. Per registrare un file di risposte, immettere:
installer
-options-record responsefile.
Per generare un modello, immettere
installer -options-template responsefile.
I comandi corrispondenti nella tabella 13 sono anch'essi non corretti; non si deve includere uno spazio tra -options e -record o -template.
Quando si utilizza la procedura guidata di estrazione di Windows per estrarre i file compressi di WebSphere Message Broker v6.1 scaricati dal sito Web Passport Advantage Xtreme Leverage, se si specifica un percorso di directory lungo in cui estrarre i file potrebbe essere visualizzato un messaggio di richiesta password.
Se viene estratto un file in una directory con un percorso lungo, la lunghezza del percorso potrebbe essere eccessiva e impedire alla procedura guidata di estrazione di Windows di eseguire l'elaborazione, e anziché ricevere un messaggio di errore viene visualizzato un messaggio di richiesta password. Ad esempio, "Password richiesta Il file 'DB2CS_NewCLRProcWizard...' è protetto da password. Immettere la password nella casella sottostante". Questo messaggio è errato e può ripetersi per molti file.
Soluzione:
Estrarre il file in un'ubicazione con un percorso di directory breve, come ad esempio C:\temp\dbimage.
Una volta distribuito un flusso di messaggi e aver avviato un broker, è possibile che appaiano i seguenti sintomi:
BIP2060W: Il broker ha rilevato che il Gruppo di
esecuzione <insert_1>, ID processo <insert_2>, si è chiuso.
BIP2227E:
È stato rilevato un errore durante un'elaborazione anomala: <insert_1> - chiusura.
Inoltre, il comando mqsistart potrebbe non avviare il broker e il syslog potrebbe contenere il seguente messaggio di errore:
BIP8893E:
Verifica non riuscita. Impossibile accedere al file '/var/mqsi/components/AIX53_BK/bipcvp_javaversion.tmp'
con ID utente <insert_2>.
Questi problemi possono verificarsi se il livello del fileset AIX V5.3 bos.rte.libc è inferiore a 5.3.0.52.
Soluzione:
Per risolvere questo problema, aggiornare il fileset bos.rte.libc a un livello minimo di 5.3.0.52. La Versione 5.3.0.52 è disponibile in AIX versione 5.3 TL05 SP2.
Quando si esegue la migrazione di un componente runtime dalla versione 5.0 o 6.0 alla versione 6.1 sullo stesso computer, aprire una nuova shell prima di eseguire mqsiprofile per impostare il proprio ambiente di comando.
La migrazione per z/OS richiede IC54505. IC54505 è incluso nel Fix Pack 2.
Nelle versioni 5.0 e 6.0, è possibile che sia presente una serie di messaggi contenente modelli non MRM e MRM con la proprietà Dominio messaggi impostata su un valore diverso da 'MRM' o 'IDOC' e che venga generato un file .dictionary quando la serie di messaggi viene aggiunta ad un file bar, indipendentemente dall'impostazione Dominio messaggi.
Nella versione 6.1, viene generato un dizionario soltanto se il Dominio messaggi è 'MRM' o 'IDOC'.
Soluzione:
Selezionare la casella di controllo MRM nella proprietà Domini di messaggi supportati della serie di messaggi.
Durante il tentativo di avvio di Toolkit, viene visualizzato un messaggio di errore del tipo "JVM terminated Exit Code = 1" o il processo javaw.exe utilizza il 100% della CPU e si arresta.
È possibile che il problema sia dovuto a -Xshareclasses:singleJVM, l'indicatore keep nel file eclipse.ini. Questo indicatore crea una cache che fornisce uno strumento per la condivisione di tutte le classi caricate e non pone restrizioni sui JVM che condividono i dati della classe. Se la cache si danneggia, nuove JVM non potranno connettersi alla cache, I JVM esistenti possono continuare a funzionare, ma non possono aggiornare la cache.
Soluzione:
Per risolvere il problema, eliminare la cache danneggiata. la cache verrà ricreata la volta successiva in cui il prodotto verrà avviato. Per eliminare la cache, completare la seguente procedura:
1. Aprire una richiesta comandi.
2. Spostarsi nella directory di Message Broker Toolkit/jdk/jre/bin
3. Immettere il seguente comando:
Su Microsoft Windows:
javaw.exe -Xshareclasses:destroy
Su Linux:
./javaw -Xshareclasses:destroy
Il prodotto adesso verrà avviato correttamente.
Se occorre aggiornare pacchetti che in origine sono stati installati utilizzando IBM Installation Manager, questi pacchetti devono essere anche aggiornarti con IBM Installation Manager. Sebbene sia possibile utilizzare il programma di gestione degli aggiornamenti Eclipse per installare plug-in non IBM, è importante non utilizzarlo per aggiornare funzioni Eclipse e plug-in che in origine sono stati installati utilizzando IBM Installation Manager. Quando si aggiungono plug-in utilizzando Eclipse Update Manager, assicurarsi di installarli nella directory di gruppi di pacchetti e non nella directory di risorse condivise (gestita da IBM Installation Manager e riservata).
Se sono stati installati più prodotti come parte di un gruppo di pacchetti, il pannello visualizzato durante l'avvio del programma (indicato talvolta anche come "schermata iniziale") si riferisce al prodotto del gruppo di pacchetti che è è stato installato per primo. Ad esempio, se si è installato Rational® Application Developer (RAD), poi WebSphere Message Broker e infine WebSphere Integration Developer (WID), il pannello di avvio di RAD viene visualizzato quando viene avviato uno qualsiasi di questi tre programmi.
La formattazione di un file WSDL o XSD in un certo modo potrebbe generare problemi nel progetto risultante al termine dell'importazione.
Sintomi:
1. Uno o più elementi nel file WSDL o XSD originale mancano dal file di definizione dei messaggi che viene creato quando il file WSDL o XSD viene importato, il che provoca errori di convalida del runtime.
2. Nella fase di sviluppo, gli errori vengono visualizzati quando una risorsa 'WSDL distribuibile' viene convalidata. Esempio di errore; "Una serie di messaggi non può contenere due dichiarazioni di elementi globali con lo stesso nome e spazi nomi (di destinazione o chameleon)".
Soluzione:
In caso di risultati imprevisti al termine dell'importazione delle risorse WSDL o di schema in una serie di messaggi, cancellare o formattare il file. Per cancellare o formattare il file, procedere come segue:
1. Copiare il file WSDL o XSD nello spazio di lavoro. Non importare il file nello spazio di lavoro.
2. Aprire il file WSDL o XSD nell'editor e fare clic su Formato > Documento sotto l'opzione Origine nel menu principale del workbench, oppure fare clic su Cancella documento.
3. Salvare il file modificato.
4. Importare il file modificato.
Il file adesso verrà importato correttamente.
Su Windows, le voci di menu "Avvio della guida" e "Arresto della guida" in Start->Programmi mancano.
Se si importano definizioni WSDL o XSD, è possibile che si rilevino degli errori nella validità del file per determinate codifiche di file, tra cui EBCDIC-CP-US. Per importare correttamente tali definizioni, aggiornare l'attributo di codifica all'interno del file XML con la codifica del sistema (ad esempio, UTF-8).
Windows .NET Server Web Services Security X509 non è supportato con WebSphere Message Broker Versione 6.1. Tutte le altre funzioni dei Servizi Web di WebSphere Message Broker con Windows .NET sono ancora completamente supportate, specificatamente i token USERNAME per Web Services Security.
L'utilizzo di allegati MTOM (Message Transmission Optimization Mechanism) superiori a 16 KB non è supportato.
Il nodo Collector può causare fini anomale che sono risolte in IC54505. IC54505 è incluso nel Fix Pack 2.
Quando si utilizza il parser XMLNSC per determinare la fine di un messaggio nei nodi di input e di ricezione TCP/IP, il parser XMLNSC trova la fine del messaggio solo se il successivo documento XML appare nel flusso dati, o se la fine del flusso dati viene visualizzato dal parser XMLNSC. Se non si verifica nessuna di queste due situazioni, viene visualizzata un'eccezione di timeout.
Per risolvere
questa condizione, impostare la proprietà di rilevamento record su Delimitato
e aggiungere un carattere nullo al flusso dati.
I nodi TCP/IP su Solaris x86-64 non elaborano dati e potrebbero rifiutare i collegamenti. Qualora si verifichino tali problemi, impostare rlim_fd_max e rlim_fd_cur su 8193 o su un valore inferiore.
I nodi JMS su z/OS non supportano le transazioni coordinate fino a IC54505. IC54505 è incluso nel Fix Pack 2.
I nodi EndpointLookup e RegistryLookup diWebSphere Message Broker V6.1 Fix Pack 1 possono essere utilizzati per accedere a metadati di servizio presenti su WSRR (WebSphere Service Registry and Repository) versione 6.0.2 o 6.1. Tuttavia, la nuova funzionalità introdotta in WSRR versione 6.1, ossia il riferimento a MQ Endpoints all'interno di WSDL e l'accesso ad elementi e oggetti modellati, non è attualmente supportata.
WebSphere Service Registry and Repository (WSRR) versione 6.1 è supportato. Versioni precedenti di WSRR non sono supportate.
Per eseguire la migrazione da MQ link per SAP R/3 a Message Broker V6.1 è necessario IC54505. IC54505 è incluso nel Fix Pack 2.
Le transazioni globalmente coordinate ('XA')JDBC/XA non sono supportate con le connessioni di database JDBC.
Le transazioni globalmente coordinate ('XA') non sono supportate.
Le procedure memorizzate non sono supportate.
La manipolazione di dati Unicode nei databases non è supportata.
Se sul proprio computer è installato WebSphere Message Broker 6.1.0.2 (o versione precedente) su HP-UX su PA-RISC, è necessario utilizzare DataDirect Connect (o DataDirect Connect64) for ODBC Drivers (DD) V5.0 per impostare le connessioni ODBC to databases. Gli argomenti del centro informazioni fanno riferimento a DD V5.3, che non è supportato su questa piattaforma.
Prima di iniziare a configurare una connessione ODBC per un database broker o un database utente, leggere la nota tecnica “Configuring database ODBC connections for WebSphere Message Broker V6.1 on HP-UX (PA-RISC platform)” sul sito: http://www.ibm.com/support/docview.wss?rs=0&context;=SSMKUK&uid=swg21305099. Questo documento fornisce informazioni dettagliate su come definire connessioni e configurare il coordinamento globale delle transazioni utilizzando i driver DD V5.0. Questa modifica non ha effetto su nessun'altra piattaforma.
Le transazioni globalmente coordinate ('XA') non sono supportate.
Se una procedura memorizzata DB2 Versione 9 con parametri di tipo 'REAL' viene eseguita mediante un database DB2 che si trova su un sistema z/OS, la chiamata ha esito negativo con errore DB2 "CLI0111E Valore numerico fuori gamma. SQLSTATE=22003".
Soluzione:
Installare le seguenti versioni minime di DB2:
Per DB2 V9.1: Fix Pack 6 con APAR IZ23102.
Per DB2 V9.5: Fix Pack 2 con APAR IZ23103.
Se in precedenza è stato creato un broker che utilizza un database Sybase come database del broker, e se si desidera eseguire l'aggiornamento a Message Broker V6.1.0.2, il broker e il database del broker potrebbero rilevare dei problemi quando viene avviato il broker.
Per ovviare a tale situazione, eseguire i comandi sottoindicati dopo aver eseguito la migrazione e prima di avviare il broker.
isql -Umqsiuid -Pmqsipw
Se è stato autorizzato un altro ID utente e un'altra password per l'accesso del broker
al database, sostituire i propri valori a mqsiuid e mqsipw in
quel comando.
use WBRKBKDB
Se il proprio database del broker è stato creato con un nome diverso, sostituire il nome del proprio database del broker a WBRKBKDB nel comando.
go
alter table BROKERAA
modify MsgId NOT NULL
modify ReplyToQ NOT NULL
go
alter table BROKERAAEG
modify MsgId NOT NULL
modify CntlMsgId NOT NULL
go
alter table BSUBSCRIPTIONS
modify Expiration NOT NULL
modify Creation NOT NULL
go
alter table BMQPSTOPOLOGY
modify Migrated NOT NULL
go
alter table BACLENTRIES
modify QopLevel NOT NULL
go
alter table BMULTICASTTOPICS
modify GroupAddress NOT NULL
go
alter table BAGGREGATE
modify ReplyGroupId NOT NULL
go
L'esempio non viene fornito fino a IC54505. IC54505 è incluso nel Fix Pack 2.
L'esempio non viene fornito fino a IC54505. IC54505 è incluso nel Fix Pack 2.
Tali informazioni sono state sviluppate per i prodotti ed i servizi offerti negli Stati Uniti d'America
È possibile che IBM non offra i prodotti, i servizi o le funzioni illustrate in questo documento in tutti i paesi. Consultare il rappresentante IBM locale per informazioni sui prodotti e sui servizi disponibili nel proprio paese. Qualsiasi riferimento a prodotti, programmi o servizi IBM contenuto in questo documento non significa che solo tali programmi, servizi o prodotti possano essere usati. In sostituzione a quelli forniti dall'IBM, possono essere usati prodotti, programmi o servizi funzionalmente equivalenti che non comportino violazione di diritti di proprietà intellettuale o di altri diritti dell'IBM. Valutazioni e verifiche operative in relazione ad altri prodotti, eccetto quelli espressamente previsti dall'IBM, sono di esclusiva responsabilità dell'utente.
L'IBM può avere brevetti o domande di brevetto in corso relativi a quanto trattato nella presente pubblicazione. La fornitura di questa pubblicazione non implica la concessione di alcuna licenza su di essi. Chi desiderasse ricevere informazioni o licenze, può rivolgersi a:
Per richieste di licenze relative ad informazioni DBCS (Double-Byte Character Set), contattare il Dipartimento di Proprietà Intellettuale IBM nel proprio paese o inviare richieste per iscritto a:
Il seguente paragrafo non è valido per il Regno Unito o qualsiasi altro paese in cui alcune disposizioni non sono congruenti con la legge locale:
L'INTERNATIONAL BUSINESS MACHINES CORPORATION FORNISCE QUESTA PUBBLICAZIONE "COSI' COM'È" SENZA ALCUN TIPO DI GARANZIA, SIA ESPRESSA CHE IMPLICITA, INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITÀ ED IDONEITÀ AD UNO SCOPO PARTICOLARE. Alcune giurisdizioni non escludono le garanzie implicite; di conseguenza la suddetta esclusione potrebbe, in questo caso, non essere applicabile.
Questo documento potrebbe contenere imprecisioni tecniche o errori tipografici. Le correzioni relative saranno incluse nelle nuove edizioni del documento. L'IBM si riserva il diritto di apportare miglioramenti e/o modifiche al prodotto o al programma descritto nel manuale in qualsiasi momento e senza preavviso.
Ciascun riferimento in questa pubblicazione a siti non IBM è fornito unicamente a scopo informativo e non a scopo pubblicitario di tali siti Web. Il materiale relativo a tali siti Web non fa parte del materiale fornito con questo prodotto IBM e l'utilizzo è a vostro rischio e pericolo.
La IBM potrebbe utilizzare o distribuire le informazioni appropriate senza incorrere in alcun obbligo verso l'utente.
Le licenze di questo programma dotato di informazioni sono valide per: (i) lo scambio delle informazioni tra i programmi creati indipendentemente e altri programmi (incluso il presente) e (ii) l'utilizzo comune delle informazioni, contattare:
È possibile che alcune informazioni siano disponibili, in base ai termini e alle condizioni appropriate, includendo in alcuni casi il pagamento di un costo.
Il programma concesso in licenza, descritto in questo documento e tutto il materiale concesso in licenza disponibile sono forniti dalla IBM nei termini dell'Accordo clienti IBM, Accordo di licenza di programmazione internazionale IBM o qualsiasi accordo equivalente.
Le informazioni relative ai prodotti non IBM sono state reperite dai fornitori di tali prodotti, annunci pubblicati e altre fonti disponibili. La IBM non ha verificato questi prodotti e non è in grado di confermare la precisione delle prestazioni, compatibilità o qualsiasi altro rilascio relativo ai prodotti non IBM. Le domande sulle funzioni di prodotti non IBM devono essere indirizzate ai fornitori di questi prodotti.
Tali informazioni includono gli esempi di dati ed i prospetti utilizzati nelle operazioni aziendali quotidiane. Per illustrarli in modo completo, gli esempi includono i nomi di individui, società, tipologie e prodotti. Tutti i nomi sono fittizi e qualsiasi somiglianza con i nomi e indirizzi utilizzati da una società attuale è casuale.
LICENZA SUL COPYRIGHT:
Tali informazioni contengono i programmi applicativi di esempio nella lingua di origine, che descrive le tecniche di programmazione su varie piatteforme operative. È possibile copiare, modificare e distribuire questi programmi di esempio in qualsiasi forma senza un pagamento alla IBM, per scopi di sviluppo, utilizzo, commerciali o di distribuzione dei programmi applicativi, compatibili all'interfaccia di programmazione applicativa per la piattaforma operativa per cui sono scritti i programmi di esempio. Questi esempi non sono stati verificati in tutte le condizioni. Quindi, la IBM, non può garantire o implicare affidabilità o il funzionamento di questi programmi. È possibile copiare, modificare e distribuire questi programmi applicativi in qualsiasi forma senza pagamento alla IBM per scopi di sviluppo, utilizzo, commerciale o di distribuzione dei programmi applicativi conformi alle interfacce di programmazione applicativa della IBM.
I seguenti termini sono marchi della International
Business Machines Corporation negli Stati Uniti e/o in altri paesi:
AIX, DB2, developerWorks,
IBM, Passport Advantage, Rational, WebSphere, z/OS.
Java e tutti i marchi basati su Java sono marchi della Sun
Microsystems, Inc. negli Stati Uniti e/o in altri paesi.
Microsoft e Windows sono marchi della Microsoft
Corporation negli Stati Uniti e/o in altri paesi.
UNIX è un marchio della The Open Group negli Stati Uniti
e/o in altri paesi.
Linux è un marchio della Linus Torvalds negli Stati Uniti e/o in altri paesi.
Altri nomi di servizio, prodotto e società sono marchi di altri.
Fix Pack DB2
È possibile ottenere i Fix Pack DB2 da CD oppure scaricandoli dal
Web. Si noti, tuttavia, che le dimensioni dei Fix Pack potrebbero essere
elevate, per cui la richiesta delle versioni
in CD evita tempi di scaricamento prolungati.
Se si dispone di un contratto di assistenza corrente, è possibile ordinare i
Fix Pack DB2 su CD rivolgendosi all'assistenza
DB2.
I dettagli di contatto sono forniti all'indirizzo:
http://www.ibm.com/software/data/db2/udb/support.html
È possibile scaricare anche dallo stesso sito Web.
Fix Pack WebSphere MQ
http://www.ibm.com/software/integration/wmq/support/
Fix Pack - WebSphere Message Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
Requisiti - WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Readme - WebSphere Message Broker
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Information center autonomo - WebSphere Message Broker
Per Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_linux.tgz
Per Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.1/wmb_help_win.zip
Centro informazioni
in linea di WebSphere Message Broker V6.1
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r1m0/index.jsp
Download nel centro IBM di sviluppo della tecnologia Java™
http://www.ibm.com/developerworks/java/jdk/
Specifica WSDL (Web Services Description Language)
http://www.w3.org/TR/wsdl
Area developerWorks® di WebSphere Message Broker
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html