The jffnms documentation has several problems: Code Listing 2.5: If executed that way it would create a symlink under the name of "htdocs" (e.g. to give /var/www/localhost/htdocs/htdocs) which is not what you'd want. Use ln -s /opt/jffnms/htdocs /var/www/localhost/htdocs/jffnms instead. Configuring PHP: Apart from the fact that the path might be /etc/php/apache2-php5/php.ini instead of ...php4... I'm unconfortable with changing these potentially security-relevant globally. Though probably those who have these kinds of feelings know what to do themselves. Database Setup, Mysql: Code Listing 2.13 apparently does no longer apply (there is nothing in the files directory of the portage jffnms directory), so better remove it. Code Listing 2.14 is slightly wrong: it should be /opt/jffnms/docs/jffnms-0.8.2.mysql instead of /opt/jffnms/docs/docs/jffnms-0.8.2.mysql. (And additionally maybe ...0.8.3... instead of ...0.8.2...) Another useful bit of information which the jffnms installation documentation completely forgets to mention and therefore should be mentioned in the Gentoo doc: After installation you can log in to your new jffnms installation with username admin and password admin. Reproducible: Always
CCing the guide's author and the netmon team (responsible for the package) to see if they know anything more about this.
It looks like maintaining jffnms documentation is a bitch :) Voting to mark as obsolete until we find a steady maintainer?
(In reply to comment #2) > It looks like maintaining jffnms documentation is a bitch :) > Voting to mark as obsolete until we find a steady maintainer? Fine with me.
This bug is only a month old, guys, and it's on a (relatively) brand-new doc. Marking it obsolete is about two years premature. Once I can get on IRC, I'll try to contact the CCed folks directly; I think angusyoung is retired/being retired or is a retirement candidate, so I expect to get more help out of the netmon herd. Who else worked on this guide originally? See if we can get any original contributors to comment.
(In reply to comment #4) > This bug is only a month old, guys, and it's on a (relatively) brand-new doc. > Marking it obsolete is about two years premature. <date>2006-11-18</date> 9 months old, authored by a retired dev and no one in GDP knows anything about it. > Once I can get on IRC, I'll try to contact the CCed folks directly; I think > angusyoung is retired/being retired or is a retirement candidate, so I expect > to get more help out of the netmon herd. He is retired. > Who else worked on this guide originally? No other Gentoo devs helped with it. A couple of contributors commented and submitted patches. You're now its only maintainer.
Thanks for reporting, fixed in CVS. Fixed . . . for now . . . Note to the GDP: we may well have to mark this as unmaintained in the future. I'm also disappointed to note that jffnms is only available for ~x86. Only one arch, and not even stable. At least, the only version (.8.3) isn't stable yet. Unfortunately, the ebuild links to our guide, so I don't think we should delete the guide just yet, but it is a matter of concern as we shouldn't be recommending ~arch software to our users. (Or maybe not even software that's only available for one arch).
Hello to all, After reading about bug 186406, I see that gentoo is searching for a documentation maintainer. I'm ready to volunteer to maintain the docs on jffnms for gentoo. After some time, I will be willing to become the package maintainer (or send patches and info) to the official maintainer, if not accepted as the maintainer. I am not currently a gentoo dev/doc/maintainer so please inform of of the steps I must take to become at least a documentation maintainer. Additionally I have JFFNMS installed on an amd64 system with this entry in the 'package.keywords' file: net-analyzer/jffnms ~x86 and in 'package.unmask': =net-analyzer/jffnms-0.8.3-r1 So this effectively get's the package installed on Gentoo. I have over 20 different machines installed with Gentoo (firewalls, web-servers and workstations) and I'm working on learning to install gentoo on embedded (ARM) systems. Eventually, I want to write code to support lots of embedded targets using JFFNMS under Gentoo Linux. Monitoring and maintaining lots of embedded targets is virgin territory, but, I believe that JFFNMS is extensible enough for the task. Gentoo is my preferred platform for development. Note, I still using Apache- 2.0.58-r2 for now but, I'm willing to figure out how to get it to work with the latest Apache2 offering from Gentoo, and then create/modify the documents for others to test and verify the procedures. JFFNMS is a wonderful software package that I use and as such I'm willing to learn the 'gentoo way' to become the maintainer of this software package. Please let me know who to contact. James
(In reply to comment #7) > I'm ready to volunteer to maintain the docs on jffnms for gentoo. Cool. A best way to get involved is to verify current guide and submit patches about how to improve it. > I am not currently a gentoo dev/doc/maintainer so please inform of > of the steps I must take to become at least a documentation maintainer. Check out http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml . Also other stuff listed at http://www.gentoo.org/proj/en/gdp/ might be worth reading.
UP, I have successfully performed a new installation of jffnms, as of 3/17/08 on both a stable x86 and amd64 system. AMD64 The only thing different I had to do was add this to /etc/portage/package.keywords: net-analyzer/jffnms ~x86 The only problem I found with the documentation where the steps to set up postgresql. I followed the jffnms document section related to postgresql and all was find: PostgreSQL: =========== # psql template1 postgres template1=# create user jffnms password 'jffnms' createdb; template1=# \connect template1 jffnms template1=# create database jffnms; template1=# \q # psql jffnms jffnms < docs/jffnms-0.8.x.pgsql This will create the jffnms Tables and required records. For record purposes here is the Jffnms.org document to which I referred to: http://www.jffnms.org/jffnms/INSTALL so all is fine with Jffnms, just follow the previously mentioned INSTALL doc to correct what is wrong (missing) from in the gentoo doc: http://www.gentoo.org/doc/en/jffnms.xml James
(In reply to comment #9) Next time open a new bug, please. Fixed in CVS.
