Installing a basic integration on a Windows machine

Download and install a basic integration on a Windows machine. 

Contents

1. Part 1: Installing Python 3.7
2. Part 2: Installing the basic integration
3. Part 3: Preparing the Config File (And Field Mapping)
4. Part 4: Running the basic integration
5. Part 5: Scheduling the basic integration

Part 1: Installing Python 3.7

This section details how to set up the necessary prerequisites on Windows for the basic integration.

1. Download and install Python 3.7.
1. https://www.python.org/downloads/release/python-376/
2. NOTE: Make sure Path installation is included
2. Launch the Command Prompt as an Administrator.
3. Download and install the last stable pywin32 release from the page. https://github.com/mhammond/pywin32/releases. Follow the instructions from the release download page to choose the proper binary.

Note
There is a known compatibility issue with virtualenv and Anaconda. If Anaconda is preinstalled, alternative steps might be required.

Part 2: Installing the basic integration

Now that the necessary prerequisites have been installed, we may proceed to set up a directory for the basic integration and install the python packages.

1. Create a working directory for the basic integration:

C:\>  mkdir oomnitza
C:\>  cd oomnitza
C:\oomnitza>  mkdir basic_integration

1. Download the basic integration package:
1. Download: https://github.com/Oomnitza/oomnitza-connector/archive/master.zip
2. Extract the zip contents of the folder “oomnitza-connector-master” to C:\oomnitza\basic_integration> directory created in previous step.
2. Install the remaining python dependencies
1. C:\oomnitza>  cd basic_integration
2. C:\oomnitza>  pip install -r requirements.txt

Part 3: Preparing the Config File (And Field Mapping)

With the basic integration setup with all requirements installed, we may proceed to generate and set up the config.ini file.

NOTE: If you already have a config.ini file, you may skip this section and simply place your existing config.ini in the root directory (in this example, C:\oomnitza\basic_integration)

1. Generate the config.ini file
1. C:\oomnitza\basic_integration>  python connector.py generate-ini

1. Set the config.ini values or migrate an existing GUI config.ini
1. Learn more about setting up the config.ini file here: https://github.com/Oomnitza/oomnitza-connector/blob/master/README.md#connector-configs
2. Oomnitza and third-party system mappings and credentials must be configured. The mappings should be completed via drag-and-drop from the WebUI (Configuration > Integrations)

Part 4: Running the basic integration

1. Run the basic integration and, confirm it is working:
1. C:\oomnitza\basic_integration>  python connector.py upload [connector]
2. NOTE: replace [connector] with an enabled connector, e.g. meraki_network_devices

Example:

python connector.py upload ldap --ini=/path/to/first.ini
python connector.py upload ldap --ini=/path/to/second.ini

Part 5: Scheduling the basic integration

This final section details how to schedule the basic integration for regular synchronization on a daily basis.

Setup the scheduled task. On windows, you will utilize the Task Scheduler.

1. Select ‘Daily’ -- Recur every: 1 days
2. You may modify the time as desired.
3. Action: Start a program
4. Program/script:  enter the following:
   C:\Python37\python.exe
5. Arguments: enter the following:
   C:\oomnitza\basic_integration\connector.py upload [connector]
   Note: [connector] should be replaced with desired/configured one
   1. Launch Task Scheduler
   2. Click Action -> Create Task from the menu
   3. Enter “basic integration” for the Name
   4. Provide an optional description.
   5. Click on ‘Triggers’ tab and then click ‘New…’ button
   6. Click on ‘Actions’ tab and then click ‘New…’ button
      NOTE: When running the basic integration via the task scheduler, please ensure that the windows account running the task has appropriate permissions to access the desired services. For SCCM, this means that the user must have permission to run batch scripts, and appropriate access to all necessary files and folders.
6. Test run the Scheduled Task
   1. Find the “basic integration” task in the list
   2. Right-click on it and select “Run”
   3. Check the info.log in the C:\oomnitza\basic_integration directory, or verify via Event Viewer or via changes in Oomnitza.
7. The basic integration is now setup and scheduled to run on a recurring basis!