Download PySNMP
***************

The PySNMP software is provided under terms and conditions of BSD-
style license, and can be freely downloaded from PyPI or GitHub
(master branch).

Besides official releases, it's advisable to try the cutting-edge
development code that could be taken from PySNMP source code
repository. It may be less stable in regards to general operation and
changes to public interfaces, but it's first to contain fixes to
recently discovered bugs.

The best way to obtain PySNMP and dependencies is to run:

   $ pip install pysnmp

or

   $ easy_install pysnmp

In case you do not have the easy_install command on your system but
still would like to use the on-line package installation method,
please install setuptools package by downloading and running
ez_setup.pz bootstrap:

   # wget https://bootstrap.pypa.io/ez_setup.py
   # python ez_setup.py

In case you are installing PySNMP on an off-line system, the following
packages need to be downloaded and installed for PySNMP to become
operational:

* PyASN1, used for handling ASN.1 objects

* PySNMP, SNMP engine implementation

Optional, but recommended:

* PyCryptodomex, used by SNMPv3 crypto features

* PySMI for automatic MIB download and compilation. That helps
  visualizing more SNMP objects

* Ply, parser generator required by PySMI

The installation procedure for all the above packages is as follows
(on UNIX-based systems):

   $ tar zxf package-X.X.X.tar.gz
   $ cd package-X.X.X
   # python setup.py install
   # cd ..
   # rm -rf package-X.X.X

In case of any issues, please open a GitHub issue so we could try to
help out.
