Deltares License Management Installation Manual

2023-06-30

CONTENTS

1 Introduction ............................................................................................................................................ 2

2 Installation of the license management software .................................................................................... 3

2.1 Stand-alone ............................................................................................................................................. 3

2.1.1 Hydrotechnical software ........................................................................................................................................................ 3
2.1.2 Geotechnical software ........................................................................................................................................................... 3

2.2 Server-Client ........................................................................................................................................... 4

2.2.1 Server installation .................................................................................................................................................................. 4
2.2.2 Client installation ................................................................................................................................................................. 16
2.2.3 Changing the port number of the license server manager ................................................................................................... 16

3 Updating license files ............................................................................................................................ 18

3.1 Updating Stand-alone and client license files ....................................................................................... 18

3.2 Updating Server license files ................................................................................................................. 18

4 Updating the license server daemon ..................................................................................................... 19

5 Updating the lmadmin license server manager ..................................................................................... 20

6 License borrowing ................................................................................................................................. 20

APPENDIX A Multiple license server managers or multiple daemons ........................................................ 22

APPENDIX B Importing old Deltares network license files in lmadmin ...................................................... 24

APPENDIX C Migrating old license server environments to lmadmin ........................................................ 26

Migrating existing ‘lmgrd’ license servers to lmadmin ................................................................................ 26

Migrating existing ‘lmgrd’ client machines .................................................................................................. 27

APPENDIX D Frequently Asked Questions ................................................................................................. 29

Server-Client FAQ ......................................................................................................................................... 30

Stand-alone license FAQ .............................................................................................................................. 41

Page 1
Deltares License Management Installation Manual
2023-06-30

1 INTRODUCTION

Please do not insert your USB-dongle (if you have received one) until you have installed your software and
license manager. Inserting the dongle before the installation can cause an automatic driver installation by
Windows. The driver installed in this way might not be compatible with your dongle.

Many Deltares software packages require a license file. This manual describes the installation of the software
needed to install, use and manage this license file.

There are two types of license files:

Stand-alone:
With a stand-alone license file, the simulation software can be used even while offline.

License files can be locked on hardware. This hardware locking can be done on the ethernet card of a pc, or on
a USB-dongle. The difference is that with dongle-locked license the dongle and license file can be transferred to
any computer with a USB port, while an ethernet card is bound to a specific computer.

Server:
A network (server-client) license file allows users to connect to a license server to obtain their license. One of
the computers in your network must be set up as license server. The Deltares simulation software is then
installed on other computers in the network (the clients). These client computers will request licenses from
your license server.

Server licenses always contain the word SERVER when viewed with a text editor.

• The latest Deltares-validated license server manager, daemon and stand-alone license installers can
be downloaded from our Deltares License Management website.
o System administrators are encouraged to check this page for updates to the license server
manager and daemon.
• The latest cutting-edge version of the lmadmin license server manager can also be downloaded
directly from Revenera

This documentation is intended for use with at least the following versions of license software: DS_Flex
7.00.00, Common Files 18.3, lmadmin 11.17.1.0 64-bit and dhsdelft.exe 11.17.1.0 64-bit. Most information in
this manual is also applicable to older versions, but details may vary.

Page 2
Deltares License Management Installation Manual
2023-06-30

2 INSTALLATION OF THE LICENSE MANAGEMENT SOFTWARE

2.1 STAND-ALONE

2.1.1 HYDROTECHNICAL SOFTWARE

➢ Remove any USB-dongles from your computer (if any) before starting the installation. Dongles can be
inserted after the installation.
➢ Download and install the DS_Flex license manager from our Deltares License Management website
➢ Install the license file when prompted.

Note: It is recommended to remove any outdated license files from the DS_Flex directory. (By default:
C:\Program Files (x86)\DS_Flex)

2.1.1.1 SILENT INSTALLATION OF THE DS_FLEX LICENSE MANAGER

Detailed below are the various command-line options for installing the DS_Flex. These options are intended for
advanced users; most of the input validations performed by the user interface version of the DS_Flex installer
are not performed when using a command line installation.

Basic options:
/S TRUE or /H TRUE Run silent/unattended
/F d:\DirName\License.lic License file name with full path. Optional.

Advanced options:
/A Install License File Only ("Add License").
/NODRIVER Skip installing Sentinel HASP dongle driver. Not recommended.

2.1.2 GEOTECHNICAL SOFTWARE

➢ Remove any USB-dongles from your computer (if any) before starting the installation. Dongles can be
inserted after the installation.
➢ Download and install the Common Files from our Deltares License Management website
➢ If prompted, choose to automatically uninstall old DS_Flex versions.
➢ Select 'Start' - 'Deltares' - 'Deltares License Manager' - 'Add License File' to browse to and select your
license file.

For computers that will use both Deltares Hydrotechnical software and Deltares Geotechnical software, it is
sufficient to only install the Common Files.

It’s possible to perform a silent installation by starting the installation from a command prompt with the
command msiexec /q /i <Name_installer>.msi. For example. For example: DSettlement-21.2.1.34213.msi /s

2.1.2.1 SILENT INSTALLATION OF COMMON FILES

Page 3
Deltares License Management Installation Manual
2023-06-30

To install the Common Files as silent, use this command from the command line:

msiexec /q /i <Name_installer>.msi

For example: msiexec /q /i Common-Files-21.1.1.32430.msi

To silently uninstall, use:

msiexec /q /x <Name_installer>.msi

To debug issues with the installer, use this command to enable logging for more information:

msiexec /l*vx install.log /I <Name_installer>.msi

2.2 SERVER-CLIENT

2.2.1 SERVER INSTALLATION

Network license files are managed by the lmadmin license server manager. This chapter explains how to install
and configure the lmadmin license server manager on your license server.

It is only necessary to follow this chapter if you have explicitly requested a server license. If you did not request
a server license, you have received a stand-alone license and can follow chapter 2.1 instead to set up your
stand-alone installation.

➢ Download and run the lmadmin installer lmadmin-x64_n6-11_17_1_0.exe (or newer)

Page 4
Deltares License Management Installation Manual
2023-06-30

The introduction screen provides general information about the installer.

➢ Press Next to continue

➢ Choose where to install the FlexNet Publisher license server. The default folder is recommended

Page 5
Deltares License Management Installation Manual
2023-06-30

➢ Choose where to install the license files and log files. The default folder is recommended

Please note: The ProgramData folder is ‘hidden’ by default in Windows

➢ Click on Next to continue

Page 6
Deltares License Management Installation Manual
2023-06-30

Note: The installer offers to import previous installations, but using this option is not recommended. If you
are upgrading from an older version of lmadmin, it is recommended to back up your license files, uninstall
the old version, and install the updated version. For more details on updating an existing lmadmin
installation, see: Updating the lmadmin license server manager

The Pre-Installation Summary provides a summary of the choices made in the installer so far.

➢ Click on Install to continue

Page 7
Deltares License Management Installation Manual
2023-06-30

The installation progress screen will now be shown.

➢ Choose to install the Visual C++ 2013 Redistributable package and click on Next

Please let the Microsoft Visual C++ installer guide you through its installation.

Page 8
Deltares License Management Installation Manual
2023-06-30

When the Microsoft Visual C++ installer is finished, or if it was already installed, the Launch Configuration
screen is shown.

Here an open port number for the license server can be selected. The default port range is correct.
Administrators responsible for managing multiple lmadmin license servers for multiple vendors might want to
manually set this port to a specific value rather than the default range.

➢ Click on Next to continue

Page 9
Deltares License Management Installation Manual
2023-06-30

➢ Click on Next to continue

On the Service Configuration screen, the license service can be given a name (by default: lmadmin64).
The license server can be given a delay in starting, which can be useful for license servers making use of a USB-
dongle. This gives the dongle drivers enough time to be loaded before the service is started.

➢ Enable ‘Run as a service’ and Press Next to continue

Note: It is recommended to check if the service name is not already listed in the Windows ‘Services’ menu,
because the installer will not overwrite existing services. If the service name already exists, you are likely
combining multiple instances of lmadmin on one server. For more information on combining multiple instances
of lmadmin, please see Multiple license server managers on the same server

Page 10
Deltares License Management Installation Manual
2023-06-30

➢ Click on Done to complete the installation

Now we will install the Deltares license daemon: ‘dhsdelft’.

➢ Download the dhsdelft.exe from our Deltares License Management website and copy it to the
directory C:\Program Files\FlexNet Publisher 64-bit License Server Manager

We will start the lmadmin license service. This can be done in various ways, including rebooting the license
server machine since the lmadmin license service is set to start on boot.

➢ Start an administrator command prompt (right-click ‘cmd.exe’ and choose ‘Run as Administrator’) and
type the command: net start lmadmin64

➢ Now, please open a browser window and browse to http://localhost:8090 to open the lmadmin web
interface (titled ‘FlexNet License Administrator’)

The window in the screenshot below should appear.

Note: If instead of the lmadmin web interface, your browser shows a ‘Page not found’ or ‘This webpage is not
available’ error message, the lmadmin service has not been started yet. Start the service and reload the page to
access the lmadmin web interface.

Page 11
Deltares License Management Installation Manual
2023-06-30

This is the web interface of the lmadmin license server manager after a server has been fully configured. This
page can be opened in a browser by visiting:

http://localhost:8090

Note: The license server service (which we named ‘lmadmin64’ during the installation) must be running in order
to open the web interface. If the license server service is not running, opening the web interface will result in a
generic browser error.

Note: If you choose a different HTTP port for the ‘License Server Management Interface’ during the installation
procedure, the license server manager can be opened by replacing the default port number 8090 by the port
you choose during the installation. It is highly recommended to document your custom port number, should you
choose to use a custom port.

Upon opening, the lmadmin web interface will show the Dashboard. Here, the button Concurrent will show an
overview of any Deltares license features installed on the server. If you are following this guide to set up a new
lmadmin license server, no features will be listed yet.

In the following steps, we will use the lmadmin web interface to set up the Deltares license daemon
(‘dhsdelft’), add a license file to this daemon, and start the daemon.

➢ Click on Administration to continue

The lmadmin web interface will prompt you for a username and password:

Page 12
Deltares License Management Installation Manual
2023-06-30

The default username and password for the License Administrator is admin. After logging in for the first time,
you will be required to change the password to a longer password, for example: admin123. Please remember
or store this password.

➢ After signing in, click on the button Vendor Daemon Configuration

Page 13
Deltares License Management Installation Manual
2023-06-30

This is the Vendor Daemon Configuration tab. The various vendor daemons you might set up on your server
will be shown here, including the dhsdelft daemon.

➢ Click on the button Import License to add a license file

➢ Click on Browse to navigate to and select your license file

➢ (Recommended) Enable Overwrite License File on License Server

➢ Click on Import License to import the selected license file. It will be copied to (by default)
C:\ProgramData\FLEXlm\lmadmin\licenses\dhsdelft

➢ Click on OK to continue and return to the Vendor Daemon Configuration tab

The dhsdelft daemon should now be listed.

After following the instructions in this manual and using the default settings, the daemon will be configured
and running, concluding the installation of the lmadmin License Server Manager.

Page 14
Deltares License Management Installation Manual
2023-06-30

It is recommended to check the configuration of the daemon:

➢ Click on the button Administer

Here, the vendor daemon administration screen for the dhsdelft daemon is shown. Important options are:

❖ License File or Directory: This shows the location of your license files. Importing multiple license files
will cause multiple lines to be shown here.

❖ Vendor Daemon Location: This is the location of the vendor daemon executable, in our case dhsdelft.
When this path is empty, the daemon should be located in the root of the lmadmin installation
directory. By default, this is C:\Program Files\FlexNet Publisher 64-bit License Server Manager

❖ Vendor Daemon Port: Here you can select a default port (random open port each time the daemon
starts) or a static port. A static port is generally less secure and requires you to ensure the port is
open. Setting a static port will allow the creation of a firewall exception for the license manager in
your internal firewall.

❖ Vendor Daemon Log: This log file will provide information and error messages relating to the vendor
daemon (here: dhsdelft). In case of problems, check the contents of this file. The file is by default
located in C:\ProgramData\FLEXlm\lmadmin\logs.

If the daemon was not configured automatically, please find instructions on how to manually configure the
daemon in the Frequently Asked Questions chapter Error message when importing license file.

In case the license is locked on a dongle, you also need to install the dongle drivers. This is done by:

Page 15
Deltares License Management Installation Manual
2023-06-30

➢ Downloading and installing the DS_Flex license manager from our Deltares License Management
website. When prompted, skip the installation of the license file.

For information about configuring your firewall, see also this FAQ item: Do I need to configure my firewall to
allow license-related traffic?

2.2.2 CLIENT INSTALLATION

The client part of a server-client installation is the same as that for a stand-alone installation.

➢ See chapter 2.1.1 for Hydrosoftware instructions, and see chapter 2.1.2 for Geosoftware instructions

Note: Easy deployment of ‘reference’ license files on your client machines is possible: First install a license file on
one of the clients per the above instructions. Then, copy that license file to the DS_Flex installation directory on
all the clients. By default, client license files are located in C:\Program Files (x86)\DS_Flex.

If you have chosen to not use the default port range (TCP 27000-27009) for the ‘License Server Manager Port’
on the license server, please see chapter 2.2.3 for instructions on how to modify your client license file to work
with your chosen port.

2.2.3 CHANGING THE PORT NUMBER OF THE LICENSE SERVER MANAGER

This chapter is only relevant if you have chosen to not use the default port range (TCP 27000-27009) for the
‘License Server Manager Port’ on the license server.

By default, client license files do not contain a port number, which causes the software to automatically
connect to the license server with the port range 27000-27009. To enable your clients to connect to a license
manager running on a different port, follow these steps:

➢ Open the license file on your client with any text editor.
o By default, license files are located in C:\Program Files (x86)\DS_Flex
➢ On the SERVER line, add the port number you wish to use by typing: TCP:portnumber
➢ Save the license file to immediately make use of the added port number.

Page 16
Deltares License Management Installation Manual
2023-06-30

These steps are only needed for the license file on your clients. The license file installed on your server does
not need to be modified.

Page 17
Deltares License Management Installation Manual
2023-06-30

3 UPDATING LICENSE FILES

This chapter describes how to install a new or updated license file when the license manager is already
configured.

3.1 UPDATING STAND-ALONE AND CLIENT LICENSE FILES

➢ Select 'Start' - 'Deltares License Manager' - 'Add License File' to browse to and select your license file.

Updating a client license file is only needed when the license server or hardware lock on the license server
changes.

Note: It is recommended to remove any outdated license files from the DS_Flex directory. (C:\Program Files
(x86)\DS_Flex by default)

Note: Easy deployment of ‘reference’ license files on your client machines is possible: First install a license file on
one of the clients per the above instructions. Then, copy that license file to the DS_Flex installation directory on
all the clients. By default, client license files are located in C:\Program Files (x86)\DS_Flex.

3.2 UPDATING SERVER LICENSE FILES

This section explains how to import new license files into the lmadmin license server manager when the
lmadmin license manager and dhsdelft daemon are already configured.

Server license files can be recognized by the label ‘S’ in the file name. For example
‘101234_S_005056826500.lic’. Server licenses are only sent to organizations that requested a server license
instead of a stand-alone license when purchasing the software.

Import your license file into the lmadmin web interface using the ‘Vendor Daemon Configuration’ tab:

➢ Click on Browse to navigate to and select your license file

➢ (Recommended) Enable Overwrite License File on License Server

➢ Click on Import License to import the selected license file.

The file is now located in the license directory, by default C:\ProgramData\FLEXlm\lmadmin\licenses\dhsdelft.

We recommend removing any expired or otherwise outdated license files (if any) from this directory, as well as
from the Vendor Daemon Configuration screen.

Note: If the license server refuses to accept the license file with an ‘Invalid license key’ error, please see the
Frequently Asked Questions below for the item: Error message in dhsdelft.log: ‘Invalid license key (inconsistent
authentication code)’

Page 18
Deltares License Management Installation Manual
2023-06-30

Now follow one of these three methods to enable the new license file on your license server:

➢ 1.: Using the lmadmin web interface, on the vendor daemon configuration tab of the dhsdelft
daemon, click the button ‘Reread License Files’.

Note: Rereading license files in this way will not start your server or the dhsdelft daemon if it was not already
running. When in doubt, stopping and starting the license daemon or server as described will ensure the license
daemon and server are started, at the possible cost of temporarily interrupted license distribution.

➢ 2.: Using the lmadmin web interface, on the vendor daemon configuration tab of the dhsdelft
daemon, click the button ‘Stop’. Then, start the dhsdelft daemon again.

Note: Restarting the dhsdelft daemon this way will temporarily prevent your server from distributing licenses
for the Deltares dhsdelft daemon.

➢ 3.: Use the (Windows) services menu to stop and start the service. (Open Start, type: services.msc and
restart the lmadmin64 service)

Note: Restarting the license service in this way will temporarily prevent your server from distributing licenses for
all software configured to use the lmadmin license server manager.

The license file on your client machines will not need to be updated when updating or adding a license file on
your license server. With the rare exception of when the reference to the server is no longer valid:

• When your server name changes; or

• When your server’s hardware lock HostID changes (for example if a different mac-address or a
different dongle ID is used).

4 UPDATING THE LICENSE SERVER DAEMON

Occasionally Deltares releases a new license server daemon (dhsdelft.exe). It is recommended to use the latest
daemon released by Deltares. If the license server daemon in use on a license server is too old, client
applications may not run and instead show this error when trying to obtain a license from the license server:
“Version of vendor daemon is too old”.

To install a new license server daemon:

➢ Download the latest license server daemon from our Deltares License Management website.
➢ Stop the Deltares dhsdelft daemon on your license server using the license server manager web
interface.
o Until the daemon is restarted, your users will be unable to obtain licenses from the license
server.

Page 19
Deltares License Management Installation Manual
2023-06-30

➢ Replace the original daemon (dhsdelft.exe) with the newly downloaded daemon. By default, the
daemon is located in C:\Program Files\FlexNet Publisher 64-bit License Server Manager
➢ Start the Deltares dhsdelft daemon using the license server manager web interface.

The new daemon will now be in use. No modifications are necessary on your client computers.

Note: The dhsdelft daemon used on your server should have a version number <= the lmadmin license server
manager. Instructions on how to update the license server manager can be found in Updating the lmadmin
license server manager

5 UPDATING THE LMADMIN LICENSE SERVER MANAGER

It is recommended to periodically update the lmadmin license server manager on your license server.
Additionally, updating lmadmin ensures compatibility with the latest dhsdelft daemon version offered by
Deltares. Deltares offers the latest version of lmadmin that has been validated for use with Deltares software
on the Deltares License Management website.

To update the lmadmin license server manager to a new version, uninstall the current version of the license
server manager:

➢ Back up the license files that are installed on the license server as these will be removed during the
process;
o See location of the license files: Where are the license files stored on the license server?
➢ Write down any custom settings that were made to your license server;
o Most notably: which port numbers are configured for use;
➢ Download the latest lmadmin license server manager from our Deltares License Management
website.
o Also download the latest version of the dependencies listed on the website such as the latest
dhsdelft daemon, Java version, etc.;
➢ Uninstall the ‘FlexNet Publisher 64-bit License Server Manager’ using the Windows Control Panel –
‘Programs and Features’
➢ Restart your License Server machine;
➢ Install the latest version of the license manager on the server. For instructions, see chapter 2.2.1.

Client computers will not need to be updated when updating the lmadmin license server version.

6 LICENSE BORROWING

Page 20
Deltares License Management Installation Manual
2023-06-30

License borrowing is a feature that allows a user to temporarily add licenses from a license server to a
workstation for offline use. During this period, the borrowed license is removed from the license server and
can only be used on the workstation. After the borrow period expires, the license automatically becomes
available on the license server again.

Users can optionally choose to return borrowed licenses to the license server before the end of the period by
using the “Return borrow” function from their workstation. A network connection to the license server is
required in order to request to borrow a license or to use the “Return borrow” function.

• The maximum period for which licenses can be borrowed is 10 days.

• Borrowing is automatically enabled on your license server for Geotechnical software.

Note: Borrowing is only available for Geotechnical software, version 16.1 or above.
To borrow a license from a license server, navigate to ‘Tools’ – ‘Program Options…’ – ‘Modules’. Click on
‘Borrow’ and choose the borrow period.

Page 21
Deltares License Management Installation Manual
2023-06-30

APPENDIX A MULTIPLE LICENSE SERVER MANAGERS OR MULTIPLE DAEMONS

The lmadmin license server manager is also used with software products that are not developed by Deltares. It
is possible to combine the license server for those products with the Deltares license software. Providing a
step-by-step guide for such an installation is not possible as each vendor can make use of custom
implementations, defaults and versions for the lmadmin license server manager.

1. Multiple license server managers on the same server

Administrators can also choose to separate each instance of the lmadmin license server manager. This can be
done by ensuring each instance of lmadmin runs in its own service (this can be chosen during the lmadmin
installation, the default service name is ‘lmadmin64’), using separate installation directories, and choosing
different ports for each lmadmin service, daemon and web interface.

When using multiple license server managers on the same server, ensure each license server manager is using
its own port number. Overlapping ports, for example in the default port range of 27000 – 27009, can cause
performance to decline. For more information on configuring the license server manager ports, see chapter:
Do I need to configure my firewall to allow license-related traffic?

Note: Installing lmadmin will not overwrite previously installed Windows services if these services already exist.
This can result in the following conflict: Imagine having previously set up an instance of lmadmin that makes
use of a custom port for accessing the web interface with the service name ‘lmadmin64’. (This is the case for
the ‘Scia Engineer’ lmadmin, which uses port 8080)
Later, lmadmin is installed again on the same server (for example, to set up a license server for the Deltares
‘dhsdelft’ daemon). The default service name ‘lmadmin64’ is used here too, but a different port is chosen during
the installation (for example, the default port 8090). Because the original ‘lmadmin64’ service running under
port 8080 is not overwritten, the new lmadmin installation running on port 8090 is not actually started or
accessible by web interface.

A workaround for this scenario is to choose a different service name for each lmadmin service, as detailed
above. It is also possible to use a separate license server for the SCIA software.

The ‘License Administration Guide’ by Flexera provides more information on combining license software from
multiple vendors.

2. Adding Deltares software to an existing lmadmin license server manager instance

Note: Although it is often possible to add Deltares software to your existing license server, we recommend
configuring your license server using the default settings described in this manual. We can support default
installations more efficiently than custom installations.

In general, the Deltares ‘dhsdelft’ daemon can be added to your existing lmadmin server by:

➢ Downloading the dhsdelft.exe from our Deltares License Management website and copying it to the
directory C:\Program Files\FlexNet Publisher 64-bit License Server Manager

Page 22
Deltares License Management Installation Manual
2023-06-30

➢ Importing the Deltares license file using the lmadmin interface as you are accustomed with.

The Deltares daemon has been verified to function correctly with lmadmin 64-bit version 11.17.1.0, up to the
latest version we make available. Older versions of lmadmin will likely function correctly as well, but users may
run into issues. For example: older versions of lmadmin would show an error message ‘Reserved characters are
not allowed’ when setting a daemon path that contains brackets, such as in the folder ‘Program Files’.

Page 23
Deltares License Management Installation Manual
2023-06-30

APPENDIX B IMPORTING OLD DELTARES NETWORK LICENSE FILES IN LMADMIN

This chapter explains how to import old license files (from early 2015 and before) into the lmadmin license
server manager. This can be useful if you still need your lmadmin license server to distribute licenses for
previous versions of Deltares software. Please note that not all old license files are compatible with lmadmin.

License files fulfilling the following criteria are compatible with lmadmin:

• File extension is *.lic;

• When viewing the file with a text editor, the keywords ‘dhsdelft’ and ‘server’ are present in the file.

Before importing such an old license file, you must manually make it fully compatible with lmadmin. Importing
such a file without manual changes will show error messages similar to:

Invalid syntax in license file, licenses\DHSDELFT_DAEMON\my-license-file.lic, on line 2, at or near:

TCP:8500.

Missing executable for DHSDELFT_DAEMON vendor: C:\Program Files (x86)\FlexNet Publisher License
Server Manager\DHSDELFT_DAEMON.

To prevent these error messages:

➢ Open the license file with a text editor

It will look something like this:

We will now edit the license file using the text editor (modify where applicable):

➢ On the SERVER line (the line starting with the word SERVER)

o Replace SERVER_NAME with the name or IP-address of your server

o Remove the text TCP:8500

➢ On the VENDOR DAEMON line (the line starting with the word VENDOR or DAEMON)

o Remove the text DHSDELFT_DAEMON

o If present, remove the text PORT=8510

Page 24
Deltares License Management Installation Manual
2023-06-30

The new license file should look something like this:

SERVER mylicenseserver123 000000000000

VENDOR dhsdelft
(…)

The exact contents differ based on the name of your server and on which hardware your license file is locked.
The two underlined keywords (the server name and server HostID) will be different for each license server.

➢ Save the file and go back to the lmadmin interface. Import the license file as normal, and as described
in this manual.

Setting up your client machines to make use of old license files using lmadmin:

➢ Please copy the license file that you manually edited to a location that can be accessed by the client
machine(s). This file will be needed while installing the license manager on the client machine(s).
This file is also always located on the license server after installing: See the directory (default)
C:\ProgramData\FLEXlm\lmadmin\licenses\dhsdelft

Install the license manager and license file on your clients as normal and as described in chapter 2.

Note: If the license server refuses to accept the old license file with an “Invalid license key” error, please see the
Frequently Asked Questions below for the item: Error message in dhsdelft.log: Invalid license key (inconsistent
authentication code)

Page 25
Deltares License Management Installation Manual
2023-06-30

APPENDIX C MIGRATING OLD LICENSE SERVER ENVIRONMENTS TO LMADMIN

MIGRATING EXISTING ‘LMGRD’ LICENSE SERVERS TO LMADMIN

When installing lmadmin on a computer that has an existing ‘lmgrd’ license server manager installed, it is
highly recommended by our security vendor Flexera to completely disable the old lmgrd license server
manager. This will prevent potential conflicts that can occur otherwise. For example, lmgrd and lmadmin might
attempt to use the same ports, resulting in error messages detailed in the Frequently Asked Questions.

The steps to migrate ‘lmgrd’ to lmadmin are therefore:

➢ Disable the ‘lmgrd’ license server manager by uninstalling any previous versions of the license
software using the Windows Control Panel:

o ‘FLEXlm License Manager’;

o ‘FlexLm License Tools‘;

o ‘Delft Hydraulics Software License Manager’;

o ‘Deltares License Manager‘.

➢ Then reboot the computer, and install the lmadmin license server manager as detailed in chapter
2.2.2.

➢ In case the license server uses a USB-dongle: Install the DS_Flex license manager available on our
Deltares License Management website

For more specific uninstallation details, for example in case of a license server running non-Deltares license
software in addition to Deltares license software, read on:

Please note that the following configurations of the lmgrd license server might be present on a license server:

1. One instance of the lmgrd, running one daemon

2. One instance of the lmgrd, running multiple daemons

3. Multiple instances of the lmgrd, running multiple daemons

Although it is recommended to completely uninstall the ‘lmgrd’ license server manager when installing
‘lmadmin’ on the same server, this may not be possible for all license servers:

• If non-Deltares software is also configured with lmgrd on the server you are migrating; and

• If it is not possible to migrate the non-Deltares software to lmadmin.

Page 26
Deltares License Management Installation Manual
2023-06-30

In the above scenario, if you wish to install the lmgrd and lmadmin license server managers on one license
server, the steps below describe how to disable the Deltares license management. What exactly to disable
depends on which of the above configurations is used, and whether or not the lmgrd license server manager
on your server was configured to run non-Deltares software as well as Deltares software.

➢ In case 1, completely uninstall the license software using the Windows Control Panel (‘FLEXlm License
Manager’, ‘FlexLm License Tools‘ and ‘Deltares License Manager‘) and reboot the computer.

➢ In case 2, if the license server is configured to only use Deltares software, see case 1.
If the lmgrd license server manager on the server is configured for non-Deltares software as well as
for Deltares software, disable the ‘dhsdelft’ and ‘delftlmd’ daemons within your current license server
manager:

o Start LMTools and on the ‘Config Services tab’, remove the services using the ‘dhsdelft’ or
‘delftlmd’ daemon; and/or

o (Only for the ‘delftlmd’ daemon used for Deltares Geotechnical software): Go the Start menu,
open ‘FLEXlm License Manager’ and remove services using the ‘delftlmd’ daemon.

➢ In case 3, disable all Deltares daemons and/or lmgrd instances as per the steps described for case 1
and 2, taking care that non-Deltares software remains configured where required.

MIGRATING EXISTING ‘LMGRD’ CLIENT MACHINES

C.1.1.1 UPGRADING SERVER REFERENCES ON CLIENTS

After setting up a new lmadmin license server, existing license files on your clients must be updated in order to
complete the migration from lmgrd to lmadmin. This applies even when the server name does not change after
the migration, because the port numbers used by lmadmin are different than those used by lmgrd.

For information on how to install (client) license files, please see chapter 2.2.2.

C.1.1.2 DELTARES GEOTECHNICAL SOFTWARE ONLY: THE SERVICETOOL ON CLIENTS

Page 27
Deltares License Management Installation Manual
2023-06-30

The ServiceTool allows users to view information about their license server and license use from any client. The
ServiceTool is automatically installed as part of the
Deltares Common Files installation.

Users can start the ServiceTool by opening Start –

Deltares Common Files

Page 28
Deltares License Management Installation Manual
2023-06-30

APPENDIX D FREQUENTLY ASKED QUESTIONS

Java errors during lmadmin installation......................................................................................................................................... 30
How do I start the lmadmin web interface? .................................................................................................................................. 30
Error message: No socket connection to license server manager ................................................................................................. 30
After installing the license server manager, no Windows service was created ............................................................................. 31
I have lost the password to my lmadmin interface. ....................................................................................................................... 31
Where are the license files stored on the license server? ............................................................................................................. 31
Where are the license files stored on client or stand-alone machines? ........................................................................................ 32
Is my license file a stand-alone or a server license? ...................................................................................................................... 32
Which log files contain error and warning messages? ................................................................................................................... 32
Is it possible to add Deltares software to my existing non-Deltares lmadmin license server?....................................................... 32
Error message when starting software on client: “Version of vendor daemon is too old” ............................................................ 32
Error message when starting software on client: “FlexNet error message: Cannot connect to license server system” ................ 33
Error message in dhsdelft.log: ‘Invalid license key (inconsistent authentication code)’ ................................................................ 33
Error message in dhsdelft.log: ‘Not a valid license server system host. Exiting’ ............................................................................ 33
Error message in server log: ‘(dhsdelft) exited with status 32. (Exited because another server was running)’ ............................. 34
dhsdelft daemon refuses to start: ‘Exiting due to signal 32 Exit reason 9’ .................................................................................... 34
Error message in dhsdelft.log when starting license daemon: ‘Can’t get hostid of type 15’ ......................................................... 34
Error message when importing license file: Unable to start vendor: dhsdelft ............................................................................... 35
Error message when uninstalling lmadmin: Error: opening registry key ‘Software\Javasoft\Java Runtime Environment’. .......... 35
License checks are performed very slowly ..................................................................................................................................... 35
The license server and clients were configured correctly, but license errors started occurring .................................................... 36
Do I need to configure my firewall to allow license-related traffic? .............................................................................................. 36
My license server doesn’t work ..................................................................................................................................................... 37
Licenses are not returned to the server after use .......................................................................................................................... 37
Geosoftware: ‘Return borrow’ does not work ............................................................................................................................... 38
Geosoftware: Cannot borrow licenses due to ‘Borrowing failed’ error ......................................................................................... 39
I am using a dongle with a license server. Can I switch license servers?........................................................................................ 39
Can I use the DS_Flex license manager to set up my license server?............................................................................................. 39
Lmadmin service does not start ..................................................................................................................................................... 39
ServiceTool takes very long to start (~60 seconds) ........................................................................................................................ 40
Where are the license files stored on client or stand-alone machines? ........................................................................................ 41
Is my license file a stand-alone or a server license? ...................................................................................................................... 41
Error message when starting software: ‘The hostid of this system does not match the hostid specified in the license file’ ......... 41
Error message when uninstalling DS_Flex / Deltares License Manager ......................................................................................... 42
Error message when uninstalling Common Files: Could not open INSTALL.LOG file ...................................................................... 43
Error message: ‘The installed version of the Software License Manager is too old to be replaced automatically by the Deltares
License Manager’ ........................................................................................................................................................................... 43
What does my USB-dongle look like? ............................................................................................................................................ 44

Page 29
Deltares License Management Installation Manual
2023-06-30

SERVER-CLIENT FAQ

Java errors during lmadmin installation

Error messages may include:

• Could not find a valid Java virtual machine to load. You may need to reinstall a supported Java virtual
machine.
• This Application has Unexpectedly Quit
• iawin32.dll not found

To solve such errors, install the latest 64-bit Java version from https://www.java.com/nl/download/manual.jsp.
Choose version: Windows Offline (64-bit)

Note: Java is used only for the installation process and can optionally be removed from your license server
after the installation is complete.

How do I start the lmadmin web interface?

The web interface of the lmadmin license server manager can be started by opening a browser window and
navigate to the server. The syntax is http://[servername]:[portnumber]. Assuming a default installation, start
the web interface on the server using: http://localhost:8090.

If you are unsure on which port your license server is running, you can check this by opening a command-
prompt, navigating to the lmadmin installation directory on your server (default C:\Program Files\FlexNet
Publisher 64-bit License Server Manager), and typing the command ‘lmadmin -foreground’ (without quotes).

Note: It is only possible to start the lmadmin web interface when the lmadmin service is running. Use the
(Windows) services menu to stop and start the service. (On Windows Vista and newer, open Start, type:
services.msc and start the ‘lmadmin64’ service)

If the service is not running, an error message will appear when trying to start the web interface: Unable to
open http://localhost:8090/. Cannot locate the Internet server or proxy server.

Error message: No socket connection to license server manager

To resolve the error, update to the latest versions of lmadmin and dhsdelft.

Page 30
Deltares License Management Installation Manual
2023-06-30

To set up a new license server: Installation of the license management software

To update dhsdelft and lmadmin: Updating the license server daemon and Updating the lmadmin license
server manager.

Background information: This error can be caused by a mismatch in the versions of the lmadmin license server
manager, the dhsdelft daemon and the calculation software.

In full detail: Lmadmin should be newer than dhsdelft, which should be newer than the licensing used in the
calculation software.

After installing the license server manager, no Windows service was created

If a Windows service ‘lmadmin64’ was not created even if the option “Run as a Service” was enabled during the
license server manager installation, the correct Visual C++ Redistributable might not have been installed.

To solve this: please reinstall the lmadmin license server manager. When prompted, choose to install the
Microsoft Visual C++ 2013 Redistributable. The service should be present when the installation is complete.

I have lost the password to my lmadmin interface.

Removing lmadmin through the Windows Control Panel and reinstalling it will restore the password to this
default, as well as any other custom settings.

Alternatively, the file server.xml in C:\ProgramData\FLEXlm\lmadmin\conf contains the password as well. This
password is normally encrypted, so you will not be able to determine the old password. However, it is possible
to replace this encrypted password with a new plaintext password of your choosing (minimum 8 characters).

• In the server.xml file, search for “password” for the “Administrator” account
• Replace everything in quotes with your new password, including (ENC-01)
• Save the document, and restart the lmadmin64 service

Please note that storing the password as plaintext makes the login procedure to the lmadmin web interface
less secure. After successfully logging in again, consider changing the password through the interface or noting
your lmadmin configuration and reinstalling the software to re-encrypt your password.

Where are the license files stored on the license server?

After importing a license file into the lmadmin web interface, the files are copied (by default)
C:\ProgramData\FLEXlm\lmadmin\licenses\dhsdelft.

If you are still using an older version of lmadmin, the default location for license files was C:\Program Files
(x86)\FlexNet Publisher License Server Manager\licenses.

Page 31
Deltares License Management Installation Manual
2023-06-30

Where are the license files stored on client or stand-alone machines?

The license files on the client are stored in and used from the DS_Flex installation directory, by default
C:\Program Files (x86)\DS_Flex.

Is my license file a stand-alone or a server license?

If you have not requested a server license, your license file will be stand-alone. To check the license file type:

• Open your license file with a text editor;

• If the license file contains the word SERVER, it is a server license. If not, it is a stand-alone license

Which log files contain error and warning messages?

These two log files contain important information about the status of the license manager:

• The log file for our vendor daemon dhsdelft:

By default, C:\ProgramData\FLEXlm\lmadmin\logs\dhsdelft.log

This log file can be also be reached from within the lmadmin web interface by navigating to ‘Vendor Daemon
Configuration’ – ‘Administer’ dhsdelft daemon – ‘Vendor Daemon Log’.

• The log file for the license server itself:

By default, C:\ProgramData\FLEXlm\lmadmin\logs\lmadmin.log

This log file can be also be reached from within the lmadmin web interface by navigating to ‘Server
Configuration’ – ‘Logging’.

Is it possible to add Deltares software to my existing non-Deltares lmadmin license

server?

Yes, although the exact method of combining software on the license server depends on how the license
server is configured. For more information, see Appendix A.

Error message when starting software on client: “ Version of vendor daemon is too
old”

The license server daemon is too old and must be updated.

For instructions, see chapter: Updating the license server daemon.

Page 32
Deltares License Management Installation Manual
2023-06-30

Error message when starting software on client: “FlexNet error message: Cannot
connect to license server system”

The license server can be connected to (i.e. ping succeeds), but the lmadmin license server manager is not
running or cannot be reached from the client. This can happen if:

• The license server ports are blocked by a firewall;

• DNS resolution of the server name fails.

For more information, see chapters Do I need to configure my firewall to allow license-related traffic? and My
license server doesn’t work.

In rare cases, license traffic might be blocked due to hostname resolution priority issues when using IPv6, for
example with DirectAccess. In such cases, try adding this environment variable to your clients:
FNP_IP_PRIORITY, with a value of 6. This will give priority to IPv6 resolution. See the Flexnet Publisher License
Administration Guide for more details.

The full error will be similar to:

Cannot connect to license server system.

The license server manager (lmgrd) has not been started yet, the wrong port@host or license file is being used,
or the port or hostname in the license file has been changed.

Error message in dhsdelft.log: ‘Invalid license key (inconsistent authentication code) ’

Your license file may be outdated and incompatible with the latest license daemons and dlls.

Please ensure that the license file being used is the unmodified file as sent by Deltares. If the file is unmodified
and the error still occurs: Please send the license file to Deltares as the license file requires an update. The
license file will then be modified to no longer give the “inconsistent authentication code”.

This error may also occur if you have modified the license file. Modifications to any part of the file except for
the server name will invalidate the file.

Error message in dhsdelft.log: ‘Not a valid license server system host. Exiting ’

This error message indicates that the server name in your license file does not match the name of your server.
If you see the word “SERVER_NAME” in your license file, replace it with the name of your server with any text
editor.
To prevent this error from occurring in the future, please send the name of your license server to
[email protected], and keep us up-to-date of any changes you make.

Page 33
Deltares License Management Installation Manual
2023-06-30

Error message in server log: ‘(dhsdelft) exited with status 32. (Exited because another
server was running)’

Or:

dhsdelft daemon refuses to start: ‘Exiting due to signal 32 Exit reason 9’

An old lmgrd license manager process for the dhsdelft daemon is probably still running. In order to allow the
lmadmin license manager to run, no lmgrd processes using the dhsdelft daemon may be running.

The solution is to migrate all dhsdelft software to the new lmadmin license manager. Software using the
dhsdelft daemon includes (but is not limited to) recent versions of CHESS, Delft3D, D-HYDRO, Geosoftware,
RIBASIM, SOBEK and Wanda.

As a workaround, stopping the ‘DS_Flex’ service or ‘lmgrd’ processes will also allow lmadmin to start the
dhsdelft daemon again. Please note that this will stop all license distribution for the DS_Flex service or lmgrd
process, including distribution for other vendors or daemons, until the service and/or process have been
started again.

This error message can also occur when the port(s) for the lmadmin license manager are in use by other
processes not related to license management.
Error message when attempting to stop the dhsdelft daemon

When attempting to stop the dhsdelft daemon, an error message stating ‘Unable to stop server’ may appear.
This error message will occur after logging into the lmadmin web interface from a different computer than the
license server. Logging into the lmadmin web interface on the license server will allow the dhsdelft daemon to
be stopped.

Error message in dhsdelft.log when starting license daemon: ‘Can’t get hostid of type
15’

This error message indicates that the dongle drivers are not installed. In order to install the dongle drivers:

➢ Remove the dongle from the computer;

➢ (Re-)install either the DS_Flex or the Common Files;

➢ Finally, insert the dongle again.

Page 34
Deltares License Management Installation Manual
2023-06-30

Error message when importing license file: Unable to start vendor: dhsdelft

When importing a license file, the following error appears:

Unable to start vendor: dhsdelft.

Missing executable for dhsdelft vendor: C:\Program Files\FlexNet Publisher 64-bit License Server
Manager\dhsdelft.

This error message appears when a Deltares license file is imported before the Deltares ‘dhsdelft’ daemon has
been installed. This can be solved by following these steps:

➢ Click on the button Administer

On the vendor daemon administration screen that has now opened, we will configure the dhsdelft daemon:

➢ Set the Vendor Daemon Location the location where you have installed the dhsdelft.exe, by default:
C:\Program Files\FlexNet Publisher 64-bit License Server Manager\dhsdelft.exe

➢ Click on Save

A message stating: ‘Successfully updated the vendor daemon configuration.’ should appear at the top of the
web interface.

➢ Click on Start to start the vendor daemon

You will be brought back to the Vendor Daemon Configuration screen. The status of the dhsdelft daemon
should now be shown as ‘Starting Up’ or ‘Up’.

Error message when uninstalling lmadmin: Error: opening registry key

‘Software\Javasoft\Java Runtime Environment’.

This error message appears when your installed Java version does not match your lmadmin installer.

• To (un-)install a 32-bit version of lmadmin, install a 32-bit version of Java.

• To (un-)install a 64-bit version of lmadmin, install a 64-bit version of Java.

License checks are performed very slowly

This can have different causes. Possible causes and advice include:

• Ensure your (virtual) license server has enough resources to handle license traffic, including firewall

Page 35
Deltares License Management Installation Manual
2023-06-30

• Set a static port instead of a port range for the lmadmin license server manager as described in
Updating the license server daemon. Especially when using multiple lmadmin instances on the same
server. See also: Appendix_A
• If you have set the optional environment variable FLEXLM_TIMEOUT, try reducing the value shown
(the value is in milliseconds)
o The value for FLEXLM_TIMEOUT is the amount of time the license mechanism will wait until
denying a license or until checking another server or lmadmin instance. Note: Setting this
value too low may cause your client to terminate a license request too early to connect to
license servers in high latency environments, such as when using a VPN.

The license server and clients were configured correctly, but license errors started
occurring

Please try stopping and starting the lmadmin64 license service. This may fix certain issues that can occur with
the license service that are not shown in the log files. Such issues may occur due to power outages, for
example.

Do I need to configure my firewall to allow license -related traffic?

Yes, if you have a firewall configured between license server and client machines, the firewall will need to be
configured.

If your firewall is blocking license traffic, the client software will not be able to contact the license server and
will show an error. In this scenario, the license server manager logs will not contain any error message or
checkin / checkout entries as the firewall blocks traffic before it reaches the license server manager.

The lmadmin license server manager makes use of 3 ports:

• The port for the license server manager itself.

By default, the port used is a random port in the range 27000-27009. This port can be configured in the menu
‘Server Configuration’.

• The port number for the Deltares ‘dhsdelft’ daemon.

By default, the port used is a random port in the dynamic port range of the operating system. On Windows, the
ports in this range are 49152-65535. This port can be configured in the menu ‘Vendor Daemon Configuration’.

• Optional: The port number for the lmadmin web interface

By default, the web interface uses port 8090. It is not necessary for client machines to be able to access this
port. This port can be configured in the menu ‘Server Configuration’.

Page 36
Deltares License Management Installation Manual
2023-06-30

Although administrators can choose to set static ports, it is recommended to use the default port ranges and
instead add the lmadmin application and dhsdelft daemon to the whitelist of the firewall on your license
server.

When choosing to use a static port for the license server manager, you will need to update the reference on
your client machines as described in chapter: 2.2.3

My license server doesn’t work

• Check that the license manager is installed as described in this manual.

• Check if the lmadmin service has been started on your server. Open Start, type: services.msc. The
default name is ‘lmadmin64’.
• Are there any error messages given when starting the software on your client computer, or in the log
files on your license server?
o For the location of the log files, see: Which log files contain error and warning messages?
o If the error messages do not help solve the issue, please check if they are detailed in this
document.
• Try to ping your license server from a client pc with the server name you provided Deltares;
o If this step fails, please check your network configuration. Does pinging the IP address of the
server work? If not, please try to replace the server name with its IP address in your license
files.
o If pinging does work, please check the log files of the license server and review the other
entries in the FAQ section of the manual. The problem might be caused by a firewall
configuration issue.
• Install the latest version of the lmadmin license server manager and dhsdelft daemon offered on
Deltares License Management website.
o When updating the dhsdelft daemon, ensure that the lmadmin license server version is equal
to or greater than the version of the daemon. Update the lmadmin license server version if
needed. See chapter: Updating the lmadmin license server manager.

If your firewall is not blocking license traffic, and if you have an active support subscription, please contact
Deltares for assistance. Please send to us the results of the above steps, including the error message shown on
the client and any error message shown by the license server manager and the installed license files of your
server and client.

Typical generic errors for the license server not working include (but are not limited to)

• Vendor daemon is down

• License server machine down

Licenses are not returned to the server after use

Page 37
Deltares License Management Installation Manual
2023-06-30

Under certain conditions licenses are displayed as “in use” when a license is no longer in use. This prevents
users from accessing software if all licenses are in use (error message: ‘Licensed number of users already
reached’).

This behaviour can occur if the application was closed when the client machine did not have a connection to
the license server. This causes the application to fail returning the license file. The license server at this point is
oblivious to the fact the application has been closed as it did not receive a ‘checkin’ request.

The license will be returned to the server over time, though this can take up to an hour. To force the license to
be returned:

➢ On your license server, restart the vendor daemon from the vendor daemon configuration menu
under the Administrator panel.

Please note that this will temporarily cause the vendor daemon to be down, which may impact your users.
After the vendor daemon has been restarted, the count of all available licenses currently in use should read
“0”.

Geosoftware: ‘Return borrow’ does not work

In order to be able to return borrowed licenses from your client pc to the license server, the following is
necessary:

• A license server running the lmadmin license server manager version 11.12.1.4 or higher;

• A network connection to the license server;

• A license server running the vendor daemon dhsdelft.exe of version 11.12.0.3 (August 2015) or higher

o You can check the version number of dhsdelft.exe by right-clicking the file, selecting
‘properties’ and opening the ‘details’ tab.

Lmadmin and the dhsdelft vendor daemon can be found on our Deltares License Management website.

Borrowed licenses will be returned to the license server automatically after their expiry date and time have
been reached, even if there is no connection between the license server and a client.

Sometimes, borrowed licenses cannot be returned even if the above conditions are fulfilled. This can happen if
something has changed on the client pc since the license was borrowed. For example, due to hardware
changes, or due to a change in the user name. If this occurs, and it is not possible to return the client to its
original state, resolve the issue by:

1. Removing borrow keys from your problem client’s registry as follows:

1.1. If possible: Return any borrowed licenses on the problem client by starting the Geotechnical software
– Tools – Program Options… - license.

Page 38
Deltares License Management Installation Manual
2023-06-30

Note: If it is not possible to return the borrowed license, the next step might lock your borrowed
license for the remaining duration of its borrow period.
1.2. Navigate to the problem client’s registry ‘HKEY_CURRENT_USER\Software\FLEXlm License
Manager\Borrow’ and removing all but the ‘(Default)’ keys.
1.3. Try ‘return borrow’ again
2. Wait until the expiry date of the borrowed license (depending on what the user selected and, for a
maximum of 10 days).

Note: Borrowing functionality is only available for Geosoftware, version 16.1 or above.

Geosoftware: Cannot borrow licenses due to ‘Borrowing failed’ error

• Remove borrow keys from your problem client’s registry as follows:

o If possible: Return any borrowed licenses on the problem client by starting the Geotechnical
software – Tools – Program Options… - license.
Note: If it is not possible to return the borrowed license, the next step might lock your
borrowed license for the remaining duration of its borrow period.
o Navigate to the problem client’s registry ‘HKEY_CURRENT_USER\Software\FLEXlm License
Manager\Borrow’ and removing all but the ‘(Default)’ keys.
o Try borrowing again
• Wait until the expiry date of the borrowed license (depending on what the user selected and, for a
maximum of 10 days).

I am using a dongle with a license server. Can I switch license servers?

Yes, this is possible. You can do this by plugging in the dongle in the new server, and following the instructions
for the initial installation of a license server. One additional step applies: open your server license file and
change the name of your license server to its new name. Please contact us after such a change to ensure your
future license files are correct.

Finally, update the license file on your clients with the new file, as described in chapter 3.2.

Can I use the DS_Flex license manager to set up my license server?

The DS_Flex installer must be installed on client and stand-alone computers, as well as on any server, client
computer or stand-alone computer making use of an USB-dongle. The DS_Flex license manager is not used to
set up the license server manager. This is done by the lmadmin installer.

Lmadmin service does not start

Page 39
Deltares License Management Installation Manual
2023-06-30

If the service does not start with a generic Windows error, this is usually due to a permission issue. A possible
solution is as follows:

Open the Windows Services menu (Open Start – type: services and press Enter)

• Scroll to the ‘lmadmin64’ service. Right-click it, and open ‘Properties’

• Open the tab ‘Log On’. Try setting the service to run as a Local System account per the screenshot:

ServiceTool takes very long to start (~60 seconds)

This can happen for this combination of installed license files in the DS_Flex directory:

1. A server license file referring to a server that does not have the license server manager active.
• See also Error message in dhsdelft.log: ‘Not a valid license server system host. Exiting’
2. A stand-alone license file.

To solve this, remove the server license file or follow the link above for tips on how to fix the connectivity.

See also: Where are the license files stored on client or stand-alone machines?

Page 40
Deltares License Management Installation Manual
2023-06-30

New lmadmin installation does not accept passwords

When installing lmadmin, as part of the first-time setup, administrators must log in with

• Username: admin
• Password: admin

After logging in the for first time, the administrator is required to change the password.

On some systems, we have seen that during either the initial login, or during the password change request, the
password “admin” is not accepted.

One possible cause is a lack of permissions for the lmadmin64 service. To fix this:

• Open Services
• Open the Properties of the lmadmin64 service
• On the Log On tab, select to log on as “Local System account”
o Alternatively, choose a service account with sufficient permissions and a password that does
not expire

STAND-ALONE LICENSE FAQ

Where are the license files stored on client or stand -alone machines?

See: Where are the license files stored on client or stand-alone machines?

Is my license file a stand-alone or a server license?

If you have not requested a server license, your license file will be stand-alone. To check the license file type:

• Open your license file with a text editor;

• If the license file contains the word SERVER, it is a server license. If not, it is a stand-alone license

Error message when starting software: ‘The hostid of this system does not match the
hostid specified in the license file ’

This error message can have various causes. Please check the following:

Page 41
Deltares License Management Installation Manual
2023-06-30

• Please remove any license files from the directory C:\Program Files (x86)\DS_Flex that you are not
currently using and try to start the software again. The error message may change.
• Check if the correct dongle is inserted in the system. The dongle number is printed on the dongle, and
it can be read on the “System Settings” tab in the LMTools program (Start – Programs – Deltares –
Deltares License Manager)
• Please remove the USB-dongle from your pc. Then, download and install the latest DS_Flex license
manager from our Deltares License Management website and restart your pc.
• Check with your IT department if antivirus software is interfering with the use of the dongle or dongle
drivers

If the error persists and you have a service package in place, please contact Deltares for assistance. Other steps
that may be tried by Deltares:

• Using the FlexNet uninstallation to fully remove the dongle drivers: remove the dongle and use
haspdinst.exe -kp -fr -purge from the DS_Flex directory until http://localhost:1947 shows the driver
was removed
• Obtaining newer dongle drivers, for example for use with a new Windows version or update
• Replacing the dongle with a new one in case of damage.
• Replacing very old, unsupported USB dongles with a new one in contact with Deltares. Very old
dongles can fail to be properly recognized by some modern software releases.
o Old unsupported dongle type. Transparent green, long shape with opening for keychain:

o Modern, supported dongle type. Short transparent green:

o Modern, supported dongle type. Short opaque green:

In case of doubt, Deltares can confirm if your dongle is of an unsupported type.

Error message when uninstalling DS_Flex / Deltares License Manager

When uninstalling the DS_Flex license manager using the “Add or remove programs” menu or “Unwise.exe”,
users may receive the following error despite having sufficient permissions to uninstall:

Page 42
Deltares License Management Installation Manual
2023-06-30

An administrator has blocked you from running this app. For more information, contact the administrator
(UNWISE32.EXE)

To uninstall the license manager, follow these steps:

• Open Start
• Type and open: Control Panel
• Click on ‘Programs’
• Click on ‘Programs and Features’
• Remove ‘Deltares License Manager’ from the menu that opens

Error message when uninstalling Common Files: Could not open INSTA LL.LOG file

The following error message may appear when uninstalling old .exe Common Files versions that were not yet
distributed as .msi format:

Could not open INSTALL.LOG file

Or
Invalid INSTALL.LOG file

When installing a newer Common Files version in this state, the installation may hang indefinitely.

To solve this:

• Click on Start and type: regedit

• Open the Registy Editor that appears, and navigate to:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion
\Uninstall\
• Remove the folder Deltares Systems Common Files

The Deltares Common Files should now no longer be present in the Windows Control Panel, and new versions
can be installed again.

Error message: ‘The installed version of the Software License Manager is too old to be
replaced automatically by the Deltares License Manager’

The old license manager needs to be uninstalled manually. This can be done the following way:

• Open Start
• Type and open: Add or remove programs
• In the ‘Add or remove programs’ menu, click on ‘Programs and Features’
• Remove the Deltares License Manager from the menu that opens

If the same error message appears after you manually uninstalled the old license manager check the following:

Page 43
Deltares License Management Installation Manual
2023-06-30

• Remove directory: C:\Program Files (x86)\DS_Flex

• Remove from Registry: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\WL | Delft
Hydraulics\DS_Flex

Error message: ‘Cannot find license file.’

• Check if your license file is correctly installed in the license directory on your pc
• Check if the license file name contains the @ character. If so, remove the @ character from the license
file name to prevent problems with your license file.
• If the above does not help, reinstall the license manager

What does my USB-dongle look like?

For customers that were provided with a dongle, your USB-dongle will look like the one below:

Or this slightly older model:

Dongles that are not/no longer supported by Deltares License Management software:

For support, contact:

E-mail: [email protected], telephone: +31 88 335 81 00

For sales, contact:

Page 44
Deltares License Management Installation Manual
2023-06-30

E-mail: [email protected] telephone: +31 88 335 81 88

Page 45