Difference between revisions of "APEL/SSMInstallation"
Line 30: | Line 30: | ||
* Example: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | * Example: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | ||
== Running the SSM == | |||
* <code>cd $HOME/bin</code> | * <code>cd $HOME/bin</code> | ||
* ./run-ssm | * <code>./run-ssm</code> | ||
</code> | |||
Once the SSM is running, it will send messages from the directory <code>$SSM_HOME/messages/outgoing</code> automatically. |
Revision as of 15:45, 14 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
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
export SSM_HOME=<directory>
$SSM_HOME/conf/ssm.cfg
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 specify 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.