5 | | '''Happy Trac-ing''' |
| 8 | Stopos is a tool to manage large number of tasks, mostly started in jobs. |
| 9 | |
| 10 | First, you define a 'pool' and fill it with lines (command lines, parameters, ...). |
| 11 | Then, tasks (usually in jobs) ask stopos for a line. Stopos takes care that lines that are |
| 12 | committed, will not be committed again, unless the user specifically requires to re-commit lines. |
| 13 | |
| 14 | === Typical usage === |
| 15 | |
| 16 | * The user fills a pool with lines, consisting of parameters that are to be used by a program. |
| 17 | * In a job: as many tasks as there are cores are started in parallel. |
| 18 | * Each task asks stopos a line: stopos will give each task another line. |
| 19 | * The task executes the required command using the line as parameter. |
| 20 | * The task tells stopos that this line is now invalidated, it must not be committed ever again. |
| 21 | |
| 22 | === Stopos is server-based === |
| 23 | |
| 24 | Stopos is based on a client-server model. |
| 25 | The clients runs on the compute cluster, the server runs on a server node. |
| 26 | |
| 27 | === Licence === |
| 28 | |
| 29 | Apache 2.0 2004 |
| 30 | |
| 31 | == Download and install == |
| 32 | |
| 33 | {{{ |
| 34 | svn co https://oss.trac.surfsara.nl/stopos/svn stopos |
| 35 | cd stopos/trunk |
| 36 | # edit the make-script Make.inc to your taste |
| 37 | ./makeit |
| 38 | }}} |
| 39 | |
| 40 | After succesfull compilation, there are: |
| 41 | |
| 42 | * {{{stoposclient}}}, the client program |
| 43 | * {{{stoposserver}}}, the server program |
| 44 | * {{{stoposzztostr}}}, a program that takes on stdin a hex-encoded string (with pre-and postfix) and outputs the decoded string. |
| 45 | This program can be useful when looking at the files on the server side. |
| 46 | * {{{stoposdump}}}, a script that demonstrates the use of 'stopos dump'. |
| 47 | * a script {{{makefunction}}} that creates a shell function called {{{stopos}}}. This shell function is normally used when invoking the program. It takes care of setting environment variables. |
| 48 | * a man page: {{{stopos.1}}} which describes the usage, also containing an example. |
| 49 | * {{{modulefile}}}: an example of a modulefile to activate the stopos command. (Only useful if you use modules, but otherwise, it illustrates how to create a suitable alias (called {{{stopos}}})) for the C-shell |
| 50 | * a comprehensive description of the program in doc/description.pdf |
| 51 | |
| 52 | === More documentation === |
| 53 | |
| 54 | We have more [https://www.surfsara.nl/systems/lisa/software/stopos user documentation] on SURFsara's website. |
| 55 | |