How to perform Add-in 4.0 deployment using command line

Modified on Tue, 24 Sep at 12:07 PM

This article consists of the following sections:

Requirements
Advantages of deployment using command line
Predefine add-in configuration properties
Add-in deployment using the command line (with parameters)
1. Deploy for ALL USERS (per machine) with predefined URL and Backend version
2. Deploy PER USER with URL and backend version
Add-in deployment using the command line (with TRANSFORM file)

Requirements

Go to System Requirements page on the Add-On Products website to have an overview of System requirements for Resource Central (RC).

NOTE: When you deploy Add-in 4.0 using Command line, you must open the Command Prompt with option “Run as Administrator”.

Advantages of deployment using command line

It is possible to predefine some add-in configurations such as RC backend URL address, RC backend compatibility.
It is possible to track the deployment process with an installation log.

Predefine add-in configuration properties

Property Name

Value

Note

RESOURCECENTRAL_URL

Example:

http://RCWebServer/ResourceCentral

URL address of Resource Central backend

RC_WEB_VERSION

0 = Any version higher than RC 3.8 HF6
1 = RC 3.7 VTC
2 = RC 3.7.10
3 = RC 3.8 RTM and Hotfix 1/2/3/4/5 (This is default value)
4 = RC 3.8 SR and HF6

Define RC backend compatibility for add-in

LANGUAGE

Language set for Add-in at the deployment:

Value	Language
da	Danish
Zh-CN	Chinese
nl	Dutch
en-US	English
fi	Finnish
fr	French
de	German
it	Italian
ja	Japanese
ko	Korean
pt	Portuguese
ru	Russian
es	Spanish
sv	Swedish
nb	Norwegian

Define RC backend compatibility for add-in

ALLUSERS

Use this property with value “1” if Add-in is deployed for All users (per machine)

DEFAULT_LOCATION

ID of location tree in RC (e.g. ID of root location is 47)

This property is used to set a default location for the first use of ResourceFinder

UPDATE_SETTINGS

0: The function is turned OFF. Add-in will not update “ResourceCentralURL” and “RCVersion” in Settings file
1: The function is turned ON, Add-in sends request to backend web service and updates both “ResourceCentralURL” and “RCVersion” (This is default value)
2: The function is turned ON, Add-in sends request to backend web service and updates “RCVersion”
3: The function is turned ON, Add-in sends request to backend web service and updates “ResourceCentralURL”

Control the update settings function in working with backend web service

Add-in deployment using the command line (with parameters)

1. Deploy for ALL USERS (per machine) with predefined properties

Open the Command Prompt with the option “Run as Administrator” and enter the following command:

msiexec /L*V "log.txt" /i ResourceCentralAddin.32bitv4.00.0056.msi RESOURCECENTRAL_URL="http://RCServerName.domain/ResourceCentral" ALLUSERS="1" RC_WEB_VERSION="4" DEFAULT_LOCATION="47" UPDATE_SETTINGS="1" LANGUAGE="da" /quiet

In which, you can:

Change ResourceCentralAddin.32bitv4.00.0056.msi with [path of installer file\name of current installer file] if it is located in another folder.
Change value of the parameters as you wish to be compatible with configuration of the machine/environment.

2. Deploy PER USER with predefined properties

Open the Command Prompt with the option “Run as Administrator” and enter the following command:

msiexec /L*V "log.txt" /i ResourceCentralAddin.32bitv4.00.0056.msi RESOURCECENTRAL_URL="http://RCServerName.domain/ResourceCentral" RC_WEB_VERSION="4" DEFAULT_LOCATION="47" UPDATE_SETTINGS="1" LANGUAGE="da" /quiet

In which, you can:

Change ResourceCentralAddin.32bitv4.00.0056.msi with [path of installer file\name of current installer file] if it is located in another folder
Change value of the parameters as you wish to be compatible with configuration of the machine/environment.

Add-in deployment using command line (with TRANSFORM file)

NOTE: See How to create a Transform file Knowledge Base article to know how to create a TRANSFORM with ORCA tool.

Copy the installer file (.msi) and .mst file to a folder then open the Command Prompt with option “Run as Administrator” and enter the following command:

msiexec /quiet /L*V "log.txt" /i ResourceCentralAddin.32bitv4.00.0056.msi TRANSFORMS="ALLUSERS_SETTINGS.mst"

You can change ResourceCentralAddin.32bitv4.00.0056.msi or ALLUSERS_SETTINGS.mst with [path of file\name of current file] if they are located in another folder.

Validation after deployment

Add-in is loaded into Outlook (My Meetings and ResourceFinder buttons are available in Outlook)
Settings file is deployed to:
Per Machine: “ProgramData\Add-On Products\Resource Central\Add-in” folder with all URL, backend version defined.
Per User: “Users\[Logged-in User]\AppData\Local\Add-on Products\Resource Central\Addin” folder with all URL, backend version defined

Properties

Applies to: RC Add-in 4.0

Reference: TFS #94950

Knowledge base ID: 0208

Last updated: Oct 03, 2017