Copyright © 2019 Dassault Systèmes GEOVIA Inc.

All rights reserved. Dassault Systèmes GEOVIA Inc. publishes this documentation for the sole use of
GEOVIA product licensees.
Without written permission, you may not sell, reproduce, store in a retrieval system, or transmit
any part of this documentation. For such permission, or to obtain extra copies please contact your
local GEOVIA office, or visit www.3ds.com/GEOVIA.
This software and documentation is proprietary to Dassault Systèmes GEOVIA Inc. and, except
where expressly provided otherwise, does not form part of any contract. Changes may be made in
products or services at any time without notice.
While every precaution has been taken in the preparation of this manual, neither the authors nor
GEOVIA assumes responsibility for errors or omissions. Neither will be held liable for any damages
caused or alleged to be caused from the use of the information contained herein.
Dassault Systèmes GEOVIA Inc. offers complete 3D software tools that let you create, simulate,
publish, and manage your data.
GEOVIA, the GEOVIA logo, combinations thereof, and GEMS, Surpac, Minex, MineSched, Whittle,
PCBC, InSite, and Hub are either trademarks or registered trademarks of Dassault Systèmes or its
subsidiaries in the US and/or other countries.
Product
GEOVIA Licence Manager™ 14.9.4
Last modified: 07 October 2019
 Table of Contents
Introduction 5
Licence Manager Permissions 5
Requirements 5
Workflow 7
Licence Manager Concepts 8
Licence Types 8
Licence Classes 9
Requesting a Licence Class 9
Licence Manager Folder Paths 9
User Defaults Folder 9
Licence Manager Installation Path 10
Setting Up the Licence Manager Server 11
Downloading Licence Manager Installer 11
Download the Licence Manager Installer 11
Upgrading Licence Manager 12
Upgrade Licence Manager on the Server Computer 13
Installing Licence Manager 13
Install Licence Manager 13
Starting Licence Manager 14
Adding or Updating Licences Using Self-Service Licensing 14
Adding and Updating Tokens 17
Adding or Updating Tokens Using a .udt File 17
Add or Update Tokens Using a .udt File 18
Adding or Updating Tokens Using an HTML File 19
Add or Update Tokens Using an HTML File 20
Adding or Updating Tokens Using a .licz File 21
Add or Update Tokens Using a .licz File 21
Running Reports 23
Reporting on Licence Classes 24
Report on Licence Classes 24
Reporting on Licence Usage 24
Report on Licences Used 25
Reporting on Licences Available 25
Report on Licences Available 26
Viewing the Log File 26
View the Log File 26
Setting up the Client to Use a Network Licence 27
Setting Up Surpac or Minex to Use the Licence Server 27
 Set up the Client to use the Licence Server 27
Setting Up GEMS to Use the Licence Server 28
Set Up GEMS to Use the Licence Server 28
Setting Up Whittle to Use the Licence Server 29
Set Up Whittle to Use the Licence Server 30
Setting Up MineSched to Use the Licence Server 31
Set Up MineSched to Use the Licence Server 31
Reacquire Your Licence 33
Introduction

Introduction
GEOVIA Licence Manager is a program that enables a site using GEOVIA programs to administer all its
licences from a central server computer. Licences managed by Licence Manager are not “tied” to one
specific computer. This concept is referred to as floating licences. Floating licences permit companies
to share licences among users, which is a cost effective means of purchasing GEOVIA programs.
Licence Manager has two components: the Licence Manager window and the Licence Manager
service.
Licence Manager Window
An administrator manages licences using the Licence Manager window. From the Licence Manager
window, the administrator performs the following activities:

l manage the use of various GEOVIA programs

l run reports that show the:
l various classes of licences defined in the tokens file

l usage of various classes of licences

l availability of licences

l the usage of functions within GEOVIA program

l revoke licences for specified users

l start and stop the licence server

Licence Manager Service

The administrator starts the service so that licences are available among the client computers on the
local area network (LAN). The Licence Manager service enforces the licensing conditions on a site,
such as number of simultaneous users and options enabled.

Licence Manager Permissions

To perform a task within Licence Manager, you must have the appropriate permissions.
For organizations that have many licences, GEOVIA recommends that only a few selected persons
have access to perform the administrative tasks in Licence Manager. This guideline ensures that only
the persons with permissions can change the Licence Manager server process.
To run the Licence Manager program or start the service, you must be an administrator with the
appropriate permissions.

Requirements
When you install Licence Manager, you can use the default settings in the wizard unless the
installation procedure explicitly states that you should change the settings.
To use GEOVIA network licences, you must install Licence Manager on one computer on the LAN that
is the Licence Manager server. In some situations, the network administrator (the person
responsible for network administration) might choose to have more than one licence server for
backup purposes, such as in the case of a computer malfunction or network outage on a large
network.
Note: Each computer can run only one instance of Licence Manager.
Installation Prerequisites
The person who is the licence administrator must have administrator permission on the computer
that is the Licence Manager server.

GEOVIA Licence Manager™ 14.9.4 Page 5 of 42 User Guide

Introduction

The Licence Manager server computer must have:

l a hardware dongle for Licence Manager

Nearly all Licence Manager dongles plug into USB ports. Some older dongles plug into
parallel ports.
l a current GEOVIA dongle (or sentinel)
l one of the following operating systems (32-bit or 64-bit):
l Windows 7

l Windows Server 2008

l Windows Server 2012

l the TCP/IP networking protocol installed

If the TCP/IP network protocol is not installed, you must install it: In the Windows
Control Panel, double-click the Network icon to install TCP/IP.
l a static IP address
The computer must not have its IP address dynamically allocated using DHCP. Char-
acteristics of using dynamic IP addresses are:
l failure for a client to locate a licence server

l excessive delays in the licence server responding to and granting licence

requests
l loss of licences while using a GEOVIA program

l the dongle driver software installed

l the Licence Manager program on the licence server computer installed
l the Licence Manager server configured using the Licence Manager window

The network must have one of the following:

l a fully functional DNS server to permit the translation from host names to IP addresses
GEOVIA recommends using a DNS server rather than relying on entries in hosts files. A
DNS server is a more robust system for name resolution than the system of relying on
entries in hosts files.
l an entry in the hosts file of each computer in the network that defines the host name
and IP address for each computer in the network

All client computers running GEOVIA programs must have:

l the TCP/IP networking protocol installed

If the TCP/IP network protocol is not installed, then you must install it: In the Windows
Control Panel, double-click the Network icon to install TCP/IP.
l the GEOVIA programs (for example, GEMS, Minex, Whittle, MineSched, or Surpac)
installed

GEOVIA Licence Manager™ 14.9.4 Page 6 of 42 User Guide

Introduction

Workflow

Note: This workflow is not intended to be complete in scope, but shows the activities needed to
achieve a result.

GEOVIA Licence Manager™ 14.9.4 Page 7 of 42 User Guide

Licence Manager Concepts

Licence Manager Concepts

The following concepts are important for you to understand in order to use Licence Manager
effectively.

l Licence Types on page 8

l Licence Classes on page 9
l Licence Manager Folder Paths on page 9

Licence Types
To use any GEOVIA program, you must obtain a licence. The types of licence that are available are:

l A demonstration licence that does not require a dongle (or sentinel) , but has reduced
functionality.
l A single-user licence (also known as a roaming licence) that requires you to install a
GEOVIA dongle driver on your computer. For this licence type, you use a token number
that is for the specific dongle attached to the computer.

l A network licence for which you need Licence Manager installed and running on a com-
puter on the local area network (LAN). The computer running the Licence Manager
must have a dongle attached. Any other computer on that network can run GEOVIA
programs without the dongle, and have fully licensed functionality.
Note: To use a network licence, the computer running the GEOVIA program must
always have a connection to the Licence Manager server computer while the program is
in use. The Licence Manager program is a service on the Licence Manager server
computer. If the Licence Manager service fails or stops responding, the person who is
using the network licence loses their licence. That person cannot continue using the full
features of the GEOVIA program. Also, a message appears to inform the person that
the copy of the GEOVIA program does not have a licence.

GEOVIA Licence Manager™ 14.9.4 Page 8 of 42 User Guide

Licence Manager Concepts Requesting a Licence Class

Licence Classes
For Surpac, GEMS, Minex, MineSched, or Whittle, you can set up different licence classes. A licence
class is the name for a grouping of options or modules for a program. Program users request a
particular licence class from Licence Manager when they use Surpac, Minex, MineSched, or Whittle.
By requesting a specific licence class, the users ensure that the licence they get includes the modules,
that is the commands or functions, needed to do their job.
When a tokens file is first installed in Licence Manager, all licences are assigned the default class. In
GEMS, the default class is the seat number of each licence. In Surpac, Minex, MineSched, and
Whittle, the default class is named default.
The person who administers Licence Manager can define the class names using any combination of
alphanumeric characters. If a site uses licence classes, the administrator determines the class to
which a licence token belongs.
For example, if you have three licences for Surpac, you might have three licence classes, one for each
licence. One class could include all modules and have the class name all. A second class could include
modules that relate specifically to surveying functions and have the class name survey. And the third
class could include modules that relate specifically to geology functions and have the class name
geology. A surveyor using Surpac can specifically request the licence class named survey, which is the
licence that includes all the modules needed perform their job.
Requesting a Licence Class
The procedure to request a licence class differs for each GEOVIA program:

l For Surpac or Minex to use a specific licence class, add the -class <classname> com-
mand-line option to the desktop shortcut, otherwise the default licence class is used.
Note: If you renamed all instances of the default class when you set up the classes,
you must add the -class <classname> option to use a specific licence. If you do not add
the -class <classname> option, you will not get a licence.
l For Whittle to use a specific licence class, choose File > Licence Validation and select
the licence class you want to use.
l For GEMS to use a specific licence class, choose File > Switch Seat and select the seat
you want to use.
l For MineSched to use a specific licence class, choose Scenario > Licensing... and select
the licence class you want to use.

Caution: If the tokens give you access to different modules, GEOVIA recommends that you put
only one token into a licence class. If more than one token is put in a licence class, users can never be
certain which modules they are licensed to use.
Note: If you have more than one token for a single version of a program, you must put the tokens
into separate licence classes, for Licence Manager to correctly distribute licences.

Licence Manager Folder Paths

The following information describes the location of the User Defaults folder and the path for Licence
Manager when you install it with a GEOVIA program.
User Defaults Folder
The User Defaults folder contains user settings and customized files. When you install Licence
Manager, you can change the default location of the User Defaults folder. The default location is

GEOVIA Licence Manager™ 14.9.4 Page 9 of 42 User Guide

Licence Manager Concepts Licence Manager Installation Path

C:\Users\Public\GEOVIA\LicenceManager\share\etc for the following operating systems: Windows

7, Windows Server 2008, and Window Server 2012.
Licence Manager Installation Path
The default installation path for Licence Manager changed in version 14.7. For Licence Manager 14.7
and later, the default installation path is:
C:\Program Files (x86)\Dassault Systemes\GEOVIA LicenceManager\<version
number>\Bin\NLMAdmin.exe
For Licence Manager 14.6 and earlier, the default installation path is:
C:\Program Files (x86)\Gemcom\LicenceManager\nt_i386\bin\NLMAdmin.exe
Note: When you install GEOVIA Surpac, GEOVIA Minex, or GEOVIA Whittle, NLMAdmin.exe and
NetworkLicenceManager.exe are installed in the binary directory of the Surpac, Minex, or Whittle
program installation folder. There is no function within Surpac, Minex, or Whitle to check the
number of licences available on the network. Instead, Licence Manager is installed with these
programs by default, so you can run reports to determine the number of licences available.

GEOVIA Licence Manager™ 14.9.4 Page 10 of 42 User Guide

Setting Up the Licence Manager Server Download the Licence Manager Installer

Setting Up the Licence Manager Server

Follow this general process for the initial setup of the Licence Manager server.

1. Install Licence Manager from the GEOVIA installation disc.

Alternatively, use the installation file that you downloaded from the GEOVIA Support web-
site (See Downloading Licence Manager Installer on page 11).
2. Stop the Licence Manager service.
3. If you have a LICZ file, add or update tokens using a .licz File
If you have a tokens file (.udt), add or update the tokens using the .udt file.
If you have an HTML file, add or update the tokens using the HTML file.
4. Start the Licence Manager service.

Note: After you have set up the server (and started the service), the licence server automatically
distributes licences on your network. For help about using a network licence on a client, see Setting
Up Surpac or Minex to Use the Licence Server on page 27 or Setting Up GEMS to Use the Licence
Server on page 28.

Downloading Licence Manager Installer

Licence Manager is available on every installation disk. Alternatively, go to the GEOVIA support
website and download the Licence Manager installer.
Note: GEOVIA recommends that you install the latest version of Licence Manager when you
upgrade your program.
Download the Licence Manager Installer
1. Type https://www.GEOVIAsupport.com into the web browser, and press Enter.
2. If you have a user name and password, enter them and click Login In.
Note: If you do not have any logon credentials, click Create an account and follow the
prompts.
3. Click Downloads.

GEOVIA Licence Manager™ 14.9.4 Page 11 of 42 User Guide

Setting Up the Licence Manager Server Download the Licence Manager Installer

4. If you are downloading Licence Manager for the most recent release of a program, under
the program heading, click Current Version.
If you are downloading Licence Manager for a previous release of a program, under the
program heading, click Previous Versions, and then click the version you need.

5. In the list of files that appear, find a link named GEOVIA Licence Manager <version num-
ber>. Click the link, which prompts you to save the installation file to your computer.
This file appears below a section name Utilities Installation Files (as in the following
image) or Required Installations.

Note: The file that you save to your computer can be a .zip file or a .msi file.
6. Using Windows Explorer, go to the folder where the Licence Manager Installer is saved.
7. To run the installer, double-click the file, and follow the prompts.
If the file that you saved is a .zip file, extract the .msi file before running the installer.

Upgrading Licence Manager

Note: When you upgrade from Licence Manager 14.x and earlier to Licence Manager 14.7, you
MUST uninstall the previous version before installing the latest version. Usually when you upgrade
Licence Manager, you run the installation file. However, uninstalling the previous version of Licence
Manager is important because there are significant changes in the installer for Licence Manager 14.7.
When you upgrade Licence Manager 14.7 and later, the installer automatically removes the previous
version and loads all the licences from the previous version into the new version. This part of the
installation process ensures that you do not have multiple versions of Licence Manager on the same
computer.

Tip: Licence Manager 14.7 and later references a different share\etc path for the ssilm.tok file.
For your licences to be available in Licence Manager 14.7 and later, you can copy the ssilm.tok file

GEOVIA Licence Manager™ 14.9.4 Page 12 of 42 User Guide

Setting Up the Licence Manager Server Upgrade Licence Manager on the Server Computer

from the share\etc directory of the existing installation and copy it to the share\etc directory of the
Licence Manager 14.7 and later installation. If both the previous version of Licence Manager and
Licence Manager GEOVIA Licence Manager are installed to the default directories, this means copying
the file from C:\Users\Public\Gemcom\LicenceManager\share\etc and pasting it to
C:\Users\Public\GEOVIA\LicenceManager\share\etc.
Upgrade Licence Manager on the Server Computer
1. Stop the Licence Manager service.
2. Run the Licence Manager installer file from the installation disc.
Or if you downloaded the installer file, browse to the folder where you saved the file, and
double-click it.
3. Follow the prompts for the installation wizard to install Licence Manager to the default loc-
ation.
4. Start the Licence Manager service.

Installing Licence Manager

For the installation prerequisites, see Requirements on page 5.
The User Defaults folder contains user settings and customized files. When you install Licence
Manager, you can change the default location of the User Defaults folder. The default location is
C:\Users\Public\GEOVIA\LicenceManager\share\etc for the following operating systems: Windows
7, Windows Server 2008, and Window Server 2012.
Install Licence Manager
1. Stop the Licence Manager service.
2. If the dongle (or sentinel) is plugged into the computer, unplug it.
Caution: When you install the dongle driver, ensure that you remove the dongle from
the computer. If the dongle is plugged into the computer, the data saved on the dongle
could be erased.
3. Insert the installation disc for the GEOVIA program into the disc drive on the computer.
4. Run the Licence Manager installation file.
l Surpac - Click Install, click Utilities, and then click Licence Manager

l Minex - In Windows Explorer, browse to <cd drive>:\Net-

workLicenceManager\GEOVIALicenceManager.msi, and double-click it.

l Whittle - In Windows Explorer, browse to <cd drive>:\Net-

workLicenceManager\GEOVIALicenceManager.msi, and double-click it.

l MineSched - In Windows Explorer, browse to <cd drive>:\Net-

workLicenceManager\GEOVIALicenceManager.msi, and double-click it.

l GEMS - Click Install, and then click GEOVIA Licence Manager

5. Continue clicking Next in the wizard, making the following changes:

l accept the terms of the licence agreement

l if you are prompted for a seat number, enter the seat number that GEOVIA

provided
l on the Custom Setup page, select the setting for the Sentinel Device Driver

to be installed on the local hard drive

GEOVIA Licence Manager™ 14.9.4 Page 13 of 42 User Guide

Setting Up the Licence Manager Server Install Licence Manager

6. Click Install.
7. When the installation finishes, click Finish.

To start Licence Manager, use the desktop icon that is automatically created, or go to Start > All
Programs > GEOVIA > GEOVIA Licence Manager.

Starting Licence Manager

Start Licence Manager using one of the following methods:

l Double-click the desktop icon

l Click Start, select All Programs > GEOVIA > GEOVIA Licence Manager <version>.

Adding or Updating Licences Using Self-Service Licensing

GEOVIA introduced the self-service licensing feature in Licence Manager 14.0. All versions of Licence
Manager after Licence Manager 14.0 have this feature.
Self-service licensing permits you to download all the network licences your company has purchased
as a single .licz file, from the GEOVIA support website.
To use self-service licensing, you need a GEOVIA dongle and a GEOVIA support account. If you do not
have a GEOVIA support account, you can create one.

1. Insert the GEOVIA dongle into a port on the computer.

Caution: If you have a parallel dongle, and a printer is connected to the parallel port,
turn on the printer. Do not connect backup tape units or other similar devices to a
parallel dongle. If you must use such a device, first remove the parallel dongle. Devices
such as these can damage the dongle. Any dongle damaged by such actions incurs a
replacement cost.
2. Start GEOVIA Licence Manager by double-clicking the desktop icon or choosing Start > All
Programs > GEOVIA > GEOVIA Licence Manager <version>.
If Licence Manager has no tokens, the Request Licence form appears. If Licence Manager
has at least one token already, the right pane of the Licence Manager window shows the
token with a green check mark beside it.

GEOVIA Licence Manager™ 14.9.4 Page 14 of 42 User Guide

Setting Up the Licence Manager Server Install Licence Manager

3. In Licence Manager, choose Service > Stop to stop the Licence Manager service.
Licence Manager stops distributing licences, and anyone who has a network licence loses
it within a few moments.
4. If you do not have an updated tokens file (.licz file) saved to the computer, request one
and download it to the computer:
a. If the Request Licence form is not visible, choose Administration > Request
licence.

b. Click Request licence.

The DS Passport page appears.
c. Sign in to the GEOVIA Support website using your DS passport and GEOVIA
support user name and password.
If your company has at least one network licence, you will receive the
following message and license is sent to your email.

d. Save the .licz file to a local folder.

5. After saving .licz file to the computer, return to Licence Manager.
6. Choose File > Open.
7. In the File name box, select SSILM LICZ Files (*.licz), find and select the .licz file.

GEOVIA Licence Manager™ 14.9.4 Page 15 of 42 User Guide

Setting Up the Licence Manager Server Install Licence Manager

8. Click Open.
The Update Tokens form appears.
The form displays a list of tokens, products, and versions contained in the update file.
You select the versions you want to add or update.

9. Select the boxes for the tokens you want to update.

If the tokens in a particular program version are already defined in Licence Manager,
Licence Manager automatically updates the existing tokens to the new tokens.

GEOVIA Licence Manager™ 14.9.4 Page 16 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using a .udt File

If the tokens in a particular program version do not exist, Licence Manager adds the
tokens to the "default" class.
10. Click OK.
The right pane of the Licence Manager window is updated to show the new token
information.

11. Save the changes to the tokens file.

12. To reinstall the Licence Manager service, choose Service > Install.
13. To restart the service so that all licenses are distributed on the network, choose Service >
Start.

Adding and Updating Tokens

To make licences available, you add tokens to Licence Manager. You add tokens using one of the
following methods:

l Adding or Updating Licences Using Self-Service Licensing on page 14

l Adding or Updating Tokens Using an HTML File on page 19
l Adding or Updating Tokens Using a .udt File on page 17
l Adding or Updating Tokens Using a .licz File on page 21

Updating tokens does not affect or change any previously defined classes.
Note: If you log on remotely to the Licence Manager server to add or update the tokens file, the
dongle must be plugged into the computer that is running Licence Manager.
Adding or Updating Tokens Using a .udt File
When you add or update tokens, you use a .udt file that you receive from GEOVIA to load the
licences into Licence Manager and make them available to all client computers. Updating tokens
does not affect or change any previously defined classes. Also, using a .udt file minimizes the chances
of typographical errors.

Tip: Before you add or update the tokens, create a backup copy of the previous version of the
.udt file (if you have one).

GEOVIA Licence Manager™ 14.9.4 Page 17 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using a .udt File

Add or Update Tokens Using a .udt File

1. Save the new .udt file to a location on the Licence Manager server computer.
2. Insert the dongle into a port on the computer.
Caution: If you have a parallel dongle, and a printer is connected to the parallel port,
turn on the printer. Do not connect backup tape units or other similar devices to a
parallel dongle. If you must use such a device, first remove the parallel dongle. Devices
such as these can damage the dongle. Any dongle damaged by such actions incurs a
replacement cost.
3. Start Licence Manager.
The Licence Manager window opens.
If you are starting Licence Manager for the first time, the following information message
appears.

4. Choose Service > Stop.

5. Choose Service > Uninstall.
6. Choose File > Open.
7. In the File name box, select SSILM Update Files (*.udt), find and select the .udt file.

GEOVIA Licence Manager™ 14.9.4 Page 18 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using an HTML File

8. Click Open.
The Update Tokens form appears.
The form displays a list of tokens, products, and versions contained in the update file.
You select the versions you want to add or update.

9. Select the boxes for the tokens you want to update.

If the tokens in a particular program version are already defined in Licence Manager,
Licence Manager automatically updates the existing tokens to the new tokens.
If the tokens in a particular program version do not exist, Licence Manager adds the
tokens to the "default" class.
10. Click OK.
The right pane of the Licence Manager window is updated to show the new token
information.

11. Save the changes to the tokens file.

12. To reinstall the Licence Manager service, choose Service > Install.
13. To restart the service so that all licenses are distributed on the network, choose Service >
Start.

Adding or Updating Tokens Using an HTML File

Before you begin, obtain written token update information by visiting the GEOVIA support website
or contacting your local GEOVIA support office.

GEOVIA Licence Manager™ 14.9.4 Page 19 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using an HTML File

When you add or update tokens using an HTML file, you copy the tokens from the file, and paste the
tokens into Licence Manager. Updating tokens does not affect or change any previously defined
classes.

Tip: Before you add or update the tokens, print a summary report of the current classes, by
choosing Report > Classes.
Add or Update Tokens Using an HTML File

1. Insert the dongle into a port on the computer.

Caution: If you have a parallel dongle, and a printer is connected to the parallel port,
turn on the printer. Do not connect backup tape units or other similar devices to a
parallel dongle. If you must use such a device, first remove the parallel dongle. Devices
such as these can damage the dongle. Any dongle damaged by such actions incurs a
replacement cost.
2. Start Licence Manager.
The Licence Manager window opens.
If you are starting Licence Manager for the first time, the following information message
appears.

3. Click Service > Stop.

4. Click Service > Uninstall.
5. Choose Edit > New Class.
The Create/Delete Class form appears.

6. Select the Product and the Version of that product.

7. Ensure Release type is set to Normal.

GEOVIA Licence Manager™ 14.9.4 Page 20 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using a .licz File

8. In Class, leave the value as default, or if you are setting up different licences for different
groups of users, type a class name.
For more information on classes, see Licence Classes on page 9.
9. Click OK.
The right pane of the Licence Manager window is updated with new token information.

10. Choose Edit > New Token.

11. In the Token Number field, type the token number provided, and click OK.
A token for Licence Manager has at least 24 digits in total. For example, 191e86aa89-
744a8c9e8c1b363e.
Tip: To reduce typing errors, copy the token number from the HTML file, and paste it
to the Token Number field.
12. Save the changes to the tokens file.
13. To install the Licence Manager service, choose Service > Install.
The server status in the status bar changes from Not installed to Installed
14. Click OK.
15. To start the service so that all licenses are distributed on the network, choose Service >
Start.
The server status in the status bar changes from Stopped to Started. In addition,
the service will automatically start when the computer starts.
16. Click OK.

Adding or Updating Tokens Using a .licz File

When you add or update tokens, you use a .licz file that you receive from GEOVIA to load the
licences into Licence Manager and make them available to all client computers. Updating tokens
does not affect or change any previously defined classes. Also, using a .licz file minimizes the chances
of typographical errors.

Tip: Before you add or update the tokens, create a backup copy of the previous version of the
.licz file (if you have one).
Add or Update Tokens Using a .licz File

1. Save the new .licz file to a location on the Licence Manager server computer.
2. Insert the dongle into a port on the computer.
Caution: If you have a parallel dongle, and a printer is connected to the parallel port,
turn on the printer. Do not connect backup tape units or other similar devices to a

GEOVIA Licence Manager™ 14.9.4 Page 21 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using a .licz File

parallel dongle. If you must use such a device, first remove the parallel dongle. Devices
such as these can damage the dongle. Any dongle damaged by such actions incurs a
replacement cost.
3. Start Licence Manager.
The Licence Manager window opens.
If you are starting Licence Manager for the first time, the following information message
appears.

4. Choose Service > Stop.

5. Choose Service > Uninstall.
6. Choose File > Open.
7. In the File name box, select SSILM LICZ Files (*.licz), find and select the .licz file.

8. Click Open.

GEOVIA Licence Manager™ 14.9.4 Page 22 of 42 User Guide

Setting Up the Licence Manager Server Adding or Updating Tokens Using a .licz File

The Update Tokens form appears.

The form displays a list of tokens, products, and versions contained in the update file.
You select the versions you want to add or update.

9. Select the boxes for the tokens you want to update.

If the tokens in a particular program version are already defined in Licence Manager,
Licence Manager automatically updates the existing tokens to the new tokens.
If the tokens in a particular program version do not exist, Licence Manager adds the
tokens to the "default" class.
10. Click OK.
The right pane of the Licence Manager window is updated to show the new token
information.

11. Save the changes to the tokens file.

12. To reinstall the Licence Manager service, choose Service > Install.
13. To restart the service so that all licenses are distributed on the network, choose Service >
Start.

Running Reports
You can run reports that show the following information on licences and Licence Manager:

l log file

GEOVIA Licence Manager™ 14.9.4 Page 23 of 42 User Guide

Setting Up the Licence Manager Server Reporting on Licence Classes

Reporting on Licence Classes

The licence class report shows details for each of the classes of licences defined in the tokens file
currently being used by the Licence Manager. Some of the details include:

l program and program version

l licence class
l licence identification
l expiry date for the licence

The following image is an example of the licence class report.

Report on Licence Classes

1. Choose Report > Classes to display a report of the various classes of licences defined in
the tokens file currently used by the Licence Manager.
Note: This report might take a few moments to appear while the Licence Manager
server is being queried.

Reporting on Licence Usage

The licence usage report includes the following details for each licence currently in use, and the total
number of licences currently available:

l the host on which the licence is running

l the user name of the session using that licence
l the product being used
l the version of the product being used
l the class of licence being used
l the Licence ID of the licence being used
l the state of the licence
The Standby state indicates that the licence is not active. If all licences are currently in
use, a licence in a Standby state can be reassigned to another user.

GEOVIA Licence Manager™ 14.9.4 Page 24 of 42 User Guide

Setting Up the Licence Manager Server Reporting on Licences Available

The following image is an example of the licence usage report.

The State of a licence is appears as:

l the name of the function being run

The name of the function that is running or has just completed. The licence state
reverts to Idle within a few seconds after the function completes.
l idle
A licence is idle if it was recently in use but has been inactive for a short amount of time.
If the licence is inactive for a period that is less than the number of seconds that you
defined in the Standby Timeout box in the Edit Configuration form, the licence is idle.
If the licence is inactive for a period that exceeds the number of seconds that you
defined in the Standby Timeout box in the Edit Configuration form, the licence state
changes to standby.
l standby
A licence state is in standby if the time that the licence is inactive exceeds the number of
seconds that you defined in the Standby Timeout box in the Edit Configuration form.
A licence that is in a standby state can be revoked from the current user and issued to a
different user when no more licences are available and when a different user requires a
licence.

Report on Licences Used

1. Choose Report > Licences to display a report of the licences usage and being managed by
the Licence Manager. This report all licences that are currently in use and licences that are
not currently in use.
Note: This report might take a few moments to appear while the Licence Manager
server is being queried.

Reporting on Licences Available

The licences available report includes details for each licence in the tokens file, the number of licences
currently in use, and the number of licences currently available. The following image is an example of
the licences available report.

GEOVIA Licence Manager™ 14.9.4 Page 25 of 42 User Guide

Setting Up the Licence Manager Server Viewing the Log File

Note: Licences that appear under Standby and Available are licences that can be made available
for other users.
Report on Licences Available

1. Choose Report > Available to display a report for each licence token. The numbers of
licences currently in use and the number of licences still available.
Note: This report might take a few moments to appear while the Licence Manager
server is being queried.

Viewing the Log File

This reporting function helps the administrator and technical support staff from GEOVIA to
investigate the activity of the Licence Manager.
The detailed log file is in the share directory, share\etc\ssilm.log. For each entry in the log file, there
is a date/time stamp and a diagnostic message that indicates the activity.
GEOVIA support staff might request this information to diagnose and correct issues that you
experience with the Licence Manager.
The following image is an example of the log file.

View the Log File

1. Choose View > Log to display the Licence Manager usage log report.
Note: This report might take a few moments to appear while the Licence Manager
server is being queried.

GEOVIA Licence Manager™ 14.9.4 Page 26 of 42 User Guide

Setting up the Client to Use a Network Licence Set up the Client to use the Licence Server

Setting up the Client to Use a Network Licence

Before you can use a network licence, ensure that the Licence Manager service is installed and
running on a computer on your local area network.
If the Licence Manager server is running on the same subnet of your local area network, the GEOVIA
program automatically uses a network licence.
For information about using a network licence, see:

l Setting Up Surpac or Minex to Use the Licence Server

l Reacquire Your Licence

Setting Up Surpac or Minex to Use the Licence Server

When you start a GEOVIA program, the program by default searches for a local dongle and licence
first, and then searches for a network licence. If you want to force the program to use a particular
licence server for licensing, you can change the desktop shortcut for the program.
Set up the Client to use the Licence Server
1. Install a GEOVIA program on a computer that can contact the Licence Manager through
the network.
A desktop shortcut for the program appears on the desktop.
2. Right-click the desktop shortcut, and choose Properties.
3. In the Shortcut tab, edit the Target box using the following format:
<path of the GEOVIA program executable> -lm <name or IP address of Licence
Server>
Note: If the Licence Manager server has class names, you must include the class name
information using the –class switch. For more information, see the section named Specify
the Licence Class.
4. Click OK.

You can change the parameters of the desktop shortcut in the following ways.
Specify the Licence Manager Server
To specify the Licence Manager server, add -lm <servername> to the desktop shortcut. By using the
-lm <servername> option, the client computer sends the licence request to a specific Licence
Manager server. The request is not broadcast to all computers in the network. Depending on the
state of the local network and the traffic load in the network, there might be a delay before a licence
is granted.
For example:
When 64-bit Surpac is installed on 64-bit Windows:
"C:\Program Files\GEOVIA\Surpac\<version>\x64\bin\surpac2.exe" -lm
licserv
When Minex is installed on 64-bit Windows:
"C:\Program Files (x86)\Dassault Systemes\GEOVIA
Minex\<version>\bin\minex.exe" -lm 192.168.1.56
Notes:

l Firewalls on a client or server computer can be set up to block specific broadcast

requests and only allow requests when a specific computer has been nominated. If a cli-
ent fails to receive a licence, you can try temporarily turning the firewall off to find out if

GEOVIA Licence Manager™ 14.9.4 Page 27 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up GEMS to Use the Licence Server

the firewall is blocking communication.

l If the Licence Manager server is on a different subnet from the client, the client does
not automatically receive a licence. Instead you must add -lm <name or IP address of
the Licence Server> to the desktop shortcut.

Reconfigure the Port

Every server 'listens' to the network using a particular port number. The default port for Licence
Manager is 1234, but any number in the range of 0 to 65535 can be used. If the server is configured
to use another port, use the command -lm <servername>:<port number>.
For example:
When 64-bit Surpac is installed on 64-bit Windows:
"C:\Program Files\GEOVIA\Surpac\<version>\x64\bin\surpac2.exe" -lm
licServer:1235
When Minex is installed on 64-bit Windows:
"C:\Program Files (x86)\Dassault Systemes\GEOVIA
Minex\<version>\bin\minex.exe" -lm licServer:1235
Specify the Licence Class
All licences in a Licence Manager installation can be added to classes. For more information about
classes, see Licence Classes on page 9.
To use the class named default, you do not need to add -class <classname> to the desktop
shortcut. Double-click the desktop shortcut for the program, select to use a network licence, and the
program automatically selects the default class.
If you require a specific class, or a class named default does not exist, you must add -class
<classname> to the desktop shortcut. If you do not specify a class, and the default class does not
exist, the licence is not granted.
For example:
When 64-bit Surpac is installed on 64-bit Windows:
"C:\Program Files\GEOVIA\Surpac\<version>\x64\bin\surpac2.exe" -lm
licServer -class survey
When Minex is installed on 64-bit Windows:
"C:\Program Files (x86)\Dassault Systemes\GEOVIA
Minex\<version>\bin\minex.exe" -lm licServer -class survey

Setting Up GEMS to Use the Licence Server

Before you can use a network licence, ensure that the Licence Manager service is installed and
running on a computer on your local area network.
Set Up GEMS to Use the Licence Server
1. Obtain a GEMS licence (.xml or .licz) file from GEOVIA, and save it on your computer.
2. Install GEMS on a computer that can contact the Licence Manager through the network.
3. Start GEMS.
Or if you currently have GEMS running:
a. Choose File > Switch Seat.
b. In the Switch Seat form, click New Licence.

GEOVIA Licence Manager™ 14.9.4 Page 28 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up GEMS to Use the Licence Server

4. In the GEMS Activation form, select I have the file, browse for the licence file, and then
click OK.

Your licence file is copied to the configuration folder, and the Switch Seat form appears.
5. In the Switch Seat form, select the Server Seat and Server name, and then click OK.

Setting Up Whittle to Use the Licence Server

Before you can use a network licence, ensure that the Licence Manager service is installed and
running on a computer on your local area network.

GEOVIA Licence Manager™ 14.9.4 Page 29 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up Whittle to Use the Licence Server

Set Up Whittle to Use the Licence Server

1. Install Whittle on a computer that can contact the Licence Manager through the net-
work.
2. Start Whittle.
3. Choose File > License Validation.
4. Select Network, and click Ok.

The Whittle Network License Request form appears. You can use this form to request a
new licence.

GEOVIA Licence Manager™ 14.9.4 Page 30 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

5. In the License Server field, type the name, or IPv4 address, of your network licence
server, for example server1.company.priv.
Tip: If you do not receive a network licence, try specifying the UDP port, for example
server1.company.priv:1234.
6. In the Licence Class field, type the name of the licence class that you want to use.
7. Click Validate.
The lower right corner of Whittle shows you that you have been granted a licence and
displays the name of the licence server.

If the licence has been revoked, and all available licences have been granted to other
users, you will not be able to obtain a licence to continue your work. If you are running a
function that permits you to save data and does not require a licence, you can save your
work.

Setting Up MineSched to Use the Licence Server

Before you can use a network licence, ensure that the Licence Manager service is installed and
running on a computer on your local area network.
Set Up MineSched to Use the Licence Server
1. Install MineSched on a computer that can contact the Licence Manager through the net-
work.
2. Start MineSched.
3. Choose Scenario > Licensing.

GEOVIA Licence Manager™ 14.9.4 Page 31 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

The MineSched Licensing form appears.

4. Select Network.
5. In the Server field, type the server name, or click the arrow and select the server from the
list.
6. Click Connect.
The licence classes available on the server are populated into the Class list.
7. In the Class field, type the class name or click the arrow and select the class from the list.

8. Click Apply.
If the licence is granted, all MineSched functions are available.

GEOVIA Licence Manager™ 14.9.4 Page 32 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

If the licence is revoked, and all available licences are granted to other users, you cannot
obtain a licence to continue your work. The word "Unlicensed" will appear in the title of
the MineSched window.
Without a licence, you can save your work and continue to define parameters for an
open scenario, but you cannot extract data from your models, use the evaluation tools,
define locations, define material movement, manage workbook linking, run the schedule,
create reports, or create a new MineSched scenario.
Note: MineSched retains the licence settings. Each time you open MineSched, the
licence settings from the previous session are used.

Reacquire Your Licence

If the licence you were using is lost or revoked and you try to run another function, the Licence Type
form appears. From the form, you can run the GEOVIA program without a licence or you can try to
reacquire a licence.

l If you choose to run the GEOVIA program without a licence, you can save your work
and attempt to reacquire a licence later. When you start Surpac and the Request a
Licence in Surpac form appears, select None. If you want to get a licence later, choose
File > Licensing > Change/Inspect Licence.
l If you try to reacquire a licence, but all licences are in use by others, the form
reappears. You can then continue trying to access a licence using the form.

Reacquire a Licence in Surpac

1. Choose File > Licencing > Change/Inspect Licence.

GEOVIA Licence Manager™ 14.9.4 Page 33 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

The Update licence form appears.

2. In the Licence type field, select the network option.

3. Click Apply.
The Surpac Network Licence Request form appears. You use this form to request a new
licence.

GEOVIA Licence Manager™ 14.9.4 Page 34 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

4. Edit the Licence Server field, for example server1.company.priv:1221, and click Apply.

5. To check which modules you are licensed to use, choose File > Licencing > Change/In-
spect Licence again, and click Apply.

GEOVIA Licence Manager™ 14.9.4 Page 35 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

Reacquire a Licence in Minex

1. Choose File > Licencing.

GEOVIA Licence Manager™ 14.9.4 Page 36 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

2. Select Network, and click Ok.

GEOVIA Licence Manager™ 14.9.4 Page 37 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

The Minex Network Licence Request form appears. You use this form to request a new
licence.

3. Edit the Licence Server field, for example server1.company.priv:1221, and click Ok.

If the licence has been revoked, and all available licences have been granted to other
users, you will not be able to obtain a licence to continue your work. If you are running a

GEOVIA Licence Manager™ 14.9.4 Page 38 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

command that permits you to save data and does not require a licence, you can save
your work.

Reacquire a Licence in Whittle

Choose File > License Validation.
Select Network, and click Ok.

The Whittle Network License Request form appears. You can use this form to request a new licence.

GEOVIA Licence Manager™ 14.9.4 Page 39 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

Enter the name, or IPv4 address, of your network licence server in the License Server field, for
example server1.company.priv.
Tip: If you do not receive a network licence, try specifying the UDP port, for example
server1.company.priv:1234.
In the Licence Class field, type the name of the licence class that you want to use.
Click Validate.
The lower right corner of Whittle shows you that you have been granted a licence and displays the
name of the licence server.

If the licence has been revoked, and all available licences have been granted to other users, you will
not be able to obtain a licence to continue your work. If you are running a function that permits you
to save data and does not require a licence, you can save your work.
Reacquire a Licence in GEMS

1. Choose File > Switch Seat.

The Switch Seat form appears. You use this form to request a new licence.

2. Select the licence server from the Server Seat list, and click OK.

If the licence has been revoked, and all available licences have been granted to other users, you
cannot obtain a licence to continue your work. If you are running a command that permits you to
save data and does not require a licence, you can save your work.
Reacquire a Licence in MineSched

1. Choose Scenario > Licensing.

GEOVIA Licence Manager™ 14.9.4 Page 40 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

The MineSched Licensing form appears.

2. Select Network.
3. In the Server field, type the server name or click the arrow and select the server from the
list.
4. Click Connect.
The licence classes available on the server are populated into the Class list.
5. In the Class field, type the class name or click the arrow and select the class from the list.

6. Click Apply.
If the Licence is granted, all MineSched functions are available.

GEOVIA Licence Manager™ 14.9.4 Page 41 of 42 User Guide

Setting up the Client to Use a Network Licence Set Up MineSched to Use the Licence Server

If the licence is revoked, and all available licences are granted to other users, you cannot
obtain a licence to continue your work. The word "Unlicensed" will appear in the title of
the MineSched window.
Without a licence, you can save your work and continue to define parameters for an
open scenario, but you cannot extract data from your models, use the evaluation tools,
define locations, define material movement, manage workbook linking, run the schedule,
create reports, or create a new MineSched scenario.

GEOVIA Licence Manager™ 14.9.4 Page 42 of 42 User Guide