Agenda: sample-smokeping-master-slave.htm

File sample-smokeping-master-slave.htm, 9.4 KB (added by Chris Elliott, 6 years ago)
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5  <meta http-equiv="Content-Style-Type" content="text/css" />
6  <meta name="generator" content="pandoc" />
7  <title></title>
8  <style type="text/css">code{white-space: pre;}</style>
9  <link href="data:text/css;charset=utf-8,%0A%0A%0A%0Adiv%23header%2C%20header%0A%7B%0A%0Aborder%2Dbottom%3A%201px%20solid%20%23aaa%3B%0Amargin%2Dbottom%3A%200%2E5em%3B%0A%7D%0A%2Etitle%20%0A%7B%0Atext%2Dalign%3A%20center%3B%0A%7D%0A%2Eauthor%2C%20%2Edate%20%0A%7B%0Atext%2Dalign%3A%20center%3B%0A%7D%0A%0Adiv%23TOC%2C%20nav%23TOC%0A%7B%0A%0Aborder%2Dbottom%3A%201px%20solid%20%23aaa%3B%0Amargin%2Dbottom%3A%200%2E5em%3B%0A%7D%0A%40media%20print%0A%7B%0Adiv%23TOC%2C%20nav%23TOC%0A%7B%0A%0Adisplay%3A%20none%3B%0A%7D%0A%7D%0A%0Ah1%2C%20h2%2C%20h3%2C%20h4%2C%20h5%2C%20h6%0A%7B%0Afont%2Dfamily%3A%20%22Helvetica%20Neue%22%2C%20Helvetica%2C%20%22Liberation%20Sans%22%2C%20Calibri%2C%20Arial%2C%20sans%2Dserif%3B%20%0A%0Apage%2Dbreak%2Dafter%3A%20avoid%3B%20%0A%7D%0A%0Adiv%20div%2C%20section%20section%20%0A%7B%0Amargin%2Dleft%3A%202em%3B%20%0A%7D%0Ap%20%7B%7D%0Ablockquote%0A%7B%20font%2Dstyle%3A%20italic%3B%0A%7D%0Ali%20%0A%7B%0A%7D%0Ali%20%3E%20p%20%0A%7B%0Amargin%2Dtop%3A%201em%3B%20%0A%7D%0Aul%20%0A%7B%0A%7D%0Aul%20li%20%0A%7B%0A%7D%0Aol%20%0A%7B%0A%7D%0Aol%20li%20%0A%7B%0A%7D%0Ahr%20%7B%7D%0A%0Asub%20%0A%7B%0A%7D%0Asup%20%0A%7B%0A%7D%0Aem%20%0A%7B%0A%7D%0Aem%20%3E%20em%20%0A%7B%0Afont%2Dstyle%3A%20normal%3B%0A%7D%0Astrong%20%0A%7B%0A%7D%0A%0Aa%20%0A%7B%0A%0Atext%2Ddecoration%3A%20none%3B%0A%7D%0A%40media%20screen%0A%7B%0Aa%3Ahover%0A%7B%0A%0Atext%2Ddecoration%3A%20underline%3B%0A%7D%0A%7D%0A%40media%20print%0A%7B%0Aa%20%7B%0A%0Acolor%3A%20black%3B%0Abackground%3A%20transparent%3B%0A%7D%0Aa%5Bhref%5E%3D%22http%3A%2F%2F%22%5D%3Aafter%2C%20a%5Bhref%5E%3D%22https%3A%2F%2F%22%5D%3Aafter%0A%7B%0A%0Acontent%3A%20%22%20%28%22%20attr%28href%29%20%22%29%20%22%3B%0Afont%2Dsize%3A%2090%25%3B%0A%7D%0A%7D%0A%0Aimg%0A%7B%0A%0Avertical%2Dalign%3A%20middle%3B%0A%7D%0Adiv%2Efigure%20%0A%7B%0A%0Amargin%2Dleft%3A%20auto%3B%0Amargin%2Dright%3A%20auto%3B%0Atext%2Dalign%3A%20center%3B%0Afont%2Dstyle%3A%20italic%3B%0A%7D%0Ap%2Ecaption%20%0A%7B%0A%0A%7D%0A%0Apre%2C%20code%20%7B%0Abackground%2Dcolor%3A%20%23fdf7ee%3B%0A%0A%0A%0Awhite%2Dspace%3A%20pre%2Dwrap%3B%20%0Awhite%2Dspace%3A%20%2Dmoz%2Dpre%2Dwrap%20%21important%3B%20%0Awhite%2Dspace%3A%20%2Dpre%2Dwrap%3B%20%0Awhite%2Dspace%3A%20%2Do%2Dpre%2Dwrap%3B%20%0Aword%2Dwrap%3A%20break%2Dword%3B%20%0A%0A%7D%0Apre%20%0A%7B%0A%0Apadding%3A%200%2E5em%3B%20%0Aborder%2Dradius%3A%205px%3B%20%0A%0Aborder%3A%201px%20solid%20%23aaa%3B%0A%0Amargin%2Dleft%3A%200%2E5em%3B%0Amargin%2Dright%3A%200%2E5em%3B%0A%7D%0A%40media%20screen%0A%7B%0Apre%0A%7B%0A%0Awhite%2Dspace%3A%20pre%3B%0Aoverflow%3A%20auto%3B%0A%0Aborder%3A%201px%20dotted%20%23777%3B%0A%7D%0A%7D%0Acode%20%0A%7B%0A%7D%0Ap%20%3E%20code%2C%20li%20%3E%20code%20%0A%7B%0A%0Apadding%2Dleft%3A%202px%3B%0Apadding%2Dright%3A%202px%3B%0A%7D%0Ali%20%3E%20p%20code%20%0A%7B%0A%0Apadding%3A%202px%3B%0A%7D%0A%0Aspan%2Emath%20%0A%7B%0A%0A%7D%0Adiv%2Emath%20%0A%7B%0A%7D%0Aspan%2ELaTeX%20%0A%7B%0A%7D%20eq%20%0A%7B%0A%7D%20%0A%0Atable%0A%7B%0Aborder%2Dcollapse%3A%20collapse%3B%0Aborder%2Dspacing%3A%200%3B%20%0Aborder%2Dbottom%3A%202pt%20solid%20%23000%3B%0Aborder%2Dtop%3A%202pt%20solid%20%23000%3B%20%0A%0Amargin%2Dleft%3A%20auto%3B%0Amargin%2Dright%3A%20auto%3B%0A%7D%0Athead%20%0A%7B%0Aborder%2Dbottom%3A%201pt%20solid%20%23000%3B%0Abackground%2Dcolor%3A%20%23eee%3B%20%0A%7D%0Atr%2Eheader%20%0A%7B%0A%7D%20tbody%20%0A%7B%0A%7D%0A%0Atr%20%7B%0A%7D%0Atr%2Eodd%3Ahover%2C%20tr%2Eeven%3Ahover%20%0A%7B%0Abackground%2Dcolor%3A%20%23eee%3B%0A%7D%0A%0Atr%2Eodd%20%7B%7D%0Atr%2Eeven%20%7B%7D%0Atd%2C%20th%20%0A%7B%20vertical%2Dalign%3A%20top%3B%20%0Avertical%2Dalign%3A%20baseline%3B%20%0Apadding%2Dleft%3A%200%2E5em%3B%0Apadding%2Dright%3A%200%2E5em%3B%0Apadding%2Dtop%3A%200%2E2em%3B%0Apadding%2Dbottom%3A%200%2E2em%3B%0A%7D%0A%0A%0Ath%20%0A%7B%0Afont%2Dweight%3A%20bold%3B%20%7D%0Atfoot%20%0A%7B%0A%7D%0Acaption%20%0A%7B%0Acaption%2Dside%3A%20top%3B%0Aborder%3A%20none%3B%0Afont%2Dsize%3A%200%2E9em%3B%0Afont%2Dstyle%3A%20italic%3B%0Atext%2Dalign%3A%20center%3B%0Amargin%2Dbottom%3A%200%2E3em%3B%20%0Apadding%2Dbottom%3A%200%2E2em%3B%0A%7D%0A%0Adl%20%0A%7B%0Aborder%2Dtop%3A%202pt%20solid%20black%3B%0Apadding%2Dtop%3A%200%2E5em%3B%0Aborder%2Dbottom%3A%202pt%20solid%20black%3B%0A%7D%0Adt%20%0A%7B%0Afont%2Dweight%3A%20bold%3B%0A%7D%0Add%2Bdt%20%0A%7B%0Aborder%2Dtop%3A%201pt%20solid%20black%3B%0Apadding%2Dtop%3A%200%2E5em%3B%0A%7D%0Add%20%0A%7B%0Amargin%2Dbottom%3A%200%2E5em%3B%0A%7D%0Add%2Bdd%20%0A%7B%0Aborder%2Dtop%3A%201px%20solid%20black%3B%20%0A%7D%0A%0Aa%2Efootnote%2C%20a%2EfootnoteRef%20%7B%20%0Afont%2Dsize%3A%20small%3B%20vertical%2Dalign%3A%20text%2Dtop%3B%0A%7D%0Aa%5Bhref%5E%3D%22%23fnref%22%5D%2C%20a%2Ereversefootnote%20%0A%7B%0A%7D%0A%40media%20print%0A%7B%0Aa%5Bhref%5E%3D%22%23fnref%22%5D%2C%20a%2Ereversefootnote%20%0A%7B%0A%0Adisplay%3A%20none%3B%0A%7D%0A%7D%0Adiv%2Efootnotes%20%0A%7B%0A%7D%0Adiv%2Efootnotes%20li%5Bid%5E%3D%22fn%22%5D%20%0A%7B%0A%7D%0A%0A%40media%20print%0A%7B%0A%2Enoprint%0A%7B%0Adisplay%3Anone%3B%0A%7D%0A%7D%0A" rel="stylesheet" type="text/css" />
10</head>
11<body>
12<div id="TOC">
13<ul>
14<li><a href="#installing-smokeping-as-a-slave"><span class="toc-section-number">0.1</span> Installing SmokePing as a Slave</a></li>
15</ul>
16</div>
17<h2 id="installing-smokeping-as-a-slave"><span class="header-section-number">0.1</span> Installing SmokePing as a Slave</h2>
18<ul>
19<li>Prequisites: Fully functional SmokePing installation to act as the Master</li>
20<li>References: http://oss.oetiker.ch/smokeping/doc/smokeping_master_slave.en.html</li>
21</ul>
22<p>Instructions tested on Ubuntu 8.10 Server ONLY</p>
23<p>Run all commands as root ($ sudo -s, then run all commands)</p>
24<ol style="list-style-type: decimal">
25<li>SLAVE Setup Instructions</li>
26</ol>
27<p>Setup Smokeping</p>
28<pre><code># apt-get install smokeping</code></pre>
29<ul>
30<li>No configuration files are necessary for slave installations</li>
31<li>Technically, you don't need SpeedyCGI for slave installations, but you'll get everything with the Ubuntu package</li>
32<li>If you want to run SmokePing as a master or stand-alone installation, you will have all the files you need</li>
33</ul>
34<p>Create a file containing a password to be used as a shared secret</p>
35<pre><code>#  editor /etc/smokeping/slave_secret</code></pre>
36<ul>
37<li>Enter a strong password on the first line of the new file, then save the file</li>
38<li>Note, /etc/smokeping/slave_secret will contain one word, the password, and nothing else</li>
39</ul>
40<p>Set appropriate permissions on this file</p>
41<pre><code># chmod 600 /etc/smokeping/slave_secret
42# chown smokeping:root /etc/smokeping/slave_secret</code></pre>
43<p>Create the cache directory and set appropriate persmissions</p>
44<pre><code># mkdir /var/smokeping
45# chown smokeping:root /var/smokeping</code></pre>
46<p>Modify the init.d Daemon script so /etc/init.d/smokeping start | stop | restart works</p>
47<pre><code># editor /etc/init.d/smokeping</code></pre>
48<p>Change &quot;MODE=master&quot; to &quot;MODE=slave&quot; Change DAEMON_ARGS=&quot;&quot; to &quot;DAEMON_ARGS=&quot;--master-url=http://<master_IP>/<path to smokeping.cgi>&quot; --cache-dir=/var/smokeping/ --shared-secret=/etc/smokeping/slave-secret&quot;</p>
49<p>Restart SmokePing</p>
50<pre><code># /etc/init.d/smokeping restart</code></pre>
51<ol start="2" style="list-style-type: decimal">
52<li>MASTER Setup Instructions</li>
53</ol>
54<p>Create a file containing the password to be used as a shared secret</p>
55<pre><code># editor /etc/smokeping/master_secrets</code></pre>
56<ul>
57<li>Enter the hostname (hostname only, not fully qualified domain name) followed by a colon, followed by the password on one line The password should match what you created on your slave SmokePing installation in /etc/smokeping/slave_secret The hostname is the name of the host running the slave installation of SmokePing If you have multiple slaves, put the hostname:password combinations on separate lines Example: myhostname:mypassword</li>
58</ul>
59<p>Set appropriate permisssions on this file</p>
60<pre><code># chmod 640 /etc/smokeping/master_secrets
61# chown www-data:root /etc/smokeping/master_secrets</code></pre>
62<p>Modify the SmokePing Slaves configuration file</p>
63<pre><code># editor /etc/smokeping/config.d/Slaves</code></pre>
64<ul>
65<li>This file should be as follows, but replace 'myhostname' with the hostname of your slave SmokePing installation The display_name can be whatever you wish but should be descriptive of where the slave is located If you have multiple slaves, put in additional +myhostname, display_name, and color lines ------ *** Slaves *** # ## make sure this is not world-readable! secrets=/etc/smokeping/masters-secrets</li>
66</ul>
67<p>+myhostname display_name=myhostname color=0000ff ------</p>
68<p>Modify the SmokePint Targets configuration file</p>
69<pre><code># editor /etc/smokeping/config.d/Targets</code></pre>
70<ul>
71<li>Add the following line under the *** Targets *** title, replacing myhostname with the name of your slave Smokeping installation If you have multiple slaves, put them all on one line separate by spaces ------ slaves = myhostname ------</li>
72</ul>
73<p>Restart SmokePing</p>
74<pre><code># /etc/init.d/smokeping stop
75# /etc/init.d/smokeping start</code></pre>
76</body>
77</html>