"smokeping" depends on

lib (24)

build (1)

Ports that depend on "smokeping"

No ports

Port notes

#### To complete the Smokeping installation ####

1) Enable mod_fcgid (installed as a dependency of Smokeping) for MacPorts Apache 2.

-Rdd the line below to ${prefix}/etc/apache2/httpd.conf.

LoadModule fcgid_module modules/mod_fcgid.so

2) Changes to httpd.conf for Smokeping.

-Uncomment this line to enable the CGI script handler.

AddHandler cgi-script .cgi

-Add a directive for Smokeping's data directory and add
smokeping.cgi to DirectoryIndex for a simple /smokeping url.

Alias /smokeping "${prefix}/var/smokeping"
<Directory "${prefix}/var/smokeping">
Allow from all
Options ExecCGI
</Directory>

<IfModule dir_module>
DirectoryIndex index.html smokeping.cgi
</IfModule>

3) Set Smokeping data directory permissions to the Apache user and group set
in httpd.conf. The default Apache user and group for OS X is www.

sudo chown -R <smokeping-user>:<smokeping-group> ${prefix}/var/smokeping/

4) Setup Smokeping logging.

-Add this statement to /etc/syslog.conf.

local1.* ${prefix}/var/smokeping/log/smokeping.log

-Create a logfile to receive the log messages.

cd ${prefix}/var/smokeping/log
sudo touch smokeping.log
sudo chmod 600 smokeping.log
sudo chown root:admin smokeping.log

-Then restart the syslog facility.

sudo kill -HUP `cat /var/run/syslog.pid`

5) Rename and edit the ${prefix}/etc/smokeping/config sample files, then test your config file.

-Remove the .dist extension from all files; do not change the filenames.

cd ${prefix}/etc/smokeping
sudo cp basepage.html.dist basepage.html
sudo cp config.dist config
sudo cp smokemail.dist smokemail
sudo cp smokeping_secrets.dist smokeping_secrets
sudo cp tmail.dist stmail

-Set the DNS names for the Smokeping config file url's "imageurl" and "cgiurl".
But you should leave all file paths alone -they are set by MacPorts.

imgurl = http://myhost.mycompany.com/smokeping
cgiurl = http://myhost.mycompany.com/smokeping/smokeping.cgi

-Customize variables.

* General * - owner, contact, and mailhost
* Alerts * - to, from addresses

-Then clear the examples (they have a leading '+') in the *** Targets ***
section and set your own.

+ My Web Server
menu = MyWebServer
title = My Web Server
host = mywebserver.mydomain.com
alerts = bigloss,someloss,startloss

-See sample configurations and examples in ${prefix}/share/doc/smokeping/.

-Perform a config file test from a terminal window and correct any errors that
are reported.

smokeping --check

6) Start Smokeping and verify it is running. (Give it a minute to start)

sudo launchctl load -w /Library/LaunchDaemons/org.macports.smokeping.plist
ps -ax |grep smoke

1713 Ss 0:00.16 ${prefix}/bin/smokeping [FPing]
1753 Ss 0:00.18 ${prefix}/bin/speedy_backend -w ${prefix}/www/smokeping/smokeping.cgi
1754 S 0:01.56 ${prefix}/bin/speedy_backend -w ${prefix}/www/smokeping/smokeping.cgi

7) Check the Smokeping graphs with a web browser.

Go to http://localhost/smokeping

8) Add or remove targets from Smokeping.

After adding or removing targets from ${prefix}/etc/smokeping/config, you must reload
Smokeping from a terminal window.

sudo smokeping --reload A startup item has been generated that will aid in starting smokeping with launchd. It is disabled by default. Execute the following command to start it, and to cause it to launch at startup:

sudo port load smokeping