[GNUnet-SVN] r30251 - in eclectic: . gplmt

[gnunet]

Author: wachs
Date: 2013-10-17 11:44:14 +0200 (Thu, 17 Oct 2013)
New Revision: 30251

Added:
   eclectic/gplmt/
   eclectic/gplmt/README
Removed:
   eclectic/gplmt/README
Log:
moving files to new directory


Deleted: eclectic/gplmt/README
===================================================================
--- gnunet-planetlab/gplmt/README       2013-10-16 13:13:50 UTC (rev 30220)
+++ eclectic/gplmt/README       2013-10-17 09:44:14 UTC (rev 30251)
@@ -1,257 +0,0 @@
-   Welcome to GNUnet Planetlab Largescale Management Tool (gplmt)
-
-
-What is GNUnet Planetlab Largescale Management Tool?
-===============
-
-GNUnet is peer-to-peer framework focusing on security.  GNUnet use the 
-PlanetLab testbed for largescale testing. We use gplmt to deploy, 
-manage and administer GNUnet. You can use gplmt to perform maintenance 
-or adminitrative tasks on a large number of hosts in parallel.
-
-Additional information and documentation about gplmt can be found at
-https://gnunet.org/gplmt .
-
-Contact & Bugs:
-=============
-
-Please check for contact information:
-https://gnunet.org/contact_information
-
-If you should find any bugs please contact:
address@hidden
-
-or even better submit them directly under
-https://gnunet.org/bugs
-
-Features:
-=============
-
-- Support for public key and SSH agent authentication
-- PlanetLab API integration to retrieve node list
-- SFTPand SCP support to copy data from and to nodes
-- Extensible task list
-- Task list validation against XML Schema
-- Extensible logging functionality
-
-Content
-=============
-
-gplmt/
-source code
-
-contrib/
-example configuration files, tasklists and tasklist XML schema
-
-contrib/
-some scripts to manage planetlab slices and other scripts
-
-
-Dependencies:
-=============
-
-These are the direct dependencies for running gplmt:
-
-- Python               >= 2.7
-- ElementTree          >= 1.3
-- Paramiko             >= 1.7
-- minixsv              >= 0.9
-
-The version numbers represent the versions we used to develop gplmt.
-
-
-How to install?
-===============
-
-Python
---------
-
-Please check your OS documention or http://www.python.org/ how to setup
-Python
-
-To install the required python modules, we recommend to use the pip 
-installer:
-
-http://www.pip-installer.org/en/latest/index.html
-
-ElementTree
---------
-
-On GNU/Linux use: sudo pip install elementtree
-Or check http://effbot.org/zone/element-index.htm
-
-minixsv
---------
-
-On GNU/Linux use: sudo pip install minixsv
-Or check http://pypi.python.org/pypi/minixsv/0.7/
-
-Paramiko
---------
-
-On GNU/Linux use: sudo pip install paramiko
-Or check http://www.lag.net/paramiko/
-
-Usage
-===============
-
-Run ./gplmt --help to get information about commandline arguments
-
-Usage
-===============
-
-To run gplmt you need to specify at least a configuration file to perform:
-
-./gplmt.py -c <configuration>
-
-If a configuration file is not passed to gplmt, it will try to use
-~/.gplmt/gplmt.conf instead.
-
-The command(s) to run can be specified in different ways:
-
-Single command:
-
-./gplmt.py -c <configuration> -C <command>
-
-Tasklist file specified in configuration file:
-
-tasks = contrib/tasks.xml
-
-Tasklist file passed as argument
-
-./gplmt.py -c <configuration> -t <tasks>
-
-
-The hosts to use can be specified in different ways:
-
-Single host
------------
-
-Perform the tasks on a single host. The host name is given as a command line 
-argument using the -H / --host switch:
-
-./gplmt.py -c <configuration> -t <tasks> -H hostname.local.example.com
-
-File
-----
-
-Perform the tasks on all hosts included in a file. Each line contains a 
-hostname The file name is given as a command line argument using the 
--n / --nodes switch:
-
-./gplmt.py -c <configuration> -t <tasks> -n nodes.file
-
-PlanetLab 
----------
-
-Perform the tasks on all nodes assigned to a PlanetLab slice. Slice name and 
-password can be specified in the configuration. If password required to be 
-secret, pass it  with the -p switch or wait to be prompted for it: 
-
-./gplmt.py -c <configuration> -t <tasks> -a -p <secretpw>
-
-The task and node file can also be specified in the configuration file.
-Command line arguments overwrite settings in the configuration file
-
-The Configuration File
-===============
-
-Here an example for an configuration file:
-
-[gplmt]
-# The file containing the list of hosts
-nodes = contrib/test_node.nodes
-# Which notification mechanism to use: 
-# simple: print messages to stdout
-# result: result summary after all threads finish
-notification = result
-# The file containing the tasks to perform
-tasks = contrib/tasklists/check_node.xml
-
-[planetlab]
-# The name of the respective planetlab slice
-slice = tumple_gnunet
-# Configuration for Planetlab API
-# Use PlanetLab nodes instead of nodes file
-# use_pl_nodes = yes
-# PlanetLab Europe
-api_url = https://www.planet-lab.eu/PLCAPI/
-# Planetlab
-#api_url = https://www.planet-lab.org/PLCAPI/
-
-# Planetlab username
-username = <pl_username>
-# Planetlab password
-password = <pl_pw>
-
-[ssh]
-# Order of ssh authentication:
-#
-# The ssh_keyfile_filename passed in (if any)
-# Any key we can find through an SSH agent
-# Any "id_rsa" or "id_dsa" key discoverable in ~/.ssh/
-# Plain password auth, if a ssh_password was given
-ssh_keyfile = <keyfile>
-ssh_password = <password>
-# protocoll for put get operations (Planetlab does not support SFTP)
-ssh_transfer = scp
-#ssh_transfer = sftp
-# Use system's SSH "known hosts" file
-ssh_use_known_hosts = yes
-# Add node hostkeys automatically
-add_unkown_hostkeys = yes
-
-
-Nodes file
-===============
-
-A node file contains the list of the hosts where the tasks should be 
-performed on.
-GPLMT supports the following formats for nodes:
-
-host1.example.com
-host2.example.com:222
address@hidden
address@hidden:222
-user:address@hidden:222
-
-In case a username and/or password is specified for a given node,it will 
-override any credentials specified in the configuration file for this node.
-
-The Tasklist
-===============
-
-A tasklist is the specification which tasks should be performed in 
-which order. The task list is written in XML. The basic element is the 
-root <tasklist> containing the tasks to execute. The tasks are 
-sequentially executed. A task is defined as:
-
-<run> element: for running a command and checking the output
-<get> element: for copying a file from remote to local
-<put> element: for copying a file from local to remote
-
-Tasks can also be enclosed in a <sequence> element.
-
-Here we have an example a tasklist first obtaining the current date and 
-and then copying a file to the remote host
-
-<?xml version="1.0" encoding="UTF-8"?>
-<tasklist name="Deploy file" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; 
xsi:noNamespaceSchemaLocation="../tasklist_schema.xsd">
-       
-       <run id="0" name="check peer">
-        <command>sudo date</command> 
-        <arguments></arguments> 
-        <timeout>10</timeout>
-        <expected_return_code>0</expected_return_code>
-        <expected_output></expected_output>
-        <stop_on_fail>true</stop_on_fail>
-       </run>
-       
-       <sequence enabled="true">
-               <put id="1" name="put gnunet.conf">
-                       <source>contrib/gnunet.conf</source>
-                       <destination>/home/gnunet.conf</destination>
-                       <stop_on_fail>true</stop_on_fail>
-               </put> 
-    </sequence>
-</tasklist>

Copied: eclectic/gplmt/README (from rev 30224, gnunet-planetlab/gplmt/README)
===================================================================
--- eclectic/gplmt/README                               (rev 0)
+++ eclectic/gplmt/README       2013-10-17 09:44:14 UTC (rev 30251)
@@ -0,0 +1,97 @@
+   Welcome to GNUnet Parallel Largescale Management Tool (gplmt)
+
+
+What is GNUnet Parallel Largescale Management Tool?
+===============
+
+GNUnet is peer-to-peer framework focusing on security. We use GPLMT to 
+deploy, manage and administer GNUnet on a large number of remote nodes 
+parallel.
+
+Additional information and documentation about gplmt can be found at
+https://gnunet.org/gplmt .
+
+Contact & Bugs:
+=============
+
+Please check for contact information:
+https://gnunet.org/contact_information
+
+If you should find any bugs please contact:
address@hidden
+
+or even better submit them directly under
+https://gnunet.org/bugs
+
+Features:
+=============
+
+- Support for public key and SSH agent authentication
+- PlanetLab API integration to retrieve node list
+- SFTPand SCP support to copy data from and to nodes
+- Extensible task list
+- Task list validation against XML Schema
+- Extensible logging functionality
+
+Content
+=============
+
+gplmt/
+source code
+
+contrib/
+example configuration files, tasklists and tasklist XML schema
+
+docs/
+documentation file, e.g. user guide
+
+
+Dependencies:
+=============
+
+These are the direct dependencies for running gplmt:
+
+- Python               >= 2.7
+- ElementTree          >= 1.3
+- Paramiko             >= 1.7
+- minixsv              >= 0.9
+
+The version numbers represent the versions we used to develop gplmt.
+
+
+How to install?
+===============
+
+Python
+--------
+
+Please check your OS documention or http://www.python.org/ how to setup
+Python
+
+To install the required python modules, we recommend to use the pip 
+installer:
+
+http://www.pip-installer.org/en/latest/index.html
+
+ElementTree
+--------
+
+On GNU/Linux use: sudo pip install elementtree
+Or check http://effbot.org/zone/element-index.htm
+
+minixsv
+--------
+
+On GNU/Linux use: sudo pip install minixsv
+Or check http://pypi.python.org/pypi/minixsv/0.7/
+
+Paramiko
+--------
+
+On GNU/Linux use: sudo pip install paramiko
+Or check http://www.lag.net/paramiko/
+
+Usage
+===============
+
+Please have a look at the GPLMT user guide in docs/gplmt-userguide.pdf