Difference between revisions of "APEL/SSM2Overview"

From EGIWiki
Jump to: navigation, search
(Simplified version)
Line 21: Line 21:
 
# A file is written to the sending SSM's 'outgoing' directory (by some other process) - see [[APEL/SSM2AddingFiles]].
 
# A file is written to the sending SSM's 'outgoing' directory (by some other process) - see [[APEL/SSM2AddingFiles]].
 
# The file disappears from outgoing directory when <code>ssmsend</code> is run.
 
# The file disappears from outgoing directory when <code>ssmsend</code> is run.
# The file appears in receiving SSM's 'incoming' directory if <ssmreceive> is running.
+
# The file appears in receiving SSM's 'incoming' directory if <code>ssmreceive</code> is running.
  
  

Revision as of 20:09, 17 January 2013

These notes refer to SSM version 2. See APEL/SSMOverview for notes on SSM1. Please send suggestions and queries to apel-ssm-test@jiscmail.ac.uk

Introduction

The Secure Stomp Messenger (SSM) is a python package designed to send arbitrary files using ActiveMQ and the STOMP protocol. Its key features are:

  • It uses the underlying filesystem to store outgoing and / or incoming messages
  • It sends arbitrary files from a client to a server SSM
  • It can use any broker configured to use STOMP
  • Files are signed and may be encrypted during transit using X509 certificates

Interface

The SSM is designed to have a simple interface, which isolates it from any other components it may be used with.

Simplified version

  1. The sending and receiving SSMs are configured to communicate using a specified queue.
  2. A file is written to the sending SSM's 'outgoing' directory (by some other process) - see APEL/SSM2AddingFiles.
  3. The file disappears from outgoing directory when ssmsend is run.
  4. The file appears in receiving SSM's 'incoming' directory if ssmreceive is running.


Once the sending and receiving SSMs are configured and running correctly, to send a message, put a file in the correct outgoing directory with the correct name, run ssmsend, and it will disappear. It will arrive in the incoming directory of the receiving SSM.