IQ Service

IQ Service provides writing capability on Active Directory like create, updated, and delete.

# Installation Command of IQ Service: IQService.exe -i

# Default port IQ Service is 5050

# Useful commands of IQ 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

Path of the IQService.zip :    C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\identityiq\WEB-INF\bin\win\IQService.zip

Install & Register the IQService:

1. Create a folder/directory in which to download the service.

2. Copy the IQService.zip file from the identityiq/WEB-INF/bin/win into a new directory.

3. Extract the IQService.zip

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

   Give a different port if 5050 is already in use

5. Search Regedit and go to the following path to set the log related attributes

 HKEY_LOCAL_MACHINE\SOFTWARE\SailPoint\IQService. 

 The following keys are used:

      1. port - port on which to listen

      2. tracefile - path to the trace file

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

      4. maxTraceFiles - maximum number of trace log files

      5. traceFileSize: maximum file size of a trace file in bytes

 

6. Search services and open SailPoint IQService-Instances1 

Open the SailPoint IQService-Instance from the services and change the Log On to the service account 

mightypedia\Administrator 

7. Start the service from the Windows Services Applet or from the command line by running

IQService.exe -s

8. Register the service account and restart

IQService.exe -a "mightypedia\Administrator"

9. Turn off the Windows Firewall

Search Control Panel ---> Category ---> small icons

                   ---> Click on Windows Defender Firewall 

                                   ---> Click on Windows Defender Firewall on or off ---> turn off all firewalls

Upgrade IQService:

# Take the correct version of the IQService.zip from C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\identityiq\WEB-INF\bin\win\IQService.zip

# Take a backup of the current IQService installation on the IQService box / VM

# Stop the IQService from Services Applet or run the following command from cmd

    IQService.exe  -k

# Uninstall the existing version by running the following command

    IQService.exe  -u

# Install the latest version by running the following command

IQService.exe -i     (OR)    IQService.exe -i -p 5050

# Start the service from the command line by running 

    IQService.exe -s

# Check the version by running the following command

    IQService.exe -v

Note:

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