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 for both available technologies (ISAPI filter and HttpModule) through the following procedure:

  1. Copy the 'IIS agent' file.

    32-bit IIS server
    • ISAPI filter technology: Copy the file 'IisSessions.dll' from the UserLock server installation folder to the IIS server 'system32' folder.
    • 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
    • ISAPI filter technology: Copy the file 'IisSessions_x64.dll' from the UserLock server installation folder to the IIS server 'system32' folder and rename it as 'IisSessions.dll'.
    • 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):

    • ISAPI filter technology
      regsvr32 C:\Windows\System32\IisSessions.dll
    • 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

The two agents can be installed on the same IIS server but can't target the same website/ Web application.

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.

Manual uninstallation of the ISAPI Filter
Open the IIS Console.
Select the target website in the menu tree.
Browse "ISAPI Filters".
Select the item of the ISAPI Filter IIS UserLock Agent.
Remove.
Restart the "iisadmin" service.
Restart the server, or at least remove the following registry key: "HKEY_LOCAL_MACHINE\SOFTWARE\ISDecisions\UserLock\IIS\Volatile".
To clean files, remove "C:\Windows\System32\IisSessions.*dll" files.
To clean registry, delete the "HKEY_LOCAL_MACHINE\SOFTWARE\ISDecisions\UserLock\IIS" registry key."