Kbase P17466: Is Progress 9.1D compatible with SonicMQ Adapter 9.1C?
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
07/11/2008 |
|
Status: Verified
GOAL:
Is Progress 9.1D compatible with SonicMQ Adapter 9.1C?
FACT(s) (Environment):
All Supported Operating Systems
Progress 9.1C
Progress 9.1D
FIX:
If you are unable to upgrade to SonicMQ 4.0,but would like to upgrade your Progress clients to 9.1D, you can do this by patching the 9.1C adapter. Due to the compatibility issues between SonicMQ 3.x and SonicMQ 4.0, you must use the Progress 9.1C adapter.
In order for Progress 9.1D clients to work with a
Progress 9.1C adapter, the 9.1C adapter must be patched. See the
instructions on patching the adapter below for more information.
Mixed Environment. If you are using SonicMQ 4.0, and want to
stage your upgrades, you can run in a mixed environment. In this
scenario, you keep your Progress 9.1C adapter running to service
Progress 9.1C clients, and install a Progress 9.1D adapter to service
Progress 9.1D clients. All the clients can communicate with the same
SonicMQ broker, they just use different adapters to do it. This
strategy is only applicable if you are using SonicMQ 4.0, since
Progress 9.1D is not compatible with previous versions of SonicMQ.
Heterogeneous environment. By installing Progress 9.1C client
and adapter patches, any Progress client can communicate with any
Progress adapter regardless of the version. See the instructions on
patching the client and adapter below.
Patching Progress 9.1C clients
------------------------------
The client code to access a Progress adapter is compiled 4GL code
that can be found in the $DLC/jms directory. The steps to patch a
Progress 9.1C client are:
1. Download the file mq4clientpatch.zip from
ftp://ftp.progress.com/pub/patches/sonic/mq4
2. Rename the $DLC/jms directory to jms-save.
3. Unzip the files in mq4clientpatch.zip into your $DLC directory.
This will create a new jms subdirectory with the patch .r code.
You are now able to use this client to talk to patched Progress 9.1C
and Progress 9.1D adapters.
Patching Progress 9.1C adapters
-------------------------------
The patched adapter code lives in a Java .jar file that must be
specified at the beginning of your Progress CLASSPATH. The steps to
patch the adapter are:
1. Download mq4adpatch.zip from
ftp://ftp.progress.com/pub/patches/sonic/mq4
2. Shut down your Progress adapters along with the Progress
Admin Server.
3. Copy mq4adpatch.jar to $DLC/java.
4. On Windows, modify your Progress CLASSPATH by:
a. Start the registry editor and find the registry key
HKEY_LOCAL_MACHINE\SOFTWARE\PSC\PROGRESS\9.1C\JAVA
b. Prepend the full path and filename for mq4adpatch.zip to
the PROGRESSCP key.
5. On Unix, modify your Progress CLASSPATH by:
a. Open $DLC/bin/java_env in a text editor
b. Prepend $DLC/java/mq4adpatch.zip where PROGRESSCP is set.
6. Restart the Admin Server and Adapter.