Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "APEL/SSMInstallation"

From EGIWiki
Jump to navigation Jump to search
 
(111 intermediate revisions by 4 users not shown)
Line 1: Line 1:
The Secure Stomp Messenger (SSM) is used to transmit arbitrary messages using the STOMP protocol.  For a description, see [[APEL/SSMOverview|SSM Overview]].
* Back to [[APEL/SSM]].


== Installing the SSM ==
If you are beginning your testing now please use [[APEL/SSM2Installation|SSM2]]
'''PLEASE NOTE THIS IS NOT PRODUCTION-LEVEL SOFTWARE''' '''This software is distributed as an example and for testing'''


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.
SSM1 downloads are available at https://github.com/apel/ssm/downloads.


Unzip the file into a directory, which is denoted as $HOME below.
'''NOTE:''' Before you can send your messages to the Accounting server you must send your host certificate DN to apel-admins [at] stfc.ac.uk, e.g. output from running


== Configure the SSM ==
<code>openssl x509 -subject -noout -in hostcert.pem</code>
<code>cd $HOME/conf/</code>


The configuration file is in <tt>ssm.cfg</tt>. The 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:
= Installing SSM =


* the broker to use (host: dev.msg.cern.ch port: 6163 for testing purposes)
* For details on the testing process, see this page: [[APEL/APELSSMExternalTesting]]
* the message store (suggest: $HOME/ssm)
* If you find any bugs please let us know about them: apel-admins [at] stfc.ac.uk.
* the certificate/key settings and CA directory
* the topic to send to (/topic/grid.accounting.cpuTest.CENTRAL)
* 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-1.2 ==
To run the SSM:


cd apel/src/ssm ./ssm-master.py
The same package is installed for CPU accounting, StAR and Cloud accounting records.
 
Version 1.2 is the current version.
 
'''It changes the default messages location from the previous version:'''
* OLD: <code>/opt/apel/ssm/messages/</code>
* NEW:  <code>/var/opt/apel/messages/</code>
 
Installation and removal instructions are now packaged with the SSM in the README file.  If you would like to read it before you install the SSM, here is the version included with ssm-1.2: [[APEL/SSM/README12]].
 
'''Please note''': the default configuration sends messages to the CPU Accounting test server.  See [[APEL/SSMConfiguration]] for how to change the configuration.
 
 
[[Category:Accounting]]

Latest revision as of 19:12, 1 November 2018

If you are beginning your testing now please use SSM2

SSM1 downloads are available at https://github.com/apel/ssm/downloads.

NOTE: Before you can send your messages to the Accounting server you must send your host certificate DN to apel-admins [at] stfc.ac.uk, e.g. output from running

openssl x509 -subject -noout -in hostcert.pem

Installing SSM

  • For details on the testing process, see this page: APEL/APELSSMExternalTesting
  • If you find any bugs please let us know about them: apel-admins [at] stfc.ac.uk.

ssm-1.2

The same package is installed for CPU accounting, StAR and Cloud accounting records.

Version 1.2 is the current version.

It changes the default messages location from the previous version:

  • OLD: /opt/apel/ssm/messages/
  • NEW: /var/opt/apel/messages/

Installation and removal instructions are now packaged with the SSM in the README file. If you would like to read it before you install the SSM, here is the version included with ssm-1.2: APEL/SSM/README12.

Please note: the default configuration sends messages to the CPU Accounting test server. See APEL/SSMConfiguration for how to change the configuration.

Retrieved from "https://wiki.egi.eu/w/index.php?title=APEL/SSMInstallation&oldid=100408"