MSI Manual SEP sesam V4.2.2/4.4

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English

Copyright © SEP AG 1999-2020. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo V2. For previous documentation version(s), check documentation archive.


Overview

Microsoft Windows Installer (MSI) is an installation and configuration service package file format used by Windows. It is used for installation, maintenance, and removal of software. SEP sesam software is contained in a package, used with its client-side installer service, an .exe file, to open and install SEP sesam.

SEP sesam .msi file is packed inside the .exe file; you can use it for clean installation and uninstallation of SEP sesam. You need to extract the .msi installation package from the .exe file, as described in MSI file extraction. SEP sesam installation files can be downloaded from SEP Download Center.

Prerequisites

  • Before starting the SEP sesam installation make sure that you are logged in as local administrator or domain administrator. In case of remote access via a remote desktop connection (RDC), the RDC administrator needs equivalent access rights as the local administrator.
  • In order to install one or several SEP sesam components (SEP sesam Server, Remote Device Server, client, or GUI) an installation file is required which can be downloaded from https://download.sep.de/windows. Make sure to download the correct file for your processor type.
  • If you are planning to install a SEP sesam Server (including a GUI) or a GUI, Java Runtime Environment (JRE) must be installed. For details on the required Java version, see Java Compatibility Matrix. For a server installation, .Net Framework 4 is obligatory, for all other SEP sesam components you can deselect .Net Framework functionality during installation.
  • An installation with or without user interaction can be executed using the suitable exe or msi file which can be extracted from the exe file. In the following sections, the different installation packages, msiexec command line parameters, and SEP sesam specific parameters for installing, updating and uninstalling SEP sesam without user interaction will be explained.

Installation packages

SEP sesam is comprised of four different components, all of which are included in the SEP sesam Server installation package. In addition to the server installation package two further installation packages, each containing only a single SEP sesam component, are available, resulting in three distinct installation packages:

  1. Server installation package: sesam-srv-<version_ID>-windows.x<system_type>.exe
    It contains all 4 SEP sesam components. During installation, select one of the 4 SEP sesam components to be installed.
  2. GUI installation package: sesam-gui-<version_ID>-windows.x<system_type>.exe
    It contains GUI subcomponents of SEP sesam with an optional client.
  3. Client installation package: sesam-cli-<version_ID>-windows.x<system_type>.exe
    It contains client subcomponents of SEP sesam only.

MSI file extraction

To extract the msi installation package from the exe file, open a prompt by selecting Start -> Run , type cmd , and click OK. Then execute the following command:

sesam-<package>-<version_ID>-windows.x<system_type>.exe /v"EXTRACT=y"

e.g.:

C:\Temp\sesam-srv-4.2.2.6-windows.x64.exe /v"EXTRACT=y"

This command extracts the msi file to the folder C:\Temp. To extract the msi file to a specific folder replace y with the destination folder, e.g.:

C:\Temp\sesam-srv-4.2.2.6-windows.x64.exe /v"EXTRACT=C:\MSI"

In contrast with the previous command the msi file will now be extracted to the folder C:\MSI instead of C:\Temp.

SEP sesam program files extraction

Extract from exe file

To extract the program files from the exe package, open a prompt by selecting Start -> Run , type cmd , and click OK. Then execute the following command:

sesam-<package>-<version_ID>-windows.x<system_type>.exe /a /v"/qb TARGETDIR=targetPath"

e.g.:

C:\Temp\sesam-srv-4.2.2.6-windows.x64.exe /a /v"/qb TARGETDIR=C:\Temp"

This command extracts the single program files from the exe file to the folder C:\Temp.

Extract from MSI file

To extract the program files from the msi package, execute the following command:

msiexec /a sesam-<package>-<version_ID>-windows.x<system_type>.msi /qb TARGETDIR=targetPath

e.g.:

msiexec /a C:\Temp\sesam-srv-4.2.2-windows.x64.msi /qb TARGETDIR=C:\Temp

This command extracts the single program files from the msi file to the folder C:\Temp.

MSI parameter

To obtain msiexec specific parameters, open a prompt and set the following command:

msiexec

A separate window pops up containing all relevant msiexec specific parameters. At this point you can also check your Windows Installer version. If you have a Windows Installer v. < 2.0, install Windows Installer 2.0 or higher before continuing. The most important parameters needed in combination with SEP sesam are displayed below.

msiexec /Option <required parameter> [optional parameter]

/Option :

/i <product.msi>                      Installs or configures a product 
/x <product.msi>                      Uninstalls the product

Optional parameter :

msiexec specific parameters :

/quiet                                Quiet mode, no user interaction 
/q[n|b|r|f]                           Sets user interface level
                                      n - No UI
                                      b - Basic UI
                                      r - Reduced UI
                                      f - Full UI (default)
/lvoicewarmup <log_file>              Creates a log file of the running process 

SEP sesam specific parameters:

SETUP         srv | rds | cli | gui   Specifies the component to be installed (SEP sesam Server, Remote Device Server, client, or GUI), 
                                      default is SETUP=srv. 
GUI           yes | no                Specifies if a GUI will be installed (available only for RDS installation),
                                      default is GUI=no. 
CLIENT        yes | no                Specifies if a client will be installed (available only for GUI installation),
                                      default is CLIENT=no. 
SERVER                                Server name (obligatory for RDS, client and GUI installation). 
LANG          en | de | de_by         Language for the GUI (English, German, and Bavarian are available), default is LANG=en.
BIN           "Path"                  Installation folder for application files, default is BIN={{path|C:\Program Files\}}. 
VAR           "Path"                  Installation folder for application data, default is VAR={{path|C:\ProgramData\}} or, in case
                                      {{path|C:\ProgramData\}} does not exist, VAR={{path|C:\Program Files\}}.  
SHORTCUTS     yes | no                Desktop and Startup menu shortcuts can optionally be created, default is SHORTCUTS=yes.
DOTNET        yes | no                To use ''SEP sesam system tray'', ''Set SEP sesam Client'', and ''Set GUI Access'' 
                                      functionality, .Net Framework 4 is required. If .Net Framework is not installed 
                                      on your system, you can optionally select ''no'', default is DOTNET=yes. In case of a SEP sesam 
                                      server installation this option is always set to ''yes''. 
SYSTEM_TRAY   yes | no                ''SEP sesam system tray'' can be selected or deselected, depending on DOTNET (it only works if 
                                      ''.Net Framework'' is installed), default is SYSTEM_TRAY=no. 
BSR_PRO       yes | no                ''BSR Pro'' is the disaster recovery solution for Windows systems, which makes   
                                      it possible to recover and have a fully functional Windows system within a very short    
                                      period of time. ''BSR Pro'' is subject to licensing. The default is BSR_PRO=no. 
JAVA_HOME     "Path"                  If Java has only been copied on the system without an actual installation, the Java path can 
                                      be inserted in the silent installation mode as follows: JAVA_HOME=D:\Java\jre7\bin.
IGNORESIZE    yes | no                To ignore the default space requirements use IGNORESIZE=yes, default is IGNORESIZE=no.
IGNOREDOTNET  yes | no                If .Net Framework is not available for an RDS, client, or GUI installation, use IGNOREDOTNET=yes, 
                                      default is IGNOREDOTNET=no.
UPDATE_MAIL   yes | no                Update sm_disaster, sm_notify, and/or sm_alarm if already present in {{path|bin\sesam}} directory, 
                                      default is UPDATE_MAIL=no.
HELP          y                       Displays the help options for installation, update, change, and uninstallation.  
EXTRACT       y | "Path"              Extracts the msi file from the exe file to the current location of the exe file. If a ''Path'' is 
                                      given, the msi file will be extracted to the given ''Path'' instead.


Server installation package

In order to install a SEP sesam component select the download folder where you saved the SEP sesam installation package. Then extract the msi file from the exe file as described in section MSI file extraction or use the exe file directly.

Open a prompt with administrative rights by selecting Start -> Run , type cmd , and press Shift + Ctrl + Return. Then change to the location of your exe file or the extracted msi package.

Installation using Windows Installer (MSI)

To start installation in quiet mode without user interaction, the following commands can be used to either use msiexec.exe or start it directly by using the SEP sesam installation file:

msiexec.exe /i <sesam>.msi /quiet

or

<sesam>.exe /s /v"/quiet"

<msi_sesam>.msi denotes the name of the msi file. This command line installs SEP sesam using all default settings, i.e. an English SEP sesam Server with no SEP sesam system tray will be installed. The location of the application files will be C:\Program Files\ and the location of the application data will be C:\ProgramData\ or C:\Program Files\, in case C:\ProgramData\ does not exist.

For the installation, you can set the following parameters: SETUP, GUI, CLIENT, SERVER, LANG, BIN, VAR, DOTNET, and SYSTEM_TRAY.

Note that the parameter GUI can only be set in case of Remote Device Server and the parameter CLIENT can only be set in case of a GUI installation. In case of a server installation, the GUI and the client will be installed automatically.

Furthermore, note that the parameter SERVER is obligatory for all components except for the SEP sesam Server installation. Make sure that the server name does not contain any underscores (_) and that it is reachable. Below several examples of how to install different components of SEP sesam are shown. Note that each example has to be inserted into one line without any new lines.

Example 1: Server installation

msiexec /i sesam-srv-4.2.2-windows.x64.msi /quiet SETUP=srv LANG=de BIN="C:\Program Files\" VAR="D:\" SYSTEM_TRAY=yes

or

sesam-srv-4.2.2-windows.x64.exe /s /v"/quiet SETUP=srv LANG=de BIN=\"C:\Program Files\" VAR=\"D:\" SYSTEM_TRAY=yes"

Example 2: RDS installation
In this example we will install an RDS without a GUI, the corresponding server name is lugus, the location for the application files will be C:\ProgramFiles\, the location for the application data will be D:\, and the user disclaims .Net Framework functionality; i.e., options SEP sesam system tray, Set SEP sesam Client and Set GUI Access are not selected.

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet SETUP=rds GUI=no SERVER=lugus BIN="C:\Program Files\" VAR="D:\" DOTNET=no

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet SETUP=rds GUI=no SERVER=lugus BIN=\"C:\Program Files\" VAR=\"D:\" DOTNET=no"

In this example we will install an RDS including GUI, the server name is ogmios, the location for the application files will be C:\ProgramFiles\, the location of the application data will be X:\, and both SEP sesam system tray and BSR Pro will be installed.

msiexec /i sesam-srv-4.2.2-windows.x64.msi /quiet SETUP=rds GUI=yes SERVER=ogmios LANG=de BSR_PRO=yes BIN="C:\Program Files\" VAR="X:\" SYSTEM_TRAY=yes

or

sesam-srv-4.2.2-windows.x64.exe /s /v"/quiet SETUP=rds GUI=yes SERVER=ogmios LANG=de BSR_PRO=yes BIN=\"C:\Program Files\" VAR=\"X:\" SYSTEM_TRAY=yes"

Example 3: GUI installation
In this example we will install a GUI without a client, the corresponding server name is grannus, the location for the application files will be C:\ProgramFiles\, and the location for the application data will be I:\.

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet SETUP=gui CLIENT=no SERVER=grannus LANG=de BIN="C:\Program Files\" VAR="I:\"

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet SETUP=gui CLIENT=no SERVER=grannus LANG=de BIN=\"C:\Program Files\" VAR=\"I:\""

In this example we will install a GUI including a client, the server name is vosegus, the location for the application files will be C:\ProgramFiles\, and the location for the application data will be I:\.

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet SETUP=gui CLIENT=yes SERVER=vosegus LANG=de BIN="C:\Program Files\" VAR="I:\"

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet SETUP=gui CLIENT=yes SERVER=vosegus LANG=de BIN=\"C:\Program Files\" VAR=\"I:\""

Example 4: Client installation
In this example we will install a client, the corresponding server name is lenus, the location for the application files will be C:\ProgramFiles\, the location for the application data will be D:\, and BSR Pro will be installed.

msiexec /i sesam-srv-4.2.2-windows.x64.msi /quiet SETUP=cli SERVER=lenus BSR_PRO=yes BIN="C:\Program Files\" VAR="D:\"

or

sesam-srv-4.2.2-windows.x64.exe /s /v"/quiet SETUP=cli SERVER=lenus BSR_PRO=yes BIN=\"C:\Program Files\" VAR=\"D:\""

Update using Windows Installer (MSI)

Major update

One of the first three positions of the version number has changed, e.g., 4.2.1.x to 4.2.2.x.

An update in quiet mode without user interaction can be executed using the following command:

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet"

Before starting the update make sure you have a successful SESAM_BACKUP of your SEP sesam Server.

The parameters REINSTALLMODE and REINSTALL must not be given in case of a major update, otherwise your SEP sesam will be uninstalled and your entire configuration will be lost.

Minor update

Only the fourth position of the version number has changed, e.g., 4.2.2.4 to 4.2.2.6.

An update in quiet mode without user interaction can be executed using the following command:

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet REINSTALLMODE=vamus REINSTALL=ALL

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet REINSTALLMODE=vamus REINSTALL=ALL"

Note that all parameters have to be given in order for the minor update to work correctly. Before starting the update make sure you have a successful SESAM_BACKUP of your SEP sesam Server.

Changing your configuration using the Windows Installer (MSI)

If you have SEP sesam already installed on your system, you can subsequently change your configuration, e.g., you can add or remove a GUI for an existing RDS installation or a client for an existing GUI installation. Furthermore, .Net Framework functionality and SEP sesam system tray can be added or removed if desired.

Major version change

One of the first three positions of the version number has changed, e.g., 4.2.1.x to 4.2.2.x.

To change the configuration in silent mode you can use one or several of the following parameters (GUI, CLIENT, DOTNET, and SYSTEM_TRAY):

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet GUI=yes|no CLIENT=yes|no DOTNET=yes|no SYSTEM_TRAY=yes|no

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet GUI=yes|no CLIENT=yes|no DOTNET=yes|no SYSTEM_TRAY=yes|no"

Example 1: Existing RDS installation without GUI and without SEP sesam system tray

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet GUI=yes SYSTEM_TRAY=yes

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet GUI=yes SYSTEM_TRAY=yes"

Example 2: Existing GUI installation without client and without .Net Framework

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet CLIENT=yes DOTNET=yes

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet CLIENT=yes DOTNET=yes"

Before starting the configuration change, make sure that you have a successful SESAM_BACKUP of your SEP sesam Server.

The parameters REINSTALLMODE and REINSTALL must not be given in case of a major update, otherwise your SEP sesam will be uninstalled and your entire configuration will be lost.

Minor version change

Only the fourth position of the version number has changed, e.g., 4.2.2.4 to 4.2.2.6.

To change the configuration in silent mode you can use one or several of the following parameters (GUI, CLIENT, DOTNET, and SYSTEM_TRAY):

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet REINSTALLMODE=vamus REINSTALL=ALL GUI=yes|no CLIENT=yes|no DOTNET=yes|no SYSTEM_TRAY=yes|no

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet REINSTALLMODE=vamus REINSTALL=ALL GUI=yes|no CLIENT=yes|no DOTNET=yes|no SYSTEM_TRAY=yes|no"

Example 1: Existing RDS installation without GUI and without SEP sesam system tray

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet REINSTALLMODE=vamus REINSTALL=ALL GUI=yes SYSTEM_TRAY=yes

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet REINSTALLMODE=vamus REINSTALL=ALL GUI=yes SYSTEM_TRAY=yes"

Example 2: Existing GUI installation without client and without .Net Framework

msiexec /i sesam-srv-4.2.2-windows.x86.msi /quiet REINSTALLMODE=vamus REINSTALL=ALL CLIENT=yes DOTNET=yes

or

sesam-srv-4.2.2-windows.x86.exe /s /v"/quiet REINSTALLMODE=vamus REINSTALL=ALL CLIENT=yes DOTNET=yes"

Note that the parameters REINSTALLMODE and REINSTALL have to be given in order for the configuration change to work correctly. Before starting the configuration change, make sure you have a successful SESAM_BACKUP of your SEP sesam Server.

Uninstall using the Windows Installer (MSI)

To uninstall in quiet mode without user interaction, use the following command. Note that this command will completely remove SEP sesam from your system.

msiexec /x sesam-srv-4.2.2-windows.x86.msi /quiet REINSTALLMODE=vamus REMOVE=ALL

All parameters have to be given in the correct order for the removal to work correctly.

GUI installation package

In order to install a SEP sesam GUI with an optional client using Windows Installer (MSI), select the winXX directory on the CD/DVD, or select the download folder where you saved the SEP sesam GUI installation package. Then extract the msi file from the exe file, as described in section MSI file extraction.

Open a prompt with administrative rights by selecting Start -> Run , type cmd , and press Shift + Ctrl + Return. Then change the location of your extracted msi package.

For more information, see section Server installation package and follow the instructions for a GUI installation.

Client installation package

In order to install a SEP sesam Client using Windows Installer (MSI), select the winXX directory on the CD/DVD, or select the download folder where you saved the SEP sesam Client installation package. Then extract the msi file from the exe file, as described in section MSI file extraction.

Open a prompt with administrative rights by selecting Start -> Run , type cmd , and press Shift + Ctrl + Return. Then change the location of your extracted msi package.

For more information, see section Server installation package and follow the instructions for a client installation (without GUI, since a SEP sesam Client installation package does not contain a GUI).

Known issues

If you have problems with MSI installation, check the Troubleshooting Guide.

See also

SEP sesam Quick Install GuideInstallation