Problem Statement
This article outlines how to create and set up the Service Graph Connector for Infoblox. The following topics are covered in this article.
- How to set up the connector
- How to configure the connector
- How to use the connector
- Common issues with the connector
How to set up the connector
Key requirements for setting up the connector:
Rest API
- Connection Url - Infoblox base URL.
- User - User name to authenticate the HTTP request.
- Password - Password for the user name used to authenticate the HTTP request.
Optional
- Network View - The network views for which data is to be imported. Use a comma-separated list for multiple views (for example, view1,view2). If you leave this field empty, all network views will be imported. For more information on network views and other Infoblox key concepts, see the Infoblox documentation: https://www.infoblox.com/developer-portal/developer-portal-api-documentation/.
- Api Version – Enter Version of WAPI you are using.
Example Curl Command
curl -X 'GET' \
'http://infobloxdemo.com/wapi/v2.11.2/networkview?name=default' \
-H 'accept: application/json'
From this command, the fields are:
URL = infobloxdemo.com
API Version= v2.11.2
Network View = default
Mid Server
Required
- Connection Url - Infoblox base URL.
- User - User name to authenticate the HTTP request.
- Password - Password for the username used to authenticate the HTTP request.
- Use Mid Server – Option to use a Mid Server to connect to the Infoblox instance.
- Mid Selection – Mid Server for the connection. This field appears only if the Use Mid Server option is selected.
Optional
- Network View - The network views for which data is to be imported. For multiple views separate with commas view1,view2. If you leave this field empty, it will import all the network views. For more information on network views and other Infoblox key concepts please refer to their documentation
https://www.infoblox.com/developer-portal/developer-portal-api-documentation/ - Api Version – The version of WAPI that you’re using.
In the example, midserverdemo123 was selected as the Mid Server. This can be done while creating the connection.
How to configure the connector
After you have gathered all of the required details. you can configure the connection.
Procedure
- Navigate to Workspace > CMDB Workspace.
- Select SGC Central.
- For more info on SGC-Central please follow this link https://www.servicenow.com/docs/bundle/yokohama-servicenow-platform/page/product/sgc-central/referen...
- On Overview Page, Select Create Connection.
- Follow the instructions and fill in the required fields.
- The following screenshots include sample values that were provided while creating the connection.
- Test the connection to verify that the connection is set up successfully.
- Optional: If you have a large volume of network and IP address data, create the sn_infoblox_integ.included_network_regex system property before running the connector:
- Navigate to System Properties > All.
- Create the sn_infoblox_integ.included_network_regex system property.
- Add regex for the networks for which you want to retrieve the IP address.
- Save the system property, and then run the connector.
-
Sample regex that retrieves the IP address for all networks.
- Optional: Specify the partition size property for parallel loading. If this property is not specified, the best value is calculated during the running of the connector.
- Navigate to System Properties > All.
- Search for the sn_infoblox_integ.parallel_loading_partition_size system property.
- Enter an integer value between 1 and 150 for the property.
How to use the connector
After setting up the connector, you can start the data load process in one of two ways.
Manual trigger
You can manually trigger the import schedules to begin the data load process. For Infoblox, it is recommended to start with the IP Pool data source. Navigate to the import schedule and select Execute Now to manually trigger the flow.
Automatic trigger
You can set the data pulls to run on a schedule. You can set up the schedule either while configuring the connector in SGC Central or by updating the IP Pool import schedule, where you specify how frequently you want the job to run.
For Infoblox, four data sources run in sequence:
- IP Pool
- Network
- IP Address
- DNS Alias
Parallel data loading is implemented for the Network and IP Address data sources, which should increase performance times for loading the data.
After the data is loaded, it is transformed and populated in the respective tables. For more information about which tables are populated, see the documentation for SGC Infoblox. https://www.servicenow.com/docs/bundle/yokohama-servicenow-platform/page/product/configuration-manag...
Common issues with the connector
No IP addresses are imported on the first run
By default, all imported networks have the Get Ip Address attribute set to false. This attribute can be updated in the Detailed Subnetwork (sn_infoblox_integ_sg_infoblox_detailed_subnetwork) table. If you have a large volume of network or IP address data, use the sn_infoblox_integ.included_network_regex system property.
