Dieser Abschnitt enthält Hinweise zur Behebung von Problemen, die bei der Produktinstallation auftreten können.
In der folgenden Liste sind typische Probleme bei der Installation aufgeführt, und zwar jeweils mit einer Lösung oder Problemumgehung:
Anmerkung: Im Zusammenhang mit der Brokerkomponente stehen die Installationsprotokolldateien erst zur Verfügung, wenn Sie das Installationsprogramm verlassen haben.
Handhabung von während der Installation aufgetretenen Problemen
Brokerkomponente auf allen Betriebssystemen:
Szenario: Bei der Installation der Brokerkomponente treten Probleme auf.
Lösung: Gehen Sie folgendermaßen vor:
Wenn bei der Installation unter z/OS
Probleme auftreten, beachten Sie die Informationen im Programmverzeichnis
für WebSphere Message
Broker for
z/OS auf der
WebSphere Message Broker-Bibliothekswebseite.
Lesen Sie die Readme-Datei readme.html, in der Sie aktuelle Änderungen an den Installationsanweisungen finden.
Wenn Sie die Installationsmedien in das lokale oder das vernetzte Dateisystem
übertragen haben, wird möglicherweise eine Fehlernachricht ähnlich der folgenden angezeigt:
Die ausführbare Installationsdatei konnte die ihr zugeordnete gemeinsam
genutzte Datei nicht finden.
Stellen Sie sicher, dass Sie
Zugriffsberechtigungen zum Lesen und Ausführen auf alle Installationsverzeichnisse und
-dateien haben. Vergewissern Sie sich außerdem, dass die Länge des Pfads zu den
Installationsmedien den durch das Betriebssystem vorgegebenen Grenzwert nicht
überschreitet.
Bei erfolgreicher Installation gibt der Installationsassistent den Rückkehrcode null zurück. Wird ein anderer Rückkehrcode zurückgegeben, prüfen Sie, ob in der Installationsprotokolldatei Fehler und Erläuterungen angegeben sind. Probleme im Zusammenhang mit der Installation der Brokerkomponente werden in der Protokolldatei
'IBM_WebSphere_Message_Broker_InstallLog.log' aufgezeichnet, die im Installationsverzeichnis gespeichert ist.
Wenn Sie bei der Installation den Standardpfad übernommen haben, ist dies das folgende Verzeichnis. Das Standardverzeichnis enthält Version, Release, Modifikationsstufe und Fix-Level des installierten Produkts im Format v.r.m.f (version.release.modifikation.fix):
Linux
/opt/ibm/mqsi/v.r.m.f
UNIX
/opt/IBM/mqsi/v.r.m.f
Windows (32-Bit)
C:\Program Files\IBM\MQSI\v.r.m.f
Windows (64-Bit)
C:\Program
Files\IBM\MQSI\v.r.m.f (für die 64-Bit-Version von WebSphere Message
Broker)
C:\Programme(x86)\IBM\MQSI\v.r.m.f (für die 32-Bit-Version von WebSphere Message
Broker)
Diese Verzeichnisse stellen den Standardwert für Installationsverzeichnis auf den einzelnen Plattformen dar.
Wenn Sie das Problem nach wie vor nicht lösen können, wenden Sie sich an Ihr IBM® Support Center.
Der Installationsprozess bricht ab
Brokerkomponente auf allen Betriebssystemen:
Szenario: Die Installation der Brokerkomponente wird vor dem Abschluss unterbrochen.
Erklärung: Der Prozess wurde möglicherweise aufgrund eines Problems (beispielsweise Stromausfall) abgebrochen.
Lösung: Löschen Sie das Installationsverzeichnis und dessen gesamten Inhalt und starten Sie das Programm erneut.
java.lang.UnsatisfiedLinkError
Brokerkomponente unter Linux:
Szenario: Für die Installation unter Linux verwenden Sie die grafische Schnittstelle der Brokerkomponente, diese funktioniert jedoch nicht korrekt.
Erklärung: Die zusätzlich für die Installation erforderlichen Pakete sind nicht installiert.
Lösung: Sie müssen die zusätzlichen Pakete installieren, damit die Schnittstelle fehlerfrei arbeitet. Weitere Informationen zu den zusätzlich erforderlichen Paketen finden Sie im Abschnitt Betriebssystemvoraussetzungen.
Die RPM-Abfrage schlägt fehl
Brokerkomponente unter Linux:
Szenario: Nach der Produktinstallation starten Sie eine RPM-Abfrage (Red Hat Package Manager), es wird jedoch kein Ergebnis zurückgegeben. Möglicherweise wurde in der Installationsprotokolldatei eine ähnliche Informationsnachricht wie im folgenden Beispiel dokumentiert:
(01-Jun-2005 09:02:27), mqsi.Setup,
com.ibm.wizard.platform.linux.LinuxProductServiceImpl, wrn,
The installer could not successfully add the product information
into the RPM database. Installation will continue as this is not
critical to the installation of the product.
Erklärung: Wahrscheinlich verfügt Ihr System nicht über die erforderliche RPM-Unterstützung.
Szenario: Beim Versuch, die Brokerkomponente über die grafische Schnittstelle zu installieren erhalten Sie einen von zwei häufig auftretenden Fehlern.
Erklärung: Beide Fehler treten in der Regel auf, wenn Sie sich über Fernzugriff anmelden oder die Benutzer-ID wechseln.
Lösung: Beheben Sie den Fehler wie unten angegeben:
Can't open display localhost:1.0
Vergewissern Sie sich, dass die Variable DISPLAY auf den richtigen Wert gesetzt ist. Wenn Sie lokal angemeldet sind, lautet der Wert für gewöhnlich :0.0 oder localhost:0.0.
Connection to ":0.0" refused by server
Führen Sie folgenden Befehl aus, wobei user für die Benutzer-ID steht, mit der Sie angemeldet sind:
xauth merge ~user/.Xauthority
Wenn Sie diese Fehler nicht beheben können, wenden Sie sich an Ihren Systemadministrator.
Der temporäre Speicherplatz reicht nicht aus
Brokerkomponente unter Linux und UNIX:
Szenario: Bei der Installation der Brokerkomponente versucht das Installationsprogramm, Produktdateien im temporären Dateibereich des lokalen Systems zu entpacken. Auf Linux- und UNIX-Systemen befindet sich der temporäre Speicherplatz in der Regel im Verzeichnis /tmp.
Erklärung: Wenn der Dateibereich in diesem Verzeichnis nicht ausreicht, schlägt der Befehl unter Umständen grundlos fehl, ohne einen Kommentar zurückzugeben, oder er meldet, dass der Dateibereich nicht ausreicht.
Lösung: Legen Sie für die Umgebungsvariable
IATEMPDIR das zu verwendende temporäre Dateisystem fest. Geben Sie beispielsweise den folgenden Befehl ein:
export IATEMPDIR=/largetemp
Es darf kein temporäres Verzeichnis angegeben werden, das über NFS-Mount von einem anderen Server zugeordnet wurde; die Installation kann in diesem Fall fehlschlagen, da bei der Überprüfung der Benutzerberechtigungen durch das Installationsprogramm hin und wieder gemeldet wird, dass auf dem lokalen System die Sicherheitsprincipals mqm und mqbrkrs nicht vorhanden sind.
Oder geben Sie bei Verwendung von SUDO den folgenden Befehl ein:
Die Firewall-Software meldet einen Internetzugriff durch ein nicht erwartetes Programm
Brokerkomponente unter Windows (32-Bit) und Windows (64-Bit):
Szenario: Bei der Installation der Brokerkomponente meldet die Firewall-Software den versuchten Internetzugriff eines nicht erwarteten Programms. Es wird einer der folgenden Programmnamen angezeigt:
Erläuterung: Für die Installation der Brokerkomponente ist kein Internetzugriff erforderlich. Allerdings wird mit dieser Komponente auch eine aktualisierte Version der C-Laufzeitbibliothek von Microsoft installiert; dieses Programm versucht unter Umständen, eine Internetverbindung herzustellen, was zu einer Warnmeldung führen kann.
Lösung: Dieses Verhalten ist für normal; die Installation wird erfolgreich durchgeführt, unabhängig davon, ob Sie den Internetzugriff zulassen oder nicht.
Handhabung von während der Installation aufgetretenen Problemen
WebSphere Message
Broker Toolkit auf allen Betriebssystemen:
Szenario: Bei der Installation des WebSphere Message
Broker Toolkits treten Probleme auf.
Lösung: Gehen Sie folgendermaßen vor:
Lesen Sie die Readme-Datei readme.html, in der Sie aktuelle Änderungen an den Installationsanweisungen finden.
Bei erfolgreicher Installation gibt der Installationsassistent den Rückkehrcode null zurück. Wird ein anderer Rückkehrcode zurückgegeben, prüfen Sie, ob in der Installation Manager-Protokolldatei Fehler und Erläuterungen angegeben sind. Probleme im Zusammenhang mit der Installation des WebSphere Message
Broker Toolkits werden in der Installation Manager-Protokolldatei
JJJJMMTT_UHRZEIT.xml aufgezeichnet. Dabei ist YYYYMMDD_TIME Datum und Uhrzeit der Installation. Die Installation Manager-Protokolldatei wird in folgendem Pfad gespeichert:
Linux
/var/ibm/InstallationManager/logs
Windows
Auf Windows-Systemen wird das Verzeichnis im folgenden Standardpfad erstellt, das tatsächliche Verzeichnis auf Ihrem Computer kann aber ein anderes sein:
Dabei ist %ALLUSERSPROFILE% die Umgebungsvariable, die das Systemarbeitsverzeichnis definiert.
Das Standardverzeichnis hängt vom Betriebssystem ab:
Unter Windows XP und Windows Server 2003:
C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\Installation Manager\logs
Windows V7
und neuere Betriebssysteme:
C:\ProgramData\IBM\Installation
Manager\logs
Lässt sich das Problem immer noch nicht beheben, exportieren Sie die Informationen zum Installation Manager unter
Installation
Manager > Help menu > Export
Data for Problem Analysis (Installation Manager > Hilfemenü > Daten zur Fehleranalyse exportieren) und wenden Sie sich mit diesen Informationen an das IBM Support Center.
Handhabung von während der Installation aufgetretenen Problemen
WebSphere Message
Broker Explorer auf allen Betriebssystemen:
Szenario: Bei der Installation des WebSphere Message
Broker Explorers treten Probleme auf.
Lösung: Gehen Sie folgendermaßen vor:
Wenn Probleme bei der Installation unter z/OS auftreten, lesen Sie im Program Directory for WebSphere Message
Broker for z/OS nach.
Lesen Sie die Readme-Datei readme.html, in der Sie aktuelle Änderungen an den Installationsanweisungen finden.
Bei erfolgreicher Installation gibt der Installationsassistent den Rückkehrcode null zurück. Wird ein anderer Rückkehrcode zurückgegeben, prüfen Sie, ob in der Protokolldatei Fehler und Erläuterungen angegeben sind. Probleme im Zusammenhang mit der Installation des
WebSphere Message
Broker Explorers werden in der Protokolldatei
MBExplorer_install.log aufgezeichnet, die im Installationsverzeichnis gespeichert ist. Bei den Standardinstallationsverzeichnissen handelt es sich um folgende:
Linux
opt/IBM/MBExplorer
Windows
C:\Programme\IBM\MBExplorer
Installation Manager ist blockiert
Installation Manager unter Linux on x86 und Windows:
Szenario: Wenn Sie im Installation Manager bei dessen ersten Aufruf auf Weiter klicken, kann es vorkommen, dass der Installation Manager blockiert ist.
Lösung: Schließend Sie das Fenster und öffnen Sie es erneut.
Die WebSphere Message
Broker Toolkit-Komponenten werden nicht im Installation Manager angezeigt
Installation Manager unter Linux on x86 und Windows:
Szenario: Bei der Installation des WebSphere Message
Broker Toolkit sind die WebSphere Message
Broker Toolkit-Komponenten nicht in der vom Installation Manager angezeigten Seite für die Paketinstallation enthalten.
Erklärung: Die Web-Adresse bzw. das Verzeichnis des Update-Repositorys wurde nicht korrekt angegeben.
Lösung: Wählen Sie Datei > Einstellungen aus und klicken Sie auf Einstellungen hinzufügen. Geben Sie die Web-Adresse bzw. das Verzeichnis an, unter der bzw. in dem sich die Installationspakete befinden, oder klicken Sie auf Durchsuchen, um nach der Web-Adresse bzw. dem Verzeichnis zu suchen. Klicken Sie auf OK. Die Pakete werden auf der Seite mit den Installationspaketen aufgeführt.
Der Rückkehrcode des WebSphere Message
Broker-Launchpads weist auf eine fehlgeschlagene Installation hin
WebSphere Message
Broker-Launchpad unter Windows:
Szenario: Sie installieren Produkte über das WebSphere Message
Broker-Launchpad. Das Launchpad erwartet von jedem initialisierten Installationsassistenten einen Rückkehrcode, der Rückkehrcode weist jedoch auf eine fehlgeschlagene Installation hin. Das Launchpad meldet den Fehler und verweist Sie auf die Dokumentation zu dem fehlgeschlagenen Produkt.
Erläuterung: Die meisten Installationsassistenten führen ein Rollback vom Fehlerpunkt aus und versetzen das System wieder in den Zustand vor dem fehlgeschlagenen Versuch. Sie können den Vorgang somit nach Behebung des Fehlers wiederholen. In diesem Szenario wurde vor Auftreten des Fehlers allerdings bereits mindestens ein Produkt erfolgreich über das Launchpad installiert. Diese Installationen werden nicht rückgängig gemacht.
Wenn Sie das Launchpad erneut starten, reflektiert der Status der installierten Produkte die erfolgreichen Installation aus dem früheren Aufruf.
Lösung: Zur Behebung des Problems mit der fehlgeschlagenen Installation müssen Sie entweder den Fehler korrigieren und das Launchpad erneut starten oder auf
Aktualisieren klicken und die Auswahl des betreffenden Produkts zurücknehmen.
Gehen Sie wie folgt vor, falls sich das Produkt nicht installieren lässt:
Lesen Sie die Readme-Datei readme.html, in der Sie aktuelle Änderungen an den Installationsanweisungen finden.
Falls sich die Brokerkomponente nicht installieren lässt, prüfen Sie den Inhalt der Installationsprotokolldatei
'IBM_WebSphere_Message_Broker_InstallLog.log', die im Installationsverzeichnis gespeichert ist.
Wenn Sie bei der Installation den Standardpfad übernommen haben, ist dies das folgende Verzeichnis. Das Standardverzeichnis enthält Version, Release, Modifikationsstufe und Fix-Level des installierten Produkts im Format v.r.m.f (version.release.modifikation.fix):
Linux
/opt/ibm/mqsi/v.r.m.f
UNIX
/opt/IBM/mqsi/v.r.m.f
Windows (32-Bit)
C:\Program Files\IBM\MQSI\v.r.m.f
Windows (64-Bit)
C:\Program
Files\IBM\MQSI\v.r.m.f (für die 64-Bit-Version von WebSphere Message
Broker)
C:\Programme(x86)\IBM\MQSI\v.r.m.f (für die 32-Bit-Version von WebSphere Message
Broker)
Diese Verzeichnisse stellen den Standardwert für Installationsverzeichnis auf den einzelnen Plattformen dar.
Wenn das WebSphere Message
Broker Toolkit nicht installiert werden kann, überprüfen Sie den Inhalt der Installationsprotokolldatei YYYYMMDD_TIME.xml. Dabei steht YYYYMMDD_TIME für Tag und Zeitpunkt der Installation.
Wenn der WebSphere Message
Broker Explorer nicht installiert werden
kann, überprüfen Sie den Inhalt der Installationsprotokolldatei
MBExplorer_install.log. Die Protokolldatei ist im
Installationsverzeichnis gespeichert.
Falls WebSphere MQ nicht installiert werden kann, prüfen Sie den Inhalt der Datei
MQV7_install.Datum_Uhrzeit.log im Verzeichnis
temp Ihres Ausgangsverzeichnisses.
Wenn Sie das Problem nach wie vor nicht lösen können, wenden Sie sich an Ihr IBM Support Center.