Running OL Connect installer in Silent Mode

Updating from Connect versions predating 2019.1

In order to update OL Connect to 2024.1 from Connect versions prior to 2019.1 it is first necessary to update the Connect License.
For details on how to upgrade the Connect License see Users of OL Connect prior to 2019.1

General information

OL Connect can be installed from the command line in "silent mode" to allow for scenarios such automated installations during company wide roll-outs, or to allow for unattended out-of-hours updates. The trigger for the Connect Installer to run in silent mode is a text file with the fixed name installProperties.ini located in the same folder as the OL Connect installation executable file.

How to prepare the installProperties.ini file is detailed in the following sections.

Installation Properties file

The basic rules for the installProperties.ini file are:

  • Comment Lines start with the semi-colon character ';'
    Example: ; The options to configure an external database
  • The properties are listed in Key = Value pair format.
    Example:  product.ServerExtension = false
  • Quotes are used for path strings, but not for other string types
    Example: path = "c:\Program Files\Objectif Lune\OL Connect"
  • Property values are case insensitive

The installation settings fall into three distinct categories:

  • [Logging] for setting the installation logging options.
  • [Installation] for selecting what gets installed.
  • [Uninstall] handles properties related to product Uninstallation. These also impact Maintenance mode.

[Logging]

This section handles Silent Installer logging options.

The logging Key pairs are as follows:

  • verbose: Boolean (Default: false)
    A basic log is always created by the installer, with or without the verbose option. The verbose option is more suitable for debugging purpose.
    If set to true, then a verbose log file is created in the logging path specified in the INI file.
    If no logging path is specified in the INI file, then the default one is used.
    If set to false, standard logging is done.

  • path: String (Default: %PROGRAMDATA%\Objectif Lune\Installation Logs)
    Sets the folder to which the installation log will be written.
    Only the log folder should be specified here, not the log file name.

    Note: The log file name's format is set automatically and uses the format Installer-YYYY-MM-DD-####.#.#.log, where:

    • YYYY-MM-DD = The date the log was created
    • ####.#.# = The OL Connect version number

    The file name for a maintenance installation begins with "Maintenance" rather than "Installer"

Example:

Copy 
; Logging properties
[Logging]
verbose = false
path = "c:\temp\Silent Install"

[Installation]

This section handles various installation parameters as well as product selection.

The logging Key pairs are as follows:

  • product.<name>: Boolean (Default: false)
    Each OL Connect product has its own entry, which can be set to true (to install) or false (to omit from installation).
    What products are available for installation is determined by which OL Connect branding is being installed. The products for OL Connect branding are as follows:

    • product.Designer
    • product.MariaDB

  • path: String (Default: %PROGRAMFILES%\Objectif Lune\OL Connect)
    Sets the installation root folder for the OL Connect applications.

  • database.configure: Boolean (Default: true)
    If set to "false", then the database configuration is skipped.

    Note: If database configuration is skipped (database.configure = false), then none of the database.xxx properties below are required, and these properties will be ignored, even in they are included in the INI file.

  • database.system: String, Optional (Default: there is no default for this setting)
    Entry needs to be from one of the following options: mariadb, mysql, mssqlserver

    Note: If product.MariaDB = true has been set:

    • This setting becomes optional. Otherwise it is required.
    • The value is required to be mariadb, if the value is to be provided.

  • database.host: String, Optional (Default: there is no default for this setting)
    If product.MariaDB = True has been set, this value is required to be set to localhost, if provided.

  • database.port: Numeric, Optional (Default: MariaDB's default port, 3306)
    The database engine port.
    The required entry depends upon the selection made in database.system.
    If product.MariaDB = True, then the port should be set to 3306.

  • database.rootpassword: String (Default: there is no default for this setting)
    Database root password.
    There is no default value, and if this is left unspecified the installation will fail.

  • database.username: String (Default: olconnect)
    The username that OL Connect will use to connect to the database.

  • database.password: String (Default: there is no default for this setting)
    The password that OL Connect will use to connect to the database.
    There is no default value, so if this is left unspecified, then the installation will fail.

  • database.instance: String, Optional (Default: there is no default for this setting)
    Only valid if database.system = mssqlserver.

  • database.schema: String (Default: there is no default for this setting)
    Specifies the database schema to use. Required. (Optional if product.MariaDB = true)

  • database.encryptedconnection: Boolean (Default: False)
    Specifies the database schema to use.
    (Optional if if product.MariaDB = true)

  • server.connection.configure: Boolean, Optional (Default: True)
    If set to False, then the server connection configuration is skipped.

  • server.connection.user: String (Default: olc-user)
    The server connection username.

  • server.connection.password: String (Default: there is no default for this setting)
    The server password. Required if server.connection.configure = true.

  • server.connection.port: Numeric (Default: 9340)
    The server port number.

  • desktopShortcuts: Boolean (Default: False)
    Specifies whether desktop shortcuts are to be added or not.
    This flag only takes effect if components were selected which have a shortcut associated with then (Designer). If no such were selected, then this flag will have no effect.

  • Language: String, Optional
    Sets the OL Connect application language settings.
    Supported user locales (as language code) are as follows:

    • English: en

    • French: fr

    • German: de

    • Italian: it

    • Japanese: ja

    • Spanish: es

    • Portuguese (Brazil): pt

    • Chinese (PRC/TW): zh

    • Korean: ko

  • Locale: String, Optional
    Sets the OL Connect application's region using a country code. For example: US, UK, DE, CH.
    If this property is not set, the locale defaults to the system locale, and if that is not found, the selected installation language will determine a default locale.

Example:

Copy 
; Installation settings
[Installation]
product.Designer = true
product.Server = true
product.PrintManager = true
product.ServerExtension = false
product.MariaDB = true
product.Messenger = true
RegisterService.connectServer = true
server.username = Administrator
server.password = ObjLune
server.connection.user = olc-user
server.connection.password = secret
database.rootpassword = @Admin2022
database.username = olconnect
database.password = @Admin2022
database.remoteaccess = true
desktopShortcuts = true
path = "c:\Program Files\Objectif Lune\OL Connect"
Language = fr
Locale = FR

[Uninstall]

This section handles properties related to Uninstallation, but also Maintenance mode installations.
These options have no effect at all if OL Connect is not present on the system.

The logging Key pairs are as follows:

  • remove: Boolean (Default: False)
    If the present version of the installer is already installed, this property defines the installer behaviour.
    The installer will perform a Remove MSI action on OL Connect if remove = true, whilst a Modify MSI action will be performed if remove = false.

    Note: This option has no effect if the product is not installed on the current system

    Note: If the Remove action is taken, then the equivalent of an uninstall is done, while a Modify action will change the components installed on the system based on the ones defined in the INI file [Installation] section, allowing removal or addition of components in the current installation.

  • keepdata: Boolean (Default: True)
    Allows the user to specify if they wish to keep or remove user data (located under %PROGRAMDATA%\Objectif Lune\OL Connect when performing a product uninstall.

Example:

Copy 
; Uninstallation/Repair properties
[Uninstall]
remove = true
keepdata = true

Properties file examples

Simple Connect installation example

Here is an example of a complete installProperties.ini file for a relatively simple OL Connect installation.

Copy 
; OL Connect silent installer properties

; Logging properties
[Logging]
verbose = false
path = "c:\ProgramData\Objectif Lune\Installation Logs"
; 

Installation settings
[Installation]
product.Designer = true
product.Server = true
product.PrintManager = true
product.ServerExtension = false
product.MariaDB = true
product.Messenger = true
RegisterService.connectServer = true
server.username = Administrator
server.password = ObjLune
server.connection.user = olc-user
server.connection.password = secret
database.rootpassword = @Admin2022
database.username = olconnect
database.password = @Admin2022
database.remoteaccess = true
desktopShortcuts = true
path = "c:\Program Files\Objectif Lune\OL Connect"

;Optional uninstallation settings
[Uninstall]
remove = true
keepdata = false

Exit Codes

Success

  • 0 = Installation completed successfully / no specific error code was returned.

Pre-Installation Check (200s)

  • 201: Operating system is not 64-bit

  • 202: Windows Operating System is too old (pre-Windows 7)

  • 203: Minimal UAC prerequisites were not met

  • 204: Installation user did not have administrator rights

Silent installation properties (300s)

  • 301: MariaDB product was selected, but no root password was supplied

  • 302: MariaDB product was selected, but no user password was supplied

  • 303: User provided database is to be used, but database.system property was missing

  • 304: User provided database is to be used, but database.system property had invalid value

  • 305: User provided database is to be used, but database.host property was missing.

  • 306: database.instance property was used with a database system other than MS SQL Server

  • 307: User provided database is to be used, but database.username property was missing.

  • 308: User provided database is to be used, but database.password property was missing.

  • 309: Connect server / server extension product was selected, but server.connection.password property was missing

  • 310: Connect server extension product was selected, but server.connection.host property was missing

Upgrade errors (400s)

  • 401: Some Connect applications were running and need to be closed before installation can proceed.

  • 402: The installer brand does not match the brand of the OL Connect version currently installed. (PlanetPress)

  • 403: The installer brand does not match the brand of the OL Connect version currently installed. (PReS)

  • 404: The installer brand does not match the brand of the OL Connect version currently installed. (Printshop Mail)

License file validation (500s)

  • 501: OL Connect license file is in older format

  • 502: License Care Date does not allow installation of product

  • 503: License brand mismatch with installer brand

Destination and selected product check (600s)

  • 601: Server and Server Extension both were selected to be installed.
    Only one of the two may be installed on any one system.

  • 602: No component was selected to be installed

  • 603: Destination folder is invalid or there is too little disk space available

Installation aborted (700s)

  • 701 - 725: Installation was aborted due to user cancellation

Service stop error (800s)

  • 801: OLConnect_MySQL/OLConnect_MariaDB service could not be stopped during uninstallation