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
[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
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]
, [release]
, and so on.
You can define the following parameters in the update.ini file:
Table: Channel parameters
Parameter | Description |
---|---|
| Name of the product to be installed. Example: iManage Work Desktop for Windows x64 |
| 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. |
| File name of the product installer. Example: iManage Work Desktop for Windows x64.exe |
| 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. |
| 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:
ie. |
| 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. |
| 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 When NOTE: When a downgrade or rollback occurs, iManage Updater performs a complete uninstall and reinstall of the software package. |
Where:
| 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. |
| Arguments to the installer to alter the default installation behavior. Example: |
| 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. |
| Adds additional checksum to the installer file. |
| 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. |