# Requirements

This section provides instructions on installing and using the store application to report Open iT data in the ServiceNow platform.

Make sure to meet the following requirements for setting up Open iT LicenseAnalyzer:

• A working ServiceNow Vendor Instance with the following components:

  • Installed Open iT LicenseAnalyzer
  • Version should be Utah or latest
  • Activated plug-in Software Asset Management Professional for Engineering Applications (com.sn_samp_eng_app)
  • Activated plug-in Software Asset Management Playbook and Guided Setup (sn_sam_playbook)
  
  
  Use the official ServiceNow documentation on how to Activate a plugin.

  • Activated plug-in Domain Support - Domain Extension Installer
  
  
  This plug-in is applicable for ServiceNow instance Vancouver and higher.

  • Import the update set from XML. Follow the instructions in the section Download and Upload Update Set from XML.
  • Time Zone of the ServiceNow instance must be the same as the Open iT Core Server (data source of the Open iT Analysis Server)
  • Created Customer Login Credentials with the following roles:
    • sam_eng_app_integrator
    • x_opeit_openit_la.openit_integrator

# Download and Upload Update Set from XML

Upload an update set from XML in the ServiceNow Vendor License to set up the integration smoothly. This update provides fixes for the issues that may affect the integration.

To download the XML files update set, follow these instructions:

1. Go to ServiceNow Update Sets to download the compressed file containing the XML files.

2. Once downloaded, extract the contents of the file. This will contain three (3) folders named after a specific version of ServiceNow: Utah, Vancouver, and Washington.

   Each of the folder will contain three (3) XML files.

To upload the XML file update set in the ServiceNow Vendor Instance, follow these instructions:

1. Log in to the ServiceNow instance with an Administrator account.

   The required role is sys_admin. Verify that the version of the ServiceNow instance is Utah, Vancouver, or Washington.

2. In the upper-left corner of the page, click All.

3. In the filter option, type in System Update Sets. This will filter the displayed items.

4. Go to System Update Sets > Retrieved Update Sets. This will redirect you to the list of uploaded update sets.

   

   ServiceNow Integration: Navigate to Import Update Set from XML
   
   

5. Under Related Links, click Import Update Set from XML. This will redirect you to the Import XML page.

   

   ServiceNow Integration: Import Update Set from XML
   
   

6. Click Choose File, then browse for the downloaded update set XML files.

   Make sure to browse for the correct version of ServiceNow instance. If the ServiceNow Instance is Utah, choose utah; if Vancouver, choose vancouver; and if Washington, choose washington.

   • For Utah, upload the following file first:
     • sys_remote_update_set_6ef22f00f5c23110f877e368cd9423ba
   • For Vancouver, upload the following file first:
     • sys_remote_update_set_2b742fd0f4423110f877a83b810eeaf1
   • For Washington, upload the following file first:
     • sys_remote_update_set_2b742fd0f4423110f877a83b810eeaf1
       
       

   Notice that the XML file name is displayed beside the button.

7. Click Upload. This will redirect to the list of uploaded update sets. Notice that Eng App Update Set - is in the list.

   

   ServiceNow Integration: Upload Update Set from XML
   
   

   Make sure that the State column is Loaded and the Application column is Global.

   

   ServiceNow Integration: Upload State and Application Update Set from XML
   
   

8. Repeat these steps for the two (2) remaining update set XML files. All of the update sets will be listed after successful upload.

   

   ServiceNow Integration: Uploaded Update Set from XML
   
   

   Use the Preview action to view the update set. Fix any reported issues before committing the update set.