Using Open-AudIT to NMIS Integrations (deprecated)



Please note that as at Open-AudIT 4.2.0, this page is no longer relevant. Please see the Integrations page.






Open-AudIT can be used as a discovery vehicle to then import devices into NMIS. If you have devices in Open-AudIT you would like to manage in NMIS (be they manually added, discovered, etc), it is simple to do.

Integrations are a Professional & Enterprise feature only and only available for Linux.

Prerequisite

To run an Integration, you will need to download the oa-nmis-integration.exe (this is a Linux binary) and place it in /usr/local/omk/bin

The binary is available here - https://dl-openaudit.opmantek.com/oa-nmis-integration.exe

Please ensure it is executable by running the below.

chmod +x /usr/local/omk/bin/oa-nmis-integration.exe

This file will be included in future releases of Open-AudIT for Linux.

Set Devices to be Managed

By default, only devices with their "nmis_manage" attribute set to y' will be exported to NMIS. You can use the Bulk Edit functionality within Open-AudIT to quickly set the "Manage in NMIS" attribute on only the devices you need. You can also set individual devices to be managed on the device details screen. Select the Opmantek Details menu item from the left side edit the "Manage in NMIS" field.

You can also set the other fields to be sent to NMIS as you desire, either individually or using Bulk Edit.

Check Device List

Once you have set the attribute on your selected devices, you can run the default integration query to ensure the resulting device list is as you expect. Go to menu → Report → Other → Integration Default for NMIS.

Create Integration

When you are happy with the resulting device list create a new Integrations - menu → Manage → Devices → Integrate Devices with NMIS.

The Advanced section should be mostly left as-is, unless you require specific customisations.

Run Integration

Running the Integration couldn't be easier. Either from the Integrations List page, or the details page of an individual Integration, just click the Execute icon (looks like a 'play' button). Depending on the number of devices to be integrated, it could take a while. Click the Logs entry on the left side menu, then click your browsers refresh button to show updated logs.

You can also use Tasks to schedule an Integration to run whenever you need it to.

Once the devices have been exported to NMIS, after NMIS has run a collect / poll cycle, the relevant data within NMIS should appear.

Success

And that's all there is to it.