1Installation
2============
3
4The Hiawatha Monitor has been built upon the Banshee PHP framework. Use the
5following steps to install a Banshee based website.
6
7
8Configure your webserver
9------------------------
10Use the following Hiawatha configuration for this website.
11
12	UrlToolkit {
13		ToolkitID = monitor
14		RequestURI isfile Return
15		Match ^/(css|files|fonts|images|js)(/|$) Return
16		Match ^/(favicon.ico|robots.txt)$ Return
17		Match [^?]*(\?.*)? Rewrite /index.php$1
18	}
19
20	VirtualHost {
21		Hostname = monitor.domain.com
22		WebsiteRoot = /usr/local/www/hiawatha-monitor/public
23		StartFile = index.php
24		AccessLogfile = /usr/local/www/hiawatha-monitor/logfiles/access.log
25		ErrorLogfile = /usr/local/www/hiawatha-monitor/logfiles/error.log
26		ExecuteCGI = yes
27		UseFastCGI = PHP # Use if you use PHP as a FastCGI daemon
28		TimeForCGI = 15
29		UseToolkit = monitor
30	}
31
32
33Configure PHP
34-------------
35The Hiawatha Monitor requires at least PHP v5.6 and needs the MySQL and XML/XSLT
36PHP modules.
37
38
39Configure your database
40-----------------------
41Open the website in your browser and follow the instructions on your screen. In
42case of an error, add /setup to the URL.
43
44
45Configure the Cron daemon
46-------------------------
47Use the following crontab settings to fetch the information from the webservers
48and to send the daily reports:
49
50	*/5 * * * * /path/to/monitor/website/database/fetch_webserver_logs
51	0   0 * * * /path/to/monitor/website/database/delete_old_logs
52	59 23 * * * /path/to/monitor/website/database/send_reports
53
54
55Using the Hiawatha Monitor
56--------------------------
57Login with username 'admin' and password 'monitor' and start adding webservers
58in the Webserver Administration page. Add the following line to the
59configuration file of your Hiawatha webservers.
60
61	MonitorServer = <IP of monitor server>
62
63Don't forget to change the admin password and to check out the settings in the
64Settings administration CMS page. When you're done testing, set DEBUG_MODE in
65the file settings/website.conf to 'no' and remove the setup module from the
66file settings/public_pages.conf.
67