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 |