| 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.6 2007/07/12 20:05:01 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/jffnms.xml,v 1.7 2007/09/20 18:49:40 nightmorph 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.2</version> |
22 | <version>1.3</version> |
| 23 | <date>2006-11-18</date> |
23 | <date>2007-09-20</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> |
| … | |
… | |
| 186 | <path>/var/www/localhost/htdocs</path> as document root. So, you should do the |
186 | <path>/var/www/localhost/htdocs</path> as document root. So, you should do the |
| 187 | following: |
187 | following: |
| 188 | </p> |
188 | </p> |
| 189 | |
189 | |
| 190 | <pre caption="Creating Jffnms symlink"> |
190 | <pre caption="Creating Jffnms symlink"> |
| 191 | # <i>cd /var/www/localhost/htdocs && ln -s /opt/jffnms/htdocs</i> |
191 | # <i>cd /var/www/localhost/htdocs && ln -s /opt/jffnms/</i> |
| 192 | </pre> |
192 | </pre> |
| 193 | |
193 | |
| 194 | </body> |
194 | </body> |
| 195 | </section> |
195 | </section> |
| 196 | <section> |
196 | <section> |
| … | |
… | |
| 299 | <p> |
299 | <p> |
| 300 | Finally, you need to create all the tables where data will be stored: |
300 | Finally, you need to create all the tables where data will be stored: |
| 301 | </p> |
301 | </p> |
| 302 | |
302 | |
| 303 | <pre caption="Creating Jffnms database"> |
303 | <pre caption="Creating Jffnms database"> |
| 304 | # <i>psql jffnms jffnms < /opt/jffnms/docs/jffnms-0.8.2.pgsql</i> |
304 | # <i>psql jffnms jffnms < /opt/jffnms/docs/jffnms-0.8.3.pgsql</i> |
| 305 | </pre> |
305 | </pre> |
| 306 | |
306 | |
| 307 | <p> |
307 | <p> |
| 308 | Once you have run those steps, PostgreSQL database configuration for Jffnms |
308 | Once you have run those steps, PostgreSQL database configuration for Jffnms |
| 309 | should be ok. |
309 | should be ok. |
| … | |
… | |
| 319 | Installing and configuring a MySQL database is not covered in this guide. |
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>. |
320 | Please see our <uri link="/doc/en/mysql-howto.xml">MySQL Startup Guide</uri>. |
| 321 | </warn> |
321 | </warn> |
| 322 | |
322 | |
| 323 | <p> |
323 | <p> |
| 324 | In case you want to run Jffnms with MySQL, the process is a bit simpler. We |
324 | In case you want to run Jffnms with MySQL, you'll first need to create a |
| 325 | provide two files to create database, user and tables for MySQL. |
325 | database and a MySQL user. After that, create your MySQL table: |
| 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> |
326 | </p> |
| 337 | |
327 | |
| 338 | <pre caption="Create a mysql tables."> |
328 | <pre caption="Create a mysql table."> |
| 339 | # <i>mysql -u jffnms -pjffnms jffnms < /opt/jffnms/docs/docs/jffnms-0.8.2.mysql</i> |
329 | # <i>mysql -u jffnms -pjffnms jffnms < /opt/jffnms/docs/jffnms-0.8.3.mysql</i> |
| 340 | </pre> |
330 | </pre> |
| 341 | |
331 | |
| 342 | </body> |
332 | </body> |
| 343 | </section> |
333 | </section> |
| 344 | <section> |
334 | <section> |
| … | |
… | |
| 392 | By now, Jffnms should be correctly installed on your system. You still need, |
382 | 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 |
383 | 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 |
384 | 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 |
385 | well as check if the current host configuration suffices Jffnms needs. You can |
| 396 | access this web interface through the following URL: |
386 | access this web interface through the following URL: |
| 397 | <uri>http://localhost/jffnms/admin/setup.php</uri>. You should visit <uri |
387 | <uri>http://localhost/jffnms/admin/setup.php</uri>. You can login to your new |
|
|
388 | installation by using the username and password <c>admin</c>. You should visit |
| 398 | link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how to |
389 | <uri link="http://www.jffnms.org/">Jffnms's home page</uri> for details on how |
| 399 | properly configure it. |
390 | to properly configure it. |
| 400 | </p> |
391 | </p> |
| 401 | |
392 | |
| 402 | </body> |
393 | </body> |
| 403 | </section> |
394 | </section> |
| 404 | </chapter> |
395 | </chapter> |