# 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).
  
  
  Follow the instructions in the ServiceNow Knowledge Base article, System and User Timezones in ServiceNow, for detailed steps on changing the Time Zone.

  • 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.

   If you are using Xanadu, the files in the Washington folder are backward compatible, allowing you to use them interchangeably with either version.

   Each folder will contain three (3) XML files, except for the Washington folder, which contains only one (1) file.

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 or Xanadu, 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 and Xanadu, upload the following file:
     • sys_remote_update_set_5dca12a4b7013110c911ff98ee11a978
       

   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 Application column is set to Global and the State column is set to Loaded.

   

   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.

   For Washington and Xanadu instances, only one (1) update set XML file needs to be uploaded.

   

   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.