Difference between revisions of "APEL/SSMInstallation"
Line 34: | Line 34: | ||
* Example: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | * Example: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | ||
== Running the SSM == | === Running the SSM === | ||
* <code>cd $HOME/bin</code> | * <code>cd $HOME/bin</code> |
Revision as of 09:30, 15 April 2011
The Secure Stomp Messenger (SSM) is used to transmit arbitrary messages using the STOMP protocol. For a description, see SSM Overview.
PLEASE NOTE THIS IS NOT PRODUCTION-LEVEL SOFTWARE This software is distributed as an example and for testing. Expect bugs, and if you find any please let us know about them: apel-admins@mailtalk.ac.uk.
ssm-0.2
Installation
You can't currently download a version of the code, but if you would like a zip file please email apel-admins@mailtalk.ac.uk and we will send you a version.
Unzip the file into a directory, which is denoted as $SSM_HOME below.
Configuration
The environment variable SSM_HOME must be set appropriately:
export SSM_HOME=<directory>
There are two other configuration files.
$SSM_HOME/conf/ssm.cfg
The default values should suffice to send messages to the APEL test system, but there are notes about the file below.
This SSM will be a producer, so the consumer section can be left out or given dummy values - it doesn't hurt. The file is well commented, it should be straightforward. In this file configure:
- the broker to use (host: dev.msg.cern.ch port: 6163 for testing purposes)
- the message store (suggest: $SSM_HOME/messages)
- the certificate/key settings and CA directory
- the topic to send to (/topic/grid.accounting.cpuTest.CENTRAL is being used for testing)
- The DN of the consumer that messages are sent to(consumerDN: /C=UK/O=eScience/OU=CLRC/L=RAL/CN=rap.esc.rl.ac.uk/emailAddress=sct certificates@rl.ac.uk)
- The acknowledgment topic; a sensible default is already used.
$SSM_HOME/conf/ssm.log.cfg
This is the configuration for the logging. 'You need to change one thing:
- In the section [handler_fileHander], specify the path to a log file. The directory must exist. You need a full path - you can't use $SSM_HOME.
- Example:
args=('/home/apel/ssm/ssm.log', 'a')
Running the SSM
cd $HOME/bin
./run-ssm
Once the SSM is running, it will send messages from the directory $SSM_HOME/messages/outgoing
automatically. All you need to do is to put the messages in this directory. If they don't disappear, check the log file to see what it says, check your configuration, then send us an email.