.. Troubleshooting infos taken from Sanet_tshoot page

Troubleshooting
===============

#. :ref:`rc.sanet dbshell does not work <tshoot-dbshell>`
#. RRDTool

  #. :ref:`Graphs are not drawn <tshoot-rrd-graphs>`

#. Performance

  #. :ref:`Nightly script <tshoot-performance-nightly>`
  #. :ref:`Refresh is too slow <tshoot-performance-refresh>`


.. _tshoot-dbshell:

`rc.sanet dbshell` does not work
------------------------------------

You can't connect to database. Problems could be:

+ The database server is not running
	The message is something like

		psql: could not connect to server: No such file or directory
		Is the server running locally and accepting
		connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

	You should start postgresql server. Probably you have an init script in /etc/init.d or /etc/rc.d

+ Database or role "xxxx" does not exist
	The message is something like

		psql: FATAL:  database "sanet" does not exist

	or

		psql: FATAL:  role "sanet" does not exist

	You must create the "sanet" database. See :ref:`Create your own user and database <install-createdb>`


RRDTool
-------

Required version at least 1.2.26

.. _tshoot-rrd-graphs:

Graphs are not drawn
^^^^^^^^^^^^^^^^^^^^

Check apache2 log files.

Try to load the specific url in your browser and check if you get the graph image.
The url is in the format:

`http[s]://<hostport>/sanet/state/node/<nodeID>/rttgraph/?interval=480m`

for RTT graphs or in the format:

`http[s]://<hostport>/sanet/state/measure/<measureID>/mgraph/?interval=480m`

for measure graphs.

If no image is visualized, check your apache2 `error_log`. Sometimes `rrdtool not found` messages are logged due to the fact that /usr/local/bin has not been set in Apache2 PATH.

Data are not written to RRD file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**TBD**

Performance
-----------

.. _tshoot-performance-nightly:

Nightly script
^^^^^^^^^^^^^^

Make sure that nightly maintenance script is running periodically. In example if cron is installed on your system, set it up to be performed daily wit the following crontab entry: ``45 4 * * * /etc/rc.d/rc.sanet nightly > /var/tmp/lastoutput.sanet.nightly 2>&1``

.. _tshoot-performance-refresh:

Refresh is too slow
^^^^^^^^^^^^^^^^^^^

Refresh is a slow operation. The refresh of the whole site should be avoided unless strictly necessary.
To update single nodes (refreshing or not the related interfaces) the command ``refresh node <node name> [interfaces]`` can be used.