You can define multiple channels in update.ini file which is located at: at %ProgramData%\iManage\AgentServices\CentralizedConfigs. For more information about update.ini file, refer to What is an Update.ini file?

By defining multiple channels, you can deploy different products with appropriate versions to different user groups. When iManage Updater runs, it identifies which channel is assigned to the current user. Based on that, iManage Updater determines the products and versions that should be installed for the corresponding channel.

Each channel includes a list of all supported products. Adding channels gives you the capability to support different versions of products with the same config file.

You can define multiple channels using the following format:

[channel name]
<product ID>=<update server path>;<installer file name>;<version number>;<upgrade code>;<product code>;rollback|norollback;<installer parameters (optional)>;<Microsoft Office bitness (x64, x86, or blank)>;<MD5 checksum of installer file>

Example:

[release]
iManage Agent Services=https://updates.imanage.work/Updates/Software/april_release_10/;iManageAgentServices.exe;109.0.14;{67E81972-CA2E-4A7A-AD32-CC95A33B1592};{CBB155FC-DC3B-4CD6-A427-2544FCE01E0C};rollback;wixexe;/passive AUTO_UPDATE=1;;6d1a7b2a58f2e2ee902e7b79d2605e54;unattended
iManage Work Desktop for Windows x86=https://updates.imanage.work/Updates/Software/release_june/;iManageWorkDesktopforWindowsx86.exe;109.1.80;{E97D2B88-6E81-45B1-8796-4C49C71ECEFA};{97DE8516-B125-4D3B-BF5F-33493214F580};norollback;wixexe;/passive AUTO_UPDATE=1;x86;c9fb5aac998023f6e982d2b7d4d717f9;unattended
iManage Work Desktop for Windows x64=https://updates.imanage.work/Updates/Software/release_june/;iManageWorkDesktopforWindowsx64.exe;109.1.80;{b106fe6e-5160-401e-bcc7-8840dcd25e56};{3892D3F6-96CF-42A4-B0D8-747C783D7B08};norollback;wixexe;/passive AUTO_UPDATE=1;x64;4c6d2ac1172517b7c25a53e729cff5a3;unattended
[coming_soon]
iManage Agent Services=https://updates.imanage.work/Updates/Software/comingsoon_10/;iManageAgentServices.exe;109.0.14;{67E81972-CA2E-4A7A-AD32-CC95A33B1592};{2383168C-839E-4BA8-AB9B-DBB59725EA2B};norollback;wixexe;/passive AUTO_UPDATE=1;;c26a738c5f2efd526c6a38134e628de1;uanttended
iManage Work Desktop for Windows x86=https://updates.imanage.work/Updates/Software/release_june/;iManageWorkDesktopforWindowsx86.exe;109.1.80;{E97D2B88-6E81-45B1-8796-4C49C71ECEFA};{97DE8516-B125-4D3B-BF5F-33493214F580};norollback;wixexe;/passive AUTO_UPDATE=1;x86;c9fb5aac998023f6e982d2b7d4d717f9;unattended
iManage Work Desktop for Windows x64=https://updates.imanage.work/Updates/Software/release_june/;iManageWorkDesktopforWindowsx64.exe;109.1.80;{b106fe6e-5160-401e-bcc7-8840dcd25e56};{3892D3F6-96CF-42A4-B0D8-747C783D7B08};norollback;wixexe;/passive AUTO_UPDATE=1;x64;4c6d2ac1172517b7c25a53e729cff5a3;unattended

Table: Channel parameters 

Parameter

Description

Product ID

Name of the product to be installed.

Example: iManage Work Desktop for Windows x64

Update server path

Update server location, which is used by the iManage Auto Updates feature to download the latest applications for the initial installation and whenever these applications are updated.

The server path can be a file path (local or UNC style) or an HTTP/HTTPS web server.

Installer file name

File name of the product installer.

Example: iManage Work Desktop for Windows x64.exe

Version number

Version number of the product to be installed. With this property, you can control the installation of different product versions for different channels. For example, you can select one product version for the [Beta] channel and a different version for the [Release] channel.

Upgrade code

A unique identifier (registry format GUID) that is valid for the life of the product. Upgrade code is the Windows installer property contained within the Windows installer database (.msi file) in the Property table. You can use a freeware—for example, Orca (available with Microsoft SDK)—to edit or browse an MSI file.

To access all elements embedded in the exe, such as the msi file, you can run dark.exe from the WiX toolset with the following arguments:

dark.exe -x <directory to extract files to> <pathtoinstaller.exe>

ie. "%wix%\bin\dark.exe" -x c:\UnpackedSetups\Work "C:\Setups\iManageWorkDesktopforWindowsx64.exe"

Product code

A unique identifier (registry format GUID) that changes for each major release of the product, or when you want to uninstall previous versions before installing the latest version. Product code is the Windows installer property contained within the Windows installer database (.msi file) in the Property table. You can use a freeware—for example, Orca (available with Microsoft SDK)—to edit or browse an MSI file.

rollback\norollback

iManage Updater supports the ability to roll back software products and versions, when necessary. Rollback allows a firm to undo an update. For example, if a firm upgraded some users from version 144 to 149 and then decided—for some reason—that the upgrade was no longer desired, the firm can roll back users to version 144. When a rollback occurs, users are presented with the same notice that an update is available. When the update is installed, the user’s software is downgraded to the specified version, instead of upgrading to the latest version.

When norollback is specified, iManage Updater allows users to install any version of the software that is equal to or greater than the software version specified for their corresponding channel.

When rollback is specified, if iManage Updater finds that users have installed any version other than the one specified for that channel, it prompts users to install an update, which upgrades or downgrades the software as needed.

NOTE:

When a downgrade or rollback occurs, iManage Updater performs a complete uninstall and re-install of that software package.

wixexe|isexe|msi|sxs

Where:

  • wiexe is Wix Installer

  • isexe is InstallShield exe installation

  • msi is Microsoft Installer file

  • sxs is InstallShield side-by-side installer

The type of installer the product uses for installation. This determines what standard installer arguments are used for silent installation of the specified product.

Installer parameters (optional)

Arguments to the installer to alter the default installation behavior. Example: TRANSFORMS=\\myserver\sharename\Work10\customizations\customwork10.mst

Microsoft Office bitness

This property maps the product bitness with the Microsoft Office bitness. The value can be x64 or x86. If there is no dependency on the Microsoft Office bitness, you can leave it blank.

MD5 checksum of installer file

Adds additional checksum to the installer file. 

Unattended

Enables automatic downloading and installation of the latest version without any manual intervention. 

NOTE: The unattended flag isn't available for all the iManage Work products. For example, if you are on a channel that installs iManage Drive, that channel won't have the unattended flag available. 

utc_update_due_date

(Optional) This property allows you to specify the date and time on which updates are automatically downloaded and installed on your user’s machine.