APEL/SSMInstallation
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.
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.