| 1 |
README FILE (W.I.P.: please be patient! ;) ) |
| 2 |
|
| 3 |
A. TABLE OF CONTENTS |
| 4 |
|
| 5 |
A. TABLE OF CONTENTS |
| 6 |
B. WHAT'S THIS PROGRAM? |
| 7 |
C. GET GOMD SOURCES |
| 8 |
D. GOMD REQUIREMENTS |
| 9 |
E. GOMD COMPILATION, INSTALLATION AND (AUTO)TESTING |
| 10 |
F. AUTHORS AND CONTRIBUTORS |
| 11 |
G. LICENSE |
| 12 |
|
| 13 |
|
| 14 |
B. WHAT'S THIS PROGRAM? |
| 15 |
|
| 16 |
gomd stands for "general openMosix daemon". |
| 17 |
|
| 18 |
gomd is a daemon which executes commands and gets information from the nodes |
| 19 |
of an openMosix cluster. It has to run on every node in order to collect data, |
| 20 |
and it waits for commands to execute. |
| 21 |
|
| 22 |
|
| 23 |
C. GET GOMD SOURCES |
| 24 |
|
| 25 |
By now, we don't have an initial release so you have to get the sources |
| 26 |
from the CVS repository. |
| 27 |
|
| 28 |
Open a shell, enter a directory of your choice, |
| 29 |
and type these lines at the shell prompt: |
| 30 |
$ cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/gomd login |
| 31 |
$ cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/gomd co gomd |
| 32 |
|
| 33 |
Also, you might want to take a look at our project page on savannah. |
| 34 |
Site: http://www.nongnu.org/gomd/ |
| 35 |
|
| 36 |
There is also an IRC channel for this project. |
| 37 |
Here you can talk with developers and see the full project status |
| 38 |
(in the channel topic) |
| 39 |
- Server: irc.freenode.net |
| 40 |
- Channel: #gomd |
| 41 |
|
| 42 |
|
| 43 |
D. GOMD REQUIREMENTS |
| 44 |
|
| 45 |
Gomd need two libraries to work properly. |
| 46 |
The first library (commoncpp) is necessary. |
| 47 |
The second one, libgtop, is not necessary: if you have it installed, |
| 48 |
gomd can produce some extra interesting system infos. |
| 49 |
|
| 50 |
- COMMONCPP Library (strictly required) |
| 51 |
Description: GNU's library. Provides some useful C++ classes (Thread, sockets,...) |
| 52 |
Download site: ftp://ftp.gnu.org/pub/gnu/commoncpp |
| 53 |
Latest version: 1.0.13 |
| 54 |
To compile: standard sequence (./configure, make, make install) |
| 55 |
|
| 56 |
- LIBGTOP Library (_NOT_ strictly required) |
| 57 |
Description: Useful library. Provides some useful classes to get extended |
| 58 |
system infos. |
| 59 |
Download site: http://ftp.gnome.org/pub/gnome/sources/libgtop/ |
| 60 |
Latest version: 2.0.2 |
| 61 |
To compile: standard sequence (./configure, make, make install) |
| 62 |
|
| 63 |
Please remember to execute ldconfig program (so the new installed |
| 64 |
libraries will be cached). |
| 65 |
|
| 66 |
|
| 67 |
E. GOMD COMPILATION, INSTALLATION AND (AUTO)TESTING |
| 68 |
|
| 69 |
These are the basic setting to compile, install and test all the code (in order: library, |
| 70 |
client examples and daemon). |
| 71 |
|
| 72 |
1. COMPILE THE CODE |
| 73 |
- To compile the code, simply run this script: |
| 74 |
$ ./compile.sh (type this command at the shell prompt) |
| 75 |
|
| 76 |
2. INSTALL THE CODE |
| 77 |
- To compile the code, run this script (root privileges _required_): |
| 78 |
# ./install.sh (type this command at the shell prompt) |
| 79 |
|
| 80 |
3.(AUTO)TEST THE CODE |
| 81 |
- If code compilation went right you can easily test the built programs by |
| 82 |
running the simple scripts in autotest directory: |
| 83 |
$ cd autotest (to enter autotest directory) |
| 84 |
|
| 85 |
Please notice these scripts invoke the compiled code (daemon, examples and library) |
| 86 |
directly from their source-code directories. So you don't need to install |
| 87 |
anything if you only want to test gomd without installing it (by the way: |
| 88 |
gomd installation requires root privileges). |
| 89 |
|
| 90 |
FILE: test1.sh |
| 91 |
DESCRIPTION: simple test script using expect command to query three info values |
| 92 |
(load, uptime and memusage) |
| 93 |
SINOPSYS: $ ./test1.sh [LOCAL_IP] [TARGET_NODE_IDS] |
| 94 |
NOTE#1: examples for TARGET_NODE_IDS: |
| 95 |
EX#1: 1-5 => to get nodes 1,2,3,4,5 |
| 96 |
EX#2: 1,3,9 => to get nodes 1,3,9 |
| 97 |
EX#3: 1,3,9-12 => to get nodes 1,3,9,10,11,12 |
| 98 |
NOTE#2: if you don't enter LOCAL_IP and/or TARGET_NODE_IDS, program |
| 99 |
will ask you to enter these two values. |
| 100 |
|
| 101 |
|
| 102 |
FILE: test2.sh |
| 103 |
DESCRIPTION: simple test script using libgomd library to query load |
| 104 |
value for a specified node. |
| 105 |
This script calls a simple C++ client example |
| 106 |
included in contrib/c++/cpp directory. |
| 107 |
SINOPSYS: $ ./test2.sh [LOCAL_IP] |
| 108 |
NOTE: if you don't enter LOCAL_IP, program |
| 109 |
will ask you to enter this value. |
| 110 |
|
| 111 |
|
| 112 |
FILE: test3.sh |
| 113 |
DESCRIPTION: simple test script using libgomd library to query load |
| 114 |
value for a specified node. |
| 115 |
This script calls a simple "pure" C client example |
| 116 |
included in contrib/c directory. |
| 117 |
SINOPSYS: $ ./test3.sh [LOCAL_IP] |
| 118 |
NOTE: if you don't enter LOCAL_IP, program |
| 119 |
will ask you to enter this value. |
| 120 |
|
| 121 |
|
| 122 |
FILE: test4.sh |
| 123 |
DESCRIPTION: simple test script using libgomd library to query load |
| 124 |
value for a specified node |
| 125 |
This script calls Matt's QT-based C++ client example |
| 126 |
included in contrib/c++/qt directory. |
| 127 |
SINOPSYS: $ ./test4.sh [LOCAL_IP] |
| 128 |
NOTE: if you don't enter LOCAL_IP, program |
| 129 |
will ask you to enter this value. |
| 130 |
|
| 131 |
|
| 132 |
FILE: stress_test1.sh |
| 133 |
DESCRIPTION: simple script used to stress the gomd daemon. |
| 134 |
It repeats the tests for a given number of times. |
| 135 |
It uses the expect-based getInfo.sh shell script |
| 136 |
(like test1.sh). |
| 137 |
SINOPSYS: $ ./stress_test1.sh [LOCAL_IP] [TIMES] |
| 138 |
NOTE: if you don't enter LOCAL_IP and/or TIMES, program |
| 139 |
will ask you to enter these two values. |
| 140 |
|
| 141 |
|
| 142 |
|
| 143 |
F. AUTHORS AND CONTRIBUTORS |
| 144 |
|
| 145 |
Authors |
| 146 |
- Roel Baardman (rbaardman at zonnet dot nl) |
| 147 |
logo designer, beta tester, java2gomd maintainer |
| 148 |
- Mirko Caserta (mirko at mcaserta dot com) |
| 149 |
public relations, web master, diagrams' guru |
| 150 |
- Massimo Fierro (mfierro at crema dot unimi dot it) |
| 151 |
developer |
| 152 |
- Gian Paolo Ghilardi (jp80 at libero dot it) |
| 153 |
daemon maintainer, developer |
| 154 |
- Marco Marocco (marco dot marocco at libero dot it) |
| 155 |
bug hunter, perl2gomd maintainer |
| 156 |
- Matthias Rechenburg (mosixview at t-online dot de) |
| 157 |
project spokesman, libgomd maintainer, developer |
| 158 |
(also author of openmosixview) |
| 159 |
- Ramon Pons Vivanco (rpons at rinu dot org) |
| 160 |
web master, site creator, developer |
| 161 |
|
| 162 |
|
| 163 |
Contributors |
| 164 |
- Moshe Bar (moshe at qlusters dot com) |
| 165 |
We wouldn't be here without him and he also wrote the first |
| 166 |
monitoring application (in perl) using gomd |
| 167 |
- Higor Alves (higor dot alves at o2 dot net dot br) |
| 168 |
bug hunter |
| 169 |
- Johnny Cache (johnycsh at hick dot org) |
| 170 |
developer (also author of 3dmosmon) |
| 171 |
- Brian Pontz (brian at axehind dot com) |
| 172 |
developer |
| 173 |
- Wim Vandersmissen (wim at bofh dot be) |
| 174 |
bug hunter (also author of clusterKNOPPIX) |
| 175 |
- The openMosix Community (openMosix-general at lists dot sourceforge dot net) |
| 176 |
we love you! :) |
| 177 |
- You! |
| 178 |
for using these bits... ;) |
| 179 |
|
| 180 |
|
| 181 |
G. LICENSE |
| 182 |
|
| 183 |
- gomd is copyright by the above authors and licensed under |
| 184 |
version 2 of the GNU General Public License (GPL) as published by |
| 185 |
the Free Software Foundation |