Software release document COMPANY SHARED

Kongsberg Digital AS 26/03/2020

LedaFlow® Engineering 1D

Installation guide
KDI license server ‘Installation guide’ COMPANY SHARED

KONGSBERG PROPRIETARY: This document contains KONGSBERG information which is proprietary

and confidential. Any disclosure, copying, distribution or use is prohibited if not otherwise explicitly
agreed with KONGSBERG in writing. Any authorised reproduction in whole or in part, must include this
legend.

© 2020 KONGSBERG - All rights reserved.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 2 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Table of contents

1 Introduction ............................................................................................................................................ 5
1.1 Overview ............................................................................................................................................... 5
1.2 Definitions ............................................................................................................................................. 5
1.3 System requirements ............................................................................................................................. 5

2 License modes ......................................................................................................................................... 7

2.1 Local license file..................................................................................................................................... 7
2.2 License server ........................................................................................................................................ 7

3 Database installation ............................................................................................................................... 8

3.1 Select destination location .................................................................................................................... 9
3.2 Select the port number ........................................................................................................................ 10
3.3 Review installation configuration........................................................................................................ 10
3.4 Completing MariaDB setup ................................................................................................................. 11

4 LedaFlow® Engineering installation ....................................................................................................... 12

4.1 Running the installation software ....................................................................................................... 12
4.2 End User License Agreement ............................................................................................................... 12
4.3 Third-party license agreement ............................................................................................................ 12
4.4 Select destination location .................................................................................................................. 13
4.5 Select components .............................................................................................................................. 14
4.6 Multiflash™ third party licenses .......................................................................................................... 15
4.7 Select start menu folder ...................................................................................................................... 15
4.8 Review installation configuration........................................................................................................ 16
4.9 Complete installation .......................................................................................................................... 16
4.10 LedaFlow® license configuration ......................................................................................................... 17
4.11 Silent installation ................................................................................................................................. 18

5 Verification of LedaFlow® Engineering installation ................................................................................ 19

5.1 Start LedaFlow® Engineering .............................................................................................................. 19
5.2 Check the connection to the database ................................................................................................ 19
5.3 Create/run a case in LedaFlow® Engineering ...................................................................................... 20

6 Database how-to ................................................................................................................................... 22

6.1 How to backup and restore the database ........................................................................................... 22
6.2 How to implement database user permissions ................................................................................... 23
6.3 How to move the database storage to another drive ......................................................................... 25

7 Upgrading LedaFlow® from an older version ......................................................................................... 27

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 3 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

7.1 From an older to a newer version ....................................................................................................... 27

7.2 Using the database of previous versions ............................................................................................. 27

8 Uninstallation ........................................................................................................................................ 28
8.1 Uninstall LedaFlow® Engineering ........................................................................................................ 28
8.2 Uninstall MariaDB ............................................................................................................................... 28

9 Troubleshooting .................................................................................................................................... 29
9.1 Administrative rights ........................................................................................................................... 29
9.2 MariaDB service not running............................................................................................................... 29
9.3 Out of range value exception when importing a case ......................................................................... 31
9.4 Invalid license ...................................................................................................................................... 32
9.5 No connection to license server ........................................................................................................... 32

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 4 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

1 Introduction
This document provides a step-by-step guide to installing LedaFlow® Engineering and is also a useful
resource if you encounter any problems during installation.

1.1 Overview
The following steps must be performed to complete the installation of LedaFlow® Engineering:

1. Verify that your system meets the system requirements listed in section 1.3;
2. Request the license required by LedaFlow® Engineering. This procedure is described in section
2;
3. Install the database as described in section 3;
4. Run the LedaFlow® Engineering installer as described in section 4.
This installation guide gives details on how to perform each step. It also provides guidance for how to
uninstall LedaFlow® Engineering and troubleshoot common problems.

1.2 Definitions
LedaFlow®

The core application that performs the physical simulations is called LedaFlow®. It is never used
directly, but rather through the LedaFlow® Engineering application.

LedaFlow® Engineering

LedaFlow® Engineering is an application suite for performing 1D multiphase flow simulations. It is also
the name of the graphical user interface where you can build, configure, run and analyse your
LedaFlow® models.

MariaDB

LedaFlow® Engineering uses a MariaDB relational database management system (DBMS) to store
LedaFlow® models and simulation results.

Multiflash™

Multiflash™ (from KBC Advanced Technologies) provides a complete and reliable solution for the
evaluation of the phase behaviour of complex fluids across the whole equipment and plant design
process and during operations. It enables engineers with quantitative information and data to rapidly
assess options, make choices and prevent or forecast potential problems.

1.3 System requirements

The table below describes the absolute minimum requirements to run LedaFlow® as well as the
recommended setup.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 5 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Minimum Recommended
1 GHz dual core 2 GHz or higher, quad core or more Intel with
CPU
Intel or AMD hyper-threading

RAM 1 GB 8 GB or more

Disk1 10 GB available 50 GB or more available SSD

Screen resolution 1366x768 1920x1080

Windows Server 2008 R2 SP1

Windows 8/8.1
Windows 8
Operating system2 Windows Server 2012 R2
Windows 10
Windows Server 2016

Please note that actual disk size requirements depend entirely on the complexity of the models to be
simulated and the amount of output data these cases produce.

The number of recommended CPU cores is directly related to the number of concurrent simulations
that the target system will run. For cases containing a large number of cells (e.g. slug capturing) we
recommend using 4 cores per simulation, since in most cases this gives the best performance. For
smaller cases 2 cores will suffice. Note that using more than the recommended number of cores may
cause the simulation to run slower and not faster. Also make sure to not use all the cores on the
system; it is recommended to always keep at least 1 core free for Windows and other processes.

Kongsberg strongly recommends keeping the system up-to-date with Microsoft Windows Update.
This will ensure that you also get all improvements to Microsoft Windows that might affect the
experience with using LedaFlow® Engineering.

1 A Solid State Drive (SSD) will improve overall simulation performance and user experience.
2 Using a virtual machine (VM) can slowdown the computation time up to 10%.
© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 6 of 33
Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

2 License modes
LedaFlow® is a licensed software. It needs a valid license to run. It is recommended to obtain a license
from the LedaFlow® support (ledaflow@kdisupport24.com) before installing LedaFlow®. You can skip
this section if you have already received a license file or completed the setup of your license server3.

The LedaFlow® license can be configured in two ways: it can be a local license file or the network
address of a license server.

2.1 Local license file

In this license mode LedaFlow® applications run using a local license file. The license file can be node
free or node locked (see below). Refer to section Error! Reference source not found. to learn how to c
onfigure local license files using the LedaFlow® License Configuration tool.

2.1.1 Node free demo license

A demo license gives access to LedaFlow® Engineering for a limited period of time. This license type is
mainly used for on-site training courses. When granted a demo license, you will receive a license file
that is used by LedaFlow® Engineering to identify your licensing rights. It is not locked to any specific
machine.

2.1.2 Node-locked license

A node locked license restricts the use of LedaFlow® Engineering to one specific computer. The
LedaFlow® support needs the host information of this computer to prepare the license file. Please
follow the steps below to generate a host information file and request a license file from the
LedaFlow® support:

• Open a Windows command prompt by running cmd.exe;

• Run the following Windows command to create host file:
“ipconfig -all > hostinfo.txt”

• Send the “hostinfo.txt” to ledaflow@kdisupport24.com to get a valid license file for your
computer. In addition, you should inform as well if the license will be installed in a virtual
machine.

2.2 License server

The most flexible licensing mode is to use a license server. This allows your company to purchase
licenses based on the anticipated number of concurrent users, and the licenses are not restricted to
any particular user or computer. This configuration requires your company to run a license server
application on a host computer on your corporate network. Each computer where you need to run
LedaFlow® Engineering will then contact the license server to acquire a license to work. The license
server must therefore be available to all computers running LedaFlow® Engineering.

The “KDI License Server Installation Guide.pdf” comes with a separate KDI license server installation
package. Please follow the license server installation guide to install the license server.

3 This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 7 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

3 Database installation
This section can be skipped if the user already has MariaDB or MySQL installed from a previous
installation of LedaFlow®.

For first time installations, the MariaDB database needs to be installed. The installer can be found in
the LedaFlow installation package, along with the KDI License Server.

As a safeguard mechanism, the MariaDB installer first tries to identify if MariaDB is already installed.
If that is the case, you will be prompted with a warning dialog as shown in Figure 1.

Figure 1 MariaDB installation safeguard

Please note that the MariaDB installer does not check for MySQL installations. If you decide to install
MariaDB along with your existing MySQL, you should choose to run MariaDB on a different port (for
example 3309) than the one used by MySQL.

The start page of the MariaDB installer wizard is shown below.

Figure 2 MariaDB installer wizard

The user must agree with the license agreement before proceeding with the installation.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 8 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Figure 3 MariaDB license agreement

3.1 Select destination location

Figure 4 Destination location

By default, MariaDB will be installed in C:\Kongsberg\LedaFlowStorage\mariadb-[version]-winXX

In this page, however, you can change the destination folder if you want to install the MariaDB
database elsewhere.

Note: You should not install the database in “Program Files (x86)” because some users don’t have
writing permissions on that folder.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 9 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

3.2 Select the port number

The MariaDB database server uses a port to communicate. The user can choose the port number in
this step. It is recommended to use the default value (3308) unless it is already used, for example by
MySQL.

Figure 5 MariaDB server port selection

3.3 Review installation configuration

Figure 6 Component review

This page presents a summary of the MariaDB installation configuration. This is the last chance to
modify the configuration before the actual installation takes place. If everything looks fine, click Install
to continue.

MariaDB installer will install the MariaDB software to the destination folder. It will also create and
start LedaMariaDB v[version] service to run the MariaDB server for LedaFlow®.
© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 10 of 33
Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

3.4 Completing MariaDB setup

Figure 7 Finish MariaDB installation

The installation of MariaDB is now completed. Click Finish to exit the Setup.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 11 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

4 LedaFlow® Engineering installation

This section provides a complete walkthrough of running the LedaFlow® Engineering installer. The
installation requires that you have administrator privileges on the system. Please contact your system
administrator for assistance if you do not have this or are uncertain if you have it.

4.1 Running the installation software

Start the installation process by running the file named “Install LedaFlow Engineering v[version].exe”
supplied with your copy of LedaFlow® Engineering installation package. Click Next > on the welcome
screen to continue the installation.

4.2 End User License Agreement

The end user license agreement must be accepted in order to continue the installation procedure.

Figure 8 End user license agreement

The complete text can be found in the file EULA.rtf supplied with LedaFlow® Engineering. After
installation the file can also be found in the destination location.

4.3 Third-party license agreement

LedaFlow® uses several publicly available libraries. The license agreement must be accepted in order
to continue the installation procedure.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 12 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Figure 9 Third-party license agreement

4.4 Select destination location

By default, the installation will install LedaFlow® Engineering in %ProgramFiles%\Kongsberg, which
on most computers with English language 32-bit versions of Windows will be:

• C:\Program Files\Kongsberg
In 64-bit Windows versions it will be:

• C:\Program Files (x86)\Kongsberg

On this page, however, you can change the path if you want to install LedaFlow® Engineering (and
Multiflash™ if selected) elsewhere.

Figure 10 Destination location

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 13 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Remember: The hard disk that contains the destination location should have at least 2 GB of free space
for successfully installing the application and running simulations.

You may get the following dialog if the Kongsberg folder already exists:

4.5 Select components

LedaFlow® Engineering comes with components that the user should install. These components
include the sample cases that are available when the user creates a new case, the user-defined
functions (UDF) development toolkit, logger templates which are used to create default loggers when
importing cases in LedaFlow® Engineering and some examples of scripting.

Multiflash™ is also distributed along with LedaFlow®. The user can choose to install it or not.

Figure 11 Select components

Important note: If you already have Multiflash™ installed together with a Kongsberg product, do leave
this checkbox enabled. This is required to ensure that your system can keep track of the number of
LedaFlow® Engineering or K-Spice instances on your computer that installed Multiflash™.

→ See section Error! Reference source not found. Error! Reference source not found. for more in
formation on how to upgrade from older versions of LedaFlow® Engineering.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 14 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

4.6 Multiflash™ third party licenses

Multiflash™ uses several publicly available libraries. The license agreement must be accepted in order
to continue the installation procedure.

Figure 12 License agreement

4.7 Select start menu folder

By default, the LedaFlow® Engineering installation will create a shortcut to start LedaFlow®
Engineering in a folder named Kongsberg\LedaFlow Engineering v[version].

Figure 13 Start menu folder

Change the name here if you wish to have the shortcut placed elsewhere.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 15 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

4.8 Review installation configuration

This page presents a summary of the entire installation configuration. This is the last chance to modify
the configuration before the actual installation takes place.

Figure 14 Review installation

If everything looks fine, click Install to continue.

4.9 Complete installation

The installation is now completed. Click Finish to exit the Setup and to open the license configuration
window.

Figure 15 Complete installation

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 16 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

4.10 LedaFlow® license configuration

After the installation has completed you are given the option to configure the LedaFlow® license using
the LedaFlow® License Configuration tool as shown in Figure 16. If the license has already been
configured, the existing license configuration is displayed in the dialog.

Figure 16 LedaFlow® License Configuration

The tool provides the option to setup the configuration for LedaFlow® applications to use either a
license server or a local license file. Depending upon the type of license, please select the
corresponding option, and provide the information in the dialog.

In case of using a license server, you have to set the host name of the license server and the license
and web server ports. If the license server is installed in the same PC as LedaFlow®, then the host
name will be “localhost” as seen in the figure above. The license server port is defined in the license
file and the web server port is the one used in the license server installation.

If you have a backup license server, you should also check that option and set the host name and port
number.

The license roaming option will enable a user to checkout LedaFlow licenses from the license server
and use them offline. Those licenses won’t be available in the license server until they are returned.

The LedaFlow® installation program will also create a shortcut for the License Configuration Tool in
the start menu: Kongsberg → LedaFlow License Configuration v[version]. This shortcut can be used
any time to change the license configuration for LedaFlow®.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 17 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

4.11 Silent installation

LedaFlow can be installed in silent mode using the “/SILENT” or “/VERYSILENT” installation options
from the command prompt.

The “/SILENT” option will still show a dialog with the installation progress while the “/VERYSILENT”
option won’t show anything.

In order to use these options, the user has to agree with the terms in the EULA and the 3rd party
components licenses. This is done by using the option “/EULA=true”. Note that the silent installation
will not work without this option. The EULA and the 3rd party components licenses can be found next
to the LedaFlow installer.

Figure 17 Silent installation from the command prompt

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 18 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

5 Verification of LedaFlow® Engineering installation

Upon LedaFlow® Engineering installation, license configuration and database, you are ready to verify
the installation.

5.1 Start LedaFlow® Engineering

Start the graphical user interface with the shortcut named LedaFlow Engineering v[version] from your
Start menu.

If you have not configured your license yet, or if there is an error in the license configuration, you will
not be able to run LedaFlow® Engineering, and a message similar to the one shown in Figure 18 will
be displayed.

Figure 18 Failed License Check

Open the LedaFlow® License Configuration tool and check if the license is properly set up. If you are
using a local license file, make sure the license file is valid. If you are using a license server, click on
“Test connection” to check if the connection to the license server is working.

5.2 Check the connection to the database

Click on “Connection and DB management” in the Tools menu and go to the “Connection profiles”
page. If you have MariaDB installed, make sure you are using the “MariaDB” connection profile.

Figure 19 Default MariaDB connection profile

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 19 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

If you are not connected to any database, the problem might be that:

• The connection profile configuration is wrong; pay particular attention to the port number
and make sure it is the same that is used in the installation.
Or

• The database service is not running. In this case, open the Windows Services and start the
LedaMariaDB v[version] service.
Or

• You forgot to install MariaDB.

5.3 Create/run a case in LedaFlow® Engineering

The last phase of the verification procedure is to create, initialize and run a case. To do so, follow the
steps described below:

1. Click on the File menu and select the “New Case” option.
2. Select “Leda 1D – 3 phases” case type and give the case a name (e.g. default3ph).

Figure 20 Create case

3. Click OK.
4. Initialize and run the case by clicking in the “Initialize/Run” buttons (Figure 21 and Figure 22)
and wait for the simulation to be completed.

Figure 21 Main toolbar

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 20 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Figure 22 Initialize and run

Figure 23 Case status: Completed

LedaFlow® Engineering is now installed and verified.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 21 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

6 Database how-to
6.1 How to backup and restore the database
MariaDB series 10.4 (distributed with LedaFlow 2.6 onwards) comes with a backup and restore tool.

6.1.1 Backup
The installation folder of MariaDB 10.4 (C:\Kongsberg\LedaFlowStorage\mariadb-10.4.11-winx64)
contains a script that can be used to perform the backup of the entire DBMS (all databases). The
backup can be performed while LedaFlow is operating. A writing lock is placed on the database while
the backup is running, and any write operation will wait until the backup is done.

The backup script is called "backupDB.bat". By default, the script will store the backup in
"C:\Kongsberg\Backup". The location of the backup can be changed by calling the script with a
different location.

Figure 24 Example of the call using a command prompt with the default backup path

Figure 25 Example of the call using a command prompt with a different backup path

The script can be used to start a backup manually, either by calling it from the command prompt or
by just double-clicking on it.

The backup script only keeps three backups. When a new backup is performed, a folder with a
timestamp is created and the backup is stored inside. The oldest backup folder is deleted if there are
already three backups.

An idea on how to automate the backups is to set up a scheduled task on Windows to call the backup
script at the desired backup frequency.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 22 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

6.1.2 Restore
In addition to the backup script, there is a restore script. Contrary to the backup, the restore needs to
be done with LedaFlow® Engineering closed and the database disabled.

A restore can be done as follows:

1. Stop the “LedaMariaDB v10.4.11” Windows service.

2. Move the contents of the “data” folder in the MariaDB installation folder to some temporary
folder until you are sure that the restore was successful. The “data” folder must be empty
before proceeding with the restore of the data.
3. Using a command prompt, run the “restoreDB.bat” script providing the path to the backup
folder.

Figure 26 Example of restoring the backup from folder 20200129_143349

4. Once the script is done, start the “the “LedaMariaDB v10.4.11” Windows service.
5. Open LedaFlow® Engineering and verify that the restore was successful.
6. If the restore was successful, delete the previously created temporary folder

6.2 How to implement database user permissions

If MariaDB/MySQL is installed on a server to be used as a central database, you might want to create
individual database accounts for each LedaFlow user. In this case, the user permissions must be set to
make sure that each user only sees its own database (schema).

Note: Using LedaFlow with a central database will result in degraded performance.

6.2.1 Create individual database accounts in the MariaDB/MySQL central server (to be
done by the Database Administrator)
Log in to mysql shell using the Windows command prompt. The mysql executable is located in the
“bin” folder of the MariaDB/MySQL installation. You should use the root user.

Example of a root user with password "ROOTPASS" and MariaDB/MySQL running on port 3308:
mysql -u root -pROOTPASS -P 3308

Each LedaFlow user should have a username and password. A user can be created with the following
command in mysql: create user username identified by 'userpass';

Example:

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 23 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

create user hugo identified by 'mypassword123';

All privileges need to be given to the user on the default database and all databases prefixed by the
username. To do this, run the following two commands in mysql:

GRANT ALL PRIVILEGES on globalnphmemory.* TO 'username'@'%';

GRANT ALL PRIVILEGES on `username\_%`.* TO 'username'@'%';

Example:
GRANT ALL PRIVILEGES on globalnphmemory.* TO 'hugo'@'%';

GRANT ALL PRIVILEGES on `hugo\_%`.* TO 'hugo'@'%';

The user is now ready to be used by LedaFlow.

6.2.2 Connect the individual database accounts to the central database server (to be done
by the LedaFlow user in the LedaFlow user interface)
Open the LedaFlow graphical user interface.

Go to “Tools”, “Connection and DB management” and click on “Connection profiles”.

Click on New and fill out the following fields:

1. Give a name to the new connection profile. Example: DatabaseServer

2. Host should be the hostname of the central MariaDB/MySQL server

3. User should be the one created in MariaDB/MySQL. Example: hugo

4. Password should be the one created for the user. Example: mypassword123

5. Save

6. Select the connection profile that was just created (Example: DatabaseServer) from the list
in "Active connection".

The user is now connected to the central database server and only sees his own databases and the
default LedaFlow database (globalnph). The default database will be seen by every user and should
not be used. The user must be able to see it to ensure the proper functioning of LedaFlow.

The user must create his own database by going to the Databases tab and select "Add new".

In the list of databases, the user will only see the globalnph database and all databases prefixed by his
username.

6.2.3 Sharing of cases

It is not possible for users to see cases in other user’s databases but a user can use the full case export
functionality to create a .qz file that contains a full case (including results and plots) and give it to
another user. That user can then import it do his\her database.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 24 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

6.3 How to move the database storage to another drive

By default, the LedaFlow database (MariaDB) stores its data in the data folder where it was installed.

The user might want to move the storage location to another place in order to release some space in
the hard drive where the database has been installed.

Note: Before moving the database and in order to avoid any loss of data, it is necessary to stop the
database service.

The data storage folder can be moved to another location by following these steps:

1. Stop the “LedaMariaDB v[version]” Windows service.

This can be done by opening a command prompt with administrator rights (right-click on the
“Command Prompt” application to get the option):

Figure 27 Start command prompt as administrator

And then typing the following command: sc stop “LedaMariaDB v[version]”

Figure 28 Stop the database service

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 25 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

2. Move the data.

The data is stored in the folder “C:\Kongsberg\LedaFlowStorage\mariadb-[version]-
winXX\data”. You can move the entire “data” folder to another location.
In our example we move it to “E:\LedaFlow\data”.

3. Change the location of the data storage in the database.

Open the kogt.ini file that is located in “C:\Kongsberg\LedaFlowStorage\mariadb-[version]-
winXX” and add the highlighted line:

Figure 29 Snippet of the database configuration file

4. Start the “LedaMariaDB v[version]” Windows service.

Open a command prompt with administrator rights and type the following command:
sc start “LedaMariaDB v[version]”.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 26 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

7 Upgrading LedaFlow® from an older version

New version of LedaFlow® Engineering can be installed without un-installing older versions.

7.1 From an older to a newer version

Users who already have older LedaFlow® versions installed can continue to use both older and newer
versions without any explicit changes to their system.

Make sure to verify the database connection settings.

To use old cases in the new version of LedaFlow® Engineering, the cases must be upgraded first by
right-clicking the case in the Case Browser and then by selecting Update to version [new version].

Warning: Once a case has been upgraded to a newer version it cannot be downgraded again. It is
always a good idea to duplicate a case (right-click and select Duplicate) before upgrading it.

7.2 Using the database of previous versions

From LedaFlow® Engineering version 1.6 onwards, the application is distributed with the MariaDB
database server.

It is however possible to use the existing MySQL database server that was installed with previous
versions of LedaFlow® Engineering. For that, just create a new connection profile and set the port to
the one being used by the existing MySQL database server.

If you decide to use MariaDB later, you just need to install it and make sure to use a different port
than the one used by MySQL.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 27 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

8 Uninstallation
The uninstallation of LedaFlow® Engineering does not uninstall the database service. Since your
LedaFlow® models are stored in a database, it is therefore possible to uninstall
LedaFlow® Engineering, install a newer version, and still have access to the models created with the
previous version.

When the last remaining instance of K-Spice or LedaFlow® Engineering is uninstalled, Multiflash™ will
be uninstalled along with it. Until then, Multiflash™ will remain on your machine.

8.1 Uninstall LedaFlow® Engineering

To uninstall LedaFlow, right-click on the Start icon and select Apps and features (or Programs and
Features). Find the LedaFlow Engineering version to uninstall in the list of apps/programs. Click on
LedaFlow Engineering v[version], select Uninstall and answer Yes to the subsequent question.
LedaFlow® Engineering will be removed from your computer.

8.2 Uninstall MariaDB

Note: This option should be used with caution. This will remove all LedaFlow® cases stored in the
database.

To uninstall MariaDB, right-click on the Start icon and select Apps and features (or Programs and
Features). Find the MariaDB version to uninstall in the list of apps/programs. Click on MariaDB
[version], select Uninstall and answer Yes to the subsequent question. MariaDB will be removed
from your computer.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 28 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

9 Troubleshooting
This section gives guidance on how to resolve the most common issues encountered during the
installation of LedaFlow® Engineering. Should you have any issues that are not described or resolved
here, do not hesitate to contact the LedaFlow® Support on ledaflow@kdisupport24.com.

9.1 Administrative rights

If you should attempt to install LedaFlow® Engineering without administrator privileges, you will
receive the following error message: “You must be logged in as an administrator when installing this
program”. Please contact your local system administrator for help on installing
LedaFlow® Engineering.

9.2 MariaDB service not running

You may encounter the message displayed in Figure 30 when you try to create a new case if the
MariaDB database server is not running. The most common cause for this is that the network port
used by the database server is already in use by another application.

Figure 30 No connection to MariaDB server

Change the database port by following these steps:

1. Close LedaFlow® Engineering if the application is running.

2. Update the port number in the configuration file.
Using Notepad or the text editor of your choice, open the kogt.ini file, located in
C:\Kongsberg\LedaFlowStorage\mariadb-[version]-winXX.
Change the ports by entering a number between 4000 and 65000; save the file.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 29 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

3. Restart the LedaMariaDB v[version] service.

Click on the Start icon, type services, and the Services applet will show up among the search
results. Click on that to launch it.
In the list of installed services, locate LedaMariaDB v[version].

Right-click on LedaMariaDB v[version] and select Restart.

Figure 31 Restart the database service

4. Update the connection profiles

Start LedaFlow® Engineering.
Go to “Connection and DB management”. An error message pops-up; click OK to close it.

Figure 32 Unable to connect to MariaDB server

Click on “Connection profiles” and change “Port” to the new port.

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 30 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Figure 33 Database port in connection profile

Click Save and Close.

If the problem persists, you can try again this procedure a couple of times with different port numbers.
If it still does not work, the cause of this problem is probably something else, and you should contact
the LedaFlow support (ledaflow@kdisupport24.com).

9.3 Out of range value exception when importing a case

When using MariaDB 10.4 with LedaFlow Engineering version 2.5 or older, you might experience an
error while trying to import an input file (.qs) with an emulsion model defined. This will happen if the
“Viscosity factor” (average_viscmod) is not defined in the input file.

In this case you’ll get an exception that looks like this:

Figure 34 Exception when importing an input file

This error can be fixed by manually adding the “Viscosity factor” in the input file as follows:

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 31 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

Figure 35 Adding the viscosity factor to the input file

9.4 Invalid license

The error message as shown in Figure 36 will be displayed if your license for LedaFlow® Engineering
has not been configured correctly. Please review your license configuration or contact LedaFlow
support for additional help.

Figure 36 License check error

9.5 No connection to license server

If you encounter the error message shown in Figure 37, the cause is usually one of the following three:

1. A firewall installed on your computer or your company’s network is blocking the connection
to the license server.
Please contact your local system administrator for help on configuring the firewall to allow
connections to the license server.
2. There is an error in your license configuration.
Review the procedure described in the section License Configuration or contact LedaFlow
Support if the problem persists.
3. The license server is not running.
To check if the license server is running:
o Open a command prompt;
o Type "sc query KOGT_RLM";
o Check the "STATE"; it should be written "RUNNING".
Please contact your local system administrator to start the license server if it is not running.

Figure 37 No connection to license server

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 32 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.
KDI license server ‘Installation guide’ COMPANY SHARED

© 2020 KONGSBERG - All rights reserved. 26MAR2020 Page 33 of 33

Note: Printed copies of this document are for information only. Always check for the latest valid electronic version.