—

License Management Guide

MineScape 2021
 MineScape License Management Guide

© Copyright 2021 Datamine Software

All Rights Reserved

Confidential and Proprietary

Legal Disclaimer
The product described in this documentation may be connected to, and/or communicate information and
data via, a network interface, which should be connected to a secure network. It is your sole
responsibility to ensure a secure connection to the network and to establish and maintain appropriate
measures (such as but not limited to the installation of firewalls, application of authentication measures,
encryption of data, installation of antivirus programs, etc.) to protect the product, the network, your
systems, and the interface against any kind of security breach, unauthorised access, interference,
intrusion, leakage, damage, or corruption or theft of data. We are not liable for damages or losses related
to any such security breach, unauthorised access, interference, intrusion, leakage, damage, or corruption
or theft of data.

2
 MineScape License Management Guide

Contents
MineScape Licenses ............................................................................................................................................................ 4
Server License ......................................................................................................................................................................... 4
Nodelocked License .............................................................................................................................................................. 4
Software Distribution Portal ............................................................................................................................................ 5
Download Installation Files ............................................................................................................................................... 5
Install MineScape License Server ................................................................................................................................... 6
Configure Server Ports ........................................................................................................................................................ 6
MineScape License Files .................................................................................................................................................... 7
Retrieve Composite Host ID.............................................................................................................................................. 7
Generate a Server License .................................................................................................................................................. 7
Generate a Nodelocked License.................................................................................................................................... 10
Return a Generated License ........................................................................................................................................... 10
Add License File to the License Server........................................................................................................................ 11
Restart the License Server .............................................................................................................................................. 11
Frequently Asked Questions ......................................................................................................................................... 12
Why am I unable to see licenses that were previously available? ..................................................................... 12
Can I connect to a license server over a Virtual Private Network (VPN)? ..................................................... 12
Can I run MineScape on a Virtual Machine? ............................................................................................................. 12
Can I run virus scanner software and MineScape? ................................................................................................. 12
Do I need to unblock any executable files for a License Server installation? ................................................ 13
Can the 32-bit license server be used with the 64-bit version of MineScape? ............................................ 13
Why is the vendor daemon crashing periodically? ................................................................................................. 13
Appendix 1: Known SubscribeNET Errors ................................................................................................................ 14
Incorrect login details ....................................................................................................................................................... 14
Appendix 2: Known Download and Installation Errors......................................................................................... 14
Installation............................................................................................................................................................................. 14
Another version of this product is already installed ...................................................................................... 14
Not enough disk space .............................................................................................................................................. 14
Installation is slow ...................................................................................................................................................... 14
Appendix 3 - Known MineScape Errors ..................................................................................................................... 15
Plugin Listing Problems .................................................................................................................................................... 15
Plugin Load Errors .............................................................................................................................................................. 15
License server system does not support this version of this plugin ......................................................... 15
License server system does not support this plugin ...................................................................................... 15
Licensed number of users already reached ...................................................................................................... 16
Plugin has expired ...................................................................................................................................................... 16
No licenses available to borrow ............................................................................................................................ 16
Appendix 4 - Known Daemon Issues and Errors ..................................................................................................... 17
Vendor daemon crashing periodically......................................................................................................................... 17

3
 MineScape License Management Guide

MineScape Licenses
MineScape provides two licensing methods:
• server license
• nodelocked license

Server License
A MineScape license server is installed on a dedicated host machine and is accessible by all machines
where MineScape is installed. Conceptually, the MineScape license server contains a pool of licenses
available for all users.
Reason to use a server license:
• You are in a multi-user environment and your purchased licenses need to be shared across a number
of users.

Nodelocked License
A nodelocked license allows a single instance of MineScape to run on a specific machine. Nodelocked
licenses are directly tied to the hardware of the machine where the license file is located and does not
require a MineScape license server.
Reasons to use a nodelocked license:
• You are the sole user of MineScape.
• You do the majority of your work on a laptop that you take offsite frequently.
• You don’t have access to a MineScape license server.
• You are not in a networked environment.

4
 MineScape License Management Guide

Software Distribution Portal

The MineScape Software Distribution website is a secure website that provides you with 24/7 access to
your software and licenses.
Note: The MineScape Software Distribution website is best viewed with Microsoft Internet Explorer.

Activity Steps
1. Open a web browser and browse to the MineScape Software Distribution site:
https://minescape.flexnetoperations.com
The login page displays:
2. Enter your Login ID and Password
Your login and password details can be found in the welcome email from
minescape@flexnetoperations.com. The Password Finder tool can be used to retrieve your login
details.
3. Click Login.

Download Installation Files

Activity Steps
1. Log in to the MineScape Software Distribution Site.
The Product Information page displays.
2. Click the MineScape License Server hyperlink.
The Software Terms and Conditions page displays.
3. Click I Agree to accept the terms and conditions.
4. Locate the MineScape version entry. Click the hyperlink to download the installation file.
The installation file is downloaded using your current download preferences. If the Mass Download
check box is selected, you are able to download multiple files at once by clicking the Download
Selected Files button.
Note: The Download Manager option and the Mass Download check box require the Java Runtime
Environment. The latest Java Runtime Environment can be downloaded from the official Java web
site.

5
 MineScape License Management Guide

Install MineScape License Server

The following topic covers the installation of MineScape License Server.
MineScape License Server is installed under the following directory:
C:\Program Files\Datamine\MineScape\License Server\

Up to 16 MB of free disk space is needed for the MineScape License Server installation. The installation
process must be run by a user with administrative privileges.
In a multi-user environment, MineScape License Server should be installed on a designated server or
host machine, i.e. the machine that will be accessed by MineScape users. The designated server or host
machine should also have MineScape Design File Server installed on it. In a single-user environment,
MineScape License Server should be installed on the same machine as MineScape Client and MineScape
System Services.
Note: The MineScape License Server web interface and the 'lmadmin' Windows service are also
automatically configured as part of the installation. The 'lmadmin' service allows other machines to
retrieve licenses. Before you can use your licenses, you must first add a license file to your license server
installation and then restart your license server.

Activity Steps
1. Locate the folder that was used to store the downloaded installation file.
2. Double-click on the installation file.
3. Click Install.
Click Settings to configure the server port numbers. Configuring server ports numbers is optional,
however, it must be done prior to installing MineScape License Server.
4. Click Exit.

Configure Server Ports

Configuring server ports numbers is optional, however, it must be done prior to installing MineScape
License Server.

Activity Steps
1. Locate the folder that was used to store the downloaded installation file.
2. Double-click on the installation file.
The MineScape installation splash screen displays.
3. Click Settings.
The Settings dialog displays.
4. Review the port numbers for the Web Port and License Server Port fields. If needed, custom port
numbers can be entered. We recommend that you keep a record of the values entered when using
custom server port numbers.
5. Click OK.

6
 MineScape License Management Guide

MineScape License Files

Retrieve Composite Host ID
The following section details how to retrieve composite host IDs using the MineScapeHostID.exe tool.
In order to generate new licenses, a composite host ID must be retrieved using the
MineScapeHostID.exe tool. The MineScapeHostID.exe tool can be downloaded directly from the
MineScape Software Distribution portal. The MineScapeHostID.exe tool is also available under the 'bin'
folder of the MineScape installation folder, as well as under the MineScape License Server installation
folder.
The MineScapeHostID.exe tool outputs all composite host ID information to the screen as well as to a
'minescape_hostid_<host_name>.spec' file under the 'C:\Users\<user name>\' folder.

Activity Steps
1. Open a Windows Explorer window and locate the MineScapeHostID.exe tool.
2. Double-click on MineScapeHostID.exe.
The executable file will run and display a dialog.
3. Press ENTER.

Generate a Server License

To generate a server license for MineScape 5.10 onwards
1. Log in to the MineScape Software Distribution Site.
2. Click Licensing and Orders.
The Licensing and Orders page displays. The Licensing and Orders page lists all orders made for
MineScape licenses.
To list the licenses for an order, click the Order Number (key) link.

3. Position the mouse cursor over the icon and select License(s).
The License Information page displays. The License Information page lists the licenses that can be
generated for the selected order.
4. Using the available check boxes, select the plugins that require licenses.
Note: It is recommended that you use the Select All/Deselect All check boxes (under Generate) to
select and then deselect all of the plugins. Once all plugins have been deselected, select the plugins
required. This ensures that you are only generating licenses for the plugins needed.
5. Click Generate.
The Generate Licenses page displays.

7
 MineScape License Management Guide

6. Complete the following fields:

• Number of Licenses to Generate - The number of licenses to generate for the selected plugin.
• Composite - The composite host ID of the machine that the licenses will be hosted on. Only one
of the displayed IDs needs to be entered.
• Host Name - The machine's host name without the domain information.
• Port - The port number that the license server will be contacted on. The recommended value is
'27000'.
• Host Description - A brief description to help you further identify the selected machine, for
example, Site A License Server.
The values shown below are only provided as an example.
Number of Licenses to Generate - 1
Composite - D0F9C9C1AAF5
Host Name - A028291
Port -27000
Host Description - MineScape License Server
7. Click Generate.
The View Licenses page displays.
8. Click Save All to save your license file.
Note: Ensure that the license file is available on the license server machine so that the server can be
set up correctly.

To generate a server license for MineScape 5.9 and earlier

1. Log in to the MineScape Software Distribution Site.
2. Click Licensing and Orders.
The Licensing and Orders page displays. The Licensing and Orders page lists all orders made for
MineScape licenses.
To list the licenses for an order, click the Order Number (key) link.

3. Position the mouse cursor over the icon and select License(s).
The License Information page displays. The License Information page lists the licenses that can be
generated for the selected order.
4. Using the available check boxes, select the plugins that require licenses.
Note: It is recommended that you use the Select All/Deselect All check boxes (under Generate) to
select and then deselect all of the plugins. Once all plugins have been deselected, select the plugins
required. This ensures that you are only generating licenses for the plugins needed.
5. Click Generate.
The Generate Licenses page displays.

8
 MineScape License Management Guide

6. Complete the following fields:

• Number of Licenses to Generate - The number of licenses to generate for the selected plugin.
• Ethernet Address - The physical/ethernet address of the machine that the licenses will be
hosted on.
• Host Name - The machine's host name without the domain information.
• Port - The port number that the license server will be contacted on. The recommended value is
'27000'.
• Host Description - A brief description to help you further identify the selected machine, for
example, Site A License Server.
The values shown below are only provided as an example.
Number of Licenses to Generate - 1
Ethernet Address - 00-21-9B-57-3F-5A
Host Name - A028291
Port -27000
Host Description - MineScape License Server
7. Click Generate.
The View Licenses page displays.
8. Click Save All to save your license file.
Note: Ensure that the license file is available on the license server machine so that the server can be
set up correctly.

9
 MineScape License Management Guide

Generate a Nodelocked License

To generate a nodelocked license file, you need to email licensing@dataminesoftware.com with a list of
the machines that require licenses.
The following information needs to be included to generate a nodelocked license for MineScape 5.10
onwards:

Composite The composite host ID of the machine that the licenses will be hosted on. The
HostID composite host IDs can be listed using the MineScapeHostID.exe tool.

Host Name The machine's host name excluding the domain information.

Host Description A brief description to further identify the selected machine.

The following information needs to be included to generate a nodelocked license for MineScape 5.9 and
earlier:

Ethernet Address The physical/ethernet address of the machine that the licenses will be hosted on.
The ethernet address can be listed using the MineScapeHostID.exe tool.

Host Name The machine's host name excluding the domain information.

Host Description A brief description to further identify the selected machine.

Return a Generated License

Activity Steps
1. Log in to the MineScape Software Distribution Site.
2. Click Licensing and Orders.
The Licensing and Orders page displays. The Licensing and Orders page lists all orders made for
MineScape licenses.

3. Position the mouse cursor over the icon and select License(s).
The License Information page displays.
4. Locate the plugin that has a license to return and select the available check box.
Note: It is recommended that you use the Select All/Deselect All check boxes (under Generate) to
select and then deselect all of the plugins. Once all plugins have been deselected, select the plugins
required. This ensures that you are only generating licenses for the plugins needed.
5. Click Return.
The following message is displayed.
License has successfully been returned.

10
 MineScape License Management Guide

Add License File to the License Server

MineScape license files (.lic) need to be stored under the '\licenses\Datamine\' folder of the MineScape
license server installation.
C:\Program Files\Datamine\MineScape License Server\license\datamine\

Note: To support backwards compatibility, license files generated for MineScape 5.9 and earlier need to
be placed under the '\licenses\mincom\' folder. License files generated for MineScape 5.10 through to
MineScape 6.1 need to be placed under '\licenses\abb\' folder.
If more than one license file has been generated for a machine, a copy of the new license file needs to be
placed under '\licenses\datamine\' folder. If required, the license file can be renamed. Duplication within
your license files will be correctly handled by the license system.
The following activity assumes that a MineScape license file has already been generated for the
MineScape license server.

Activity Steps
1. Double-click on the MineScape Licenses desktop icon.
A new Windows Explorer window is opened and it automatically points to the '\licenses\' folder.
2. Copy the license file to the open directory.

Restart the License Server

Activity Steps
1. Open a new internet browser window.
2. Enter the address for the FlexNet License Server Web Interface.
The address is:
http://localhost:<web port>/
where <web port> refers to the Web Port value set during the MineScape License Server
installation. The default web port number is '8080'.
3. Click Administration.
4. Complete the User Name and Password fields.
Note: The default value is 'admin' for both the User Name and Password fields. Login details, such as
user names and passwords can be changed using the User Configuration tab.
5. Click Submit.
If you have not logged in before, the Change Password dialog box displays. Enter the new password
and click Save.
6. Click the Vendor Daemon Configuration tab.
The Vendor Daemons screen displays.
7. Click on the 'Datamine' entry.
The Vendor Daemon:Datamine screen displays.
8. If the license server has not been started, click the Start button. If the license server is already
running, click the Reread License Files button.
The Vendor Daemon screen displays with a Status column of 'RUNNING'.
Note: If the Status column displays a value of 'RUNNING_PENDING', press F5 to refresh the Vendor
Daemons screen.
9. Click Dashboard.
10. Click Concurrent to view the licenses.

11
 MineScape License Management Guide

Frequently Asked Questions

Why am I unable to see licenses that were
previously available?
If you were previously able to check out licenses from your license server but are now unable to display
these licenses, it is most likely that the license server is no longer running. This issue commonly occurs on
laptops that are being used as license servers, as the license server will shut down when a laptop is put
into hibernate and sleep modes.
Note: If you are using a laptop for MineScape, and also have a license server on the laptop for your use,
contact MineScape support to change your license to a nodelocked license. This will remove the need for
a license server on your laptop and stop this issue from occurring.
To determine a resolution, the following steps should be taken:
1. Restart your license server.
2. If this does not resolve the issue, there is a problem with the license server installation.

Can I connect to a license server over a Virtual

Private Network (VPN)?
Yes, as long as the license server is available on the network you are connected to. However, depending
on the connection speed and quality, the performance of retrieving and using licenses may decrease.

Can I run MineScape on a Virtual Machine?

Only MineScape's Design File and Licence servers can be installed and run on a virtual machine.

Can I run virus scanner software and MineScape?

In the event you have a virus scanner and firewall installed on either your license server machine or on
your client machine, it will depend how secure your settings are. You may have to unblock some
executable files (.exe) on your firewall.
Do I need to unblock any executable files for the MineScape installation?
The following executable files should be added as exceptions:
C:\Users\[user]\AppData\Local\MineScape2021\app-
[versions].[build]\MineScape.DiagnosticsTool.exe
C:\Users\[user]\AppData\Local\MineScape2021\app-
[versions].[build]\MineScapeStudio.exe
C:\Users\[user]\AppData\Local\MineScape2021\app-[versions].[build]\mdserver.exe
C:\Users\[user]\AppData\Local\MineScape2021\app-[versions].[build]\serv*****.exe
C:\Program Files\Datamine\MineScape\System Services\Bin\dfserver.exe
C:\Program Files\Datamine\MineScape\System Services\Bin\MineScapeMonitorService.exe
C:\Program Files\Datamine\MineScape\Design File
Server\Bin\DesignFile.DiagnosticsTool.exe
C:\Program Files\Datamine\MineScape\Design File
Server\Bin\DesignFileMonitorService.exe

Note: You may have problems running MineScape successfully if the executables listed above are not
added as exceptions. Contact your local network administrator or support desk before attempting to
modify your firewall settings.

12
 MineScape License Management Guide

Do I need to unblock any executable files for a

License Server installation?
For a MineScape License Server installation, the following executable files should be added as
exceptions:
C:\Program Files\Datamine\MineScape\License Server\ABB.exe
C:\Program Files\Datamine\MineScape\License Server\Datamine.exe
C:\Program Files\Datamine\MineScape\License Server\Mincom.exe
C:\Program Files\Datamine\MineScape\License Server\lmadmin.exe
C:\Program Files\Datamine\MineScape\License
Server\bin\LicenseServer.DiagnosticsTool.exe
C:\Program Files\Datamine\MineScape\License
Server\bin\LicenseServerMonitorService.exe

Note: You may have problems running the MineScape license server successfully if the executables
listed above are not added as exceptions. Contact your local network administrator or support desk
before attempting to modify your firewall settings.

Can the 32-bit license server be used with the 64-

bit version of MineScape?
Yes, the 32-bit version of the license server can be used with MineScape 64-bit and vice versa.

Why is the vendor daemon crashing periodically?

This is a known issue requiring a permanent resolution from Flexera. The current workaround is to
perform the following steps.

Activity Steps
1. Open an internet browser window.
2. Enter the following address:
http://localhost:<web port>/
where <web port> refers to the Web Port value set during the MineScape License Server
installation. The default web port number is '8080'.
3. Click Administration.
4. Complete the User Name and Password fields.
5. Click Submit.
6. Click the Vendor Daemon Configuration tab.
The Vendor Daemons screen displays.
7. Click on the 'Datamine' entry.
The Vendor Daemon:Datamine screen displays.
8. Under Vendor Daemon Log, change Vendor Daemon Log Location to:
C:\Program Files\Datamine\MineScape\License Server\logs\Datamine.log
9. Under General Configuration, change Restart Retries to ‘999’.
10. Click Save.
Note: Restarting the license server service or rebooting the physical machine used as the MineScape
License Server will result in the Restart Retries value defaulting back to ‘10’. This is the default
behaviour implemented by Flexera.

13
 MineScape License Management Guide

Appendix 1: Known SubscribeNET Errors

Incorrect login details
Ensure the user name and password details are entered correctly. Passwords are case-sensitive. A
temporary password can be requested via the Password Finder tool.
https://minescape.flexnetoperations.com/control/minc/password

Appendix 2: Known Download and

Installation Errors
Installation
Another version of this product is already installed
The existing MineScape installation needs to be removed.

Not enough disk space

You need to make more space available on the disk where you are installing the product.

Installation is slow
• Ensure enough RAM is available on the current machine. All open applications should be closed
before running the installation.
• Anti-virus software can result in slow installation speeds and should be temporarily disabled.
Note: Contact your local network administrator or support desk before attempting to disable anti-
virus software.
• Microsoft .NET Framework 4.6.2 and the Microsoft Visual C++ 2015 Redistributable are now
included with the MineScape installer. These components are automatically installed as part of the
MineScape installation process.
Note: In rare cases, Microsoft's KB2999226 update will need to be installed manually on systems
prior to Windows 10 (including Windows Server 2008/2012) before proceeding with the MineScape
and License Server installations. The absence of this update may result in the installation process
hanging for a period of time before reporting a failure to install. The update can be found at
http://support.microsoft.com/kb/2999226.

14
 MineScape License Management Guide

Appendix 3 - Known MineScape Errors

Plugin Listing Problems
If you do not see a list of plugins in the Plugin Manager from a license server, check that the license
server is running.

Activity Steps
1. Click on Control Panel » Administrative Tools » Services and check the lmadmin service on the
license server.
2. If the service is not running, restart it.
3. If the service fails to restart, uninstall and re-install the MineScape License Server software. We
recommend downloading the software from the distribution portal to ensure that you have the
latest version.

Plugin Load Errors

When loading MineScape plugins, there may be instances where you receive an error and the plugin
cannot be loaded.

When a plugin fails to load, the icon is displayed next to the plugin name. To display the error
information for the failed load operation, position the mouse cursor over the icon.

License server system does not support this version of

this plugin
This error is caused because the version of MineScape running is newer than the version specified in the
license file.
When a license file is downloaded, the current maintenance end date for a customer agreement is
encoded into the license file. If an attempt is made to use a version of MineScape that is released after
this end date, the error occurs.
If your maintenance agreement has since been updated, download the license file again and replace your
current license file with the new one. If the problem persists, contact your MineScape support or sales
contact as your license file may not have been upgraded correctly.

License server system does not support this plugin

The error is caused by an incorrect server name being used when creating the license file. The server
name used for the license file must be the server name without the domain.
For example, if you have a license server MACHINE1.TESTDOMAIN on the domain TESTDOMAIN,
when generating your license only specify MACHINE1 as the host name.
Log into the MineScape Software Distribution site and generate a new license file using the correct
server name (minus the domain).

15
 MineScape License Management Guide

Licensed number of users already reached

This error message is displayed when all of the licenses available for a plugin have already been checked
out by other users that are using that license server. One of the other users will have to check their
license back in, so you can use it.

Plugin has expired

This error will occur if you are using an expiring license. This type of license is given for limited use
purposes.

No licenses available to borrow

This error is the same as the error described Licensed number of users already reached, except it occurs
when you are attempting to borrow a license rather than checking it out.

16
 MineScape License Management Guide

Appendix 4 - Known Daemon Issues and

Errors

Vendor daemon crashing periodically

This is a known issue requiring a permanent resolution from Flexera. The current workaround is to
perform the following steps.

Activity Steps
1. Open an internet browser window.
2. Enter the following address:
http://localhost:<web port>/
where <web port> refers to the Web Port value set during the MineScape License Server
installation. The default web port number is '8080'.
3. Click Administration.
4. Complete the User Name and Password fields.
5. Click Submit.
6. Click the Vendor Daemon Configuration tab.
The Vendor Daemons screen displays.
7. Click on the 'Datamine' entry.
The Vendor Daemon:Datamine screen displays.
8. Under Vendor Daemon Log, change Vendor Daemon Log Location to:
C:\Program Files\Datamine\MineScape\License Server\logs\Datamine.log
9. Under General Configuration, change Restart Retries to ‘999’.
10. Click Save.
Note: Restarting the license server service or rebooting the physical machine used as the MineScape
License Server will result in the Restart Retries value defaulting back to ‘10’. This is the default
behaviour implemented by Flexera.

17