source: trunk/INSTALL @ 221

Last change on this file since 221 was 221, checked in by bastiaans, 15 years ago

INSTALL:

  • more docs for open source release
File size: 2.2 KB
Line 
1DESCRIPTION
2===========
3
4        Job Monarch is a set of tools to monitor and optionally archive (batch)job information.
5
6        It is a addon for the Ganglia monitoring system and plugs in to a existing Ganglia setup.
7
8        To view a operational setup with Job Monarch, have a look here: http://ganglia.sara.nl/?c
9
10
11        Job Monarch stands for 'Job Monitoring and Archiving' tool and consists of three (3) components:
12
13        * jobmond
14
15                The Job Monitoring Daemon.
16                 
17                Gathers PBS/Torque batch statistics on jobs/nodes and submits them into
18                Ganglia's XML stream.
19
20                Through this daemon, users are able to view the PBS/Torque batch system and the
21                jobs/nodes that are in it (be it either running or queued).
22
23        * jobarchived
24
25                The Job Archiving Daemon (optionally).
26
27                Listens to Ganglia's XML stream and archives the job and node statistics.
28                It stores the job statistics in a Postgres SQL database and the node statistics
29                in RRD files.
30               
31                Through this daemon, users are able to lookup a old/finished job
32                and view all it's statistics.
33
34                Optionally: You can either choose to use this daemon if your users have use for it.
35                As it can be a heavy application to run - even though optimized (staged/buffered writes
36                and multi threaded) - and not everyone may have a need for it.
37               
38        * web
39
40                The Job Monarch web interface.
41
42                This interfaces with the jobmond data and (optionally) the jobarchived and presents the
43                data and graphs.
44
45                It does this in a similar layout/setup as Ganglia itself, so the navigation and usage is intuitive.
46               
47
48REQUIREMENTS
49============
50
51        jobmond:
52
53                - pbs_python v2.8.1 or higher
54                  ftp://ftp.sara.nl/pub/outgoing/pbs_python.tar.gz
55
56                - gmond 3.0.1 or higher
57                  http://www.ganglia.info
58
59        jobarchived:
60
61                - Postgres SQL v7.xx
62                  http://www.postgres.org
63
64                - rrdtool v1.xx
65                  http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/
66
67                - gmetad 3.x.x
68                  http://www.ganglia.info
69
70        web:
71
72                - PHP 4.1 or higher
73                  http://www.php.net
74
75
76INSTALLATION
77============
78
79        Prior to installing the software make sure you meet the necessary requirements as
80        mentioned above.
81
82        1. copy
83
84
85CONFIGURATION
86=============
87
88
89START
90=====
91
92
93
94CONTACT
95=======
96
97        To contact the author for anything from bugfixes to flame/hate mail:
98
99        Ramon Bastiaans
100        <ramon ( a t ) sara ( d o t ) nl>
Note: See TracBrowser for help on using the repository browser.