Troubleshooting

Installation issues

Follow the Installation instructions to install naarad and its necessary prerequisites. We have found that the steps below should help address most issues encountered during installation of dependencies, specially matplotlib.

OS dependencies

Linux

As sudo/root,

yum install gcc gcc-c++ python-devel freetype-devel libpng-devel libxml2-devel libxslt-devel pip

OSX

Install XQuartz (http://xquartz.macosforge.org/landing/) to satisfy freetype dependency for matplotlib.

python version

If there are multiple python versions on you system, you might want to pick a version to work with and run pip for that version. Let's say you pick python 2.6, then make sure to run pip2.6 when installing requirements.

pip version

Ensure that you are using the system version of pip. Some machines have many pip version installed. If you are facing problems with some requirements (pip says requirement satisfied, but naarad still doesn't work), use the "system" version of pip, usually in /usr/local/bin/pip.

$ which pip
/usr/local/bin/pip

distribute / setuptools issue

Ensure setuptools/distribute are up to date.

As sudo/root,
easy_install -U distribute
easy_install -U setuptools
pip install --upgrade distribute
pip install --upgrade setuptools

Python dependencies for Naarad

As sudo/root,
pip install --upgrade pyparsing
pip install --upgrade numpy
pip install --upgrade matplotlib
pip install --upgrade lxml
pip install --upgrade pygal
pip install --upgrade argparse
pip install --upgrade pytz

Package versions

List versions of installed python dependencies for naarad. Versions should match or exceed whats listed below

pip list | grep -e numpy -e matplotlib -e pygal -e lxml -e argparse -e lxml -e pyparsing -e pytz
argparse (1.2.1)
pyparsing (2.0.1)
pytz (2013.8)
lxml (3.2.4)
pygal (1.2.0)
numpy (1.7.0)
matplotlib (1.3.1)

Runtime Questions

Q. naarad does not recognize the timestamp in my data files.

A. You can find the list of timestamp formats naarad currently supports @ https://github.com/linkedin/naarad/wiki/Supported-Timestamp-Formats