Deploying iManage Work Desktop for Windows in a remote desktop session host environment

You can deploy iManage Work Desktop for Windows in a remote desktop session host (RDSH) environment by doing the following:

1. Visit iManage Help Center and download the offline full installers for iManage Agent Services and iManage Work Desktop for Windows. Make sure that the offline full installers that you download match the Microsoft Office bitness on the user's machine. Use:

   • 32-bit offline full installer for 32-bit version of Microsoft Office.

   • 64-bit offline full installer for 64-bit version of Microsoft Office.

2. Make sure the following prerequisites are installed on the user’s machine:

   • Microsoft Framework .NET 4.6.2 or later

   • Microsoft Edge WebView2 runtime
     For the complete list of prerequisities, refer to Prerequisites.

3. Uninstall any previous versions of iManage Work Desktop for Windows using the following commands:

   • For iManage Work Desktop for Windows 10.8.0 or earlier:

     • iManage Agent Services: iManageAgentServices.exe /uninstall /silent

     • iManage Work Desktop for Windows: iManageWorkDesktopforWindows.exe /silent

   • For iManage Work Desktop for Windows 10.9.0 or later:

     • iManage Agent Services: iManageAgentServices.exe /uninstall /quiet

     • iManage Work Desktop for Windows: "C:\ProgramData\iManage\Work\iManageWorkDesktopForWindows\iManageWorkDesktopforWindows.exe" /uninstall /quiet

4. Do the following:

   1. Deploy iManage Agent Services using the iManageAgentServices.exe /quiet command. iManage Agent Services should be deployed before installing iManage Work Desktop for Windows.

   2. iManage Auto Updates is enabled by default. Disable iManage Auto Updates using the following command when installing iManage Agent Services iManageAgentServices.exe /silent AUTO_UPDATE=0.
      Command line parameters are case-sensitive. 

5. Deploy iManage Work Desktop for Windows using the following command:

   • For 64-bit Microsoft Office: iManageWorkDesktopforWindowsx64.exe /s setup.iss

   • For 32-bit Microsoft Office: iManageWorkDesktopforWindowsx86.exe /s setup.iss

Additionally,

• To create a setup.iss file to automate the installation of iManage Work Desktop for Windows, run the following command before deploying iManage Work Desktop for Windows as described in Step 5:

  • For 64-bit Microsoft Office: 
    iManageWorkDesktopforWindowsx64.exe /r /f1"c:\temp\setup.iss”

  • For 32-bit Microsoft Office:
    iManageWorkDesktopforWindowsx86.exe /r /f1"c:\temp\setup.iss”
    where:

    • /r means recording

    • "c\temp\setup.iss" is the output for the setup.iss file.

• To know the command line parameters that are available for InstallScript setup.exe file, go to Command line parameters for InstallScrupt setup.exe.

• iManage Work Desktop for Windows installer checks whether Microsoft Framework .NET 4.6.2 or later and Microsoft Edge WebView2 are installed. If these applications aren’t present, an error message states that .NET 4.6.2 and Microsoft Edge WebView2 are required and the installer closes.

• Ensure that you install Microsoft WebView2 runtime as an administrator. 

• Microsoft WebView2 runtime, once installed, can automatically update itself to the latest stable version published by Microsoft. iManage Work Desktop for Windows picks up the latest Microsoft WebView2 runtime installed at run time.

When using a non-persistent Virtual Desktop Infrastructure (VDI) environment like Citrix, users can sometimes checkout a document from one VDI session and try to check in that document back in from another VDI session. This behavior isn't enabled by default in the client software; to enable, set:

Location:

For all users: HKEY_LOCAL_MACHINE\SOFTWARE\iManage\Work\10.0\Client
OR
For each signed-in user: HKEY_CURRENT_USER\SOFTWARE\iManage\Work\10.0\Client

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

Type: DWORD

Name: ValidateCheckoutLocation

Values:

• 0: Disabled

• 1: Enabled (default value)