Installing and Registering IQService

IQService itself can be downloaded from the source configuration page of the sources that require it. Note that in some cases the IQService is called the Integration Service and the Server Host in the source configuration pages for some sources.

Complete the following steps when installing IQService for the first time:

  1. Download the Integration Service from IdentityNow via a source that requires it.

    Note
    Alternatively, you can download the software directly from https://s3.amazonaws.com/files.accessiq.sailpoint.com/integrations/iqservice/IQService.zip

    1. Go to Connections > Sources.

    2. Select a source that requires IQService.

      These include Azure Active Directory, Active Directory, HCL Domino (IBM Lotus Domino), Microsoft SharePoint Online, Microsoft SharePoint Server, and Windows Local.

      Note
      If you do not already have one of these sources in your IdentityNow Sources page, you do not need to install IQService.

    3. Find the panel labeled IQService or Integration Service.

    4. Select Download.

    Note
    You are only entitled to download components for which you have an active license with SailPoint and the availability of a component for download does not grant you a license to use a component or entitle you to use a component for which you do not have an active license. Please contact your Account Representative or CSM for more information.

  2. Unzip the downloaded IQService.zip archive into the created or desired location. For example:

    C:\SailPoint\IQService\

    Note
    Verify the DLLs are trusted by checking the properties of the DLL files.

  3. Run the following command to install a Windows service named IQService.

    IQService.exe -i

    The above command installs IQService with name IQService-Instance1 and at port 5050 (if available).

  4. To install IQService to communicate with IdentityNow on non-TLS port only

    IQService.exe -i

    The above command installs IQService with name IQService-Instance1 and at port 5050 (if available).

  5. To install IQService to communicate with IdentityNow on TLS port only.

    IQService.exe -i -o <TLS Port Number>

    The above command installs IQService with name IQService-Instance1 and given TLS port number.

    Note
    For more details on requirements and procedure to setup TLS Communication and Client Authentication, refer to IQService: TLS and client authentication configuration for IdentityNow.

  6. To install IQService to communicate with IdentityNow on both TLS and Non-TLS port

    IQService -i -p <Non-TLS Port> -o <TLS port>

    The above command installs IQService with name IQService-Instance1 and given TLS and Non-TLS Ports.

  7. Start the service either from the Services Applet or from the command line by running the following command:

    IQService.exe -s