File: INSTALL.rst

package info (click to toggle)
hatop 0.8.2-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 632 kB
  • sloc: python: 1,794; sh: 152; makefile: 75
file content (48 lines) | stat: -rw-r--r-- 1,178 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
************
Installation
************

HATop is written as a single executable python script file called ``hatop``.

This allows easy distribution and installation.

:Package maintainers:

  Please use "hatop" for the final package and executable name.

  This allows users on different platforms to find it easily.


Requirements
============

**HATop is written in pure Python and has no external dependencies!**

* `Python 2.4 <http://python.org/>`_ or later (no Python 3 support planned yet)
* `HAProxy 1.4 <http://haproxy.1wt.eu/>`_ or later


Installation
============

The installation is simple::

  $ install -m 755 bin/hatop /usr/local/bin

  $ install -m 644 man/hatop.1 /usr/local/share/man/man1
  $ gzip /usr/local/share/man/man1/hatop.1


Permissions
===========

HATop itself can be used by any system user.

The permission to connect to a given HAProxy instance is controlled
by the file permission of the unix socket file.

HATop needs ``read`` and ``write`` access (``chmod +rw``) on the socket file.

The initial socket file permissions can be configured in haproxy.conf using
the ``user``, ``group`` and ``mode`` parameters of the ``stats socket`` option.