Updating EMS
The EMS installer does not currently offer an upgrade option. The install process removes any queues, topics, factories, or other configurations that have been applied to the EMS server and restores to the default configurations.
In order to backup and restore all your existing EMS queues, factories, topics, queue messages, topic messages and configuration use the following process:
| 1. | Stop your EMS applications. |
| 2. | Stop tibemsd and tibemsadmin. |
| 3. | Make a copy of all .conf files and .db files found under the ems/bin directory and its sub-directories. |
| 4. | Uninstall the old EMS version. |
| 5. | Install the new EMS version. |
| 6. | Replace your .conf files and .db files from step 3. |
For more detailed instructions on how to install and uninstall EMS, see TIBCO Enterprise Message Service Installation.
It is important that this configuration is maintained because iProcess features, such as IAPJMS, Technology Plug-ins, and Web Services Plug-in, rely on EMS queues and topics to function correctly.
IAPJMS Specific Procedure
With a basic iProcess Engine installation, EMS can be used by the IAPJMS process for activity publication.
After the upgrade IAPJMS will continue to function. IAPJMS uses client jar files found in the EMS install directory to connect to EMS. As long as the configuration is correct no other update should be needed.
TIBCO iProcess Web Services Plug-in Specific Procedure
TIBCO iProcess Web Services Plug-in can be configured to use EMS as the JMS provider. In this case an additional step is required after the EMS upgrade.
Update the tibjms.jar file stored under the SWDIR\jetty-6.1.1\jms\tibco directory to the new version supplied with the updated EMS server.
TIBCO iProcess Technology Plug-in Specific Procedure
The TIBCO iProcess Technology Plug-in uses EMS to communicate with the ActiveMatrix BusinessWorks Engine when iProcess Engine > BusinessWorks EAI steps are being defined. The following additional step is required after EMS has been updated:
Update the tibjms.jar file stored under the SWDIR\jmslib\ems directory to the new version supplied with the updated EMS server.