Maptek Floating License Server (FLS)

Quick Start Guide | Version 4.0

Introduction

This guide will assist the user in understanding the installation and operation of the Maptek Floating License Server (FLS).

The Maptek FLS hosts licenses for Maptek’s end-user software products (Vulcan, I-Site Studio, etc.) and provides shared access to available licenses over a local area network (LAN). Vendor Daemons are installed which control specific licensing and borrowing rights for Maptek software products. The server machine requires a dongle for each Vendor Daemon.

Maptek Vendor Daemons

At present there are two Vendor Daemons representing groupings of Maptek software products:

Vulcan Vendor Daemon uses MAPTEK.exe
Non-Vulcan Vendor Daemon uses MAPTEKLD.exe

Non-Vulcan products include I-Site Studio and variants, Eureka, Sentry, PerfectDig, etc.

Complete or Custom installation

Generally, a license server can accommodate one or more Flex-enabled Vendor Daemons. The full installation will install all components including the Maptek FlexNet License Administrator, all Vendor Daemons and utilities.

Alternatively, a partial (Custom) installation for just Vendor Daemon(s) can be carried out, then installed into a compatible FlexNet license server.

In summary, there are seven basic steps:

Plug in Server Dongle(s).
Install Maptek FLS onto Server Machine.
Email and receive License File(s) from Maptek.
Log into Maptek FLS License Manager.
Install License File(s) for Vendor Daemons.
Configure Firewall(s).
Install Client Floating License Files on networked computers.

The basic license server components and associated ports are shown below.

Ports

The complete system will utilise a HTTP(S) URL port, a License Manager port, plus one or more daemon ports. Please ensure that all port addresses are unique – do not share addresses between any ports.

The Maptek FLS admin web page (HTTP(S) URL port) can be accessed from a remote machine but with limited privileges. We recommend carrying out administration tasks using console login on the server machine.

Installation options (Complete or Custom)

The installer is supplied with all components for a Complete system – FlexNet License Administrator, Vendor Daemon(s) and utilities.

A Custom (partial) installation is possible for the purpose of installing only Vendor Daemon(s) into a previously installed, compatible FLS system.

Prerequisites

System Requirements

Microsoft Windows Server 2012, Windows 10, Windows® 8.x, Windows® 7
Intel or AMD quad core processor, or better
8 GB RAM or more
500 MB free disk space for installation
Network connection
USB ports for license dongle
Screen resolution: 1024 x 768 or larger

License Dongle

Maptek FLS requires a Dongle and corresponding driver installed on the server machine, for each Vendor Daemon.

The Non-Vulcan Vendor Daemon requires a Dongle with a Dongle number equal to 1900 or greater (i.e. Non-Vulcan Dongle number ≥ 1900).

License File(s)

Maptek FLS requires a valid licence file for each software product. Each Maptek software product will require its associated Vendor Daemon to help manage license use. For example, Vulcan and I-Site Studio are Maptek software products and each will require the installation of their respective Vendor Daemon. Vulcan licensing will be administered through the Vulcan Vendor Daemon (MAPTEK.exe) and I-Site Studio is administered through the Non-Vulcan Vendor Daemon (MAPTEKLD.exe).

If you don’t have the appropriate valid license file(s), please contact Maptek. Please refer to step 5 in Installing Maptek Floating License Server.

Maptek Floating License Server Installer

Maptek Floating License Server installer can be found in the installation media or can be downloaded from the Users Area.

Server Ports

Once installed, the Maptek FLS may have three or more ports assigned for network communications – HTTP(S) URL, License Manager Port and Vendor Daemon port(s). If ports are configured manually (not default settings), please ensure that each port address is unique and not shared. In particular, Vendor Daemon ports, should be unique for each Vendor Daemon.

Installation

Dongle Driver

If there is a working dongle with a driver this step can be skipped or the driver can be renewed with the driver included in the installation package.

Installing the dongle driver:

Unplug the dongle from the system and uninstall existing HASP driver, if there is any.
Locate the HASP driver installer in the installation media.
The file name is HaspUserSetup.exe.
Double click on it and follow the steps to install the driver.
You can also download the driver from the Users Area.Plug the dongle into a USB port. Windows will recognise the dongle.
Check Device Manager to confirm the dongle is installed and activated.
Device Manager can be accessed through Start > Run > DevMgmt.msc.

Removal of existing Maptek FLS software

Only one instance of the Maptek FLS can be running at a time. Uninstall any previous version. Restarting Windows after uninstall is strongly recommended. Other license servers may operate along side the Maptek FLS provided there are no PORT conflicts, etc.

Preparing the Server License File (Vulcan)

FOR VULCAN ONLY: The license file needs to be modified to suit the server machine.

Editing can be done with any text editor.

Edit the license file using a text editor.
Update SERVER value to the hostname or an IP address of the server machine.
Remove any PORT settings if they exit. Ports are managed by LMAdmin server.
Remove VENDOR MAPTEK line if it exists.

Maptek FLS supports both IPv4 and IPv6. The SERVER value must be an IPv6 address to be used in IPv6 network. Refer to Using IPv6 for details.

Main Installation Process for Maptek FLS

Maptek FLS consists of three parts: Maptek FlexNet LMAdmin server, one or more Vendor Daemon(s) and Licence Utilities. The following instructions are common to both Complete system installations and Custom (Vendor Daemon only) installations.

To install Vendor Daemon(s) only (to an existing FlexNet LMAdmin server), proceed to step 4, choose Custom, then move on to Install Vendor Daemon(s) Only.

Double click on Maptek Floating License Server 4.0.exe to start installation.
Click Next to begin the installation.
Please read the license agreement. If you agree select I accept the terms in the license agreement, and click Next.
a) Select Complete then Next to accept defaults and continue to step 5, or
b) Select Custom then move on to Install Vendor Daemon(s) Only to add Vendor Daemon(s) to an existing FlexNet LMAdmin server.
Select a license file using the Browse… button then click Next. If you don’t have a license file then use Request License button to get information which will be sent to Maptek to request a license file. You are able to continue the installation without a license file.
Choose an HTTP web port that will not conflict with existing web services on the server machine. The default is 8080. Record the value you select then click Next to continue.
Click Change… to change the installation folder. Click Next to continue.
Click Install to begin copying and installing files.
Note the login info shown in the INFO section. Click Finish to complete install.
When the process is completed, your default web browser will open to the administration page. If the site does not automatically open, start your web browser and navigate to http://localhost:8080, or the alternative port that you may have chosen earlier.

Custom Installation - Vendor Daemon(s) Only

The Vendor Daemon(s) can be used with other compatible LMAdmin FlexNet server instances. Below demonstrates how the Maptek FLS installer can be used to install both Vulcan and Non-Vulcan Vendor Daemons with their license files to an existing LMAdmin server.

Start the Maptek FLS installer and advance to the Setup Type page, then select the Custom option.
Exclude LMAdmin Server from installing (and exclude the appropriate Vendor Daemon if you don’t want to install both Vendor Daemons).
Click Next then Install to complete the installation.

You may choose to install the destination for Daemon and Utils to a specific folder where you keep all vendor daemons.

FOR VULCAN ONLY: Edit the license file by adding the full path details to MAPTEK.exe, to the VENDOR MAPTEK line as shown in the example below.
SERVER test-server HASPAUTH=8E82849772587E420000
VENDOR MAPTEK “C:\Program Files\Maptek\Floating License Server 4.0
\vendors\Maptek\Vulcan\daemon\MAPTEK.exe”
Open LMAdmin web page.
Log in to Administration.
Navigate to the Vendor Daemon Configuration tab.
Click Import License.
Click Choose File to select the license file. Check Overwrite License File on License Server.
Click Import License.
The Vendor Daemon(s) should be added and status is UP. If status is not UP, wait a minute and refresh the page to check the latest status.
Once the Vendor Daemon(s) is/are running, you can go to the Dashboard and view licenses from each Vendor Daemon. For example, you can select MAPTEK from the combo box and view all Vulcan licenses.

Administration

User Name = admin

Password = admin

Change your password when prompted.

Changing Ports

The TCP ports used by Maptek FLS are automatically assigned when using the default settings. However, they can be customised. The common case involves accessing the Maptek FLS through firewalls.

Manual Configuration - LMAdmin Server Port

By default, the LMAdmin port is assigned a value between 27000 and 27009. To change this setting:

Navigate to Administration > Server Configuration.

Specify a value in Use this Port field under License Server Configuration.

Click Save.

Restart the server using Windows Services management console (Start -> Run -> services.msc).

Manual Configuration - Vendor Daemon Port

By default, the Vendor Daemons (MAPTEK.exe, MAPTEKLD.exe) use a randomly-assigned TCP port. To change this to a static port:

Navigate to Administration > Vendor Daemon Configuration.

Click Administer on the target daemon.

Specify a value in Use this Port field under Vendor Daemon Port.

Click Save.

Stop and Start the daemon.

Firewall Exceptions

Both the lmadmin.exe and the Vendor Daemon applications (MAPTEKLD.exe,

MAPTEK.exe) must be added to the firewall exception list so that users can check out licenses.

Appendices

Using IPv6

FOR VULCAN ONLY: The license file needs to have an IPv6 address to work with an IPv6 network. Once this license is activated, the software can use the IPv6 address to access the license server.

Edit the license file and change the hostname to IPv6 format.

Import the license using this modified license file.

In Vulcan, use @IPv6Address to access the license server.

Both IPv6 and IPv4 addresses can be used in the license file but only one format can be used at a time, and the same format must be used from the Maptek software application to connect to the license server.

IP Versions compatibility

Maptek FLS Machine

IPv4 only

Dual IPv4 / IPv6 Stack

IPv6 only

Maptek Software Product Machine

IPV4 only

Use IPv4

addresses only

Use IPv4

addresses only

Not supported

Dual stack, uses IPV4 address only

Use IPv4, IPv6, or both addresses

Dual stack, uses both IPV4 and IPV6 addresses

Use IPv6 addresses only

Dual stack, uses IPv6 address only

Not supported

Use IPv6 addresses only

IPv6 only

Client Floating License Files for end user computers (Non-Vulcan)

Generating the Client Floating License File

FOR NON-VULCAN ONLY: When the license administrator receives the Vendor Daemon license file(s) by email, a Client Floating License File “license.mlf” is usually included, which is used by the Maptek software products on an end user’s computer/laptop to find the license server on the connected network. If this file is not available, or the server name or port differs from what is specified in the provided “license.mlf” file, you can generate one manually using the following procedure.

Open a text editor, for example Notepad and create a file that contains the following:

</HostDefinition>

</LicenseSource>

Where ADDRESS is the name or IP address of the computer running the license server. Save as plain text with the extension.mlf.

If you want to run the license server on a specific License Server Manager Port, the port can be set using the FLEXnet License Administrator. The License Server Manager Port (PORT) must then be specified in the license file in the form:

</HostDefinition>

</LicenseSource>

Installing Client Floating License Files

FOR NON-VULCAN ONLY: The Client Floating License File (*.mlf) should be distributed to all end user laptops/computers that will run the Maptek software products. Recent software releases allow you to both set up and install a license using an automated process.

Installing a Client Floating License File

Dragging the license file onto the Maptek License Tool will install the license. The Maptek License Tool can be accessed when the Maptek software application is first installed or subsequently when opened. If there is already a license for Maptek software, then this license can be updated to include the new license server by selecting the Help menu and then the Update license submenu.

Alternatively, click the plus sign at the right of the panel. The Add license source panel will open. Select From a license file. Enter the license file name or navigate to it and select it.

Automated license setup

With newer software releases, you can try both creating and installing the license file on each end user computer/laptop by simply entering the License Server name or IP address. The software will automatically write the license file without requiring user intervention.

Click the plus sign at the right of the panel. The Add license source panel will open.

Select Specify a server with an optional port number. Enter License Server address (“ADDRESS” = server name or IP address) directly into the Server input field. If required (e.g. non-default setup), the License Server Manager Port can be entered into the Port field.