The update.ini file is a configuration file available at: %ProgramData%\iManage\AgentServices\configs. The file contains all the key value properties that iManage Auto Updates requires. You can define channels and other iManage Auto Updates related parameters in the update.ini file.

To ensure that configuration changes are managed centrally, sign the update.ini file and upload it to iManage Control Center (Client Setup > Office tab > Configuration option) along with the following files:

  • sign.txt

  • pubcert.crt

  • updateinfo.json

When users connect to iManage Work, the files are downloaded to their machines in the %ProgramData%\iManage\AgentServices\CentralizedConfigs folder. iManage Updater reads all information from this update.ini file.

A sample update.ini is as follows:

[General]
server=updates.imanage.work/Updates/Work10
default=release
type=https
rest_backend=0
channel_category=work10
[monthly]
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

The [General] section includes the following properties: 

  • server: Indicates the update server location. For example: updates.imanage.com/Updates/Work10

  • default: Indicates the default channel assigned to the user.

  • type: Indicates if https is used.

  • rest_backend: Indicates if rest_backend is used.

  • channel_category: Indicates the channel category.

The next sections in the update.ini file are the definitions for the channels, for example, [beta] and [release]. You can add as many channels as you want and name them per your organization's requirements—for example, [pre-release], [monthly], and so on. 

You can define the following parameters in the update.ini file:

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 the iManage Auto Updates feature uses 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 another for the [Release] channel.

Upgrade code

A unique identifier (registry format GUID) that is valid for the entire 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 executable, 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 rollback of software products and versions, when necessary. Rollback allows a firm to undo an update. For example, if a firm upgrades some users from version 144 to 149 and then decides for some reason that the upgrade is 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 later 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 reinstall of the 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 that 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 download and installation of the latest version without manual intervention. 

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