Installing in Remote Desktop Session Host Environment

The Windows service named 'iManage Work Agent Web Service' handles the communication between the iManage Work client and the iManage Work Agent. This adds support for installing in Remote Desktop Session Host (RDSH) environments, for example, Citrix terminal server or Windows machines that host multiple users.

To install Work Desktop for Windows 10.2.1 in a multi-user environment with the new Windows service, perform the following steps:

  1. Download the executables for iManage Work Desktop for Windows and iManage Agent Services.

  2. Double-click iManageAgentServices-102xxx.exe.

  3. Run the following command at the command prompt and follow the standard installation prompts to complete the installation:
    For 64-bit version of Microsoft Office: "iManage Work Desktop for Windows x64.exe" OR
    For 32-bit version of Microsoft Office: "iManage Work Desktop for Windows x86.exe"

For silent installation, run the following commands in the specified order:

  1. iManageAgentServices-102xxx.exe /Silent

  2. "iManage Work Desktop for Windows.exe" /Silent

NOTE:

  • The iManage Work Desktop for Windows.exe file is available in the installer package.

  • The first time installation of the iManage Work Agent Web Service requires a server restart to activate the new system event source used for logging the events that occur in the Service. The logged events can be viewed in the event viewer under Applications and Services Logs > WorkAgent. The new Service automatically starts after server logon. If you want to update the installation when the new Service is already running, stop the iManage Work Agent Web Service, install the product, and restart the Service.

  • The Auto-Update functionality is not supported if you are running a Remote Desktop Session Host environment.

New registry setting

The ValidateCheckoutLocation registry setting was added to fix NT-71246: If users are connected to a Citrix farm, they cannot check in a document from a Citrix machine other than the machine from which they checked out the document.

This issue occurs because during check in, the document's checkout location is validated against the current machine name of the logged on user. To bypass this check, add the following registry setting and set it to 0 (disabled):

Path:

For all users:

HKEY_LOCAL_MACHINE\SOFTWARE\iManage\Work\10.0\Client

OR

For each logged on user:

HKEY_CURRENT_USER\SOFTWARE\iManage\Work\10.0\Client

If the registry setting is not found at either location, the default value (1) is enabled.

Type: DWORD

Name: ValidateCheckoutLocation

Values:

  • 0: Disabled

  • 1: Enabled (default value)

Changing the installation path

If you do not want to install iManage Work Desktop for Windows in the Program Files\iManage folder, use the command line interface to set the desired path as the INSTALLDIR:

iManage Work Desktop for Windows.exe INSTALLDIR=<Path of the folder where you want to install the application. For example, c:\MyNewDir>