Before Installing ResponseMaster

  1. Your operating system is Linux (Red Hat or Ubuntu recommended). Other distributions are likely compatible — please let us know what you’re using.
  2. You have super user (root) access.
  3. You have the username and password for the mail server account where ResponseMaster will process emails. Note: ResponseMaster deletes each email from the mailbox after processing it.
  4. You’ve reviewed the ResponseMaster readme file.

Steps for Installing ResponseMaster

  1. Download the latest installation package from the home page. If you already have a previous version installed, choose the “Upgrade” package.
  2. If a version of ResponseMaster is currently running on the machine, stop it.
  3. Install the RPM package: rpm -i ResponseMaster-###-1.i386.rpm This installs ResponseMaster into /etc/ResponseMaster and places a control script in /etc/init.d. If you are upgrading, use: rpm -i --force ResponseMaster-###-1.i386.rpm
  4. Place your license file (obtained from support@extreme-messaging.com) in the config subdirectory.
  5. Ensure a supported Java Virtual Machine is installed on your system. If you don’t have one, download it from java.sun.com or Adoptium. See the current release notes for the supported Java version for your version of ResponseMaster.
  6. Edit the ResponseMaster configuration files. At a minimum, set up the mailbox parameters in config/master.xml. Refer to the ResponseMaster Configuration Guide for details.
  7. Review the /etc/init.d/ResponseMaster startup script. You may need to make minor changes to adapt it for your system.
  8. Start the ResponseMaster service: service ResponseMaster start
  9. Verify that ResponseMaster is running correctly by examining the log file in the output folder.
  10. If there are no error messages, installation is complete.
  11. If you encounter errors and need assistance, contact Extreme Messaging at support@extreme-messaging.com.

Adapting the Installation for Your Environment

Setting the JVM path: Edit /etc/init.d/ResponseMaster and update the JAVA_HOME variable to point to your JVM installation.

Changing the classpath: Edit /etc/init.d/ResponseMaster and modify the CLASSPATH variable to include any additional paths you need. If you are using the JMX monitoring features, include jmxri.jar and jmxtools.jar in your classpath. These jars are part of the JMX package, available at java.sun.com/products/JavaManagement.

Setting JVM system properties: Edit /etc/init.d/ResponseMaster and add your properties after the -outfile /etc/ResponseMaster/output/stdout.txt line. For example: -Dmyprop=myval

Running ResponseMaster from the command line instead of as a service: Remove /etc/init.d/ResponseMaster and run the following from the /etc/ResponseMaster directory: /usr/lib/jvm/java-25/bin/java -jar responseMaster.jar ./config/master.xml

ResponseMaster User Manuals