/[gentoo]/xml/htdocs/doc/en/jffnms.xml
Gentoo

Diff of /xml/htdocs/doc/en/jffnms.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.11 Revision 1.12
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.11 2011/09/04 17:53:40 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.12 2012/08/30 07:24:00 nightmorph Exp $ -->
4 4
5<guide lang="en"> 5<guide>
6<title>Jffnms Installation and Setup Guide</title> 6<title>Jffnms Installation and Setup Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="angusyoung@gentoo.org">Otavio R. Piske</mail> 9 <mail link="angusyoung"/>
10</author> 10</author>
11 11
12<abstract> 12<abstract>
13This guide shows you how to proceed with the post installation setup of Jffnms, 13This guide shows you how to proceed with the post installation setup of Jffnms,
14a network management and monitoring system, and how to monitor your systems 14a network management and monitoring system, and how to monitor your systems
15with it. 15with it.
16</abstract> 16</abstract>
17 17
18<!-- The content of this document is licensed under the CC-BY-SA license --> 18<!-- The content of this document is licensed under the CC-BY-SA license -->
19<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 19<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 20<license/>
21 21
22<version>1.5</version> 22<version>2</version>
23<date>2008-03-17</date> 23<date>2012-08-30</date>
24 24
25<chapter> 25<chapter>
26<title>Jffnms Basics</title> 26<title>Jffnms Basics</title>
27<section> 27<section>
28<title>Introduction</title> 28<title>Introduction</title>
29<body> 29<body>
30 30
31<p> 31<p>
32<uri link="http://www.jffnms.org">Jffnms</uri> is a network management and 32<uri link="http://www.jffnms.org">Jffnms</uri> is a network management and
33monitoring system. It allows you to grab information from many different kinds 33monitoring system. It allows you to grab information from many different kinds
34of hosts and protocols. With this guide, we aim to show you how to get Jffnms 34of hosts and protocols. With this guide, we aim to show you how to get Jffnms
35properly installed and have your systems monitored by this amazing tool. 35properly installed and have your systems monitored by this amazing tool.
36</p> 36</p>
37 37
38</body> 38</body>
230run this commands on the remote host, the procedure is the same. 230run this commands on the remote host, the procedure is the same.
231</p> 231</p>
232 232
233</body> 233</body>
234</section> 234</section>
235<section> 235<section>
236<title>Setting up PostgreSQL</title> 236<title>Setting up PostgreSQL</title>
237<body> 237<body>
238 238
239<note> 239<note>
240If you already have a PostgreSQL database up and running, you can proceed to 240If you already have a PostgreSQL database up and running, you can proceed to
241the <uri link="#use-pg">next section</uri>. 241the <uri link="#use-pg">next section</uri>.
242</note> 242</note>
243 243
244<p> 244<p>
245You should add PostgreSQL to your default runlevel so it's started each time 245You should add PostgreSQL to your default runlevel so it's started each time you
246you boot your computer. 246boot your computer. Make sure to change <c>${SLOT}</c> to your PostgreSQL
247slot, such as 9.1 or 9.2.
247</p> 248</p>
248 249
249<pre caption="Adding PostgreSQL to the default runlevel"> 250<pre caption="Adding PostgreSQL to the default runlevel">
250# <i>rc-update add postgresql default</i> 251# <i>rc-update add postgresql-${SLOT} default</i>
251</pre> 252</pre>
252 253
253<p> 254<p>
254Now you must setup the PostgreSQL database. 255Now you must setup the PostgreSQL database. Make sure to change
256<c>${VERSION}</c> to your PostgreSQL version, such as 9.0.9 or 9.1.5.
255</p> 257</p>
256 258
257<pre caption="Preparing PostgreSQL"> 259<pre caption="Preparing PostgreSQL">
258# <i>emerge --config postgresql</i> 260# <i>emerge --config postgresql-server-${VERSION}</i>
259</pre> 261</pre>
260 262
261<p> 263<p>
262Now start PostgreSQL: 264Now start PostgreSQL:
263</p> 265</p>
264 266
265<pre caption="Starting PostgreSQL"> 267<pre caption="Starting PostgreSQL">
266# <i>/etc/init.d/postgresql start</i> 268# <i>/etc/init.d/postgresql-${SLOT} start</i>
267</pre> 269</pre>
268 270
269</body> 271</body>
270</section> 272</section>
271<section id="use-pg"> 273<section id="use-pg">
272<title>Using PostgreSQL as database</title> 274<title>Using PostgreSQL as database</title>
273<body> 275<body>
274 276
275<p> 277<p>
276Once you have your PostgreSQL set up and running, you have to create a Jffnms 278Once you have your PostgreSQL set up and running, you have to create a Jffnms
277user and a database to store host data. 279user and a database to store host data.
278</p> 280</p>
279 281
280<pre caption="Creating the Jffnms user and database"> 282<pre caption="Creating the Jffnms user and database">
281# <i>psql template1 postgres</i> 283# <i>psql template1 postgres</i>
282template1=# <i>create user jffnms password 'jfnms' createdb;</i> 284template1=# <i>create user jffnms password 'jfnms' createdb;</i>
283template1=# <i>\connect template1 jffnms</i> 285template1=# <i>\connect template1 jffnms</i>
284template1=# <i>create database jffnms;</i> 286template1=# <i>create database jffnms;</i>
285template1=# <i>\q</i> 287template1=# <i>\q</i>
286</pre> 288</pre>
287 289
288<p> 290<p>
289Finally, you need to create all the tables where data will be stored: 291Finally, you need to create all the tables where data will be stored:
290</p> 292</p>
291 293
292<pre caption="Creating Jffnms tables"> 294<pre caption="Creating Jffnms tables">
293# <i>psql jffnms jffnms &lt; /opt/jffnms/docs/jffnms-0.8.3.pgsql</i> 295# <i>psql jffnms jffnms &lt; /opt/jffnms/docs/jffnms-0.9.3.pgsql</i>
294</pre> 296</pre>
295 297
296<p> 298<p>
297Once you have run those steps, the PostgreSQL database configuration for Jffnms 299Once you have run those steps, the PostgreSQL database configuration for Jffnms
298should be ok. 300should be ok.
299</p> 301</p>
300 302
301</body> 303</body>
302</section> 304</section>
303<section> 305<section>
304<title>Using MySQL as database</title> 306<title>Using MySQL as database</title>
305<body> 307<body>
306 308
307<warn> 309<warn>
308Installing and configuring a MySQL database is not covered in this guide. 310Installing and configuring a MySQL database is not covered in this guide.
309Please see our <uri link="/doc/en/mysql-howto.xml">MySQL Startup Guide</uri>. 311Please see our <uri link="/doc/en/mysql-howto.xml">MySQL Startup Guide</uri>.
310</warn> 312</warn>
311 313
312<p> 314<p>
313In case you want to run Jffnms with MySQL, you'll first need to create a 315In case you want to run Jffnms with MySQL, you'll first need to create a
314database and a MySQL user. After that, create your MySQL table: 316database and a MySQL user. After that, create your MySQL table:
315</p> 317</p>
316 318
317<pre caption="Create a mysql table."> 319<pre caption="Create a mysql table.">
318# <i>mysql -u jffnms -pjffnms jffnms &lt; /opt/jffnms/docs/jffnms-0.8.3.mysql</i> 320# <i>mysql -u jffnms -pjffnms jffnms &lt; /opt/jffnms/docs/jffnms-0.9.3.mysql</i>
319</pre> 321</pre>
320 322
321</body> 323</body>
322</section> 324</section>
323<section> 325<section>
324<title>UDP Port Monitoring and discovery</title> 326<title>UDP Port Monitoring and discovery</title>
325<body> 327<body>
326 328
327<warn> 329<warn>
328This section covers setting up and running suid programs, so it may not be 330This section covers setting up and running suid programs, so it may not be
329adequate for systems where security is too much an issue. 331adequate for systems where security is too much an issue.
330</warn> 332</warn>
331 333
332<p> 334<p>
333If you want UDP port monitoring and discovery, you need to set <c>nmap</c> and 335If you want UDP port monitoring and discovery, you need to set <c>nmap</c> and
392Though Jffnms is a wonderful application, it is a bit hard to get it up and 394Though Jffnms is a wonderful application, it is a bit hard to get it up and
393running. So if you run into problems with Jffnms, there are some places where 395running. So if you run into problems with Jffnms, there are some places where
394you can look for help: 396you can look for help:
395</p> 397</p>
396 398
397<ul> 399<ul>
398 <li> 400 <li>
399 <uri link="http://www.jffnms.org/docs/installing.html">Jffnms Installation 401 <uri link="http://www.jffnms.org/docs/installing.html">Jffnms Installation
400 Manual</uri> 402 Manual</uri>
401 </li> 403 </li>
402 <li> 404 <li>
403 <uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri> 405 <uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri>
404 </li> 406 </li>
405 <li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li> 407 <li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li>
406 <li> 408 <li>
407 <uri link="http://www.postgresql.org/docs/8.0/static/index.html">PostgreSQL 409 <uri link="http://www.postgresql.org/docs/9.1/static/index.html">PostgreSQL
408 8 Documentation</uri> 410 9 Documentation</uri>
409 </li> 411 </li>
410 <li><uri link="http://dev.mysql.com/doc/">MySQL Documentation</uri></li> 412 <li><uri link="http://dev.mysql.com/doc/">MySQL Documentation</uri></li>
411</ul> 413</ul>
412 414
413</body> 415</body>
414</section> 416</section>
415</chapter> 417</chapter>
416</guide> 418</guide>

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.12

  ViewVC Help
Powered by ViewVC 1.1.20