Creating a basic integration for VMware vCenter assets

Let Oomnitza be your single source of truth!

You'll get visibility of all the network devices in your organization as data from vCenter is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and vCenter in minutes

Get the information and the insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key information for network devices
• Configurable reports to share information about network devices with your colleagues and management

Basic integration for vCenter
The basic integration retrieves key information about all the network devices in your organization. For further information see vCenter REST APIs.
The vCenter connector supports versions v6.5 - 7.0 U1.

Before you start

To stream asset data from vCenter to Oomnitza, you must complete these tasks:

• Download the source code for the Oomnitza connector
• Generate a configuration file
• Edit the configuration file

Download the source code for the Oomnitza connector

1. Log into Oomnitza.
2. Click Configuration > Integrations and click Integrations List View .
3. In the Basic section for Asset Integrations, click the VMware tile.
4. Download the source code.    

Learn more
On the Info page, click READ DOCUMENTATION and scroll down and click Getting started. 

Generate a configuration file for the Oomnitza connector

To find out how to generate the configuration file, read the Connector Configs section in the Getting started document.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The vCenter settings

Before you edit the configuration file, you must retrieve the following information:   

Your Oomnitza token

1. Open the configuration file that you generated in edit mode.
2. In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza. For information on how to generate an API key in Oomnitza, refer to Creating an API Token.
   

   Oomnitza configuration settings 
   [oomnitza]
url= https://<name_of_instance>.oomnitza.com line
api token = <my_Oomnitza_token> 

3. In the vCenter section, make the following changes:
   • Set enable to True.
   • Enter the URL or host of your vCenter account. For example, https://api_host
   • Enter the username and password of your vCenter account

   VCenter settings 
   [vcenter] enabled = True
url = https://api_host
username =[e-mail]
password = change-me

4. Delete the remaining information in the configuration file, as this relates to other vendors.
5. Save your changes

Map vCenter fields to Oomnitza fields

To get the information that you need to manage your network devices, complete these actions:

1. Click Configuration > Integrations.
2. In the Basic section for Asset Integrations, click the VMWare tile.
3. Click Mappings.
4. Map the vCenter fields to the Oomnitza fields.  
5. Select a unique identifier such as the Virtual Machine Identifier as the sync key, which will synchronize the data that is streamed from vCentre to Oomnitza.
6. Click FINISH.

Custom vCenter mappings

You can map the following fields to Oomnitza:

Boot Delay
Boot Device NIC
Boot Device Type
Boot EFI Legacy Boot
Boot Enter Setup Mode
Boot Network Protocol
Boot Retry
Boot Retry Delay
Boot Type
CPU Cores Per Socket
CPU Count
CPU Hot Add Enabled
CPU Hot Remove Enabled
Data Center
Guest Identity Family
Guest Identity Host Name
Guest Identity IP Address
Guest Identity Name
Guest OS
Hardware Upgrade Policy
Hardware Upgrade Status
Hardware Upgrade Version
Hardware Version
Host
Identity BIOS UUID
Identity Instance UUID
Identity Name
Instant Clone Frozen
Memory Hot Add Enabled
Memory Hot Add Increment Size (MiB)
Memory Hot Add Limit (MiB)
Memory Size (MiB)
Power State
VM Name
VM Tools Auto Update Supported
VM Tools Install Attempt Count
VM Tools Install Type
VM Tools Run State
VM Tools Upgrade Policy
VM Tools Version
VM Tools Version Number
VM Tools Version Status
Virtual Machine Identifier

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

Run the vCenter connector

To upload the network device information to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload vcenter --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload vcenter

1. Click Configuration > Integrations.
2. In the Basic section for Asset Integrations, click the VMWare tile.
3. Click SYNC SESSIONS and review the information that is uploaded.

Schedule
To find out how to schedule the vCenter integration, contact Support.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets
• Configure custom reports about your assets 

See Getting started.