It may be neccessary to have a mid-server setup to ensure Faddom can communicate with your ServiceNow Instance. For further information you can see the ServiceNow Mid Server documentation
​

The actions below can only be performed by a user with the Admin role in the target ServiceNow instance
​

You need the appropriate Update Sets at the bottom of this article

Login into ServiceNow with your admin credentials
​

Navigate to Retrieved Update Sets
​

Scroll down to the bottom and click on Import Update Sets from XML. For more information see the ServiceNow documentation on Update Sets

Upload the XML file Faddom_ServiceNow_Integration_v2.xml and click Upload

The XML file should appear in Retrieved Update Sets as below

Open the record
​

Click on Preview Update Set in the top left or right

After previewing, click on Commit Update Set on the top right or left bottom

Ensure the update set has been committed
​

Navigate to the table by typing sys_auth_profile_basic.list in the Application Navigator and pressing enter
​

From this table, search for Faddom API Auth
​

Input your Faddom credentials
​

Search for Rest Messages in the Application Navigator
​

Search for Faddom CIs and open the record

Scroll down at the bottom to HTTP Method
​

Open these methods one by one and replace 0.0.0.0 with the IP address of the Faddom server
​

If needed, you will also need to select the Mid-Server you wish to use
​

​​

After updating it, you can test the HTTP Method by clicking on the ‘Test’ button under Related Links

Once all the HTTP methods are working fine and returning the HTTP Status code as 200, move to the next step. If you have any other issues see the Troubleshooting section
​

Navigate to the Scheduled Script Execution table by typing sysauto_script.list in the Application Navigator
​

Right-click on any Column header and click on Import XML

​​

Upload Get Faddom Business Apps Job.xml
​

Repeat steps 19-21 to upload the following XML:

Navigate to table sysauto_script again by typing sysauto_script.list to check all the four jobs mentioned in the above steps

To upload the data the first time, you can click on Execute Now for every job in the following order:
a. Delete All Faddom Tagged Records.xml
b. Get Faddom Business Apps Job
c. Get Faddom Servers Job
d. Get Faddom Servers Relationships Job
e. Get Faddom Application Server Relationships Job

Click on each job and edit the Run, Schedule, TimeZone, and Time as per your business need. Also, you can execute these jobs on an ad-hoc basis by clicking on Execute Now in the top right or bottom left. Ensure the timing is the same as the above order.

To check the records created navigate to the following tables:
​cmdb_ci_business_app -> Business Applications
cmdb_ci_server -> Servers
cmdb_rel_ci -> Relationships
​

To Navigate to the above tables type tableName.list in the Application Navigator.

You can then filter the records based on the Name or the Created dates or as per your search criteria. For applying search criteria, click the Filter button, apply your conditions, and finally click Run.

You can also filter the records based on Tags created by Faddom Integration using the following criteria

If you want to check logs after the execution of jobs, you can navigate to System Logs -> System Log -> All and apply a filter Created on Today and Source is Faddom to see the logs related to Faddom

Ensure that the Delete All Faddom Tagged Records.xml record set is imported and committed. (see steps 1-20 above)
​

Navigate to System Navigator -> Fix Script
​

Search for Faddom Delete CIs
​

Open the above script
​

Click on Run Fix Script

​​

Click on Proceed or Proceed in Background on the popup

Verify in the respective tables if the records have been deleted
​

Follow Step 25 above if you wish to schedule the deletion job of Faddom CIs

Manually re-rerun the previously uploaded order as per Steps 21-22.

Navigate to Business Applications in the Application Navigator

Click on the name of the Business Application

You will see a list of members

Click on the Map icon to see a map of the Business Application

Navigate to Servers in the Application Navigator

Find a server you are interested in seeing the information of

Click on the name of the server to enter the server properties

You will see a list of Dependencies and the Application Maps it belongs too

You can click on the name of the Map and the map icon to see a map of the Business Application

If your HTTP methods are returning an SSL certificate error, can change the following under System Property:
a. Set com.glide.communications.httpclient.verify_hostname to False
b. Set ‘com.glide.communications.trustmanager_trust_all to True
​​
​However, this is not recommended by ServiceNow and the other option is to install a self-signed SSL certificate on the Faddom server. You can do this by following our guide on Changing the Faddom server SSL certificate
​

To update the above System Properties, navigate to the System Properties table by typing sys_properties.list in the Application Navigator. Search for the above properties and mark them true/false as per requirements
​

Note: Just make changes to System Properties in your lower instance temporarily as it might affect the security of your instance or contact the ServiceNow Admin team before making any changes