/[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.2 Revision 1.3
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.2 2006/04/15 19:56:03 rane Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.3 2006/04/25 10:58:33 neysx Exp $ -->
4 4
5<guide link="/doc/en/jffnms.xml" lang="en"> 5<guide link="/doc/en/jffnms.xml" lang="en">
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">
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.0</version> 22<version>1.1</version>
23<date>2006-03-10</date> 23<date>2006-04-25</date>
24 24
25<chapter> 25<chapter>
26<title>Jffms Basics</title> 26<title>Jffms Basics</title>
27<section> 27<section>
28<title>Introduction</title> 28<title>Introduction</title>
39</section> 39</section>
40</chapter> 40</chapter>
41 41
42<chapter> 42<chapter>
43<title>Initial Setup</title> 43<title>Initial Setup</title>
44<section>
45<title>Choosing your use flags</title>
46<body>
47
48<p>
49In order to better fit your needs, Jffnms ebuild has the following USE Flags
50available:
51</p>
52
53<table>
54<tr>
55 <th>USE Flags for Jffnms</th>
56 <th>Description</th>
57</tr>
58<tr>
59 <ti><c>mysql</c></ti>
60 <ti>Uses Mysql to store Jffnms data</ti>
61</tr>
62<tr>
63 <ti><c>postgres</c></ti>
64 <ti>Uses PostgreSQL to store Jffnms data</ti>
65</tr>
66<tr>
67 <ti><c>snmp</c></ti>
68 <ti>
69 Adds suport for snmp, which enables jffms to gather data from other hosts.
70 </ti>
71</tr>
72</table>
73
74</body>
75</section>
76<section>
77<title>USE Flags for PHP</title>
78<body>
79
80<p>
81Being written in PHP, Jffnms is heavily dependent on php USE Flags. In order
82to install Jffnms successfully, it is required that you have your php package
83installed with (at least) the following USE flags:
84</p>
85
86<table>
87<tr>
88 <th>USE Flags for PHP</th>
89 <th>Description</th>
90</tr>
91<tr>
92 <ti><c>gd</c></ti>
93 <ti>Adds support for media-libs/gd (to generate graphics on the fly)</ti>
94</tr>
95<tr>
96 <ti><c>wddx</c></ti>
97 <ti>Adds support for Web Distributed Data eXchange </ti>
98</tr>
99<tr>
100 <ti><c>sockets</c></ti>
101 <ti>Adds support for tcp/ip sockets</ti>
102</tr>
103<tr>
104 <ti><c>session</c></ti>
105 <ti>Adds persistent session support</ti>
106</tr>
107<tr>
108 <ti><c>spl</c></ti>
109 <ti>Adds support for the Standard PHP Library</ti>
110</tr>
111<tr>
112 <ti><c>cli</c></ti>
113 <ti>Enable CLI SAPI</ti>
114</tr>
115</table>
116
117</body>
118</section>
44<section> 119<section>
45<title>Installation</title> 120<title>Installation</title>
46<body> 121<body>
47 122
48<p> 123<p>
263<pre caption="Creating Jffnms user"> 338<pre caption="Creating Jffnms user">
264# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db</i> 339# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db</i>
265</pre> 340</pre>
266 341
267<pre caption="Creating Jffnms database"> 342<pre caption="Creating Jffnms database">
268# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db_tables</i> 343# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db_table</i>
269</pre> 344</pre>
270 345
271<p> 346<p>
272Finally, you need to create all the tables where data will be stored: 347Finally, you need to create all the tables where data will be stored:
273</p> 348</p>
347<p> 422<p>
348The poller process is responsible for gathering data from hosts. In order to 423The poller process is responsible for gathering data from hosts. In order to
349collect this data at regular intervals, it must be added to crontab. 424collect this data at regular intervals, it must be added to crontab.
350</p> 425</p>
351 426
352<pre caption="Setting up udp port monitoring and discovery"> 427<pre caption="Collecting data at regular intervals">
353# <i>crontab -u jffnms /opt/jffnms/docs/unix/crontab</i> 428# <i>crontab -u jffnms /opt/jffnms/docs/unix/crontab</i>
354# <i>crontab -e -u jffnms</i> 429# <i>crontab -e -u jffnms</i>
355</pre> 430</pre>
356 431
357</body> 432</body>
433</section>
434<section>
435<title>Final Setup</title>
436<body>
437
438<p>
439By now, Jffnms should be correctly installed on your system. You still need,
440however, to configure Jffms. Luckily, Jffnms provides us with an easy to use
441web page where it's possible to configure access to database, user access as
442well as check if the current host configuration suffices Jffnms needs. You can
443access this web interface through the following URL:
444<uri>http://localhost/jffnms/admin/setup.php</uri>. You should visit <uri
445link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how to
446properly configure it.
447</p>
448
449 </body>
358</section> 450</section>
359</chapter> 451</chapter>
360 452
361<chapter> 453<chapter>
362<title>Support</title> 454<title>Support</title>
377 </li> 469 </li>
378 <li> 470 <li>
379 <uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri> 471 <uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri>
380 </li> 472 </li>
381 <li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li> 473 <li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li>
474 <li>
475 <uri link="http://www.postgresql.org/docs/8.0/static/index.html">PostgreSQL
476 8 Documentation</uri>
477 </li>
478 <li><uri link="http://dev.mysql.com/doc/">MySQL Documentation</uri></li>
382</ul> 479</ul>
383 480
384<p> 481<p>
385You may also run into problems when configuring Apache to work with PHP 482You may also run into problems when configuring Apache to work with PHP
386(specially if you run both PHP4 and PHP5 on the same system). In that case, our 483(specially if you run both PHP4 and PHP5 on the same system). In that case, our

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.20