Preparing ServiceNow CMDB for synchronization

Add BMC Discovery to cmdb_ci discovery_source choice list

The BMC Discovery integration uses a Discovery Source choice list on the base cmdb_ci class. Discovery Source is a choice list meaning that it is not a free text field and that the values allowed are restricted to a predefined list. The Discovery Source text used in theBMC Discovery CMDB integration is BMC Discovery and this must exist in the choice list.

1. Login to the ServiceNow CMDB with a system administrator privileged account and navigate to System Definition > Choice Lists

2. Click on New to add a choice list record and complete the following fields:

   Field	Value
   Table	"Configuration Item [cmdb_ci]"
   Element	discovery_source
   Language	English (mandatory)
   Label	"BMC Discovery"
   Value	The default value is, "BMC Discovery". This must match the "Source Name" used in the configuration in BMC Discovery, and be unique in your ServiceNow CMDB instance.

3. Click Submit.
   
   

Create the bmc.integration user

A ServiceNow user must be created to allow the BMC Discovery CMDB integration to create / update and manage CIs within the ServiceNow CMDB.

This procedure assumes that the roles have not been modified from their default configuration.

1. Login to the ServiceNow CMDB with a system administrator privileged account and navigate to User Administration > Users

2. Click on New to add a User record and complete the following fields:

   Field	Value
   User ID	This must match the Username used in the configuration in BMC Discovery.
   First Name	Integration user first name
   Last Name	Integration user last name
   Password	This must match the Password used in the configuration in BMC Discovery.
   Active	Set to "Active"
   Locked Out	Ensure this is not selected
   Password needs reset	Ensure this is not selected
   Web service access only	Ensure this is selected.
   Language	English (mandatory)

3. Click Submit.

4. Locate the created user and open the User record, select Roles and Edit. The following roles must be added to the user:

   Role	Purpose
   itil	The itil role is required to give access to the cmdb_ci tables
   model_manager	The model_manager role is required so that any missing products (models) can be created when a CI is added to ServiceNow. The products (models) are stored in the table cmdb_model. The role model_manager gives write access to the cmdb_model table.
   user_admin	Optional - The user_admin role is to allow write permissions to the core_company table to create / add missing "manufacturers" to the system. If not provided, manufacturers unknown by ServiceNow will be empty on CIs.
   personalize_choices	The system needs to read the sys_choice records to check that the discovery source exists in the choice list of the cmdb_ci table.

   This procedure assumes that the above roles have not been modified from the default configuration.

5. Click Save.
   
   

Setting the OAuth API Endpoint

Create an OAuth application endpoint to allow the BMC Discovery CMDB integration to access system resources in the ServiceNow CMDB.

1. Login to the ServiceNow CMDB with a system administrator privileged account and navigate to System OAuth > Application Registry

2. Click New
3. On the interceptor page, click Create an OAuth API endpoint for external clients.

4. Complete the following fields:

   Field	Value
   Name	A unique name.
   Client ID	This is created by default. This must match the Client ID used in the configuration in BMC Discovery.
   Client Secret	If no value supplied the system automatically generates this. This must match the Client Secret used in the configuration in BMC Discovery.

5. Click Submit.