UserLock Documentation
UserLock Documentation
You are here: Reference > Agents > IIS agent > IIS agent manual installation

IIS agent manual installation

UserLock can monitor, control and apply a user access control policy on 'Internet Information Services' (IIS) sessions. The UserLock 'IIS agent' can be installed manually through the UserLock console. However, you can also deploy it manually through the following procedure:

  1. Copy the 'IIS agent' file.

    32-bit IIS server
    • HttpModule technology: Copy the file 'UlHttpModule.dll' from the UserLock server installation folder to any IIS server folder (no specific folder is required here).
    64-bit IIS server
    • HttpModule technology: Copy the file 'UlHttpModule_x64.dll' from the UserLock server installation folder to any IIS server folder (no specific folder is required here).
  2. Register the agent with the following command line (run as administrator):

    • HttpModule technology
      regsvr32 [Path]\UlHttpModule.dll or regsvr32 [Path]\UlHttpModule_x64.dll
  3. Register communication settings with the following registry values to allow the agent to find UserLock servers:

    HKEY_LOCAL_MACHINE\SOFTWARE\ISDecisions\UserLock\IIS
    • UserLockServer (REG_SZ) with the name of the Primary server.
    • UserLockServerBackup (REG_SZ) with the name of the Backup server.

Once the procedure has been completed, UserLock 'IIS agents' will require some additional configurations.

Please note

Manual uninstallation of the HTTP Module
Open the IIS Console.

For each IIS application where you enabled the HTTP Module IIS UserLock Agent:

  • From the IIS Console, click on the application.
  • Browse "Modules".
  • Remove the item of the HTTP Module IIS UserLock Agent.

From the IIS Console, click on the server.
Browse "Modules".
Open "Configure native modules".
Select the item of the HTTP Module IIS UserLock Agent.
Unregister.
Restart the server, or at least remove the following registry key: "HKEY_LOCAL_MACHINE\SOFTWARE\ISDecisions\UserLock\IIS\Volatile".
To clean registry, delete the "HKEY_LOCAL_MACHINE\SOFTWARE\ISDecisions\UserLock\IIS" registry key.