doc/en/jffnms.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.5 2007/07/09 08:35:04 nightmorph Exp $ -->

<guide link="/doc/en/jffnms.xml" lang="en">
<title>Jffnms Installation and Setup Guide</title>

<author title="Author">
  <mail link="angusyoung@gentoo.org">Otavio R. Piske</mail>
</author>

<abstract>
This guide shows you how to proceed with the post installation setup of Jffnms,
a network management and monitoring system, and how to monitor your systems
with it.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.2</version>
<date>2006-11-18</date>

<chapter>
<title>Jffnms Basics</title>
<section>
<title>Introduction</title>
<body>

<p>
<uri link="http://www.jffnms.org">Jffnms</uri> is a network management and
monitoring system. It allows you to grab information from many different kinds
of hosts and protocols. With this guide, we aim to show you how to get Jffnms
properly installed and have your systems monitored by this amazing tool.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Initial Setup</title>
<section>
<title>Choosing your use flags</title>
<body>

<p>
In order to better fit your needs, Jffnms ebuild has the following USE Flags
available:
</p>

<table>
<tr>
  <th>USE Flags for Jffnms</th>
  <th>Description</th>
</tr>
<tr>
  <ti><c>mysql</c></ti>
  <ti>Uses Mysql to store Jffnms data</ti>
</tr>
<tr>
  <ti><c>postgres</c></ti>
  <ti>Uses PostgreSQL to store Jffnms data</ti>
</tr>
<tr>
  <ti><c>snmp</c></ti>
  <ti>
    Adds support for snmp, which enables jffnms to gather data from other hosts.
  </ti>
</tr>
</table>

</body>
</section>
<section>
<title>USE Flags for PHP</title>
<body>

<p>
Being written in PHP, Jffnms is heavily dependent on php USE Flags. In order to
install Jffnms successfully, you are required to have your php package installed
with (at least) the following USE flags:
</p>

<table>
<tr>
  <th>USE Flags for PHP</th>
  <th>Description</th>
</tr>
<tr>
  <ti><c>gd</c></ti>
  <ti>Adds support for media-libs/gd (to generate graphics on the fly)</ti>
</tr>
<tr>
  <ti><c>wddx</c></ti>
  <ti>Adds support for Web Distributed Data eXchange </ti>
</tr>
<tr>
  <ti><c>sockets</c></ti>
  <ti>Adds support for tcp/ip sockets</ti>
</tr>
<tr>
  <ti><c>session</c></ti>
  <ti>Adds persistent session support</ti>
</tr>
<tr>
  <ti><c>spl</c></ti>
  <ti>Adds support for the Standard PHP Library</ti>
</tr>
<tr>
  <ti><c>cli</c></ti>
  <ti>Enable CLI SAPI</ti>
</tr>
</table>

</body>
</section>
<section>
<title>Installation</title>
<body>

<p>
Just like any package in Portage, jffnms can be installed with <c>emerge</c>:
</p>

<pre caption="Installing Jffnms">
# <i>emerge jffnms</i>
</pre>

<p>
Jffnms should be installed in <path>/opt/jffnms/</path>.
</p>

</body>
</section>
<section>
<title>Configuring Apache 2</title>
<body>

<warn>
This very basic configuration procedure for apache does not cover all aspects
of setting up a web server.
</warn>

<p>
Sometimes you will want to run Jffnms on your local computer instead of a
remote server. If this is your case, it is very likely that you don't have an
apache setup running. Don't worry about installing apache though, Portage has
already done that for you. Nevertheless, you still have to configure and test
apache, which (luckily) is pretty straightforward. Start by adding apache to
your default runlevel:
</p>

<pre caption="Adding apache 2 to the default runlevel">
# <i>rc-update add apache2 default</i>
 * apache2 added to runlevel default
 * rc-update complete.
</pre>

<p>
If you haven't done it yet, it's time to start apache2:
</p>

<pre caption="Starting apache2">
# <i>/etc/init.d/apache2 start</i>
</pre>

<p>
Finally, point your browser at <uri>http://localhost/</uri> and you should be
presented with a home page about your newly installed Apache 2.  Now that we
know that Apache is up and running, we can proceed to the mod_php
configuration.  Fire up your favorite text editor, open
<path>/etc/conf.d/apache2</path> and add <c>-D PHP4</c> the APACHE2_OPTS
variable.
</p>

<pre caption="Apache 2 Configuration">
# <i>nano -w /etc/conf.d/apache2</i>
APACHE2_OPTS="-D DEFAULT_VHOST -D PHP4"
</pre>

<p>
After that, you should create a symlink to the Jffnms install directory in your
Apache document root dir. In Gentoo, by default, Apache uses
<path>/var/www/localhost/htdocs</path> as document root. So, you should do the
following:
</p>

<pre caption="Creating Jffnms symlink">
# <i>cd /var/www/localhost/htdocs &amp;&amp; ln -s /opt/jffnms/htdocs</i>
</pre>

</body>
</section>
<section>
<title>Configuring PHP</title>
<body>

<p>
Now that apache is running, it is time to configure PHP. Jffnms requires that
you set some variables in php.ini in order to run. The <path>php.ini</path> file
is usually located in <path>/etc/php/apache2-php4/php.ini</path>. You have to
set these variables to the following values:
</p>

<pre caption="Configuring PHP">
# <i>nano -w /etc/php/apache2-php4/php.ini</i>
register_globals = On
register_argc_argv = On 
error_reporting  =  E_ALL &amp; ~E_NOTICE
allow_url_fopen = On
include_path = ".:/usr/share/php4:/usr/share/php:/usr/share/php/PEAR"
short_open_tag = On
</pre>

</body>
</section>
<section>
<title>Database setup</title>
<body>

<warn>
Please note again that this a very basic configuration procedure for any
database system and does not cover all aspects of setting up such systems.
</warn>

<p>
Jffnms allows you to use either PostgreSQL or MySQL as its database. Here we'll
show you how to create the database and necessary tables where Jffnms will
store its data.  It's important to note that it isn't necessary to have a
database running localy to run Jffnms and except for the fact that you need to
run this commands on the remote host, the procedure is the same.
</p>

</body>
</section>
<section>
<title>Setting Up PostgreSQL</title>
<body>

<note>
If you already have a PostgreSQL database up and running, you can proceed to
the <uri link="#use-pg">next section</uri>.
</note>

<p>
You should add PostgreSQL to your default runlevel so it's started each time
you boot your computer.
</p>
 
<pre caption="Adding PostgreSQL to the default runlevel">
# <i>rc-update add postgresql default</i>
 * postgresql added to runlevel default
 * rc-update complete.
</pre>

<p>
Now you must setup the PostgreSQL database.
</p>

<pre caption="Preparing PostgreSQL">
# <i>emerge --config postgresql</i>
</pre>

<p>
Now start PostgreSQL:
</p>

<pre caption="Starting PostgreSQL">
# <i>/etc/init.d/postgresql start</i>
</pre>

</body>
</section>
<section id="use-pg">
<title>Using PostgreSQL as database</title>
<body>

<p>
Once you have your PostgreSQL set up and running, you have to create a Jffnms
user and a database to store host data. We provide files to do both.
</p>

<note>
If you don't use <path>/usr/portage</path> as your Portage dir ($PORTDIR) you
have to change the last part of these commands to whatever your Portage dir
is.
</note>

<pre caption="Creating Jffnms user">
# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db</i>
</pre>

<pre caption="Creating Jffnms database">
# <i>psql template1 postgres &lt; /usr/portage/net-analyzer/jffnms/files/postgresql_db_table</i>
</pre>

<p>
Finally, you need to create all the tables where data will be stored:
</p>

<pre caption="Creating Jffnms database">
# <i>psql jffnms jffnms &lt; /opt/jffnms/docs/jffnms-0.8.2.pgsql</i>
</pre>

<p>
Once you have run those steps, PostgreSQL database configuration for Jffnms
should be ok.
</p>

</body>
</section>
<section>
<title>Using MySQL as database.</title>
<body>

<warn>
Installing and configuring a MySQL database is not covered in this guide.
Please see our <uri link="/doc/en/mysql-howto.xml">MySQL Startup Guide</uri>.
</warn>

<p>
In case you want to run Jffnms with MySQL, the process is a bit simpler. We
provide two files to create database, user and tables for MySQL.
</p>

<note>
If you don't use <path>/usr/portage</path> as your Portage dir ($PORTDIR) you
have to change the last part of these commands to whatever your Portage dir
is.
</note>

<pre caption="Create a database and a mysql user.">
# <i>mysql -u <comment>username</comment> -p <comment>password</comment> &lt; /usr/portage/net-analyzer/jffnms/files/mysql_db</i>
</pre>

<pre caption="Create a mysql tables.">
# <i>mysql -u jffnms -pjffnms jffnms &lt; /opt/jffnms/docs/docs/jffnms-0.8.2.mysql</i>
</pre>

</body>
</section>
<section>
<title>UDP Port Monitoring and discovery</title>
<body>

<warn>
This section covers setting up and running suid programs, so it may not be
adequate for systems where security is too much an issue.
</warn>

<p>
If you want UDP port monitoring and discovery, you need to set <c>nmap</c> and
<c>fping</c> as a SUID programs. This may give you security hole in case
there's a bug in one of them. To set them as a SUID you can run the following
commands:
</p>

<pre caption="Setting up udp port monitoring and discovery">
# <i>chmod +s /usr/bin/nmap ; chmod a+x /usr/bin/nmap</i>
# <i>chmod +s /usr/sbin/fping ; chmod a+x /usr/sbin/fping</i>
</pre>

</body>
</section>
</chapter>

<chapter>
<title>Configuring Jffnms</title>
<section>
<title>Configuring the poller process</title>
<body>

<p>
The poller process is responsible for gathering data from hosts. In order to
collect this data at regular intervals, it must be added to crontab.
</p>

<pre caption="Collecting data at regular intervals">
# <i>crontab -u jffnms /opt/jffnms/docs/unix/crontab</i>
# <i>crontab -e -u jffnms</i>
</pre>

</body>
</section>
<section>
<title>Final Setup</title>
<body>

<p>
By now, Jffnms should be correctly installed on your system. You still need,
however, to configure Jffnms. Luckily, Jffnms provides us with an easy to use
web page where it's possible to configure access to database, user access as
well as check if the current host configuration suffices Jffnms needs. You can
access this web interface through the following URL:
<uri>http://localhost/jffnms/admin/setup.php</uri>.  You should visit <uri
link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how to
properly configure it.
</p>

 </body>
</section>
</chapter>

<chapter>
<title>Support</title>
<section>
<title>Support</title>
<body>

<p>
Though Jffnms is a wonderful software, it is a bit hard to get it up and
running. So if you run into problems with Jffnms, there are some places where
you can look for help:
</p>

<ul>
  <li>
    <uri link="http://www.jffnms.org/docs/installing.html">Jffnms Installation
    Manual</uri>
  </li>
  <li>
    <uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri>
  </li>
  <li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li>
  <li>
    <uri link="http://www.postgresql.org/docs/8.0/static/index.html">PostgreSQL
    8 Documentation</uri>
  </li>
  <li><uri link="http://dev.mysql.com/doc/">MySQL Documentation</uri></li>
</ul>

<p>
You may also run into problems when configuring Apache to work with PHP
(specially if you run both PHP4 and PHP5 on the same system). In that case, our
<uri link="/proj/en/php/php4-php5-configuration.xml">Configuring Apache to Work
with PHP4 and PHP5</uri> guide may give you some help.
</p>

</body>
</section>
</chapter>
</guide>
1	<?xml version="1.0" encoding="UTF-8"?>
2	<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.5 2007/07/09 08:35:04 nightmorph Exp $ -->
4
5	<guide link="/doc/en/jffnms.xml" lang="en">
6	<title>Jffnms Installation and Setup Guide</title>
7
8	<author title="Author">
9	<mail link="angusyoung@gentoo.org">Otavio R. Piske</mail>
10	</author>
11
12	<abstract>
13	This guide shows you how to proceed with the post installation setup of Jffnms,
14	a network management and monitoring system, and how to monitor your systems
15	with it.
16	</abstract>
17
18	<!-- The content of this document is licensed under the CC-BY-SA license -->
19	<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20	<license/>
21
22	<version>1.2</version>
23	<date>2006-11-18</date>
24
25	<chapter>
26	<title>Jffnms Basics</title>
27	<section>
28	<title>Introduction</title>
29	<body>
30
31	<p>
32	<uri link="http://www.jffnms.org">Jffnms</uri> is a network management and
33	monitoring system. It allows you to grab information from many different kinds
34	of hosts and protocols. With this guide, we aim to show you how to get Jffnms
35	properly installed and have your systems monitored by this amazing tool.
36	</p>
37
38	</body>
39	</section>
40	</chapter>
41
42	<chapter>
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 support for snmp, which enables jffnms 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 to
82	install Jffnms successfully, you are required to have your php package installed
83	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>
119	<section>
120	<title>Installation</title>
121	<body>
122
123	<p>
124	Just like any package in Portage, jffnms can be installed with <c>emerge</c>:
125	</p>
126
127	<pre caption="Installing Jffnms">
128	# <i>emerge jffnms</i>
129	</pre>
130
131	<p>
132	Jffnms should be installed in <path>/opt/jffnms/</path>.
133	</p>
134
135	</body>
136	</section>
137	<section>
138	<title>Configuring Apache 2</title>
139	<body>
140
141	<warn>
142	This very basic configuration procedure for apache does not cover all aspects
143	of setting up a web server.
144	</warn>
145
146	<p>
147	Sometimes you will want to run Jffnms on your local computer instead of a
148	remote server. If this is your case, it is very likely that you don't have an
149	apache setup running. Don't worry about installing apache though, Portage has
150	already done that for you. Nevertheless, you still have to configure and test
151	apache, which (luckily) is pretty straightforward. Start by adding apache to
152	your default runlevel:
153	</p>
154
155	<pre caption="Adding apache 2 to the default runlevel">
156	# <i>rc-update add apache2 default</i>
157	* apache2 added to runlevel default
158	* rc-update complete.
159	</pre>
160
161	<p>
162	If you haven't done it yet, it's time to start apache2:
163	</p>
164
165	<pre caption="Starting apache2">
166	# <i>/etc/init.d/apache2 start</i>
167	</pre>
168
169	<p>
170	Finally, point your browser at <uri>http://localhost/</uri> and you should be
171	presented with a home page about your newly installed Apache 2. Now that we
172	know that Apache is up and running, we can proceed to the mod_php
173	configuration. Fire up your favorite text editor, open
174	<path>/etc/conf.d/apache2</path> and add <c>-D PHP4</c> the APACHE2_OPTS
175	variable.
176	</p>
177
178	<pre caption="Apache 2 Configuration">
179	# <i>nano -w /etc/conf.d/apache2</i>
180	APACHE2_OPTS="-D DEFAULT_VHOST -D PHP4"
181	</pre>
182
183	<p>
184	After that, you should create a symlink to the Jffnms install directory in your
185	Apache document root dir. In Gentoo, by default, Apache uses
186	<path>/var/www/localhost/htdocs</path> as document root. So, you should do the
187	following:
188	</p>
189
190	<pre caption="Creating Jffnms symlink">
191	# <i>cd /var/www/localhost/htdocs && ln -s /opt/jffnms/htdocs</i>
192	</pre>
193
194	</body>
195	</section>
196	<section>
197	<title>Configuring PHP</title>
198	<body>
199
200	<p>
201	Now that apache is running, it is time to configure PHP. Jffnms requires that
202	you set some variables in php.ini in order to run. The <path>php.ini</path> file
203	is usually located in <path>/etc/php/apache2-php4/php.ini</path>. You have to
204	set these variables to the following values:
205	</p>
206
207	<pre caption="Configuring PHP">
208	# <i>nano -w /etc/php/apache2-php4/php.ini</i>
209	register_globals = On
210	register_argc_argv = On
211	error_reporting = E_ALL & ~E_NOTICE
212	allow_url_fopen = On
213	include_path = ".:/usr/share/php4:/usr/share/php:/usr/share/php/PEAR"
214	short_open_tag = On
215	</pre>
216
217	</body>
218	</section>
219	<section>
220	<title>Database setup</title>
221	<body>
222
223	<warn>
224	Please note again that this a very basic configuration procedure for any
225	database system and does not cover all aspects of setting up such systems.
226	</warn>
227
228	<p>
229	Jffnms allows you to use either PostgreSQL or MySQL as its database. Here we'll
230	show you how to create the database and necessary tables where Jffnms will
231	store its data. It's important to note that it isn't necessary to have a
232	database running localy to run Jffnms and except for the fact that you need to
233	run this commands on the remote host, the procedure is the same.
234	</p>
235
236	</body>
237	</section>
238	<section>
239	<title>Setting Up PostgreSQL</title>
240	<body>
241
242	<note>
243	If you already have a PostgreSQL database up and running, you can proceed to
244	the <uri link="#use-pg">next section</uri>.
245	</note>
246
247	<p>
248	You should add PostgreSQL to your default runlevel so it's started each time
249	you boot your computer.
250	</p>
251
252	<pre caption="Adding PostgreSQL to the default runlevel">
253	# <i>rc-update add postgresql default</i>
254	* postgresql added to runlevel default
255	* rc-update complete.
256	</pre>
257
258	<p>
259	Now you must setup the PostgreSQL database.
260	</p>
261
262	<pre caption="Preparing PostgreSQL">
263	# <i>emerge --config postgresql</i>
264	</pre>
265
266	<p>
267	Now start PostgreSQL:
268	</p>
269
270	<pre caption="Starting PostgreSQL">
271	# <i>/etc/init.d/postgresql start</i>
272	</pre>
273
274	</body>
275	</section>
276	<section id="use-pg">
277	<title>Using PostgreSQL as database</title>
278	<body>
279
280	<p>
281	Once you have your PostgreSQL set up and running, you have to create a Jffnms
282	user and a database to store host data. We provide files to do both.
283	</p>
284
285	<note>
286	If you don't use <path>/usr/portage</path> as your Portage dir ($PORTDIR) you
287	have to change the last part of these commands to whatever your Portage dir
288	is.
289	</note>
290
291	<pre caption="Creating Jffnms user">
292	# <i>psql template1 postgres < /usr/portage/net-analyzer/jffnms/files/postgresql_db</i>
293	</pre>
294
295	<pre caption="Creating Jffnms database">
296	# <i>psql template1 postgres < /usr/portage/net-analyzer/jffnms/files/postgresql_db_table</i>
297	</pre>
298
299	<p>
300	Finally, you need to create all the tables where data will be stored:
301	</p>
302
303	<pre caption="Creating Jffnms database">
304	# <i>psql jffnms jffnms < /opt/jffnms/docs/jffnms-0.8.2.pgsql</i>
305	</pre>
306
307	<p>
308	Once you have run those steps, PostgreSQL database configuration for Jffnms
309	should be ok.
310	</p>
311
312	</body>
313	</section>
314	<section>
315	<title>Using MySQL as database.</title>
316	<body>
317
318	<warn>
319	Installing and configuring a MySQL database is not covered in this guide.
320	Please see our <uri link="/doc/en/mysql-howto.xml">MySQL Startup Guide</uri>.
321	</warn>
322
323	<p>
324	In case you want to run Jffnms with MySQL, the process is a bit simpler. We
325	provide two files to create database, user and tables for MySQL.
326	</p>
327
328	<note>
329	If you don't use <path>/usr/portage</path> as your Portage dir ($PORTDIR) you
330	have to change the last part of these commands to whatever your Portage dir
331	is.
332	</note>
333
334	<pre caption="Create a database and a mysql user.">
335	# <i>mysql -u <comment>username</comment> -p <comment>password</comment> < /usr/portage/net-analyzer/jffnms/files/mysql_db</i>
336	</pre>
337
338	<pre caption="Create a mysql tables.">
339	# <i>mysql -u jffnms -pjffnms jffnms < /opt/jffnms/docs/docs/jffnms-0.8.2.mysql</i>
340	</pre>
341
342	</body>
343	</section>
344	<section>
345	<title>UDP Port Monitoring and discovery</title>
346	<body>
347
348	<warn>
349	This section covers setting up and running suid programs, so it may not be
350	adequate for systems where security is too much an issue.
351	</warn>
352
353	<p>
354	If you want UDP port monitoring and discovery, you need to set <c>nmap</c> and
355	<c>fping</c> as a SUID programs. This may give you security hole in case
356	there's a bug in one of them. To set them as a SUID you can run the following
357	commands:
358	</p>
359
360	<pre caption="Setting up udp port monitoring and discovery">
361	# <i>chmod +s /usr/bin/nmap ; chmod a+x /usr/bin/nmap</i>
362	# <i>chmod +s /usr/sbin/fping ; chmod a+x /usr/sbin/fping</i>
363	</pre>
364
365	</body>
366	</section>
367	</chapter>
368
369	<chapter>
370	<title>Configuring Jffnms</title>
371	<section>
372	<title>Configuring the poller process</title>
373	<body>
374
375	<p>
376	The poller process is responsible for gathering data from hosts. In order to
377	collect this data at regular intervals, it must be added to crontab.
378	</p>
379
380	<pre caption="Collecting data at regular intervals">
381	# <i>crontab -u jffnms /opt/jffnms/docs/unix/crontab</i>
382	# <i>crontab -e -u jffnms</i>
383	</pre>
384
385	</body>
386	</section>
387	<section>
388	<title>Final Setup</title>
389	<body>
390
391	<p>
392	By now, Jffnms should be correctly installed on your system. You still need,
393	however, to configure Jffnms. Luckily, Jffnms provides us with an easy to use
394	web page where it's possible to configure access to database, user access as
395	well as check if the current host configuration suffices Jffnms needs. You can
396	access this web interface through the following URL:
397	<uri>http://localhost/jffnms/admin/setup.php</uri>. You should visit <uri
398	link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how to
399	properly configure it.
400	</p>
401
402	</body>
403	</section>
404	</chapter>
405
406	<chapter>
407	<title>Support</title>
408	<section>
409	<title>Support</title>
410	<body>
411
412	<p>
413	Though Jffnms is a wonderful software, it is a bit hard to get it up and
414	running. So if you run into problems with Jffnms, there are some places where
415	you can look for help:
416	</p>
417
418	<ul>
419	<li>
420	<uri link="http://www.jffnms.org/docs/installing.html">Jffnms Installation
421	Manual</uri>
422	</li>
423	<li>
424	<uri link="http://www.jffnms.org/docs/jffnms.html">Jffnms Manual</uri>
425	</li>
426	<li><uri link="http://forums.gentoo.org">Gentoo Forums</uri></li>
427	<li>
428	<uri link="http://www.postgresql.org/docs/8.0/static/index.html">PostgreSQL
429	8 Documentation</uri>
430	</li>
431	<li><uri link="http://dev.mysql.com/doc/">MySQL Documentation</uri></li>
432	</ul>
433
434	<p>
435	You may also run into problems when configuring Apache to work with PHP
436	(specially if you run both PHP4 and PHP5 on the same system). In that case, our
437	<uri link="/proj/en/php/php4-php5-configuration.xml">Configuring Apache to Work
438	with PHP4 and PHP5</uri> guide may give you some help.
439	</p>
440
441	</body>
442	</section>
443	</chapter>
444	</guide>