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 back up and restore all your existing EMS queues, factories, topics, queue messages, topic messages, and configurations, 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.

Note 

If the new EMS is installed in a different folder to the old one (different versions have different default locations), then you will need to reconfigure the location of the EMS JAR files in $SWDIR/etc/iapjms_classpath.properties). See the entry:

classpath.basedir.EMS=/opt/tibco/ems/5.1/lib

TIBCO iProcess Technology Plug-in Specific Procedure

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.