This section describes issues related to the installation of Message Queue version 4.4 Update 1.
Message Queue 4.4, like Message Queue 4.2 and 4.1, is installed by a relatively new installer, which also installs and upgrades the Java Enterprise System (Java ES) shared components required by Message Queue; for example, JDK, NSS, JavaHelp, and so on.
The new Message Queue installer and the older Java ES installer, which was used to install previous Message Queue versions, do not share the same product registry. If a version of Message Queue that was installed with the Java ES installer is removed and then Message Queue 4.4 is subsequently installed by the Message Queue installer, the Java ES product registry might be in an inconsistent state. As a result, if the Java ES uninstaller is run, it may inadvertently remove Message Queue 4.4 and the shared components upon which it depends, even though it did not install them.
The best way to upgrade Message Queue software that was installed by the Java ES installer is as follows.
Use the Java ES uninstaller to remove Message Queue and its shared components.
Use the Message Queue installer to install Message Queue 4.4.
These issues affect installation on all platforms.
The Ready to Install screen displays the product name as “mq” rather than as Sun Java System Message Queue 4.3. (Bug 6650841)
When the Installer is in the process of installing Message Queue 4.3 and the Progress screen is displayed, the Cancel button is active. Selecting the Cancel button at this time results in incomplete or broken installs. (Bug 6595578)
The Installer Summary Screen contains a number of links that when clicked will launch a log or summary page viewer. If you dismiss this viewer window using the window close button “X” instead of the button labelled “Close', you will not be able to bring this viewer window back up. (Bug 6587138)
Workaround: Use the button labeled Close to close the window.
Running the installer in registration-only mode (installer -r) after performing a silent install in which registration was skipped, results in registration failing with "Premature end of file" error. (Bug 6767988)
When running the Message Queue installer on a computer with no JDK installed, the following error message is displayed: "Invalid root in registry key "HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion." (Bug 6764358)
Workaround: Install the JDK prior to running the installer.
The mqInstallHome directory is created by the Message Queue installer even before you click the Install button on the Ready To Install screen. (Bug 6595590)
When installing Message Queue on Windows, please note the following limitations.
The installed directory structure of Message Queue 4.3 on the Windows platform is different from that of previous releases. See Installed Directory Structure in Sun Java System Message Queue 4.3 Installation Guide.
The installer does not add entries for Message Queue to the Start>Programs menu. (Bug 6567258)
Workaround: To start the Administration Console use the command line as shown in Starting the Administration Console in Sun GlassFish Message Queue 4.4 Administration Guide.
The installer does not add the IMQ_HOME\mq\bin directory to the PATH environment variable.(Bug 6567197)
Workaround: Users need either to add this entry to their PATH environment variable or provide a full path name when invoking Message Queue utilities (IMQ_HOME\mq\bin\command).
The installer does not add entries to the Windows registry to indicate that Message Queue is installed. (Bug 6586389)
The installer does not add the Message Queue broker as a Windows service.
Workaround: Manually add the Message Queue broker as a Windows service using the imqsvcadm command.
If there is no JDK installed, the installer will throw the following error: “Invalid root in registry key HKLM\\SOFTWARE\\JavaSoft\\Java Runtime Environment\\CurrentVersion.” (Bug 6764358)\par
Workaround: If you see this error, install a JDK and proceed.
When run in silent mode with an answer file, the installer returns right away. The installation does happen; but the user has no way of knowing when the silent installation is actually done. (Bug 6586560)
The installer installs Message Queue on C:\ even if the operating system is installed on a different drive. (Bug 6673511)
For installation and uninstallation on Windows, there are no .bat files that the user can run, nor can user uninstall by using Add/Remove Programs in the Windows Control Panel. (Bug 6673417)
On Windows Vista, you cannot install Message Queue under C:\Program Files unless you install from a Command Prompt as Administrator. (Bug 6701661)
Workaround: To install from a Command Prompt as Administrator:
1. Start->Programs->Accessories->Command Prompt.
2. Right click on Command Prompt.
3. Select Run as Administrator.
4. Change directory to the Message Queue 4.2 install image.
5. Run installer.vbs.
When the uninstaller is run in dry run mode (uninstaller -n), it incorrectly performs an uninstall. (Bug 6719051)
Workaround: Perform a silent install using the following command:
uninstaller -s
The “Install Home” string on the installer Home page is not localized. (Bug 6592491)
Message Queue Zip-based uninstaller hangs on Windows 2003. (Bug 6764370)
Workaround: Manually remove the mqInstallHome directory.
When the installer is run in dry run mode (installer –n), the Summary Screen shows some error messages and also displays an install status of “Incomplete”. This is incorrect and misleading; a dry run does not install anything on the system; it only creates the answer file that can be subsequently used to perform a silent install. (Bug 6594351)
The installer does not perform Sun Connection registration when run in silent mode with an answer file (installer -a filename -s). (Bug 6710268)
When the installer is run in CCJK locales on OpenSolaris versions prior to 2009.06, CCJK characters display incorrectly. (Bug 6865540)
Workaround: Before running the installer, first install JDK 6 Update 12 or later.
The following issues affect installation on the Linux Platform:
On Red Hat Linux 5, the compat-libstdc++ library needed to run C client applications is not included in the Message Queue distribution and is therefore is not installed by the Message Queue installer. If you are developing and running C clients, you need to install this library manually.
Thecompat-libstdc++ rpm is usually found on the install medium of the Linux version you are using. It can be installed using the following command:
rpm -ivh compat-libstdc++-x-x.x.x.x..rpm
where x represents the version number.
To check that the library has been successfully installed, use the following command:
rpm -qa | grep compat-libstdc++
On Red Hat Linux 5, C clients can fail with a PR_LOAD_LIBRARY_ERROR error (Bug 6885978)
On Red Hat Linux 5, C clients can fail, displaying a message similar to:
"Preparing for NSS initialization ..." "Initializing NSS ..." "Could not connect to broker because 'PR_LOAD_LIBRARY_ERROR' (-5977)." producer(): Error: PR_LOAD_LIBRARY_ERROR |
This error arises because the NSS/NSPR libraries are not accessible.
To resolve this issue, set the LD_LIBRARY_PATH environment variable to include the path to the NSS/NSPR libraries, IMQ_HOME/nss/lib.
On the JDK Selection panel, the scroll list displays only one item. This makes it difficult to select other JDK's in the list. (Bug 6584735)
If the JDK is current and the user selects “Install default JDK” on the JDK Selection Screen, the installer still tries to install it and reports that it cannot install the package. Installation completes successfully despite this issue. (Bug 6581310)
If the currently installed JDK is a later version than JDK 1.5.0_15 (the version normally installed by the Message Queue installer), then the Message Queue uninstaller cannot find the default IMQ_JAVAHOME directory and returns an error. (Bug 6673415)
Workaround: Install JDK 1.5 manually as follows before running the Message Queue uninstaller.
# cd installImage/Product/UNIX/LINUX/X86/2.4/Packages
# rpm -i --force jdk-1.5.0_15–linux-arch.rpm
where arch is either i586 or amd64.
When the installer is run in dry run mode (installer –n), the Summary Screen shows some error messages and also displays an install status of “Incomplete”. This is incorrect and misleading; a dry run does not install anything on the system; it only creates the answer file that can be subsequently used to perform a silent install. (Bug 6594351)
The installer displays Message Queue version information in an opaque form. (Bug 6586507)
On the Solaris platform, refer to the following table to determine the Message Queue version displayed by the installer.
Table 1–13 Version String Translation
Version as Displayed by the Installer on Solaris OS |
Corresponding Message Queue Release |
---|---|
4.4.1.0 |
4.4 Update 1 |
4.4.0.0 |
4.4 |
4.3.0.0 |
4.3 |
4.2.0.0 |
4.2 |
4.1.0.2 |
4.1 Patch 2 |
4.1.0.1 |
4.1 Patch 1 |
4.1.0.0 |
4.1 |
3.7.2.1 |
3.7 UR2 Patch 1 |
3.7.0.2 |
3.7 UR2 |
3.7.0.1 |
3.7 UR1 |
3.6.0.0 |
3.6 |
3.6.0.4 |
3.6 SP4 |
3.6.0.3 |
3.6 SP3 |
3.6.0.2 |
3.6 SP2 |
3.6.0.1 |
3.6 SP1 |
For Patch releases to 3.6 SP4 (for example, 3.6 SP4 Patch 1), the releases string displayed by the installer stays the same. You need to run the command imqbrokerd -version to determine the exact version.
On the Linux platform, the version number displayed by the installer is in the following form.
majorReleaseNumber.minorReleaseNumber-someNumber
For example, 3.7–22. This tells us only that this is one of the 3.7 releases, but not which specific one. To determine the installed Message Queue version, run the command:
imqbrokerd -version.
The following issues relate to localization problems.
When the installer is run in text mode (installer –t), in a non-English locale, multi-byte characters show up as garbage. (Bug 6586923)
On the Installer Progress screen, the progress bar shows strange characters. The tooltip is hard coded in non-English locales. (Bug 6591632)
The License screen of the installer displays English license text no matter which locale the Installer is run in. (Bug 6592399)
Workaround: To access localized license files, look for at the LICENSE_MULTILANGUAGE.pdf file.
Installer usage help text is not localized. (Bug 6592493)
The string “None” that is seen on the Installer summary HTML page is hard coded in English. (Bug 6593089)
When the installer is run in a German locale, the Welcome screen does not show the complete text that is seen in other locales. (Bug 6592666)
The string “Install Home” seen on the Installer Install Home screen is not localized. It appears in English even when the installer is run in non-English locales. (Bug 6592491)
When the installer is run in text mode (installer –t), the English response choices “Yes” and “No” are used no matter what locale the installer is run in. (Bug 6593230)
The tooltip for the browse button on the Installer JDK Selection screen is hard coded in English. (Bug 6593085)