Install and Register the IQService for Use with Windows

The IQService is a native Windows service that enables IdentityIQ to participate in a Windows environment and access information only available through Win32 APIs.

After the IQService is installed and running on a Windows machine you can configure tasks in IdentityIQ that use the service such as Windows activity collection, Windows target collection, Active Directory provisioning, and more.

Note: Version 4.5 of Microsoft .NET is required for installation of the IQService executable with most configurations of IdentityIQ. If your configuration requires a different version it is noted in the connector documentation.

Note: The IQService version must match the IdentityIQ server version including patch versions. When you upgrade one, you must upgrade the other.

Install the IQService in a location that is running Windows.

To install and register the IQService, do the following:

  1. Create a directory in which to download the service. For example, C:\iqservice.

  2. Copy the IQService.zip file from the IdentityIQ installation into the new directory. The IQService.zip file is located in identityiq_home/WEB-INF/bin/win where identityiq_home is the directory in which you expanded the identityiq.war file.

  3. Expand the IQService.zip.

  4. Run IQService.exe -i to install a Windows service named IQService.

  5. Start the service from the Windows Services Applet or from the command line by running IQService.exe -s.

    Other command line options with this service are:

    -? | h — This help output
    -d — run in console mode
    -i — Install a service
    -k — stop the service
    -n — (Optional) name of IQService for installing multiple instances. Default: IQService-Instancex, where x is an incremental integer value.
    -p — (Optional) unique available port number specified at the time of IQService installation. Default: 5050. Incremental based on the next available port.
    -r — remove the service
    -s — Start the service
    -t — Restart (stop/start) the service
    -u: Uninstall the service. Removes the service components and clears the registry entries
    -v — Print version information

The IQService will persist configuration settings related to the port, trace file, and trace level in the Windows registry at HKEY_LOCAL_MACHINE\SOFTWARE\SailPoint\IQService. The following keys are used:

  • - port - port on which to listen

  • - tracefile - path to the trace file

  • - tracelevel - 0 (off), 3 (verbose)

  • - maxTraceFiles - maximum number of Trace log files

  • - traceFileSize: maximum file size of a trace file in bytes