| 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> |
|
|
49 | In order to better fit your needs, Jffnms ebuild has the following USE Flags |
|
|
50 | available: |
|
|
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> |
|
|
81 | Being written in PHP, Jffnms is heavily dependent on php USE Flags. In order |
|
|
82 | to install Jffnms successfully, it is required that you have your php package |
|
|
83 | installed 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 < /usr/portage/net-analyzer/jffnms/files/postgresql_db</i> |
339 | # <i>psql template1 postgres < /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 < /usr/portage/net-analyzer/jffnms/files/postgresql_db_tables</i> |
343 | # <i>psql template1 postgres < /usr/portage/net-analyzer/jffnms/files/postgresql_db_table</i> |
| 269 | </pre> |
344 | </pre> |
| 270 | |
345 | |
| 271 | <p> |
346 | <p> |
| 272 | Finally, you need to create all the tables where data will be stored: |
347 | Finally, you need to create all the tables where data will be stored: |
| 273 | </p> |
348 | </p> |
| … | |
… | |
| 347 | <p> |
422 | <p> |
| 348 | The poller process is responsible for gathering data from hosts. In order to |
423 | The poller process is responsible for gathering data from hosts. In order to |
| 349 | collect this data at regular intervals, it must be added to crontab. |
424 | collect 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> |
|
|
439 | By now, Jffnms should be correctly installed on your system. You still need, |
|
|
440 | however, to configure Jffms. Luckily, Jffnms provides us with an easy to use |
|
|
441 | web page where it's possible to configure access to database, user access as |
|
|
442 | well as check if the current host configuration suffices Jffnms needs. You can |
|
|
443 | access this web interface through the following URL: |
|
|
444 | <uri>http://localhost/jffnms/admin/setup.php</uri>. You should visit <uri |
|
|
445 | link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how to |
|
|
446 | properly 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> |
| 385 | You may also run into problems when configuring Apache to work with PHP |
482 | You 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 |