readme

OpenMosix工具

(c) David Santo Orcero, 2006

 This is a non-authoritative version of userland tools for 2.4, and
the alpha version of the userland tools for 2.6. It does
not form part of official OpenMosix distribution. It is the version
that I use on my own cluster, and that you can download, compile,
use and abuse at your own.


----------------------------------------------------------------------

 For kernels 2.4 this version is stable, but conservative. If you
want the cool new features, go to the OpenMosix web page. 

 For kernels 2.6 is a alpha internal development version. Use it if
you want to test the latest 2.6 OpenMosix kernels, but do not install
it on any production cluster.

----------------------------------------------------------------------

 Basically, I have been including all the stable patches of the official
version at my own version. The patches that I have not incuded are
those that are unstable, or simply irrelevant. This included the
autoconf scripts -autoconf tools are usefull to recompile code on
different flavours of Unix, but this is not the case, and there are
some issues with autoconf versioning that makes that there is not 
a free lunch. ;-)

 Loadlimit and cpulimit has not been included due to stability reasons;
and omdiscd has been retired due to race conditions in large or loaded 
clusters. 

 My own userland tools have some scripts that I developed, and were
take out from the pakage without developing any new versions. The
scripts are usefull and well-tested.

 Finally, the weird problem of the configuration file has been resolved
on a "gordian knot" basis: /proc directory for OpenMosix is hpc, and thus
configuration file for this tools is /etc/hpc.map.

 You can find a more recent version of OpenMosix userland tools on:

 http://www.orcero.org/irbis


Installation
------------

 Edit "configuration". It is a file on the root of this filetree.
 The most of the times, you need only to touch:

 KERNELMAINVER: It must be 2.4 if it is a 2.4.x kernel, or 2.6 if it
 is a 2.6.x kernel.
 OPENMOSIX: It should point to where OpenMosix kernel is.
 INSTALLDIR: Where is going to be the system base directory (usually, /)
 INSTALLEXTRADIR: Where is going to be the apps directory (usually, /usr)
 INSTALLMANDIR: Where is going to be the manpages (usually, ($INSTALLEXTRADIR)/man)
 CC: Which is is the C compiler (usually, gcc)
 MONNAME: mon userland tool use the same name of mon, a common used
 monitoring tool. This is a problem in most system -like mine- since
 the most distributions come with mon package.  If you want no 
 headaches, the best is to change the name. This variable determines
 the name of the old mon. Some posible values are:
 	MONNAME=mosmon: recommended
	MONNAME=mon: the old fashion
	MONNAME=mmon: The Debian way. Debian patch is no more needed.


 and do:

 make all


 this should work. Don't worry about too much warning messages. I am cleaning
up the code, and I have activated all warnings.


 After all, use the "scripts/openmosix" script as a "System V inicialization"-type script, 
put your cluster at "/etc/hpc.map" and enjoy!