[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r30251 - in eclectic: . gplmt
From: |
gnunet |
Subject: |
[GNUnet-SVN] r30251 - in eclectic: . gplmt |
Date: |
Thu, 17 Oct 2013 11:44:15 +0200 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r30251 - in eclectic: . gplmt,
gnunet <=