install

linux/unix下c/s形式的资源监视,客户端负责搜集机器,再传送到服务端.

LilyCRM Suite Installation and Usage

by Shen Jian <[e-mail]>

LilyCRM Suite consists of two parts: server and client. The server side collects load information of the whole cluster, while the client side collects local load information and sends it to server every a few seconds.


** Install **

After you untar the source package:
	make
	(su) make install

The monitor server (a kernel module) will be installed on this machine. Check it by `ls /proc/cluster`.

Then, you should start your monitor client on this machine by:
	sysmon server_host		# name or ip

If you want this client to broadcast in the cluster, you can:
	sysmon -b

If you have more than one network cards, you may specify which one to use. This will be discoverd automatically through `sysmon -b`, then you can:
	sysmon -b -i eth0		# any network interface name

Each machine in the cluster should start a monitor client, you'd better start sysmon with root.

`make install` is full installtion. If you just want to install server or client, we provide `make svr_inst` and `make clt_inst`.


** How to use **

After installation, each machine monitored has an entry in /proc/cluster. You may look at /proc/cluster by your self, for example:
	cat /proc/cluster/192.168.0.1/top
  	cat /proc/cluster/192.168.0.1/ps

Otherwise, we provide three command to help you check the cluster load: chosts, cps, ctop

chosts: lists all the machines monitored now, no arguments is needed.

cps: list all processes on that machine, for example
	cps node1
	cps -u root node1 		# list processed belong to root on node1

ctop: list load information, for example
	ctop				# list all nodes' load continuously
	ctop node1			# list node1's load continuously
	ctop -v				# list detail information for all nodes
	ctop -v node1		# list node1's detail information
In continuous mode, you may press 'v' to toggle between verbose information and non-verbose information; you may press 'q' to exit. 


** Uninstall **

You should do as follows one by one in the sequence:
	(su) /sbin/cstop	# stop monitor server
	sysmon stop			# stop monitor client
	make uninstall

If you do not use full installation, you should uninstall by `make svr_uninst` or `make clt_uninst`.



Enjoy it!