SES Software installation uses Windows Installer. This means that the entire installation process is compliant with the Windows Installer Setup and MSI command-line arguments.
Command-line Structure
To administer the installation silently, the Windows Installer command-line arguments for Setup.exe can be used along with the standard /v switch for the MSI command-line arguments. Its command line takes the following general format:
"_distro_\Setup.exe" /s /v"/qn" /v"INSTALLDIR=\"%programfiles(x86)%\SES Software\_distro_version_\"" ... /v"_property_n_=_value_n_"
Unless customization is required, the following command line is sufficient to carry out a silent installation using default settings:
"_distro_\Setup.exe" /s /v"/qn"
The various components of the command-line structure are explained below:
_distro_version_: This is the version number of the distribution that is being installed. For a given version, X.Y.Z, of SES Software X.Y, the distribution version is X.Y while the build version is Z. It is recommended to install the software in the default suggested location as mentioned for the INSTALLDIR property below.
_distro_: This is the full path specifying the location where the distribution files exist. This path is also the location of the SETUP.EXE program, so the entire path specification of this program should be enclosed in double quotes as shown in the general format of the command structure above. The distribution files of a given version, X.Y.Z, of SES Software X.Y are extracted from the package, SESXY.EXE, to %public%\Documents\SES Software\_distro_version_\Setup.Z. For example, the package for software version 19.0.19098 would extract to the default location, C:\Users\Public\Documents\SES Software\19.0\Setup.19098.
_property_n_: This is the name of the public property that you would like to use. The public properties comprise of standard MSI public properties as well as the custom public properties of SES Software; the custom properties are listed in the table below.
_value_n_: This is the value of the corresponding public property that you would like to set. Please use one of the values that are suggested in the table below for the corresponding custom property.
The custom public properties that are listed in the table below correspond to each dialog setting that is used in the installation. By using their values, you can customize the installation based on your requirements. The examples below illustrate some common installation scenarios.
The example command line below will install the software for a standalone license configuration.
"C:\Users\Public\Documents\SES Software\19.0\Setup.19098\Setup.exe" /s /v"/qn"
The example command line below will install the software for a network license configuration.
"C:\Users\Public\Documents\SES Software\19.0\Setup.19098\Setup.exe" /s /v"/qn" /v"SESLICENSETYPE=CLIENTSERVER"
The example command line below will install the software on a 64-bit Windows platform to a customized installation directory. (Windows guidelines does not recommend installing outside of the program files folder.)
"C:\Users\Public\Documents\SES Software\19.0\Setup.19098\Setup.exe" /s /v"/qn" /v"INSTALLDIR=\"%programfiles(x86)%\CDEGS 19.0\""
These are custom public properties that are available to use in order to customize the MSI installation.
Use the following guide for the symbols used in the table below:
Dialog Title | Property Name | Property Name |
License Type | SESLICENSETYPE | STANDALONE† {Use Standalone License}; CLIENTSERVER {Use Network License} |
SES Software Protection Dongle | SESKEYTYPE | KEYTYPE_SENTINEL† {Sentinel/Sentinel Net} (KEYTYPE_HASP {HASP} and KEYTYPE_NETHASP {NetHASP} are no longer supported by the installer; internally, they will default to KEYTYPE_SENTINEL.) |
SESINSTALLHASPDRIVER | 1† {INSTALL}; -1 {DO NOT INSTALL} INSTALL is set when SESKEYTYPE=KEYTYPE_SENTINEL and when the installed version is less than the one available in the distribution. Note that this property is ignored for silent installation; i.e., when installed silently, the driver installation cannot be invoked. At the end of the installation of the software, the installer automatically starts the installation of the driver for the software protection dongle if SESINSTALLHASPDRIVER is set to "1". The installer for the Sentinel USB-port driver (HASPUserSetup.exe) exists in the distribution folder, Tools\Sentinel\Install. You may choose to turn off the automatic installation of the Sentinel driver by setting SESINSTALLHASPDRIVER to "-1" and script your own silent installation of the driver using the following command-line arguments: "_distro_\Tools\Sentinel\Install\HASPUserSetup.exe" /s /v"/qn" | |
Installation Scheme | SESIOSCHEME | PERMACHINE† {For everyone}; SESSOFTWARE {In the classic way} |
Upgradable Version Found | SESUPGMIGRATESETTINGS | 1† {I want to have ... migrated from the upgradable version ...}; -1 {UNSELECTED} If you have the current distribution of SES Software already installed but it is older than the version that is being installed, and you would like the installer to migrate the settings from the older version to the newly installed environment, then set the value of this property to "1". However, if you would like the installer to skip the migration of the settings of the older version, then you should specify "-1" for this property. If the installer does not detect an older version of current distribution of SES Software, then this property will be ignored. NOTE: migrating settings from an older version of the current distribution of SES Software and migrating settings from a legacy version (refer to SESMIGRATESETTINGS below) are mutually exclusive. In other words, if you choose to migrate the settings from an older version of the current distribution of SES Software, then you must explicitly set the value of SESMIGRATESETTINGS to "-1" |
Legacy Version Found | SESUNINSTLEGACY | 1 {I want to have ... legacy version ... removed ...}; -1† {UNSELECTED} If a legacy version of SES Software (e.g., v13, v12, etc.) is already installed and you would like to have the legacy version automatically removed by the installer of current distribution of SES Software, then you should specify "1" for this property. If you want the legacy version to remain alongside the current distribution of SES Software, then you should specify "-1" for this property. If the installer does not detect a legacy version, then this property will be ignored. This property is not supported for a silent installation of the current distribution of SES Software since the legacy version is uninstalled during the UI sequence of the installation. You may script a silent uninstall of the legacy version after the current distribution of SES Software has been installed by following the steps below:
%systemroot%\system32\msiexec.exe /x {_product_code_} /qn |
SESDELLEGACYSETTINGS | 1† {I also want the legacy settings to be removed}; -1† {UNSELECTED} -- the default value is the value of SESUNINSTLEGACY If a legacy version of SES Software (e.g., v13, v12, etc.) is already installed and you have set "1" for the SESUNINSTLEGACY property, then you will want to delete the settings of the legacy version that are in the Windows registry; in this case, you should explicitly specify "1" for this property. On the other hand, if the value of SESUNINSTLEGACY is set to "-1", then you should specify "-1" for this property. If the installer does not detect a legacy version, then this property will be ignored. | |
SESMIGRATESETTINGS | 1† {I want to have the user settings and databases migrated ...}; -1† {UNSELECTED} -- the default value is the opposite value of SESUPGMIGRATESETTINGS If a legacy version of SES Software (e.g., v13, v12, etc.) is already installed and you would like the installer to migrate the settings from the legacy version to the newly installed environment, then you should explicitly specify "1" for this property. However, if you would like the installer to skip the migration of the settings of the legacy version, then you should specify "-1" for this property. If the installer does not detect a legacy version, then this property will be ignored. NOTE: migrating settings from a legacy version and migrating settings from an older version of the current distribution of SES Software (refer to SESUPGMIGRATESETTINGS above) are mutually exclusive. In other words, if you choose to migrate the settings from a legacy version, then you must explicitly set the value of SESUPGMIGRATESETTINGS to "-1" | |
Update Notification | SESUPDATE | 0† {Allow update notification}; 2† {UNSELECTED} Programs can notify at start-up whenever there is a new version of an SES Software update available to download and install. The update notification can be disabled if desired. |
These are standard public properties that are available to use in order to customize the MSI installation.
Dialog Title | Property Name | Property Name |
Destination Folder | INSTALLDIR | %programfiles(x86)%\SES Software\_distro_version_† Customization of the installation directory can be done by specifying the full path of the installation with the INSTALLDIR MSI property. However, Windows guidelines does not recommend installing outside of the program files folder. On a 64-bit platform, please use the %programfiles(x86)% environment variable to construct the path of the installation directory: INSTALLDIR="%programfiles(x86)%\SES Software\19.0". NOTE: This property should be double-quoted whenever it is used. When passing the INSTALLDIR command-line argument via SETUP.EXE, double quotes in the command line must be escaped using the escape sequence, \". Refer to the full command-line structure at the top. |