IBM TRIRIGA Version 10.5.0

Silent mode: Installing the IBM TRIRIGA Workplace Reservation Manager Add-in in Microsoft Outlook

The IBM® TRIRIGA® Workplace Reservation Manager Add-in for Microsoft Outlook can be installed silently by using a command line. The silent installation requires you to define properties on the command line. The properties that you specify on the command line provide the responses that a user would provide in an attended installation. A silent installation might be used for a bulk deployment or a remote installation.

Before you begin

Review the IBM TRIRIGA Support Matrix (https://www.ibm.com/developerworks/community/wikis/home?lang=en#/wiki/IBM+TRIRIGA1/page/Support+Matrix) and verify that the prerequisite Microsoft software is installed. Install any missing prerequisites.

The IBM TRIRIGA application server and IBM TRIRIGA Workplace Reservation Manager Add-in client must be the same version.

Uninstall any previous versions of the add-in before you run this installer. To uninstall the add-in, use the Microsoft Windows Control Panel.

If IBM TRIRIGA runs on an Oracle WebLogic Server, the TRIRIGA Application Platform installer sets the <enforce-valid-basic-auth-credentials> element in the config.xml to false. This setting is a requirement for the add-in to authenticate against IBM TRIRIGA. The element cannot be set to true.

To do a silent installation of the add-in, use the Windows Installer, msiexec.exe on a command line.

Procedure

  1. Close all Outlook windows.
  2. Download the IBM TRIRIGA install_outlook_addin_version_date.msi installation file.
  3. Run the silent installation by entering the following command on the command line. Specify the exact path to and name of the .msi file in quotation marks, and add the package parameters that you want:
    msiexec /i "<path>\install_outlook_addin_version_date.msi" /qn
     AGREETOLICENSE=YES package_parameters
    Table 1. Built-in msiexec parameters and package specific properties that control the installation.
    Parameter Options
    /i Normal installation
    /qn Sets the UI level of the installation to no UI.
    /L*V <path_to_log> Creates an installation log at the specified existing path and defines the level of information to write to the log, for example, /L*V C:\YourDirectory\install.log.

    /L*V logs all information. The path to the log file location must exist. The installer does not create the directory structure for the log file.

    For information on command line logging options andWindows Installer error codes, see the Microsoft documentation for the Windows Installer, msiexec.exe.

    AGREETOLICENSE=
    Package-specific property that accepts the license agreement.
    • AGREETOLICENSE=YES

    This parameter must be set to YES or the installation fails.

    AUTHTYPE=
    Package-specific property that specifies the authentication type in use.
    • Set AUTHTYPE=BASIC if you want the add-in to use basic authentication when it communicates with the IBM TRIRIGA server. In this case, the add-in uses the user name and password that the user enters during add-in configuration.
    • Set AUTHTYPE=WINDOWS if you want the add-in to use Windows authentication when it communicates with the IBM TRIRIGA server. In this case, the add-in uses the credentials of the currently logged in Outlook user to connect to IBM TRIRIGA. Set AUTHTYPE=WINDOWS only if the IBM TRIRIGA system is configured for single sign-on (SSO) and SSO uses NTLM authentication.

    If this parameter is not specified on the command line, the authentication type defaults to BASIC.

    ALLUSERS=
    • Set ALLUSERS=1 to specify a per machine installation.
    • Set ALLUSERS="" to specify a per user installation.

    If this parameter is not specified, the default is per user installation.

    INSTALLDIR=

    Specifies where the .msi package will install.

    Specify the installation directory in quotation marks, for example, INSTALLDIR="C:\IBM\YourDirectory".

    If this parameter is not specified, the add-in is installed in the default location, C:\IBM\TRIRIGA Reserve Outlook Addin.

    URL=

    Package-specific property that specifies the IBM TRIRIGA server URL.

    Specify the server URL in quotations, for example, URL="http://hostname:8080/dev".

    If this parameter is not specified, the default is null.

    OFFLINETIME=

    Package-specific property for advanced configuration of add-in behavior during communication errors.

    Specify a length of time in minutes, for example, OFFLINETIME=5.

    When in offline mode, the add-in does not attempt to connect to the IBM TRIRIGA server and therefore does not function.

    If the offline time expires, and the add-in still cannot contact IBM TRIRIGA, it goes into offline mode again. If the user wants to get out of offline mode, for example, if the connection to IBM TRIRIGA is returned within the duration, they need to restart Outlook.

    If this parameter is not specified, the default is 0 and the add-in will not go into offline mode after a communication error.

    Examples:
    Silent installation for the current user:
    msiexec /i "install_outlook_addin_version_date.msi" /qn
     AGREETOLICENSE=YES
    Silent installation for all users on the machine:
    msiexec /i "install_outlook_addin_version_date.msi" /qn
     AGREETOLICENSE=YES ALLUSERS = 1
    Silent installation in a location different from the default and set the URL value:
    msiexec /i "install_outlook_addin_version_date.msi" /qn
     AGREETOLICENSE=YES INSTALLDIR="C:\IBM\YourDirectory"
     URL="http://hostname:8080/dev"
    To create an install log, use the /L* option and specify a log file:
    msiexec /i "install_outlook_addin_version_date.msi"
    /qn /L*V C:\YourDirectory\install.log AGREETOLICENSE=YES

Results

If the installation process was successful, the IBM TRIRIGA Reserve tab is displayed in the Outlook ribbon. If not, check the installation log file for errors. The log file is located in the path that you specified in the msiexec.exe /L option.

What to do next

Configure the IBM TRIRIGA Workplace Reservation Manager Add-in.


Feedback