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

Cambia cronologia:
GA: 23 luglio 2004
Updated: 20 August 2004

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

Benvenuti in IBM WebSphere Business Integration Message Brokers Toolkit Versione 5.1. Questo file README contiene le informazioni che non sono ancora disponibili nel sistema di guida in linea. Viene applicata solo l'installazione di Message Brokers Toolkit Versione 5.1 in Microsoft^(R) Windows^(R) e l'utilizzo di WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versione 5.0.

AVVISO!
Installare Message Brokers Toolkit Versione 5.1 solo se è stato installato WebSphere Application Development Integration Edition (WSADIE) Versione 5.1. Non installare la Versione 5.1 se si dispone di un livello precedente di WSADIE; è 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.3 (Fix Pack 3).

Per informazioni su tutti gli altri componenti di WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versione 5.0, consultare il README Versione 5.0.

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

Informazioni fondamentali per tutti gli utenti
Si consiglia di visualizzare la versione aggiornata del file README. E' possibile rilevare la versione aggiornata di questo file README (solo in lingua inglese) all'indirizzo:
http://www.ibm.com/software/integration/mqfamily/support/readme/

Per completare l'installazione, consultare il file install.html.

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

Informazioni fondamentali nel caso di migrazione

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

E' 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.
• E' 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.

E' possibile condividere le risorse tra le versioni sui diversi sistemi:

• E' possibile distribuire i progetti sviluppati nella Versione 5.0 senza doverli modificare.
• E' 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
Il centro informativo autonomo per WebSphere Business Integration Message Broker e WebSphere Business Integration Event Broker Versione 5.0 è stato aggiornato per includere le modifiche richieste per Message Brokers Toolkit Versione 5.1 ed è disponibile per il download. E' possibile scaricare il file zip da: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip

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

Supporto
Mediante questo readme, sono presenti riferimenti per i numeri di errore. 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.
Per le informazioni correnti sui problemi noti e le correzioni disponibili, ricercare
http://www.ibm.com/software/integration/wbimessagebroker/support/
per WebSphere Business Integration Message Broker e
http://www.ibm.com/software/integration/wbieventbroker/support/
per WebSphere Business Integration Event Broker.

Aggiornamenti di funzioni
E' necessario controllare periodicamente gli aggiornamenti delle funzioni (inclusi gli aggiornamenti della documentazione).

Seguire tali passaggi:

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 firmate digitalmente. E' 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 WSADIE al livello supportato appropriato. La versione del workbench WSADIE che può essere estesa è WSADIE Versione 5.1 GA con "Interim Fix 002 - Correzioni generali 2.0.0".

E' anche necessario applicare la correzione "WebSphere Business Integration Message Broker v5.1.0 Interim Fix 001 - Correzioni di prerequisito 1.0.0.1" una volta installato WebSphere Business Integration Message Broker o WebSphere Business Integration Event Broker.

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

Coesistenza

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

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

Per le informazioni su come migrare le risorse e i dati dell'utente in Versione 5.1, consultare la sezione Migrazione del centro informativo in linea.

Installazione

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

In seguito all'installazione

1. Se è stato installato Message Brokers Toolkit Versione 5.1 e sostituita la Versione 5.0:
   1. Errore 34555
      E' 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 plug-in per Message Brokers Toolkit.
      
      E' possibile verificare che i livelli dei plug-in in uso siano corretti facendo clic su ? > About 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 presente 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 informativo è elevato.
   
   Soluzione: L'amministratore del sistema può configurare le impostazioni LAN in modo che sia possibile accedere ai i 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. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.