Metadata-Version: 2.1
Name: ihan
Version: 0.3.17
Summary: IHAN Client for feeding and back filling log files
Home-page: https://www.ihan.ee/
Author: Mark Litwintschik
Author-email: mark@marksblogg.com
License: MIT
Project-URL: Bug Tracker, https://github.com/marklit/ihan/issues
Project-URL: Documentation, https://ihan.readthedocs.io/en/latest/
Project-URL: Source Code, https://github.com/marklit/ihan
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Networking :: Monitoring
Description-Content-Type: text/x-rst
Requires-Dist: Click
Requires-Dist: requests

IHAN Client
===========

This is the installation and usage guide for the `IHAN <https://www.ihan.ee/>`_ 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:

.. code-block:: bash

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

Installation
------------

.. code-block:: bash

    $ 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``).

.. code-block:: bash

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

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

If it is compressed, run the following:

.. code-block:: bash

    $ 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.

