Difference between revisions of "APEL/SSMInstallation"
Line 9: | Line 9: | ||
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. | 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 $ | Unzip the file into a directory, which is denoted as $SSM_HOME below. | ||
=== Configuration === | === Configuration === | ||
<code> | * <code>export SSM_HOME=<directory></code> | ||
==== <code>$SSM_HOME/conf/ssm.cfg</code> ==== | |||
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 broker to use (host: dev.msg.cern.ch port: 6163 for testing purposes) | ||
* the message store (suggest: $ | * the message store (suggest: $SSM_HOME/messages) | ||
* the certificate/key settings and CA directory | * the certificate/key settings and CA directory | ||
* the topic to send to (/topic/grid.accounting.cpuTest.CENTRAL) | * 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 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. | * The acknowledgment topic; a sensible default is already used. | ||
==== <code>$SSM_HOME/conf/ssm.log.cfg</code> ==== | |||
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: <code>args=('/home/apel/ssm/ssm.log', 'a')</code> | |||
To run the SSM: | To run the SSM: | ||
<code> | * <code>cd $HOME/bin</code> | ||
cd $HOME/bin | * ./run-ssm ../conf/ssm.cfg | ||
./run-ssm ../conf/ssm.cfg | |||
</code> | </code> |
Revision as of 15:44, 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')
To run the SSM:
cd $HOME/bin
- ./run-ssm ../conf/ssm.cfg