/[gomd]/gomd/README
ViewVC logotype

Contents of /gomd/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.20 - (show annotations) (download)
Wed Sep 17 22:28:16 2003 UTC (20 years, 6 months ago) by rejected
Branch: MAIN
Changes since 1.19: +4 -2 lines
IN README
(+) added new member entry for Wim Vandersmissen (nick on Savannah: "dolphinbofh")

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

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26