IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit Versione 5.1

Cronologia delle modifiche:
GA: 23 luglio 2004
Aggiornato: 20 agosto 2004
Aggiornato: 20 ottobre 2004
Aggiornato: 17 dicembre 2004
Fix Pack 5: 09 febbraio 2005
Fix Pack 7: 06 febbraio 2006
Aggiornato: 24 febbraio 2006

(C) Copyright IBM Corporation 2004, 2006. Tutti i diritti riservati.

Benvenuti in IBM WebSphere Business Integration Message Brokers Toolkit Versione 5.1.

Questo file readme viene applicato solo all'installazione di Message Brokers Toolkit Versione 5.1 in Microsoft^(R) Windows^(R) ed il relativo utilizzo con WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versione 5.0. Questo file readme descrive i problemi noti e contiene gli aggiornamenti alla documentazione che non erano disponibili quando sono stati inclusi nel centro informazioni in linea. È anche necessario consultare il file readme di IBM WebSphere Business Integration Message Brokers Versione 5.0 o ulteriori informazioni sul prodotto.

AVVISO!
Installare Message Brokers Toolkit Versione 5.1 solo se è stato installato WebSphere Application Development Integration Edition Versione 5.1. Non installare la Versione 5.1 se si dispone di un livello precedente di WebSphere Studio Application Developer Integration Edition; è necessario utilizzare Message Brokers Toolkit Versione 5.0, fornito con WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versione 5.0. Message Brokers Toolkit Versione 5.1 dispone di una funzione identica a Message Brokers Toolkit Versione 5.0.

Installazione di Message Brokers Toolkit Versione 5.1 in un ambiente di team
WebSphere Studio Application Developer Integration Edition Versione 5.1 non è un prerequisito per ogni installazione di Message Brokers Toolkit Versione 5.1. Tuttavia, se almeno una delle installazioni di Message Broker Toolkit viene integrata con WebSphere Studio Application Developer Integration Edition Versione 5.1, tutte le installazioni di Message Broker Toolkit devono essere alla Versione 5.1 per garantire l'integrità e condivisione dei dati.

Se non si utilizza WebSphere Studio Application Developer Integration Edition Versione 5.1 o si utilizza WebSphere Studio Application Developer Integration Edition Versione 5.0, è necessario installare Message Brokers Toolkit Versione 5.0.

Compatibilità CVS
Message Brokers Toolkit Versione 5.1 si basa su Eclipse 2.1.2 e utilizza il plugin client CVS versione 2.1.1. Per questa versione, è necessario che il server CVS sia alla versione 1.11.6 o precedenti (solo Linux UNIX, CVSNT non è supportato).

Informazioni fondamentali per tutti gli utenti

Le versioni tradotte del file readme e del file install.html sono disponibili all'indirizzo: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

Le versioni tradotte del centro informazioni non sono incluse in questo pacchetto. Tutti i frammenti in lingua nazionale del centro informazioni sono vuoti e tutte le informazioni sono visualizzate in lingua inglese. Se si desidera visualizzare il centro informazioni in una lingua supportata, diversa da quella inglese, è necessario scaricare la funzione Eclipse appropriata una volta installato il fix pack. Le traduzioni sono rese disponibili in seguito alla disponibilità del fix pack. Per le istruzioni su come scaricare questi aggiornamenti, consultare gli Aggiornamenti della funzione.

Informazioni fondamentali in caso di migrazione

Se si sta eseguendo la migrazione, consultare il file install.html per le informazioni dettagliate delle azioni da dover intraprendere prima di effettuare l'installazione.

Se si desidera installare Message Brokers Toolkit Versione 5.1 su un sistema su cui è stato già installato Message Brokers Toolkit Versione 5.0, è necessario disinstallare prima il Toolkit Versione 5.0; le due versioni non possono coesistere.

Il centro informazioni fornisce ulteriori informazioni sulla migrazione; consultarlo prima di installare, scaricare una versione autonoma del centro informazioni (consultare la Documentazione per le istruzioni).

È necessario considerare le informazioni di utilizzo e migrazione:

• Quando si creano o si modificano i flussi di messaggio, la serie di messaggi e i mapping di messaggio nel toolkit della Versione 5.1, non è possibile accedere più a queste risorse di un toolkit della Versione 5.0. Verificare che tutti gli utenti che condividono i progetti in un ambiente di team considerano questa limitazione e creano le copie di backup se necessario.
• È necessario reperire una versione migrata di tutti i plug-in del nodo personalizzato dal fornitore prima di poter distribuire correttamente i flussi di messaggio contenuti.

È possibile condividere le risorse tra le versioni sui diversi sistemi:

• È possibile distribuire i progetti sviluppati nella Versione 5.0 senza doverli modificare.
• È possibile importare i file di archivio del broker creati in questa versione in un area di lavoro di Versione 5.0 e distribuirli correttamente.

Documentazione

È possibile accedere al centro informazioni in linea per WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker da: http://www.ibm.com/software/integration/wbimessagebroker/library/.

Esso è anche disponibile per il download, in formato file compresso, da: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/wbimb_help.zip

Consultare il file installing_and_managing.htm, incluso nel file wbimb_help.zip.

Supporto

Aggiornamenti di funzioni

1. Dal toolkit, selezionare ? > Aggiornamenti software > Nuovi aggiornamenti. Quindi, Eclipse ricerca gli aggiornamenti disponibili.
2. Eclipse visualizza gli aggiornamenti disponibili. Selezionare gli aggiornamenti che si desidera installare.
3. Una volta selezionati gli aggiornamenti da installare, viene ricevuta una nota di avviso in cui le funzioni non sono state contrassegnate da firme digitali. È possibile ignorare questa nota di avviso.
4. Una volta installate le funzioni, Eclipse richiede di riavviare il workbench.
5. Una volta riavviato il workbench, le nuove funzioni sono state installate e possono essere utilizzate.

Sommario

Restrizioni e limitazioni:

• WebSphere Studio Application Developer Integration Edition
• Coesistenza
• Installazione
• In seguito all'installazione

Informazioni particolari e marchi

Pagine Web utili

Restrizioni e limitazioni

Questa sezione descrive le restrizioni e le limitazioni di WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker in base al componente.

WebSphere Studio Application Developer Integration Edition

Per estendere il workbench WSADIE (WebSphere Studio Application Developer Integration Edition) con questo prodotto, è necessario aggiornare WebSphere Studio Application Developer Integration Edition al livello supportato appropriato. La versione del workbench di WebSphere Studio Application Developer Integration Edition che può essere estesa è WebSphere Studio Application Developer Integration Edition Versione 5.1 GA con "Interim Fix 002 - Correzioni generali 2.0.0". Le versioni precedenti di WebSphere Studio Application Developer Integration Edition 5.1 non sono supportate.

È anche necessario applicare la correzione "WebSphere Business Integration Message Broker v5.1.X Interim Fix 001" una volta installato WebSphere Business Integration Message Broker o WebSphere Business Integration Event Broker, dove X è il numero del fix pack applicato.

Per le istruzioni dettagliate, consultare il file install.html.

Coesistenza

• È possibile distribuire i progetti sviluppati nella Versione 5.0 senza doverli modificare.
• È possibile importare i file di archivio del broker creati in questa versione in un area di lavoro di Versione 5.0 e distribuirli correttamente.

Installazione

1. Errore 34320
   Durante l'installazione, se si sceglie di NON accettare l'Accordo di licenza viene visualizzata una finestra dotata di pulsati SI' e NO. Una volta selezionato, viene visualizzata la pagina Accordo di licenza. La selezione del pulsante SI' annulla l'installazione e la chiusura del Launchpad.

   Inoltre, se durante l'installazione si seleziona INDIETRO nella pagina Accordo di licenza, si verificano i diversi messaggi di errore JVM (Java^TM Virtual Machine) e si blocca Launchpad.

   Soluzione: Accettare l'Accordo di licenza se si desidera installare correttamente il prodotto.

2. Errore 37122
   Quando si utilizzano file di risposta per l'installazione non presidiata, essi possono contenere indicatori di impostazioni non corretti. Per risolvere tale problema, completare le azioni seguenti:
   • Creare un file di risposta, come riportato di seguito.
   • Impostare installLocation nella directory di installazione desiderata.
   • Impostare il componente da installare su true, come descritto nella riga dei commenti.

   Il seguente esempio installa lo strumento nel percorso C:\Program Files\IBM\WBIMB.

   ---start of response file---------
   
   -P installLocation="C:\Program Files\IBM\WBIMB"
   -W setupTypes.selectedSetupTypeId=custom
   
   ###############################################################################
   #
   # User Input Field - suiteFeatures
   #
   #
   
   #Do not change this - it sets the installer to ignore the standard custom setup route
   -W featureSelectionIB.active=false
   
   #Set a value to true to install that component
   # If any of the Broker, UNS or Config Manager parameters are set to true, 
   # the core value must also be set to true.  
   # Otherwise set this should be set to false to avoid installing most of the product.
   
   -W enableCore.value=true
   -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
   -W setCustomSuiteUNSFeatureTrue.propertyValue=false
   -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
   
   #Set to true if the Message Broker extension features are required.
   #The broker and core features must also be set to true to install this
   
   -W setCustomMessageTrue.value=false
   
   #Set to true if the tooling is required
   -W setCustomToolingTrue.value=true
   
   ------ end of response file----------
   

In seguito all'installazione

1. Se è stato installato Message Brokers Toolkit Versione 5.1 e sostituita la Versione 5.0:
   1. Errore 34555
      È necessario ricreare tutti i progetti definiti nell'area di lavoro.
   2. Errore 34930
      Se è presente INSTALL_PATH\eclipse\workspace\.metadata, è possibile che, una volta visualizzato Message Brokers Toolkit, Update Manager viene avviato correttamente, ma non vengono applicati gli aggiornamenti ai plug-in. Di conseguenza, Message Brokers Toolkit non viene aperto con i livelli di plug-in corretti e potrebbero verificarsi degli errori.
      
      Ad esempio, in Broker Application Development Perspective, è possibile rilevare che la voce di menu File di definizione dei messaggi non sia presente nell'elenco prodotto da File > Nuovo menu. Ciò indica che l'installazione non contiene il livello o la versione corretti dei plugin per Message Brokers Toolkit.
      
      È possibile verificare che i livelli dei plug-in in uso siano corretti facendo clic su ? > Informazioni su Message Brokers Toolkit per WebSphere Studio - Message Broker nella finestra Message Brokers Toolkit per WebSphere Studio. Sotto l'intestazione "Message Brokers Toolkit for WebSphere Studio", viene visualizzato un numero di versione. Se le versioni corrette dei plug-in sono in uso una volta installata la Versione 5.1, la versione visualizzata è 5.1.0. Se la versione visualizzata è inferiore alla seguente:
      1. Cancellare la directory .metadata.
      2. Aprire di nuovo Message Brokers Toolkit.
      3. Importare di nuovo i progetti esistenti nello spazio di lavoro facendo quanto segue per ciascun progetto:
         1. Fare clic su File > Importa.
         2. Quando viene visualizzata la procedura guidata di Importa, selezionare il Progetto esistente nello spazio di lavoro e fare clic su Avanti.
         3. Fare clic su Sfoglia e definire il percorso del progetto nello spazio di lavoro.
         4. Fare clic su Fine.
2. Errore 32898
   Se le impostazioni LAN non sono correttamente configurate per l'accesso all'host locale, probabilmente a causa di alcune impostazioni nello script di configurazione automatica, potrebbe verificarsi quanto segue:
   • Il browser per la guida visualizza una pagina vuota.
   • Il browser della guida visualizza un errore HTTP invece della pagina della guida.
   • Il tempo di caricamento del centro informazioni è elevato.
   
   Soluzione: l'amministratore del sistema può configurare le impostazioni LAN in modo che sia possibile accedere ai file della guida dal server locale, come segue:
   1. Nel Pannello di controllo, aprire Opzioni Internet, selezionare Connessioni e poi Impostazioni LAN.
   2. Se l'host è configurato per l'utilizzo di DHCP per l'assegnazione dell'IP, assicurarsi che la casella Rileva automaticamente impostazioni non sia selezionata.
   3. Se si utilizza un server proxy, assicurarsi che l'opzione Ignora server proxy per indirizzi locali sia selezionata.
   4. Nelle impostazioni avanzate per i proxy, aggiungere '127.0.0.1;localhost' alle eccezioni se tale indirizzo non è elencato.
   5. Se si utilizza uno script di configurazione automatica per le impostazioni del proxy e non si è sicuri che lo script sia corretto, annullare la selezione della casella Utilizza script di configurazione automatica.
   
   Se queste operazioni non risolvono il problema, modificare la porta e le proprietà dell'host in org.eclipse.tomcat\preferences.ini. L'impostazione host=localhost oppure host=127.0.0.1 dovrebbe risolvere il problema. Se si utilizza un firewall, potrebbe essere necessario impostare il valore port=80 (o un altro valore compatibile con il firewall).
3. Errore T32243
   L'estensione file mxsd non è associata correttamente all'editor di definizione messaggi. Per verificare che i file mxsd siano visualizzati nell'editor di definizione messaggi come azione predefinita, selezionare Finestra > Preferenze > Workbench > Associazioni file. Scorrere l'elenco dei tipi di file e selezionare *.mxsd. Quindi, selezionare Editor definizione di messaggi nell'elenco degli editor associati. Fare clic su Valore predefinito quindi su OK.
4. Errore 36638
   La sezione Preferenze dell'editor della serie di messaggi (ad15810_) descrive solo le opzioni disponibili nel toolkit di versione 5.0. Le opzioni della Versione 5.0 non sono disponibili per la Versione 5.1. Nel toolkit della versione 5.1, le opzioni sono:
   • Impostazioni dell'editor della serie di messaggio. Tali opzioni sono visualizzate ma non sono attive:
     • Raggruppa in base allo spazio nome e alle raccolte
     • Raggruppa in base alle raccolte e agli spazi nome
   • Impostazioni dell'editor della definizione di messaggio:
     • Visualizza tipi complessi di base
       Se è stato definito uno o più tipi complessi in base ad altri tipi complessi, selezionare questa opzione se si desidera visualizzare il contenuto di tali tipi complessi di base nelle viste di profilo e di panoramica dell'editor di definizione dei messaggi (viene selezionata per impostazione predefinita).
       Se non si desidera visualizzare, eliminare il segno di spunta.
5. Errore 36655
   Se si disinstalla il toolkit richiamando uninstaller.exe con l'opzione -silent, il programma di disinstallazione restituisce il controllo in modo immediato e viene eseguito come un'attività in background. Se non si desidera visualizzare il programma di disinstallazione una volta completata l'esecuzione, è necessario richiamare il programma di disinstallazione in java mediante questo comando:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   dove <install_dir> indica la directory in cui è stato installato il prodotto.
   Se non è stato configurato jvm (Versione 1.3.1 o superiore), è possibile utilizzare il jvm all'interno del prodotto installato nella directory <install_dir>\_sjvm\bin\. In tal caso, è necessario eliminare questa directory manualmente una volta completata la disinstallazione.
6. Errore 37671
   Importazione di copybook COBOL: quando si importa un copybook COBOL per creare un file di definizione della serie di messaggi, verificare che il copybook contenga almeno una struttura di livello 01. Se non è presente alcuna struttura di livello 01, nessun oggetto (elementi, gruppi, tipi) viene importato.
7. Le definizioni delle viste di database non sono supportate nell'editor ESQL. I riferimenti alle viste di database nel codice ESQL (invece degli schemi o delle tabelle) sono contrassegnati come avvertenze (riferimento non risolto) nell'editor ESQL. Queste avvertenze non impediscono la distribuzione dell'ESQL corrispondente.
   Queste avvertenze di riferimento non risolto possono anche essere visualizzate dopo la migrazione del flusso messaggi della Versione 2.1, in quanto l'editor ESQL 5.0 convalida i riferimenti del database.
   Solo i riferimenti alle tabelle del database e gli schemi sono supportati.
8. Limitazione della compilazione ESQL: se si crea un flusso secondario e si sceglie di distribuirlo come un progetto plug-in, le chiamate alle routine globali ESQL nel flusso secondario potrebbero non essere generate correttamente quando si aggiunge un flusso di messaggi che contiene un flusso secondario in un file BAR. Quando si distribuisce il file BAR, l'operazione avrà esito negativo.
   Soluzione: implementare una delle opzioni seguenti:
   • Includere tutte le routine a livello modulo con il flusso secondario.
   • Aggiungere tutti i flussi secondari all'area di lavoro e aggiornare il progetto che contiene il flusso di messaggi di chiamata per il riferimento al progetto del flusso secondario (o i progetti).

Informazioni particolari

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:

• Director of Commercial Relations
• IBM Europe
• Schoenaicher Str. 220
• D-7030 Boeblingen
• Deutschland

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'E'" SENZA ALCUN TIPO DI GARANZIA, SIA ESPRESSA CHE IMPLICITA, INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITA' ED IDONEITA' 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:

• IBM United Kingdom Laboratories,
• Mail Point 151,
• Hursley Park,
• Winchester,
• Hampshire,
• England
• SO21 2JN

È 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.

Marchi

I seguenti termini sono marchi della International Business Machines Corporation negli Stati Uniti e/o in altri paesi:

IBM WebSphere.

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.

Altri nomi di servizio, prodotto e società sono marchi di altri.

Pagine Web utili

Fixpack di WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006041

WebSphere Business Integration Message Broker - Requisiti di sistema
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

WebSphere Business Integration Event Broker - Requisiti di sistema
http://www.ibm.com/software/integration/wbieventbroker/requirements/

WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Install.html
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

File readme di WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006913

WebSphere Business Integration Message Broker Stand-alone Information Center
http://www.ibm.com/software/integration/wbimessagebroker/library/

WebSphere Business Integration Event Broker Stand-alone Information Center
http://www.ibm.com/software/integration/wbieventbroker/library/