A command line interface to inventory
Python Shell
Latest commit 1bc16aa Nov 19, 2014 @uberj uberj enable SREG and HW kv support
Failed to load latest commit information.
bin let env resolve which python we get. fixes #3 Aug 4, 2013
docs fix typo Aug 11, 2014
etc update keyring support Apr 28, 2013
invtool enable SREG and HW kv support Nov 19, 2014
.gitignore added more granular ip range options to csv creator Nov 13, 2013
CHANGES.txt changes Nov 11, 2013
LICENSE.txt structural changes Nov 28, 2012
Makefile refactored kv stuff and added ro interface to network/site objects Aug 7, 2013
README.rst make things more user friendly Nov 17, 2014
requirements.txt service dispatch Jul 2, 2014
setup.py Parse out requirments.txt and install the required package Apr 2, 2014



A Command Line Interface for poking at Mozilla's Inventory project.

Notes On Updating

Here is how you update your invtool.

The git method (recommended)

See which INVTOOL_VERSION you are running:

invtool status | grep INVTOOL_VERSION

Change directory to where you cloned this repository:

cd invtool

Update the code to the latest version:

git pull

Install the code you just pulled in (You don't need to do this if you are running a non-root install):

sudo python setup.py install

Confirm you are running a newer version:

invtool status | grep INVTOOL_VERSION

The non-git method (not recommended)

Go to https://github.com/uberj/inv-tool/releases and download the latest version.

Notes On Installing

invtool requires requests and simplejson (and argparse if you are running python2.6):

sudo pip install -r requirements.txt
sudo python setup.py install

An optional package (though highly recommend and included in requirements.txt) is keychain. If you need to use invtool without it, remove it from requirements.txt and store your ldap password in plaintext.

invtool supports a few different ways of setting your credentials. Your username can either be stored in the configuration file or passed at the command line. Your password may be stored in the configuration file (in plain text), stored in a python-keyring, or passed on the command line. If you do not want to store your credentials on disk at all, you must remove the ldap_username AND ldap_password entries from the configuration file.

invtool will read its configuration from

  • /etc/invtool.conf
  • ~/.invtool.conf and
  • ./etc/invtool.conf

Quick Install

Here is a quick tip for a non-root install:

git clone https://github.com/uberj/inv-tool.git invtool
cd invtool
cp etc/invtool.conf-dist etc/invtool.conf
# Set host and port
$EDITOR etc/invtool.conf
ln -s ./bin/invtool ./devinvtool
./devinvtool status

On this first invocation, if no credentials have been previously set, invtool will prompt you for them. If the keyring module is present, your password will be stored in the system keyring for later use under the service "invtool-ldap". The keyring service name can be changed in the configuration file.


man invtool OR checkout the repo and run make man.