Setting up NAV from scratch/non-OVA (Graphite-issues)

[Joachim Tingvold]

Hi,

Decided to install NAV from 'scratch' (i.e. not use the OVA-package).
Got NAV running fine, but had some hiccups getting Graphite working as
it should. Found no documentation on this what-so-ever (neither on the
NAV-pages, or the Graphite-pages), so had to try-and-fail some. Thought
I'd share.


- Debian Wheezy (not OVA)
- NAV via apt (from https://nav.uninett.no/debian)
***@tardis:~# dpkg -s nav|grep Vers
Version: 4.0.1-3


1) Fixed /etc/nav/graphite.conf;
base=http://localhost:8888/

2) Copied content of '/usr/share/graphite-web/apache2-graphite.conf'
into own VHost;
<VirtualHost localhost:8888>
( + add NameVirtualHost + Listen in /etc/apache2/ports.conf)

3) Set 'CARBON_CACHE_ENABLED=true' in '/etc/default/graphite-carbon'
Set 'ENABLE_UDP_LISTENER = True' in '/etc/carbon/carbon.conf'
Set 'SECRET_KEY = <longsecretstring>' in
'/etc/graphite/local_settings.py'
Set 'TIME_ZONE = '<Gallifrey>' in '/etc/graphite/local_settings.py'

4) cd /usr/share/pyshared/graphite
python manage.py syncdb

5) Started carbon-cache (/etc/init.d/carbon-cache start)

6) Started NAV + apache

Should work.

Some of the errors I got along the road;
<http://files.jocke.no/b/nav-graphite-error.txt>.

[Joachim Tingvold]

Post by Joachim Tingvold
4) cd /usr/share/pyshared/graphite
python manage.py syncdb

Ah, needed some more things to get Graphite working as it should -- do
these before step 5) in my previous email;

cat /etc/nav/graphite/storage-aggregation.conf >
/etc/carbon/storage-aggregation.conf
cat /etc/nav/graphite/storage-schemas.conf >
/etc/carbon/storage-schemas.conf



Oh, also, if you want to start with a 'clean slate', you can do the
following;

** WARNING -- WILL REMOVE ALL GRAPHITE + NAV-DATA **

/etc/init.d/nav stop; /etc/init.d/carbon-cache stop;
/etc/init.d/apache2 stop
rm -rf /var/lib/graphite/whisper/*
rm /var/lib/graphite/graphite.db
python /usr/share/pyshared/graphite/manage.py syncdb
chown _graphite:_graphite /var/lib/graphite/graphite.db
chmod o-r /var/lib/graphite/graphite.db
su - postgres -c 'psql nav -c "truncate device, vlan, netbios
cascade;"'
/etc/init.d/carbon-cache start; /etc/init.d/nav start;
/etc/init.d/apache2 start

[Joachim Tingvold]

Hi,

Decided to install NAV from 'scratch' (i.e. not use the OVA-package). Got NAV running fine, but had some hiccups getting Graphite working as it should. Found no documentation on this what-so-ever (neither on the NAV-pages, or the Graphite-pages), so had to try-and-fail some. Thought I'd share.


- Debian Wheezy (not OVA)
- NAV via apt (from https://nav.uninett.no/debian)
***@tardis:~# dpkg -s nav|grep Vers
Version: 4.0.1-3


1) Fixed /etc/nav/graphite.conf;
base=http://localhost:8888/

2) Copied content of '/usr/share/graphite-web/apache2-graphite.conf' into own VHost;
<VirtualHost localhost:8888>
( + add NameVirtualHost + Listen in /etc/apache2/ports.conf)

3) Set 'CARBON_CACHE_ENABLED=true' in '/etc/default/graphite-carbon'
Set 'ENABLE_UDP_LISTENER = True' in '/etc/carbon/carbon.conf'
Set 'SECRET_KEY = <longsecretstring>' in '/etc/graphite/local_settings.py'
Set 'TIME_ZONE = '<Gallifrey>' in '/etc/graphite/local_settings.py'

4) cd /usr/share/pyshared/graphite
python manage.py syncdb

5) Started carbon-cache (/etc/init.d/carbon-cache start)

6) Started NAV + apache

Should work.

Some of the errors I got along the road; <http://files.jocke.no/b/nav-graphite-error.txt>.

[Joachim Tingvold]

Hi,

Sorry for the duplicate. One of them was sent last night (-:

[Morten Brekkevold]

Post by Joachim Tingvold
Decided to install NAV from 'scratch' (i.e. not use the OVA-package). Got NAV
running fine, but had some hiccups getting Graphite working as it should.
Found no documentation on this what-so-ever (neither on the NAV-pages, or the
Graphite-pages), so had to try-and-fail some. Thought I'd share.

Thanks for the writeup, Joachim. You couldn't possibly have searched
NAVs wiki pages very thoroughly - a quick search for the word "graphite"
in the wiki reveals this page as the first search hit:

https://nav.uninett.no/graphite_on_debian

[Joachim Tingvold]

Post by Morten Brekkevold
Thanks for the writeup, Joachim. You couldn't possibly have searched
NAVs wiki pages very thoroughly - a quick search for the word
"graphite"
https://nav.uninett.no/graphite_on_debian

Well, you kinda have a split-brain regarding documentation, then. On
your main page[1] there's a link called "Documentation"[2]. None of the
links on that page have remotely the steps needed to get Graphite
running (-:

[1] <https://nav.uninett.no>
[2] <https://nav.uninett.no/doc/>

[Morten Brekkevold]

Post by Morten Brekkevold
Thanks for the writeup, Joachim. You couldn't possibly have searched
NAVs wiki pages very thoroughly - a quick search for the word "graphite"
https://nav.uninett.no/graphite_on_debian

Well, you kinda have a split-brain regarding documentation, then. On your main
page[1] there's a link called "Documentation"[2]. None of the links on that
[1] <https://nav.uninett.no>
[2] <https://nav.uninett.no/doc/>

Sorry about that; [2] is NAV's documentation, not Graphite's, which is
why the doc explicitly states that Graphite installation is
out-of-scope.

Graphite's documentation can be found at http://graphite.wikidit.com.
The fact that Graphite's documentation sucks is what made us write the
wiki article.

There is still more NAV doc in the wiki, but we are slowly moving and
updating everything to [2], so that only "wiki-esque" material remains
in the wiki.