# Installation

# Installing through the Windows Installer Interface

  1. Right-click the Open iT ServiceNow Adapter 1.0.1 x64.msi installer file, then click Run as Administrator.

    Allow the app to make changes to the device to begin. A setup wizard will be displayed.

    Click Next.

    ServiceNow Integration: Installation Wizard

    ServiceNow Integration: Installation Wizard

  2. Read the License Agreement before accepting the terms, then click Next.

    ServiceNow Integration: Installation End-User License Agreement

    ServiceNow Integration: Installation End-User License Agreement

  3. Specify the path to a valid Open iT license with SERVICENOW license key.

    The Installation Directory is automatically set to install the adapter on the parent directory where the Analysis Server is because the adapter uses configurations from the Analysis Server.

    ServiceNow Integration: Installation License FIle

    ServiceNow Integration: Installation License FIle

  4. Specify a valid ServiceNow Instance URI. This is provided when deploying a ServiceNow Store Application.

    Specify the Authentication Type that will be used to connect to the ServiceNow instance. There are three available options:

    • Basic - requires a Username and Password to connect to the ServiceNow instance

    ServiceNow Integration: Installation ServiceNow Instance Configuration - Basic

    ServiceNow Integration: Installation ServiceNow Instance Configuration - Basic

    • Bearer Token - requires a Bearer Token that will be used to authenticate the connection

    ServiceNow Integration: Installation ServiceNow Instance Configuration - Bearer Token

    ServiceNow Integration: Installation ServiceNow Instance Configuration - Bearer Token

    • OAuth2.0 - requires the following details to connect to the ServiceNow instance:
      • Username and Password - valid credentials with specific role
      • Client ID - the generated ID once an Application Registry is created in the ServiceNow instance
      • Client Secret - an encrypted key which is generated once an Application Registry is created in the ServiceNow Instance

    ServiceNow Integration: Installation ServiceNow Instance Configuration - OAuth 2.0

    ServiceNow Integration: Installation ServiceNow Instance Configuration - OAuth 2.0

    Click Next to test the connection to the ServiceNow instance using the provided authentication type and credentials.

  5. Click Install to start the installation process. If a review of the entries is needed, click Back.

    ServiceNow Integration: Ready to Install

    ServiceNow Integration: Ready to Install
  6. The installer will set up all necessary files on the computer.

    Click Finish to complete the installation.

    ServiceNow Integration: Installation Complete

    ServiceNow Integration: Installation Complete

# Installing through the Command Line

  1. Open a command prompt with Administrator level privilege.

  2. Execute the following command:

    Command Syntax
    msiexec /i [msi_file] /l*v [log_file] [options] ADAPTERLICENSEFILE=[license_file]
    AUTHTYPE=[authtype] INSTANCEURI=[uri] INSTANCEUSERNAME=[username] 
    INSTANCEPASSWORD=[password] InStANCEBEARER=[token] CLIENTID=[clientid] 
    CLIENTSECRET=[clientsecret]

    Required Parameters:

    Parameter Description
    /i [msi_file] Use this parameter to specify the path to the Windows installer file, Open iT ServiceNow Adapter 1.0.1x64.msi.
    l*v [log_file] Use this parameter to specify the path to the installation log file that will be created during installation.
    Installing through the Command Line: Required Parameters

    Optional Parameters:

    Parameter Description
    /quiet Use this parameter to run the command in silent mode.
    /passive Use this parameter to run the command in unattended mode - progress bar only.
    Installing through the Command Line: Optional Parameters

    Required Properties:

    Properties Description
    ADAPTERLICENSEFILE=[license_file] Use this property to specify the path to the Open iT license file with SERVICENOW license key.
    AUTHYPE=[authtype] Use this property to specify the authentication type that the installer will use to communicate with the specified ServiceNow instance. It accepts Basic, Bearer Token, or OAuth2.0. This is case-sensitive.
    INSTANCEURI=[uri] Use this property to specify a valid ServiceNow instance URI.
    INSTANCEUSERNAME
    INSTANCEPASSWORD
    Use these properties to specify valid credentials that will be used to authenticate on the specified ServiceNow instance. This is required with AUTHTYPE=Basic or AUTHTYPE=OAuth2.0.
    INSTANCEBEARER=[token] Use this property to specify a valid token that will be used to authenticate on the specified ServiceNow instance. This is required with AUTHTYPE=Bearer.
    CLIENTID=[clientid]
    CLIETSECRET=[clientsecret]
    Use these properties to specify valid identification keys of the ServiceNow instance that will be used for authentication. This is required with AUTHTYPE=OAuth2.0.
    Installing through the Command Line: Required Properties

    Example (Basic)
    msiexec /i "Open iT ServiceNow Adapter x64.msi" /l*vx install.log ADAPTERLICENSEFILE="C:\Path\to\your\license" AUTHTYPE=Basic INSTANCEURI=https://your-servicenow-instance/ INSTANCEUSERNAME=username INSTANCEPASSWORD=password
    Example (OAuth2.0)
    msiexec /i "Open iT ServiceNow Adapter x64.msi" /l*vx install.log ADAPTERLICENSEFILE="C:\Path\to\your\license" AUTHTYPE=OAuth2 INSTANCEURI=https://your-servicenow-instance/ INSTANCEUSERNAME=username INSTANCEPASSWORD=password CLIENTID=clientid CLIENTSECRET=clientsecret
    Example (Bearer Token)
    msiexec /i "Open iT ServiceNow Adapter x64.msi" /l*vx install.log ADAPTERLICENSEFILE="C:\Path\to\your\license" AUTHTYPE=Bearer INSTANCEURI=https://your-servicenow-instance/ INSTANCEBEARER=token
  3. When using the passive mode, wait until the process bar dialog disappears. When using the quiet mode, verify if the installation is complete by opening the Task Manager and checking in the Details tab if the msiexec process is still running.

We value your feedback!

Please take a few minutes to complete our survey and share your thoughts on your recent experience with our documentation.

Take survey

Close