[GNUnet-SVN] r34240 - msh

[gnunet]

Author: harsha
Date: 2014-08-29 14:18:27 +0200 (Fri, 29 Aug 2014)
New Revision: 34240

Added:
   msh/README
Log:
README.


Added: msh/README
===================================================================
--- msh/README                          (rev 0)
+++ msh/README  2014-08-29 12:18:27 UTC (rev 34240)
@@ -0,0 +1,48 @@
+MPI-Shell (MSH) is a remote shell for executing commands remotely on hosts 
where
+Message Passing Interface (MPI) layer is available for communication.  Such
+hosts are commonly found in High Performance Computing (HPC) systems such as
+compute clusters or supercomputers.
+
+The motivation for this project is that often in such systems Secure-Shell 
(SSH)
+is either unavailable or restricted for users due to security reasons.  As a
+result, hosts in these systems cannot be used for non MPI applications such as
+network emulators or testbeds which rely on SSH to establish connections among
+the hosts.  MSH aims to solve this problem by providing an alternative remote
+shell which can be used by these applications instead of SSH.
+
+Architecture
+------------
+
+MSH consists of two components: the MSH daemon(mshd) and the MSH client.  mshd
+is similar to SSH daemon(ssd) in that one mshd instance is started per host.
+The daemons execute the commands given from remote MSH clients.  However, 
unlike
+sshd, mshd is started by the job scheduler employed in the HPC system and only
+runs during the life-time of the job.
+
+
+The MSH client, takes the IP address of the target host and the
+remote command string as arguments.  The client relies on the local
+mshd for learning the port address of the remote mshd and for
+authenticating itself to the remote mshd.
+
+The command string is executed by the remote mshd after successful
+authentication of the connecting MSH client.  The input for the executed 
command
+string is relayed by the MSH client to the remote mshd.  Similarly, the output
+from the executed command string is relayed from the remote mshd to the MSH
+client;
+
+Installation
+------------
+
+Installation should be fairly simple if you want to go-ahead with the default
+settings.  The following steps should do the job:
+
+$ ./bootstrap
+$ ./configure
+$ make
+$ make install
+
+You may change some of the default settings before installing via ./configure.
+For help on those settings and how to change them execute:
+
+./configure --help