Metadata-Version: 2.1
Name: ihan
Version: 0.3.8
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
Description: 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.
Platform: UNKNOWN
Description-Content-Type: text/x-rst
