Difference between revisions of "APEL/SSMInstallation"
Line 12: | Line 12: | ||
=== Configuration === | === Configuration === | ||
The environment variable SSM_HOME must be set appropriately: | |||
* <code>export SSM_HOME=<directory></code> | |||
There are two other configuration files. | |||
==== <code>$SSM_HOME/conf/ssm.cfg</code> ==== | ==== <code>$SSM_HOME/conf/ssm.cfg</code> ==== | ||
'''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: | 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: | ||
Line 26: | Line 30: | ||
* The acknowledgment topic; a sensible default is already used. | * The acknowledgment topic; a sensible default is already used. | ||
==== <code>$SSM_HOME/conf/ssm.log.cfg</code> ==== | ==== <code>$SSM_HOME/conf/ssm.log.cfg</code> ==== | ||
This is the configuration for the logging. You need to | 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. | * 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: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | * Example: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> |
Revision as of 15:48, 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
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.