-
Notifications
You must be signed in to change notification settings - Fork 4
/
README
131 lines (89 loc) · 4.39 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
MONIT - UNIX Systems Management
Introduction
------------
Monit is a free utility for managing and monitoring processes, programs,
files, directories and filesystems on a Unix system. Monit conducts automatic
maintenance and repair and can execute meaningful causal actions in error
situations.
Monit logs to syslog or to its own log file and notifies you about error
conditions via customizable alert messages. Monit can perform various
TCP/IP network checks, protocol checks and can utilize SSL for such checks.
Monit provides an optional http(s) interface and you can use a browser to
access the Monit program.
System requirements
-------------------
* Memory and Disk space
A minimum of 1 megabytes RAM are required and around 500KB of free disk
space. You may need more RAM depending on how many services Monit should
monitor.
* ANSI-C Compiler and Build System
You will need an ANSI-C99 compiler installed to build Monit. The GNU C
compiler (GCC) from the Free Software Foundation (FSF) is recommended. In
addition, your PATH must contain basic build tools such as make.
Installation
------------
Monit utilize the GNU auto-tools and provided the requirements above are
satisfied, building Monit is conducted via the standard;
./configure
make
make install
This will install Monit and the Monit man-file in /usr/local/bin and
/usr/local/man/man1 respectively. If you want another location than
/usr/local, run configure with the prefix options, like so: ./configure
--prefix=<dir>
Use ./configure --help for build and install options. By default, Monit is
built with SSL, PAM and large file support. You may change this with the
--without-<xxx> options to ./configure. E.g. --without-ssl, --without-pam
or --without-largefiles.
QUICK START
-----------
After you have built Monit you can simply start the monit program from the
build directory to test it. Monit will use the monitrc control file located
in this directory for its configuration. The file is setup to start
Monit's http server so you have something interesting to look at; After you
have started monit, point your browser to http://127.0.0.1:2812/ and log in
with the username admin and password monit.
Once started, monit will run as a background process. To stop monit, use
monit quit. To run monit in the foreground and in diagnostic mode, start
monit with the -Iv options. In diagnostic mode, monit will print debug
information to the console. Use ctrl+c to stop monit in diagnostic mode. To
see all options for the program, use monit -h.
Copy monitrc in the build directory to ~/.monitrc or if you plan to run
Monit as root, to /etc/monitc. Use this file as a starting point to write
your own configuration file for Monit.
DOCUMENTATION
-------------
Please use `man monit' for an in-depth documentation of the program. More
documentation can be found at http://mmonit.com/monit/
Acknowledgments
---------------
Thanks to the Free Software Foundation (FSF) for hosting the mailing list
and to Atlassian for hosting the code repository.
The design of libmonit was inspired by principles put forth by David R.
Hanson <[email protected]> in his excellent book "C Interfaces and
Implementations". You can learn more about this book here
http://www.cs.princeton.edu/software/cii/
Contributing
------------
You are welcome to contribute to this project. Good pull requests,
patches, improvements and new features are always helpful and
appreciated. Please read the contributing guidelines before working
on a patch. See https://bitbucket.org/tildeslash/monit
Reporting a problem
-------------------
If you believe you have found a bug, please use the issue tracker to
report the problem. Remember to include the necessary information that
will enable us to understand and reproduce this problem.
If you have found a security vulnerabilities we appreciate if you will
send this information to [email protected].
Mailing list
------------
You can subscribe to Monitʼs mailing list to be the first to hear
about new releases and important information about Monit. The mailing
list is read-only with very low traffic. Please go here to subscribe;
https://lists.nongnu.org/mailman/listinfo/monit-announce
Contact information
-------------------
Monit is a product of Tildeslash Ltd. a company registered in Norway and in
United Kingdom. For further information about this Software, please visit
http://mmonit.com/monit/