Documentation
ResponseMaster Installation Guide
Installation Guide for:
Windows
Redhat
Windows
Preparation Checklist for Installing ResponseMaster
Before you install ResponseMaster ensure that
  1. Your operating system is Windows XP, Windows 2003, or Windows Vista.
  2. You can log on as an administrator.
  3. You know the mail server user name and password.
  4. You have reviewed the ResponseMaster readme file.
Steps for Installing ResponseMaster
  1. Get the latest installation package for ResponseMaster from the home page. Be sure to choose the "Upgrade" package if you have already installed a previous version.
  2. If you already have a version of ResponseMaster running on the machine, stop it.
  3. Double-click the ".msi" file to perform the installation.
  4. Place your license file (obtained from support@extreme-messaging.com) into the "config" subdirectory.
  5. You need to have the Visual Basic runtime libraries, Microsoft XML parser, version 3, and a supported Java Virtual Machine on your system. If you do not already have them, you can install them from these locations:
      Visual Basic runtime libraries depends\vbruntime\setup.exe
      MS XML parser - v3 depends\msxml3sp1.exe
      Sun Java Virtual Machine http://java.sun.com
    Reboot your machine if you receive a message to do so.
  6. Run the ResponseMaster configuration utility (ResponseMasterConfig.exe). At a minimum, you must set up the mailbox parameters. Refer to the ResponseMaster Configuration Guide for details.
  7. Start the ResponseMaster service as you would start any other service on your system.
  8. Verify that the ResponseMaster service is running correctly by examining the log file in the Output folder.
    1. If you do not see any error messages, installation is complete.
    2. If you see error messages and need help addressing them, contact Extreme Messaging at support@extreme-messaging.com
    3. If the log file is not there, check the Event Viewer for errors.
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. These jars 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
Redhat
Preparation Checklist for Installing ResponseMaster
Before you install ResponseMaster ensure that
  1. Your operating system is Redhat Linux 9 (other flavors of unix and other versions are likely to work, but please let us know what you are using).
  2. You can log on as a superuser.
  3. You know the mail server user name and password.
  4. You have reviewed the ResponseMaster readme file.
Steps for Installing ResponseMaster
  1. Get the latest installation package for ResponseMaster from the home page. Be sure to choose the "Upgrade" package if you have already installed a previous version.
  2. If you already have a version of ResponseMaster running on the machine, stop it.
  3. Install the rpm, e.g. rpm -i ResponseMaster-###-1.i386.rpm
    This will install ResponseMaster into /etc/ResponseMaster and place a control script into /etc/init.d
    1. Note: If you are upgrading, you will need to specify the "--force" option.
  4. Place your license file (obtained from support@extreme-messaging.com) into the "config" subdirectory.
  5. You need to have a supported Java Virtual Machine on your system. If you do not already have one, you can download one from http://java.sun.com
  6. Edit the ResponseMaster config files. At a minimum, you must set up the mailbox parameters in config/master.xml. Refer to the ResponseMaster Configuration Guide for details.
  7. The /etc/init.d/ResponseMaster script starts ResponseMaster.
    You will probably need to make minor changes to adapt it for your system.
  8. Start the ResponseMaster service, e.g. service ResponseMaster start
  9. Verify that ResponseMaster is running correctly by examining the log file in the output folder.
    1. If you do not see any error messages, installation is complete.
    2. If you see error messages and need help addressing them, contact Extreme Messaging at support@extreme-messaging.com
Adapting the installation for your environment
  • To set the path to your JVM:
    1. Edit /etc/init.d/ResponseMaster
    2. Change the JAVA_HOME variable
  • To change the classpath:
    1. Edit /etc/init.d/ResponseMaster
    2. Change the CLASSPATH variable 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. These jars are part of the JMX package, available at http://java.sun.com/products/JavaManagement/.
  • To set system properties on the JVM:
    1. Edit /etc/init.d/ResponseMaster
    2. Add something like "-Dmyprop=myval \" after the
      "-outfile /etc/ResponseMaster/output/stdout.txt \" line
  • To run ResponseMaster from the command line instead of as a service
    1. Delete /etc/init.d/ResponseMaster
    2. Use a command line like this from the /etc/ResponseMaster directory:
      /usr/java/jdk1.6.0_17/bin/java -jar responseMaster.jar ./config/master.xml