Installing a basic integration on a Mac OS X machine

Download and install the basic integration on a Mac OS machine. 

Step 1: Prerequisites 

1. To find out which version of Python must be installed, see GitHub: Getting started. 
2. To download and install Python, go to the Python homepage, and enter the version number of Python that you retrieved.
3. Download and install Python.
4. To install pip, enter sudo easy_install pip.
5. To install virtualenv, enter sudo /usr/bin/easy_install virtualenv.
6.  Install Git from the official Git website.

Step 2: Download and install the Oomnitza basic integration

In the commands below, replace <N.N> with the python version.

Once the prerequisites are met, follow these steps to install the integration:

1. Open a terminal and create a directory for Oomnitza:

cd ~/
mkdir oomnitza
cd oomnitza/

2. Set up a virtual environment and activate it:

virtualenv -p python<N.N>
source bin/activate

3. Clone the Oomnitza connector repository:

git clone https://github.com/Oomnitza/oomnitza-connector connector
cd connector

4. Install required Python dependencies:

pip3 install -r requirements.txt

Step 3: Prepare the Configuration File

With the Oomnitza basic integration set up, proceed to generate and configure the config.ini file:

1. Generate the config.ini file:

python connector.py generate-ini 
vim config.ini

2. Set the config.ini values. For more information refer to the Connector Configs section in the GitHub documentation.

Step 4: Map vendor fields to Oomnitza fields

Map the vendor fields to Oomnitza fields to get the information that you need. For the field mapping, it is recommended to follow these steps in your Oomnitza instance:

1. Click Configuration > Integrations and click Block view 
2. Choose your vendor integration from the Basic Integrations section.
3. Click Mappings.
4. Map the vendor fields to the Oomnitza fields.  
5. Select a sync key, such as a Serial Number or Email. The field must have unique values.
6. Click FINISH.

Note
If you are creating a user integration, both the Username and Email fields must be mapped, and a default Role set. You can select a suitable option from the Role dropdown on the Oomnitza mapping side.

Did you know? 
You can complete additional actions in the configuration file, such as filtering the values that are mapped  Filtering basic integrations

Step 5: Run the Oomnitza basic integration

Run the basic integration, and confirm it is working:

python connector.py upload [connector]

Note
Replace [connector] with an enabled basic integration, e.g. meraki_network_devices

Additional command-line arguments:

• --save-data: Saves processed data in saved_data/ for inspection.
• --testmode: Runs the connector without sending data to Oomnitza, useful for testing.

Step 6: Schedule the basic integration

To schedule the Oomnitza basic integration for regular synchronization, use Launchd

1. Visit Launchd Information for guidance on creating a Launchd job.

2. Remember to specify the full path to the virtualenv's Python executable, not the system-level Python. Example command for Launchd:

/{YOUR PATH}/oomnitza/bin/python {YOUR PATH}/oomnitza/connector/connector.py upload {connector}