ihan 0.3.11

IHAN Client for feeding and back filling log files

This is the installation and usage guide for the IHAN Client. This utility is used for feeding and back filling log files to the IHAN service.

Requirements

Python 2.7 and Python 3.4+ are supported.

On most Ubuntu systems you should be able to install Python and virtualenv via the following:

$ sudo apt update
$ sudo apt install \
    python-pip \
    python-virtualenv

Installation

$ virtualenv ~/.ihan
$ source ~/.ihan/bin/activate
$ pip install --upgrade ihan

Shipping Logs

Make sure the user account that is running has read access to the main nginx log file. If it doesn’t please run the following. Replace your_user_name with your unix username (found via whoami).

$ sudo chown your_user_name:www-data /var/log/nginx/access.log
$ sudo chmod u+r /var/log/nginx/access.log

$ sudo apt install screen
$ screen
$ ihan live /var/log/nginx/access.log

Once that’s running type CTRL-A and then CTRL-D to return to your regular shell.

Backfill Log Files

If the log file is not compressed, run the following:

$ screen
$ ihan backfill /var/log/nginx/access.log

If it is compressed, run the following:

$ screen
$ gunzip -c /var/log/nginx/access.log.gz | ihan backfill -

Once that’s running type CTRL-A and then CTRL-D to return to your regular shell.