Preparation Checklist for Installing ResponseMaster

Before you install ResponseMaster ensure that

  1. Your operating system is Windows10 or Windows Server 2019 & 2016.
  2. You can log on as a Windows administrator.
  3. You know the mail server user name and password.
  4. You have downloaded Java.
  5. You have have a ResponseMaster License Key
  6. You have reviewed the ResponseMaster readme file.

Uninstall all existing version of java prior to installing a version. If you have issues uninstalling older version of Java please read the following like for assistance: https://java.com/en/download/help/remove_olderversions.html

  • New Install Video
  • Upgrade Install Video

High Level Steps

Execute all of these steps as a windows administrator.

  1. Java download and install
    1. Run add remove programs. Look for existing version of java. Most likely from Oracle Java and uninstall. Do this even if you are upgrading to a more current release of Oracle Java! Installing a new version of Java on top of existing Java versions will cause issues.
    2. Download Java from either Oracle or Adoptium. Select one of the version of java for which ResponseMaster was verified.  This information is included on the release notes.  When available, selecting the LTS, MSI, and HotSpot package version of java is best.
    3. When installing the MSI make sure you select the install of the JavaSoft (Oracle) registry keys!!
  2. ResponseMaster
    1. Download ResponseMaster
      1. New Install is for installing ResponseMaster on a computer for the first time. Most will want to download the msi windows installer file.
      2. Upgrade is for customers who had prior version of ResponseMaster installed on the computer. It is HIGHLY recommend you confirm ResponseMaster is not currently running and you perform a backup of the ResponseMaster directory before you start the install.
    2. Double click the ResponseMaster file which will start the windows installer. Follow all the prompts.
    3. If this is a ResponseMaster upgrade, skip to step 6 Verify ResponseMaster Install.
  3. ResponseMaster Configuration Tool
    1. Install Windows systems for the ResponseMaster configuration tool.
      1. Navigate to the C:\Program Files\ExtremeMessaging\ResponseMaster\depends\VBRuntime
      2. Double click setup. Accept all the defaults during the install. (Don’t be alarmed… This is an old windows installer and it looks very old)
  4. License Key
    1. Install ResponseMaster License Key.
      1. Navigate to C:\Program Files\Extreme Messaging\ResponseMaster\config and place the License.xml file in this directory.
  5. Verify ResponseMaster Install
    1. Open the Windows System Service manager. Navigate to the service named ResponseMaster. Start the service.
    2. Navigate to C:\Program Files\Extreme Messaging\ResponseMaster\output and open the log.txt file. Search for the words “Logger initialized”. This is the first line in the log file generated by ResponseMaster when it starts.
    3. The next line is ResponseMaster Build ###. ### should match the version of ReposneMaster you just installed. If not search log file until you locate it.
    4. Now look for errors. Scroll down through the file looking for errors. If you encounter errors you can search the FAQs for answers or contact Customer support for assistance.
  6. Configure ResponseMaster
    1. For new installations now you will need to configure ResponseMaster to process your returned and bounced emails. Refer to the ResponseMaster Configuration Guide for details.

Adapting the installation for your environment

  • To change the classpath:
    1. Double-click EditServiceParameters.bat
    2. Change the “imagepath” setting to include whatever additional paths you need

    Note: If you are using the JMX monitoring features, you will need to include jmxri.jar and jmxtools.jar in your classpath. If these jars are not included in your java distribution then are part of the JMX package, available at http://java.sun.com/products/JavaManagement/.

  • To set system properties on the JVM:
    1. Double-click EditServiceParameters.bat
    2. Go to the Java VM tab
    3. Put something like “-Dmyprop=myval” in the Java Options box

    Note: most JVMs have a very low default max heap size, so you may want to adjust it using an option like this (for 750MB): -Xmx750M

  • To run ResponseMaster from the command line instead of as a service
    1. Go to Administrative Tools->Services and disable the ResponseMaster service
    2. Use a command line like this from the installation directory: java -jar responseMaster.jar ./config/master.xml