Installationsanweisungen für IBM^(R) WebSphere ^(R) Business Integration Message Brokers Toolkit for WebSphere Studio Version 5.1  

Änderungsprotokoll:
GA: 23. Juli 2004
Fixpack 5: 9. Februar 2005
Web-Update: Februar 2006

In dieser Datei sind Informationen enthalten, die Sie zur Installation von IBM WebSphere Business Integration Message Brokers Toolkit for WebSphere Studio Version 5.1 unter Microsoft^(R) Windows^(R) 2000 und Windows XP und zur Ausführung von Konfigurationsschritten nach der Installation benötigen.

Sie gelten nur für die Installation der Komponente Message Brokers Toolkit Version 5.1 und deren Verwendung mit WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0. Informationen zu allen anderen Komponenten finden Sie in der Readme-Datei (readme.html) und den Installationsanweisungen zu Version 5.0.

Die Datei 'readme.html' zu Version 5.0 ist verfügbar unter: http://www.ibm.com/software/integration/wbimessagebroker/support/ oder
http://www.ibm.com/software/integration/wbieventbroker/support/

Die Installationsanweisungen zu Version 5.0 sind verfügbar unter: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/

WARNUNG!
Installieren Sie Message Brokers Toolkit Version 5.1 nur, wenn auch WebSphere Studio Application Developer Integration Edition Version 5.1 installiert ist. Installieren Sie Version 5.1 nicht, wenn Sie über eine frühere Versionsstufe von WebSphere Studio Application Developer Integration Edition verfügen, für die Sie Message Brokers Toolkit Version 5.0 verwenden müssen. Message Brokers Toolkit Version 5.0 befindet sich im Lieferumfang von WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0.

Migration
Lesen Sie vor einer Migration den Abschnitt Vorbereitungen.

Message Brokers Toolkit Version 5.1 in einer Teamumgebung installieren
WebSphere Studio Application Developer Integration Edition Version 5.1 wird nicht für jede Installation von Message Brokers Toolkit Version 5.1 vorausgesetzt. Wenn aber mindestens eine Ihrer Message Broker Toolkit-Installationen in WebSphere Studio Application Developer Integration Edition Version 5.1 integriert ist, müssen alle Ihre Message Broker Toolkit-Installationen Version 5.1 aufweisen, um gemeinsame Datennutzung und Integrität zu gewährleisten.

Wenn Sie auf keinem System WebSphere Studio Application Developer Integration Edition Version 5.1 verwenden oder Sie mit WebSphere Studio Application Developer Integration Edition Version 5.0 arbeiten, müssen Sie Message Brokers Toolkit Version 5.0 installieren.

Dokumentation

Prüfen Sie in der neusten Online-Version dieser Installationsanweisungen nach, ob Sie über die aktuelle Version verfügen. Die neuste englische (USA) Version finden Sie unter folgender Adresse:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Landessprachliche Versionen werden zu gegebener Zeit auch unter dieser Adresse zur Verfügung stehen.

Eine Aktualisierung der Dokumentation wird im Februar 2006 nach der Bereitstellung von Fixpack 7 vorhanden sein. Die neue Versionsstufe der Dokumentation erhalten Sie, wenn Sie die entsprechende Eclipse-Komponente herunterladen. Eine englische (USA) Version ist bereits vorhanden; eine aktualisierte Eclipse-Komponente für landessprachliche Versionen wird zu gegebener Zeit herausgegeben werden. Anweisungen zum Herunterladen dieser Aktualisierungen finden Sie in der Readme-Datei.

Das eigenständige Information Center für WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker steht zum Herunterladen bereit. Es enthält Informationen für Version 5.0 und Version 5.1 des Toolkits. Die komprimierte Datei finden Sie unter:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/wbimb_help.zip

Lesen Sie die Datei 'installing_and_managing.htm'. Sie ist in der Datei 'wbimb_help.zip' enthalten.

Sie ist in amerikanischem Englisch sofort verfügbar. Landessprachliche Versionen werden zu gegebener Zeit unter derselben Adresse vorhanden sein.

Das Information Center ist ebenfalls online, aber nur in amerikanischem Englisch, verfügbar unter:
http://publib.boulder.ibm.com/infocenter/wbihelp/v6rxmx/index.jsp

Inhalt

• Unterstützte Betriebsumgebungen
• Vorbereitungen
• Installationsanweisungen
• Befehlszeilenoptionen für die Installation
• Fehlerbehebung bei der Installation
• WebSphere Studio Application Developer Integration Edition
• Anweisungen zur Deinstallation
• Installationsservice
• Bemerkungen und Marken

Unterstützte Betriebsumgebungen

Den neusten Stand der Informationen darüber, welche Versionen der verschiedenen Betriebssysteme von WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker unterstützt werden, finden Sie unter "Brokers V5" auf den Seiten mit den Systemvoraussetzungen. Rufen Sie dazu folgende Adresse auf:

http://www.ibm.com/software/integration/wbimessagebroker/requirements/ (für WebSphere Business Integration Message Broker)

http://www.ibm.com/software/integration/wbieventbroker/requirements/ (für WebSphere Business Integration Event Broker)

Message Brokers Toolkit Verison 5.1 wird in diesen Umgebungen unterstützt:

• Windows 2000 Server und Advanced Server mit Service-Pack 3 oder 4
• Windows 2000 Professional mit Service-Pack 3 oder 4
• Windows XP Professional mit Service-Pack 1

Das Toolkit wird nicht unter Windows 2003 unterstützt.

Zurück zum Seitenanfang^

Vorbereitungen

Vor der Installation von Message Brokers Toolkit Version 5.1 müssen Sie möglicherweise einige Schritte ausführen:

1. Wenn Sie Message Brokers Toolkit Version 5.1 als Teil einer Migration von Version 2.1 auf Version 5.0 installieren, finden Sie in dieser Datei nicht die benötigten Informationen. Dazu müssen Sie die Dateien 'readme.html' und 'install.html' von Message Brokers Version 5.0 heranziehen und auf Version 5.0 (Februar 2006) des eigenständigen Information Centers zugreifen. Dort finden Sie Details zu den Migrationstasks, die Sie vor der Installation von Version 5.0 ausführen müssen.
   • Laden Sie die Datei 'readme.html' der Version 5.0 (nur in amerikanischem Englisch) unter folgender Adresse herunter:
     http://www.ibm.com/software/integration/wbimessagebroker/support/ oder
     http://www.ibm.com/software/integration/wbieventbroker/support/
   • Laden Sie jeweils Version 5.0 der landessprachlichen Version der Datei 'readme.html' und der Installationsanweisungen unter folgender Adresse herunter:
     ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/

     Die Installationsanweisungen der Version 5.0 befinden sich auch auf der CD des Hauptprodukts. Sie sind in folgendem Verzeichnis zu finden: \installdocs\<locale>\install.html.

   • Laden Sie das eigenständige Information Center der Version 5.0 (Februar 2006) unter folgender Adresse herunter:
     ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/wbimb_help.zip

     Das Information Center der Version 5.0 (Februar 2006) enthält Informationen für das Toolkit der Version 5.1 und 5.0.

2. Führen Sie folgende Schritte aus, wenn Sie bereits über eine Message Brokers Version 5.0-Installation verfügen und das Toolkit von Version 5.0 auf Version 5.1 migrieren:
   1. Sichern Sie alle Plug-ins oder Komponenten von Fremdanbietern, die in Message Brokers Toolkit Version 5.0 installiert sind. Sie werden nämlich bei der Installation von Message Brokers Toolkit Version 5.1 entfernt.
   2. Sichern Sie Ihren Message Brokers Toolkit Version 5.0-Arbeitsbereich in einem anderen Verzeichnis.
      • Wenn Sie Message Brokers Toolkit Version 5.0 in der Befehlszeile mit der Option -data aufrufen, wird der Arbeitsbereich in dem Verzeichnis gespeichert, das Sie mit dieser Option angeben.
      • Wenn Sie Message Brokers Toolkit Version 5.0 in der Befehlszeile nicht mit der Option -data aufrufen, wird der Arbeitsbereich im Standardverzeichnis eclipse/workspace/ des Installationsverzeichnisses gespeichert.
   3. Deinstallieren Sie Message Brokers Toolkit Version 5.0. Der Installationsprozess wird nicht fortgesetzt, solange sich Message Brokers Toolkit Version 5.0 auf dem System befindet.
   4. Wenn Sie unter Beachtung der Installationsanweisungen Message Brokers Toolkit Version 5.1 installiert haben, stellen Sie Ihren Arbeitsbereich der Version 5.0 wieder her. Führen Sie einen der folgenden Schritte aus:
      • Kopieren Sie Ihren alten Arbeitsbereich aus dem Sicherungsverzeichnis in den Ordner eclipse/ Ihrer Message Brokers Toolkit Version 5.1-Installation.
      • Führen Sie Message Brokers Toolkit Version 5.1 über die Befehlszeile mit der Option -data, die auf das Sicherungsverzeichnis gesetzt ist, aus. Beispiel:
        mqsistudio.exe -data C:\Ihr_Pfad_zum_Arbeitsbereich
   5. Folgen Sie den Anleitungen des Online-Information Centers, um die Migration aller Plug-ins oder Komponenten von Fremdanbietern auszuführen.
3. Rufen Sie nach der Installation das Online-Information Center auf. Dort finden Sie weitere Informationen zur Migration.

Wenn Sie Message Brokers Toolkit Version 5.1 auf einem System ohne andere Message Brokers-Komponenten installieren, sind keine Aktionen erforderlich.

Zurück zum Seitenanfang^

Installationsanweisungen

Beim Einlegen der CD wird der Installationsassistent automatisch gestartet. Das Installationsprogramm kann auch gestartet werden, wenn Sie im Windows Explorer auf die Datei 'setup.exe' doppelklicken oder es über die Befehlszeile aufrufen.

In diesen Installationsanweisungen werden die Schritte beschrieben, die zur Installation von Message Brokers Toolkit Version 5.1 erforderlich sind.

Führen Sie das Installationsprogramm über die Befehlszeile aus, können Sie Optionen angeben, mit denen festgelegt wird, wie die Installation ausgeführt werden soll. Diese Optionen werden im Abschnitt Befehlszeilenoptionen für die Installation beschrieben.

Die Befehlssyntax ist wie folgt:
setup.exe [-Optionen-...]

Werden keine Optionen angegeben, startet der Installationsassistent im Standardmodus (GUI).

Zugeordnete Netzlaufwerke

Sie können das Netzlaufwerk der CD zuordnen, wenn es sich auf einem fernen System befindet. UNC-Pfade (\\server\drive) können für den Zugriff auf das Installationsprogramm nicht verwendet werden. Das Laufwerk MUSS zugeordnet werden, andernfalls überschreitet der Java^TM-Prozess das Zeitlimit. Wenn keine Zuordnung möglich ist oder gewünscht wird, kopieren Sie den CD-Inhalt auf ein lokales Laufwerk, und führen Sie die Installation von dort aus durch.

Installationsassistent

Diese Anweisungen beschreiben die Vorgehensweise beim Installations-Setup von Message Brokers Toolkit Version 5.1. Der Installationsassistent kann in drei verschiedenen Modi ausgeführt werden:

• Über die GUI-Schnittstelle (AWT)
• Über die Konsolenschnittstelle
• Im Befehlszeilenmodus

Vergewissern Sie sich zunächst, ob Sie über Administratorrechte verfügen.

GUI-Schnittstelle (AWT)

Die GUI-Schnittstelle ist der Standardmodus des Installationsassistenten, d. h., es werden keine Befehlszeilenoptionen verwendet.

Wenn Sie vor der Fortschrittsanzeige auf Abbrechen klicken, verlassen Sie die Installation und stellen den ursprünglichen Stand Ihres Systems wieder her. Wenn Sie den Installationsassistenten jedoch nach der Fortschrittsanzeige abbrechen, wird der frühere Stand Ihres Systems nicht wiederhergestellt. Informationen zur Entfernung von Message Brokers Toolkit finden Sie im Abschnitt Anweisungen zur Deinstallation.
Bei Verwendung des Assistenten müssen Sie nach Klicken auf Weiter > möglicherweise ein paar Sekunden bis zum Aufruf der nächsten Anzeige warten. Bei zweimaligem Klicken auf Weiter > überspringen Sie möglicherweise eine Anzeige. Durch Überwachen der CPU-Auslastung können Sie sicherstellen, dass die Installation fortschreitet: während der Installation steigt die CPU-Auslastung.

1. Führen Sie das Installationsprogramm aus.
2. Der InstallShield-Assistent wird initialisiert. Dies kann einige Minuten dauern.
3. Wählen Sie die gewünschte Sprache aus.  
4. Willkommen. In der ersten Anzeige wird das Produkt vorgestellt. Klicken Sie zum Fortfahren auf Weiter >.  
5. Warnung. Stellen Sie sicher, dass Sie mit der Installation dieser Toolkitversion fortfahren möchten. In dieser Anzeige finden Sie Informationen, die Ihnen bei dieser Entscheidung helfen. Klicken Sie zum Fortfahren auf Weiter >. Wenn Sie die Installation abbrechen möchten, klicken Sie auf Abbrechen.
6. Warnung. Bestätigen Sie die Sicherung von Daten und die Ausführung von Schritten zur Migration. Wählen Sie Ja aus, und klicken Sie zum Fortfahren auf Weiter >. Wenn Sie nicht bestätigen möchten, lassen Sie die Auswahl von Nein, und klicken Sie zum Abbrechen der Installation auf Abbrechen.
7. Ergänzung zur Softwarelizenz. Lesen Sie die Ergänzung, und klicken Sie zum Fortfahren auf Weiter >.
8. Installationspfad. Diese Anzeige wird nur dann eingeblendet, wenn noch keine Komponente von WebSphere Business Integration Message Broker oder WebSphere Business Integration Event Broker installiert ist. Das Standardverzeichnis lautet C:\Programme\IBM\WebSphere Business Integration Message Brokers. Sie können aber durch Klicken auf die Schaltfläche Durchsuchen ein anderes Verzeichnis auswählen. Klicken Sie zum Fortfahren auf Weiter >.  
9. Setuptyp. Diese Anzeige wird nur eingeblendet, wenn auf diesem System WebSphere Studio Application Developer Integration Edition installiert ist. Wählen Sie Standard aus, wenn das Toolkit nicht in WebSphere Studio Application Developer Integration Edition integriert werden soll. Wählen Sie Angepasst aus, wenn das Toolkit in WebSphere Studio Application Developer Integration Edition integriert werden soll. Klicken Sie zum Fortfahren auf Weiter >.
   Weitere Informationen zur Integration in WebSphere Studio Application Developer Integration Edition finden Sie unter WebSphere Studio Application Developer Integration Edition.
10. Integration in WebSphere Studio Application Developer Integration Edition. Diese Anzeige wird nur bei Auswahl einer angepassten Installation eingeblendet. Aktivieren Sie das Kontrollkästchen, um zu bestätigen, dass eine Integration erforderlich ist. Klicken Sie zum Fortfahren auf Weiter >.
11. Installationszusammenfassung. Die in den zuvor eingeblendeten Anzeigen ausgewählten Optionen werden hier aufgeführt. Außerdem wird der erforderliche Gesamtplattenspeicherplatz in MB und das Installationsverzeichnis des Toolkits angezeigt. Von hier aus können Sie zu früheren Anzeigen zurückkehren und Einstellungen ändern.
    Klicken Sie zum Installieren des Toolkits auf Weiter >.
12. Installationsfortschritt. Der Fortschritt der Änderungen auf dem Hostsystem in Prozent.  
13. Installation abgeschlossen. Die Installation wurde erfolgreich abgeschlossen. Klicken Sie auf Fertig stellen.

Konsolenschnittstelle

Der Konsolenmodus weist eine textbasierte Schnittstelle im Konsolenfenster auf. Geben Sie zu seinem Start folgenden Befehl in die Befehlszeile ein:

Dabei ist Pfad die aktuelle Speicherposition des Installationsprogramms. Beispiel:

startet das Windows-Installationsprogramm, das sich im Stammverzeichnis von Laufwerk E des aktuellen Konsolenfensters befindet.

Mit diesen Eingaben navigieren Sie durch die Installation:
1 - weiter zur nächsten Anzeige
2 - zurück zur vorherigen Anzeige
3 - Installationsprogramm abbrechen und beenden
4 - Neuanzeige der aktuellen Anzeige
Die Standardoption wird immer in eckigen Klammern angezeigt. Beispiel: [1]. Wenn dies die richte Auswahl ist, drücken Sie zum Fortfahren auf die Eingabetaste.

1. Sprache für den Assistenten auswählen. Es wird eine Liste mit zehn Sprachen mit jeweils einer Nummer daneben angezeigt. Geben Sie die Nummer Ihrer gewünschten Sprache ein. Die Liste wird erneut angezeigt. Links neben der gewählten Nummer wird ein X in Klammern angezeigt. Geben Sie nach Beendigung Ihrer Auswahl 0 ein.
2. Willkommen. Zeigt Produktinformationen wie Name, ID-Nummer und Website an. Geben Sie zum Aufruf der nächsten Anzeige 1 ein.
3. Warnung. Stellen Sie sicher, dass Sie mit der Installation dieser Toolkitversion fortfahren möchten. In dieser Anzeige finden Sie Informationen, die Ihnen bei dieser Entscheidung helfen. Geben Sie zum Aufruf der nächsten Anzeige 1 ein.
4. Warnung. Bestätigen Sie die Sicherung von Daten und die Ausführung von Schritten zur Migration. Geben Sie zum Aufruf der nächsten Anzeige 1 ein.
5. Ergänzung zur Softwarelizenz. Drücken Sie auf die Eingabetaste, um die Ergänzung anzuzeigen und zu lesen. Geben Sie zum Aufruf der nächsten Anzeige 1 ein.
6. Zielverzeichnis. Diese Anzeige wird nur dann eingeblendet, wenn noch keine Komponente von WebSphere Business Integration Message Broker oder WebSphere Business Integration Event Broker installiert ist. Das Standardverzeichnis lautet C:\Programme\IBM\WebSphere Business Integration Message Brokers. Sie können diese Einstellung durch Drücken der Eingabetaste übernehmen oder über die Eingabeaufforderung eine andere Speicherposition angeben. Geben Sie 4 ein. Die Anzeige wird mit Ihrem gewählten Zielverzeichnis aktualisiert. Geben Sie 1 ein, um zur nächsten Anzeige zu gelangen.
7. Setuptyp. Diese Anzeige wird nur eingeblendet, wenn WebSphere Studio Application Developer Integration Edition installiert ist. Wählen Sie Standard aus, wenn das Toolkit nicht in WebSphere Studio Application Developer Integration Edition integriert werden soll. Wählen Sie Angepasst aus, wenn das Toolkit in WebSphere Studio Application Developer Integration Edition integriert werden soll. Geben Sie 1 ein, um fortzufahren.
   Weitere Informationen zur Integration in WebSphere Studio Application Developer Integration Edition finden Sie im Abschnitt WebSphere Studio Application Developer Integration Edition.
8. Integration in WebSphere Studio Application Developer Integration Edition. Diese Anzeige wird nur bei Auswahl einer angepassten Installation eingeblendet. Wählen Sie Ja aus, um zu bestätigen, dass eine Integration erforderlich ist.
9. Installationszusammenfassung. Hier werden das Installationsverzeichnis des Produkts, eine Liste der zu installierenden Pakete und der erforderliche Gesamtplattenspeicherplatz in MB angezeigt. Von hier aus können Sie zu früheren Anzeigen zurückkehren und Einstellungen ändern, indem Sie 2 eingeben. Geben Sie zum Installieren des Produkts 1 ein.
10. Installationsfortschritt. Der Fortschritt der Änderungen auf dem Hostsystem wird in Prozent angegeben. Nach Erreichen von 100 % wird das Deinstallationsprogramm erstellt.
11. Installation abgeschlossen. Die Installation wurde erfolgreich abgeschlossen. Geben Sie 3 ein, um den Assistenten zu verlassen.

Befehlszeilenmodus

Eine Installation im Befehlszeilenmodus, eine unbeaufsichtigte Installation also, erfolgt entweder über eine Antwortdatei oder unter Verwendung der Standardeinstellungen des Installationsprogramms.

Beim Arbeiten mit den Standardeinstellungen im Installationsassistenten, die auf den im interaktiven Modus verfügbaren Optionen beruhen, erfolgt die Installation wie folgt:

• Installation im Standardverzeichnis
• Installation aller auswählbaren Komponenten

Bei Verwendung der Standardeinstellungen geben Sie in der Befehlszeile folgenden Befehl ein:

Dabei ist Pfad die aktuelle Speicherposition des Installationsprogramms. Beispiel:

startet das Windows-Installationsprogramm, das sich im Stammverzeichnis von Laufwerk E befindet.

Mit einer Antwortdatei können Sie die unbeaufsichtigte Installation steuern. Es gibt zwei Möglichkeiten, eine Antwortdatei zu generieren:

1. Führen Sie den Installationsassistenten bis zum Ende aus. Die generierte Antwortdatei ist eine Aufzeichnung der Eingaben, die während der Installation erfolgt sind. Die Befehlssyntax für diese Methode lautet wie folgt:

   Pfad setup.exe -options-record Antwortdatei

   Dabei steht Antwortdatei für den vollständigen Pfad und Namen Ihrer gewählten Antwortdatei. Es ist ratsam, sie in einem eigenen Verzeichnis außerhalb des Installationsverzeichnisses des Produkts zu erstellen.

2. Geben Sie zur Erstellung einer Antwortdatei als Schablone, die Sie mit benutzerdefinierten Optionen bearbeiten können, einen Befehl ein, ohne dabei den Installationsassistenten auszuführen. Die Befehlssyntax für diese Methode lautet wie folgt:

   Pfad setup.exe -options -template Antwortdatei

   Dabei steht Antwortdatei für den vollständigen Pfad und Namen Ihrer gewählten Antwortdatei. Die Schablonendatei enthält ausführliche Anweisungen zur Eingabe Ihrer benutzerdefinierten Optionen.

WARNUNG
Sie müssen an den Antwortdateien (generierte Dateien oder Schablonen) folgende Korrekturen vornehmen, wenn das Toolkit eine Verbindung zur Arbeitsumgebung von WebSphere Studio Application Developer Integration Edition herstellen soll.

1. Suchen Sie folgende Zeile, und entfernen Sie sie:
   -W linkChoice.YES_NO="<Wert>"
2. Fügen Sie folgenden Inhalt ein, wenn das Toolkit mit WebSphere Studio Application Developer Integration Edition verbunden werden soll:
   • Event Broker:
     -P evLinkComponent.active=true
   • Message Broker:
     -P evLinkComponent.active=true
     -P ibLinkComponent.active=true
3. Wenn das Toolkit nicht mit WebSphere Studio Application Developer Integration Edition verbunden werden soll, sind keine Änderungen erforderlich.

Bei der unbeaufsichtigten Installation müssen Sie eine Antwortdatei verwenden, wenn Sie dieses Toolkit in WebSphere Studio Application Developer Integration Edition integrieren möchten. Weitere Informationen finden Sie im Abschnitt WebSphere Studio Application Developer Integration Edition.

Befehlszeilenoptionen für die Installation

Über die Installationsargumente kann das Installationsprogramm in vier verschiedenen Modi ausgeführt werden: im GUI-Modus, im Konsolenmodus, im Eingabehilfemodus für Menschen mit eingeschränkter Sehkraft und im Befehlszeilenmodus. Über Installationsargumente können Sie auch angeben, dass eine Antwortdatei erstellt wird, die anschließend verwendet werden kann.

GUI-Modus (AWT)

Der GUI-Modus, auch als AWT (Abstract Window Toolkit) bezeichnet, ist der standardmäßige Installationsmodus, der ohne Angabe von Argumenten erfolgt. Geben Sie folgenden Befehl ein:

Dabei ist awt optional und nur erforderlich, wenn der GUI-Modus nicht der Standardinstallationsmodus ist.

Konsolenmodus

Wenn keine GUI verfügbar ist, wird in der Regel der Konsolenmodus verwendet. Er kann immer verwendet werden. Geben Sie folgenden Befehl ein:

Modus für Menschen mit eingeschränktem Sehvermögen

In diesem Modus erhalten Menschen mit eingeschränkter Sehkraft gesprochene Informationen; dieser Modus kann als alternative Befehlszeile für eine Ausführung im Konsolenmodus verwendet werden. Geben Sie folgenden Befehl ein:

Befehlszeilenmodus

Bei diesem Modus sind keine Benutzereingaben erforderlich. Dies ist nur der Fall, wenn eine Antwortdatei verwendet wird. Dieser Modus empfiehlt sich für automatisierte Installationen bei einer großen Anzahl identischer Systeme. Geben Sie folgenden Befehl ein:

Antwortdatei erstellen

Antwortdateien dienen dazu, Optionen, die während einer interaktiven GUI-Installation oder Konsoleninstallation festgelegt wurden, einer unbeaufsichtigten Installation zuzuführen. Um eine Installation im Konsolenmodus aufzuzeichnen, geben Sie in einer Befehlszeile den folgenden Befehl ein:

Dabei steht Antwortdatei für den vollständigen Pfad und Namen der Antwortdatei.

Geben Sie folgenden Befehl ein, um eine Antwortdatei in einer GUI-Installation aufzuzeichnen:

Dabei steht Antwortdatei für den vollständigen Pfad und Namen der Antwortdatei.

Eine Musterantwortdatei befindet sich im Verzeichnis sample-scripts des CD-Stammverzeichnisses für Images.

Antwortdatei verwenden

Vor Verwendung dieser Datei müssen Sie einen Fehler korrigieren. Details dazu finden Sie im Abschnitt Warnung zu den Installationsanweisungen von Befehlszeilenmodus.

Um die während einer Installation gespeicherten Eingaben für eine unbeaufsichtigte Installation zu verwenden, geben Sie in einer Befehlszeile den folgenden Befehl ein:

Dabei steht Antwortdatei für den vollständigen Pfad und Namen der Antwortdatei.

Antwortdateischablone generieren

Die Antwortdateischablone enthält keine voreingestellten Installationsoptionen und wird zur späteren Bearbeitung generiert. Diese Datei kann generiert werden, ohne dass die Installation bis zum Ende ausgeführt wird. Geben Sie dazu folgenden Befehl ein:

Dabei steht Antwortdatei für den vollständigen Pfad und Namen der Antwortdatei.

Installationsanweisungen

Fehlerbehebung bei der Installation

1. Szenario: Beim Starten oder Verwenden von Message Brokers Toolkit erhalten Sie folgende Nachricht: "The license cannot be found or has expired. The features that do not have the valid license will be disabled." (Die Lizenz wurde nicht gefunden oder ist abgelaufen. Die Komponenten ohne gültige Lizenz werden inaktiviert.)

   Lösung: Für Teile von Message Brokers Toolkit ist eine registrierte Lizenz erforderlich. In der Regel erfolgt die Lizenzierung automatisch, doch hier müssen Sie die Datei enroll.exe manuell ausführen. Verwenden Sie dazu einen der folgenden Befehle. Stellen Sie sicher, dass Ihr Systemdatum korrekt ist.

   • Führen Sie folgenden Befehl im Konfigurationsverzeichnis innerhalb des Produktverzeichnisses aus:
     enroll.exe -debug .\product.lic
   • Geben Sie für die Lizenzdatei einen vollständigen Pfad an. Beispiel:
     enroll.exe -debug "C:\Programme\IBM\Websphere Business Integration Message Brokers\config\product.lic"
2. Szenario: Das Programm zur unbeaufsichtigten Installation gibt auch dann einen Rückkehrcode von 0 aus, wenn die Installation fehlschlägt.

   Lösung: Sie müssen das Installationsprotokoll (mqsi5.log) nach jeder unbeaufsichtigten Installation auf Fehler überprüfen, um sicherzugehen, dass die Installation erfolgreich durchgeführt wurde.

   mqsi5.log ist die Installationsprotokolldatei. Die Standardposition lautet in der Regel: C:\Dokumente und Einstellungen\Anmeldenamen_Benutzer.

Nur Toolkit unter Windows installiert

Wenn nur das Toolkit auf einem Windows-System installiert ist, haben Sie möglicherweise Zugriffsprobleme, wenn Sie das Toolkit mit dem Konfigurationsmanager verbinden möchten. Der Grund dafür ist, dass einige Dateien, die zur Identifizierung der Domäneninformationen des Benutzers (zusätzlich zu den Benutzer-ID-Informationen) erforderlich sind, in diesem Szenario nicht installiert sind. Die Domäneninformationen werden nicht an den Konfigurationsmanager gesendet, und die Sicherheitsprüfung schlägt deswegen möglicherweise fehl.

Wählen Sie eine der folgenden Möglichkeiten, um das Problem zu umgehen:

1. Installieren Sie eine der Laufzeitkomponenten (Konfigurationsmanager, Benutzernamensserver oder Broker) sowie das Toolkit. Die Konfiguration der Komponente ist nicht erforderlich.
2. Kopieren Sie folgende Dateien vom Windows-System, auf dem eine oder mehrere Laufzeitkomponenten (Konfigurationsmanager, Benutzernamensserver oder Broker) installiert sind, auf das System, auf dem sich nur das Toolkit befindet:
   • bipicu.dll
   • bipicudata.dll
   • CommonServices.dll
   • LogonInfo.dll
   • Personality.dll

   Vergewissern Sie sich, dass sich die Dateien im definierten Pfad befinden.

Zurück zum Seitenanfang^

WebSphere Studio Application Developer Integration Edition

WARNUNG!

Wenn Sie eine WebSphere Studio Application Developer Integration Edition-Arbeitsumgebung mit diesem Produkt erweitern möchten, müssen Sie WebSphere Studio Application Developer Integration Edition Version 5.1 GA installieren; frühere Versionen werden nicht unterstützt.

Wenn die unterstützte GA-Version von WebSphere Studio Application Developer Integration Edition nicht installiert ist oder Sie sich über die Version nicht sicher sind, wenden Sie sich an Ihren IBM Ansprechpartner.

Sie müssen auch WebSphere Studio Application Developer Integration Edition auf die entsprechende unterstützte Version aktualisieren. Sie müssen "Interim Fix 002 - General Fixes 2.0.0" und "WebSphere Business Integration Message Broker v5.1.5 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" anwenden.

Nach Anwendung der Fixes für WebSphere Studio Application Developer Integration Edition müssen Sie folgende Tasks in der angegebenen Reihenfolge ausführen.

Sie müssen diese Fixes nach der Installation von WebSphere Business Integration Message Broker oder WebSphere Business Integration Event Broker anwenden. Außerdem müssen Sie die Installationsoption auswählen, um die Verbindung zu WebSphere Studio Application Developer Integration Edition zu aktivieren (siehe Installationsanweisungen).

1. Navigieren Sie in WebSphere Studio Application Developer Integration Edition zu Help > Software Updates > New Updates (Hilfe > Software-Updates > Neue Updates).
2. Wählen Sie "IBM WebSphere Studio Application Developer Integration Edition Interim Fix 002 - General Fixes" 2.0.0 aus. Klicken Sie auf Install Now (Jetzt installieren).
   Starten Sie danach die Arbeitsumgebung NICHT neu.
3. Wählen Sie Help > Software Updates > Update Manager (Hilfe > Software-Updates > Update-Manager) aus, um zur Ansicht für den Update-Manager zu wechseln.
4. Erweitern Sie unten links in der Ansicht für die Komponenten-Updates "Sites to Visit", "IBM WebSphere Studio Application Developer Integration Edition Discovery" ("Sites", "IBM WebSphere Studio Application Developer Integration Edition Discovery").
5. Wählen Sie "WebSphere Business Integration Message Broker Interim Fix 001 - Prerequisite Fixes 1.0.0.1" aus, und klicken Sie auf Install Now (Jetzt installieren).
6. Starten Sie die Arbeitsumgebung erneut.
7. Überprüfen Sie mit Hilfe der Konfigurationsdetails, ob die Installation erfolgreich war. Wählen Sie Help > About > Configuration Details (Hilfe > Info > Konfigurationsdetails) aus. Am Ende des Protokolls sollten sich keine neuen Warnungen (mit aktueller Zeitmarke) über Fehler beim Laden von Plug-ins befinden. Warnungen, die beim Start vor Anwendung des vorläufigen Fixes generiert wurden, sind möglicherweise vorhanden, können aber ignoriert werden.
8. Die Ansichten für Broker Administration und Broker Application Development sind nun in der Arbeitsumgebung von WebSphere Studio Application Developer Integration Edition verfügbar.

Weitere Informationen finden Sie auf der Download-Site für die WebSphere Studio Application Developer Integration Edition-Unterstützung. Die Adresse lautet: http://www.ibm.com/software/awdtools/studiointegration/support/

Anweisungen zur Deinstallation

Zur Entfernung von Message Brokers Toolkit Version 5.1 müssen Sie den Deinstallationsassistenten in Installationsverzeichnis\_uninst\studio\uninstaller.exe verwenden.

WARNUNG: Vor Ausführung des Deinstallationsassistenten müssen Sie alle aktiven Prozesse stoppen.

Deinstallationsassistent

In folgenden Anweisungen wird die Deinstallation von Message Brokers Toolkit Version 5.1 beschrieben. Wie der Installationsassistent kann der Deinstallationsassistent in drei verschiedenen Modi aufgerufen werden:

• Über die GUI-Schnittstelle (AWT)
• Über die Konsolenschnittstelle
• Im Befehlszeilenmodus

GUI-Schnittstelle (AWT)

Die GUI-Schnittstelle ist der Standardmodus des Deinstallationsassistenten, d. h., es werden keine Befehlszeilenoptionen verwendet.

Wenn Sie vor der Fortschrittsanzeige auf Abbrechen klicken, verlassen Sie die Deinstallation und stellen den ursprünglichen Stand Ihres Systems wieder her.

Sie können das Windows-Deinstallationsprogramm auch über Programme hinzufügen/entfernen starten. Beispiel: Start > Einstellungen > Systemsteuerung > Programme hinzufügen/entfernen.

1. Wählen Sie IBM Message Brokers Toolkit for WebSphere Studio Version 5.1 aus.
   Klicken Sie auf Ändern/Entfernen.
   Wählen Sie die zu verwendende Sprache für den Deinstallationsassistenten aus. Klicken Sie auf OK.

2. Willkommen. Zeigt Produktinformationen wie Name, ID-Nummer und Website an. Klicken Sie zum Fortfahren auf Weiter > .  
3. Warnung. Stellen Sie sicher, dass die WebSphere-Arbeitsumgebung von keinem anderen Produkt benötigt wird. Bestätigen Sie dies durch Auswahl von Ja, und klicken Sie zum Fortfahren auf Weiter >.
4. Zusammenfassung. Zeigt Details zu den deinstallierten Daten an: zum Produktverzeichnis und zu den zu entfernenden Komponenten. Klicken Sie zum Fortfahren auf Weiter >.
5. Deinstallationsfortschritt. Gibt an, dass die Deinstallation läuft.
6. Deinstallation abgeschlossen. Der Deinstallationsassistent wurde erfolgreich ausgeführt. Sie werden zu diesem Zeitpunkt gebeten, Ihr System erneut zu starten. Klicken Sie zum Schließen des Assistenten auf Fertig stellen.

Konsolenschnittstelle

Der Konsolenmodus ist eine textbasierte Schnittstelle im Konsolenfenster. Geben Sie zum Starten des Konsolenmodus von der Befehlszeile aus folgenden Befehl ein:

Dabei ist Pfad die aktuelle Speicherposition des Deinstallationsprogramms und Deinstallationsprogramm der Name des Programms. Beispiel:

1. Wählen Sie die vom Assistenten zu verwendende Sprache aus.  Es wird eine Liste mit zehn Sprachen mit jeweils einer Nummer daneben angezeigt. Geben Sie die Nummer Ihrer gewünschten Sprache ein. Die Liste wird erneut angezeigt. Links neben der gewählten Nummer wird ein X in Klammern angezeigt. Geben Sie nach Beendigung 0 ein.
2. Willkommen. Zeigt Produktinformationen wie Name, ID-Nummer und Website an. Geben Sie zum Aufruf der nächsten Anzeige 1 ein.
3. Deinstallationszusammenfassung. Hier werden der Produktname, die aktuelle Speicherposition und eine Liste der zu deinstallierenden Produktkomponenten angezeigt. Von hier aus können Sie zu früheren Anzeigen zurückgehen und Einstellungen ändern, indem Sie 2 eingeben. Geben Sie zum Deinstallieren des Produkts 1 ein.
4. Deinstallation des Produkts. Es wird eine Nachricht über die Deinstallation des Produkts angezeigt. Hier wird keine Fortschrittsanzeige eingeblendet.
5. Deinstallation abgeschlossen. Die Deinstallation wurde erfolgreich abgeschlossen. Geben Sie 3 ein, um den Assistenten zu verlassen.

Befehlszeilenmodus

Hier werden die Standardeinstellungen des Deinstallationsassistenten verwendet. Auf Grundlage der oben in den interaktiven Modi verfügbaren Optionen werden alle auswählbaren Komponenten mit diesen Einstellungen deinstalliert.

Geben Sie folgenden Befehl ein:

Dabei ist Pfad die aktuelle Speicherposition des Deinstallationsprogramms und Deinstallationsprogramm der Name des Programms. Beispiel:

Installationsverzeichnis\_uninst\studio\uninstaller.exe -silent 

Zurück zum Seitenanfang^

Installationsservice

Wartungsaktualisierungen können von einer Website in Form einer vorläufigen Programmkorrektur, auch Fixpack genannt, heruntergeladen werden. Fixpacks sind kumulativ, so dass Sie beispielsweise nicht Fixpack 1 vor Fixpack 2 installieren müssen. Der GA-Code muss aber zuerst installiert sein, um die Lizenzvoraussetzungen zu aktivieren.

Die neusten Informationen zu verfügbaren Fixpacks können Sie abrufen unter: http://www.ibm.com/software/integration/wbimessagebroker/support/ oder
http://www.ibm.com/software/integration/wbieventbroker/support/

Fixpacks für WebSphere Business Integration Message Brokers Toolkit werden mit derselben Technologie wie die GA-Version installiert. Produktdateien werden so durchgängig überwacht und entsprechend aktualisiert.

Einzelne Fixpacks können nicht ohne Deinstallation des gesamten Produkts entfernt werden. Deshalb ist es sehr zu empfehlen, eine Sicherungskopie des GA-Images und früherer Fixpacks aufzubewahren, falls Sie einmal nach dem Installationsservice auf Probleme stoßen. Wenn Sie auf einem System eine frühere Servicestufe wiederherstellen möchten, müssen Sie das gesamte Produkt deinstallieren, die GA-Version des Produkts neu installieren und anschließend die gewünschte Servicestufe des Fixpacks installieren.

Wenn Ihre vorhandene Installation vorläufige Fixes aufweist, müssen Sie sich an Ihren IBM Ansprechpartner wenden. Von ihm erhalten Sie Anweisungen und möglicherweise aktualisierte vorläufige Fixes für die Fixpackstufe, die Sie installieren möchten.

Hinweis: Wenn Sie ein Fixpack für Laufzeitkomponenten der Version 5.0 nach der Installation von Message Brokers Toolkit Version 5.1 installieren, wählen Sie die Standardinstallation aus, und inaktivieren Sie das Kontrollkästchen für die Komponente Message Brokers Toolkit. Die Tool-Fixes im Fixpack der Version 5.0 sind mit dem Toolkit der Version 5.1 nicht kompatibel. Inaktivieren Sie das Kontrollkästchen nicht, meldet das Installationsprogramm einen Fehler (da es keine Fixes der Version 5.0 auf eine Komponente der Version 5.1 installieren kann). Für alle anderen Komponenten kann es Fixes erfolgreich installieren.
(Achten Sie darauf, dass Sie bei der Konsoleninstallation oder unbeaufsichtigten Installation die vergleichbaren Optionen auswählen.)

Fixpack herunterladen

Sie können das neuste Fixpack herunterladen unter:
http://www.ibm.com/software/integration/wbimessagebroker/support/ oder
http://www.ibm.com/software/integration/wbieventbroker/support/

Klicken Sie auf "Recommended updates" (Empfohlene Updates), und folgen Sie dem Link zu WebSphere Business Integration Brokers V5. Klicken Sie bei dem erforderlichen Produkt auf den Link für das neuste Fixpack. Es wird eine Beschreibung des Fixpacks geöffnet.

Auf dieser Seite können Sie auf die Datei 'readme.html', auf in diesem Fixpack behobene Probleme (in Datei 'memo.ptf') und auf die Downloadpakete zugreifen.

Klicken Sie zum Herunterladen des Pakets auf den Link, und folgen Sie den Anweisungen auf der IBM Download-Website. Wählen Sie ein passendes Zielverzeichnis aus.

Fixpack installieren

Vergewissern Sie sich, dass die ID, unter der Sie angemeldet sind, zur Windows-Administratorengruppe in der lokalen Sicherheitsdomäne gehört. Es wird empfohlen, dieselbe ID wie bei der Installation von WebSphere Business Integration Message Brokers Toolkit zu verwenden.

Stellen Sie sicher, dass alle Prozesse von WebSphere Business Integration Event Broker oder WebSphere Business Integration Message Broker gestoppt werden. Sie müssen dazu folgende Tasks ausführen:

1. Stoppen Sie mit dem Befehl mqsistop die Ausführung des Konfigurationsmanagers, Benutzernamensservers und aller Broker auf diesem System. Oder stoppen Sie die Windows-Dienste für diese Komponenten über das Diensteprogramm in der Systemsteuerung.
2. Stoppen Sie die Ausführung aller Arbeitsumgebungsinstanzen.
3. Stellen Sie sicher, dass keine Dateien von WebSphere Business Integration Event Broker oder WebSphere Business Integration Message Broker offen sind.
4. Verlassen Sie alle Windows-Programme, bevor Sie Wartungsaktualisierungen für Message Brokers Toolkit anwenden.
5. Wechseln Sie in das Verzeichnis, in das Sie die Fixpackdatei (Unnnnnn.exe) heruntergeladen haben. Klicken Sie im Windows Explorer auf den Dateinamen, und wählen Sie Öffnen aus. Alternativ dazu können Sie auch folgenden Befehl eingeben:
   Fixpack_Startprogramm [-s] -a Installationsargumente

   Dabei ist Fixpack_Startprogramm der vollständige Pfad zur ausführbaren Datei des Fixpacks (wie etwa U200208.exe).
   -s ist optional und bedeutet, dass das Startprogramm des Fixpacks unbeaufsichtigt arbeitet. Wird dieses Argument weggelassen, wird eine Fortschrittsanzeige eingeblendet.
   -a bedeutet Lesen der folgenden Installationsargumente
   Installationsargumente bestimmen, wie das Installationsprogramm ausgeführt wird. Weitere Informationen dazu finden Sie im Abschnitt Befehlszeilenoptionen für die Installation.

   Nach erfolgreicher Extraktion wird das Installationsprogramm gemäß den gewählten Argumenten automatisch ausgeführt. Befolgen Sie die Anweisungen in der Installationsanzeige. Eine detaillierte Beschreibung der Installationsanzeigen finden Sie im Abschnitt Installationsanweisungen.

   Lesen Sie nach der Installation das plattformübergreifend gültige Memo, das sich im Readme-Verzeichnis befindet. Führen Sie die Tasks aus, die nach der Installation eventuell noch manuell ausgeführt werden müssen.