Getting Started¶
Install and Upgrade¶
This section provides directions to install or upgrade the IIQTools package for your instance of InsightIQ.
Installing the RPM¶
This is by far the easiest way to install IIQTools.
Download the newest RPM here
Copy the RPM file onto the machine running InsightIQ
Install with this command, replacing
</path/to/rpm>
with the literal file path:$ sudo yum install --disablerepo=* <path/to/rpm>
Installing Python pip¶
Python pip is the preferred way to install Python packages. I f your instance of InsightIQ doesn’t have pip installed, there are some pretty simple directions at:
https://pip.pypa.io/en/stable/installing/
Note
The --upgrade
flag is automatically ignored if you’re performing an initial install
With Internet connection¶
To install or upgrade the IIQTools package to your instance of InsightIQ run:
$ sudo pip install --upgrade iiqtools
Setting up a development environment¶
This section is only for settings up a development environment. Only follow these directions if you intend to contribute source code to the project.
If you have the know-how to build and test IIQTools on MacOS or Windows, we’d love to get a Pull Request from you updating this section!
Linux¶
These are non-Python libraries required to build and test IIQTools. Use the builtin packagemanger (i.e. apt-get, yum, dnf) to install these packages.
RHEL/CentOS/Fedora:
- make
- python-devel
- postgresql-devel
- postgresql
- redhat-rpm-config
Ubuntu:
- make
- python-dev
- postgresql
- libpq-dev
Before installing the Python dependencies, it’s highly encouraged to configure a Python Virtualenv for working with IIQTools.
Once you’ve got your virtualenv configured and activated, run this command to install the dependencies for building and testing IIQTools:
$ pip install -r requirements-dev.txt
Once you’ve installed those dependencies, you can run all the unit tests like this:
$ make test
And generate the docs with:
$ make docs
Or clean up everything with:
$ make clean