KAPPA-Workstation (KW) v5.

60 Installation

This document gives information about the KAPPA-Workstation installation and is organized as follows:

• Section 1 lists the minimum and recommended hardware requirements

• Section 2 details the different installation steps
• Section 3 deals with the software protection settings
• Section 4 relates to the Sentinel USB driver installation
• Section 5 refers to the silent installation

Major release and intermediate upgrade

As a KAPPA user, you will be dealing with two distinct types of product distributions: major releases and
intermediate upgrades. A major release corresponds to a significant number of improvements for a particular
software, both in terms of technical content and software. Examples of major releases are KAPPA-Workstation
v5.50, and Emeraude v5.50. Each release in turn has its own evolution, mirrored by a number of intermediate
upgrades for minor additions and bug fixes. Upgrades are identified by two-digit numbers, appended on the
release name, e.g., KW v5.50.03 or Emeraude v5.50.02. Installing the first version of a given release is like
installing a brand new product. Installing an upgrade of an already installed release will upgrade the installation
and replace the previous contents.

1. Hardware requirements
Minimum configuration:
• A computer that runs a target OS can run KAPPA-Workstation. As a reminder KW is validated on the
following x64 OS versions: Windows 11, Windows 10 and Windows 8.1.
• The KW installation is about 13GB so at least this amount should be free.
• KW is designed to work in High resolution, the absolute minimum being 1024x768.
• The minimum Graphics card for the 3D plot is 512 MB / OpenGL v3.2 or higher is required

Recommended configuration:
Processor clock frequency: A typical recommendation would be for a processor with a frequency higher than
2.6 GHz. But the actual performance will vary depending on the processor generation and the nominal
frequency is not always representative.
Number of cores: a number of operations are parallelized in KW: the computation of sensitivity coefficients in
the regression, the runs in sensitivity analyses, some gridding, etc. There are also some parallelized solvers
available optionally in the numerical simulations. Obviously, the number of cores will affect the performances
of all these operations.

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 1/6

RAM: this is definitely important, and the recommendation would be to run with 16 GB or above.
Disk type: There is no disk access other than reading / saving documents. A fast disk will not make KW faster.
Resolution: a resolution with at least 1080 vertical pixel is recommended for KW.
Graphics card: NVIDIA Quadro

2. Installation procedure
Unzip the installation package into a folder and run the SETUP.EXE program, so the installation program starts.

Please note that it may take a few seconds before the first installation dialog appears on your screen.

If not already installed, the InstallShield Wizard proposes the installation of the following pre-requisites:

- Microsoft .NET Framework 4.6.2 Full

- Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)
- Microsoft Visual C++ 2015-2022 Redistributable (x64)

A welcome and a license agreement screen are displayed. Accept the license conditions and click on ‘Next’ to
continue.

Welcome screen License agreement

The next dialog (below, left) requires the name of the installation directory. The default location is
C:\Program Files\KAPPA\Workstation 5.60\. You can amend this path by clicking on ‘Browse’ and pointing
to the required folder. Click on ‘Next’ to continue. The following dialog (below, right) offers the possibility to
install any of the available modules ticking / unticking the corresponding module checkboxes. The user may
also call the same installer later to add new modules or remove some. Click on ‘Next’ to continue.

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 2/6

 Installation directory Features selection

In the following dialog, you can select your protection type, but please note that if existing G4 license
settings are detected at this stage, they will be automatically retrieved and imported in KW.

Protection type

You can modify the path to your local license file by clicking on ‘Change’ and pointing to the required folder.

To run the software with a hard key protection, a driver needs to be installed on your computer. It should be
automatically installed provided you have selected ‘USB Sentinel protection’ and you have Administrator
privileges on your computer. If you have been given a Sentinel HL driverless USB dongle you do not require any
driver installation, you just need to plug the key to the computer so it is detected. Please do not connect your
hard key to your computer unless requested by the installation.

If the FlexLM server protection has been chosen, please specify the host name of your license server in the
following format: ‘@hostname’, or ‘port@hostname’. If unknown at the time of the installation, the server may
be specified later in the Licensing dialog.

The InstallShield Wizard will then be ready to install KAPPA Workstation (below, left). Upon confirmation, the
installation is executed, and the necessary files are copied and decompressed.

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 3/6

 Installation preparation NGen optimization process

WARNING: The final installation steps may take several minutes to complete. See screen above, right.
KAPPA-Workstation is a .Net application, also referred to as “Managed application”. A managed application
comes in Microsoft Intermediate Language (MSIL) that is interpreted at execution time by the .Net runtime
environment. NGen (aka Native Image Generator) is executed by the installation to convert the MSIL into
machine code, producing a code that executes much faster since the MSIL to machine code conversion does
not need to be done anymore. The conversion from MSIL to machine code is however machine specific and
this is why it must be executed at installation time.

At the end of the installation and provided you have specified that you will be using a FlexLM local license, if
no valid license file is found on your computer, you will be prompted to request a Demo license (below, left).
If you agree, the DemoLicenseRequestForm.exe tool will be executed so your computer identification is
retrieved by this program. Since this tool is copied in your installation folder you will be able to request a Demo
license at any time after installation.

Setup complete

Once the installation is successful, you will be notified (above, right).

WARNING: KW must be started with the shortcuts we create. If one tries to recreate a shortcut, then every
time KW is started it will go through a discovery step to find the connected modules. The shortcut we create
has a special instruction on the command line (-f namely) to skip the discovery because we do it once during
the installation.

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 4/6

3. View / edit your protection settings after KW installation
To successfully launch KW modules, a valid license needs to be detected at each module startup.

As previously indicated during the installation steps, please note that if existing G4 license settings are detected
at installation time, they will be automatically retrieved and configured in KW.

The Licensing dialog accessed clicking on the USB icon located at the bottom right of the KW launcher allows
to configure, view and edit your licenses.

In this dialog, you may:

• Define your licenses
• View your protection settings
• Rank your licenses
• Update your USB port dongle
• Define the path to the FlexLM license file
• Define the FlexLM license server

Please refer to the KW on-line help while in the Licensing dialog for more details.

The license information set in the Licensing dialog is stored in the kw-settings.kws file found in
C:\Users\Public\Documents\KAPPA\Settings 5.60.

4. Sentinel USB driver installation

If you need to manually install the Sentinel USB driver, please make sure you have Administrator privileges on
the computer.
Execute the HASPUserSetup.exe found by default in C:\ProgramData\KAPPA\Protection\Sentinel.
The Wizard will pop up, click on ‘Next’ until the installation is completed.

Note: To view this path you may need to activate the ‘Show hidden files, folders and drives’ option in Windows
Explorer > Organize > Folder and search options > View tab.

5. Silent mode installation / uninstallation

The installation package of KAPPA-Workstation enables the Silent mode option.

A standard (non-silent) installation necessarily needs the input from the user to respond to the InstallShield
Wizard. However, a silent installation does not prompt the end user for input. Instead, a silent installation will
get the user input from a response file (setup.iss).

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 5/6

5.1. Setup.exe command-line parameters
/r : Record mode
To run the installation program in silent mode, you must first run Setup.exe with the /r switch to generate a
response file, which stores information about the data entered and options selected by the user at run time.

/s : Silent mode
The command Setup.exe /s runs the installation in silent mode, by default based on the responses contained
in a response file called Setup.iss in the same directory (response files are created by running Setup.exe with
the /r option). To specify an alternative file name or location of the response file, use the /f1 option.

/f1 : Specify alternative response file name

Using the /f1 argument allows to specify where the response file is (or where it should be created) and what
its name is, as in Setup.exe /s /f1"C:\Temp\Setup.iss". The /f1 switch is available both when creating a
response file (with the /r option) and when using a response file (with the /s option).

/f2 : Specify alternative log file name

When running the installation in silent mode (using the /s argument), the log file Setup.log is by default created
in the same directory and with the same name (except for the extension) as the response file. The /f2 argument
allows to specify an alternative log file location and file name, as in Setup.exe /s /f2"C:\Setup.log".

5.2. Installation commands

a) Record mode
To create a response file, run setup.exe with the /r argument, which runs the installation normally, and
additionally creates the response file used by a silent installation. By default, the response file is called Setup.iss,
and is created in the Windows directory. To specify a different name or location for the response file, use the
/f1 argument to Setup.exe, as illustrated below:

c:\Silent Mode Installation>setup.exe /r /f1"c:\Silent Mode Installation\setup.iss"

b) Execute mode
c:\Silent Mode Installation>setup.exe /s /f1"c:\Silent Mode Installation\setup.iss"

5.3. Uninstallation commands

a) Record mode
"C:\Program Files (x86)\InstallShield Installation Information\{11EA250B-E442-445E-8017-
D834B12B5D9B}\setup.exe" /r /f1”c:\uninstall.iss”

b) Execute mode
"C:\Program Files (x86)\InstallShield Installation Information\{11EA250B-E442-445E-8017-
D834B12B5D9B}\setup.exe" -runfromtemp /s /f1”c:\uninstall.iss”

You may get further details from the Revenera software web site: https://docs.revenera.com/

KW v5.60 - Doc v5.60.02 © KAPPA 1988-2024 KAPPA-Workstation (KW) Installation - 6/6