Aveva Licensing System

AVEVA Licensing System
v2.0.0.0
AVEVASolutionsLimited
Disclaimer
1.1 AVEVA does not warrant that the use of the AVEVA software will be uninterrupted, error-free or free from viruses.
1.2 AVEVA shall not be liable for: loss of profits; loss of business; depletion of goodwill and/or similar losses; loss of
anticipated savings; loss of goods; loss of contract; loss of use; loss or corruption of data or information; any special,
indirect, consequential or pure economic loss, costs, damages, charges or expenses which may be suffered by the user,
including any loss suffered by the user resulting from the inaccuracy or invalidity of any data created by the AVEVA
software, irrespective of whether such losses are suffered directly or indirectly, or arise in contract, tort (including
negligence) or otherwise.
1.3 AVEVA's total liability in contract, tort (including negligence), or otherwise, arising in connection with the performance
of the AVEVA software shall be limited to 100% of the licence fees paid in the year in which the user's claim is brought.
1.4 Clauses 1.1 to 1.3 shall apply to the fullest extent permissible at law.
1.5 In the event of any conflict between the above clauses and the analogous clauses in the software licence under which
the AVEVA software was purchased, the clauses in the software licence shall take precedence.
Copyright
Copyright and all other intellectual property rights in this manual and the associated software, and every part of it
(including source code, object code, any data contained in it, the manual and any other documentation supplied with it)
belongs to, or is validly licensed by, AVEVA Solutions Limited or its subsidiaries.
All rights are reserved to AVEVA Solutions Limited and its subsidiaries. The information contained in this document is
commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without the prior
written permission of AVEVA Solutions Limited. Where such permission is granted, it expressly requires that this copyright
notice, and the above disclaimer, is prominently displayed at the beginning of every copy that is made.
The manual and associated documentation may not be adapted, reproduced, or copied, in any material or electronic form,
without the prior written permission of AVEVA Solutions Limited. The user may not reverse engineer, decompile, copy, or
adapt the software. Neither the whole, nor part of the software described in this publication may be incorporated into any
third-party software, product, machine, or system without the prior written permission of AVEVA Solutions Limited, save as
permitted by law. Any such unauthorised action is strictly prohibited, and may give rise to civil liabilities and criminal
prosecution.
The AVEVA software described in this guide is to be installed and operated strictly in accordance with the terms and
conditions of the respective software licences, and in accordance with the relevant User Documentation. Unauthorised or
unlicensed use of the software is strictly prohibited.
Copyright 2012 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved. AVEVA shall not be
liable for any breach or infringement of a third party's intellectual property rights where such breach results from a user's
modification of the AVEVA software or associated documentation.
AVEVA Solutions Ltd, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom
Trademark
AVEVA, AVEVA Everything3D and AVEVA E3D are registered trademarks of AVEVA Solutions Limited or its
subsidiaries. Unauthorised use of the AVEVA, AVEVA Everything3D and AVEVA E3D trademarks is strictly
forbidden.
AVEVA product/software names are trademarks or registered trademarks of AVEVA Solutions Limited or its subsidiaries,
registered in the UK, Europe and other countries (worldwide).
3rd Party Software

The copyright, trademark rights, or other intellectual property rights in any other product or software, its name or logo
belongs to its respective owner.
The following 3rd party software is included in some of the AVEVA products contained in this Online Help:
Based on Teigha from the Open Design Alliance.
Microsoft Office Fluent user interface. Fluent is a trademark of Microsoft Corporation and the Fluent user
interface is licensed from Microsoft Corporation. The Microsoft Office User Interface is subject to protection under
U.S. and international intellectual property laws and is used by AVEVA Solutions Limited under license from
Microsoft.
DevExpress redistributables are used by AVEVA under license from Developer Express Inc. Copyright 2000-
2014 Developer Express Inc.
3D input device development tools and related technology are provided under license from 3Dconnexion.
3Dconnexion 1992 - 2013. All rights reserved.
AVEVALicensingSystem
Revision Sheet
Date Version Comments / Remarks

July2015 2.0.0.0 Support section added. Various minor corrections and updated
screenshots
AVEVALicensingSystem
Contents Page

v2.0.0.0
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
Client Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1
How License Server Details Are Configured . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:1
Update a Workstation already Configured with AVEVA FlexMan Licensing . . 2:2
Configure a Workstation using the AVEVA Licensing System Client Configura-
tion Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:2
AVEVA License System Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1

Install the AVEVA Licensing System on a Clean Host . . . . . . . . . . . . . . . . . . . . 3:1
Install the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1
Choose and Set the Server Port Numbers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:2
Console Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Query/Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1
Start/Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:3
Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:4
Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:9
Group Reservations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1

Reservation File Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1
Creating the Reservation File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:2
Copyright 1974 to current year. i 2.0.0.0

AVEVA Solutions Limited and its subsidaries.
All rights reserved.
Three Redundant License Servers . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1

Setting up the Redundant License Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1
Configuration and installation of the Three Redundant Server License File . . 6:2
RULES SERVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7:1

RULES System and Port Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7:1
RULES Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7:2
Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:1

What should I do if the error "AVEVA Installation Error, Exiting!" is displayed? .
8:1
How to generate the ALS Server Locking Criteria? . . . . . . . . . . . . . . . . . . . . . . 8:2
What should I do if AVEVA-Server-name-info.txt file does NOT have a UUID? 8:2
What should I do if AVEVA-Server-name-info.txt file does NOT have an Ethernet
address? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:3
What should I do if I get the error 'locking-code mismatch' during the license file
installation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:5
Where is the composite locking criteria code in ALS license file? . . . . . . . . . . 8:5
How can I check the machine is in the same state as the license code? . . . . . 8:5
How to check that the output from echoid.exe is the same as from running
Wechoid.exe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:6
What should I do if I get the error 'locking code mismatch' during the license file
installation even though I specified the correct values? . . . . . . . . . . . . . . . . . . 8:7
How do I specify all TCP and UDP ports for ALS through a firewall?. . . . . . . . 8:8
How can I see users accessing my ALS/RMS license server? . . . . . . . . . . . . . 8:9
What should I do if FLEXlm lmstat-a does not show new RMS secured products
usage? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:12
How do I perform a silent installation of the ALS Client configuration Tool? 8:12
What should I do if I get Error [18] when I run the RMS license secured products
(ex. Aveva E3D)? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:13
Why I am getting Error 8 in the Flex license secured products? . . . . . . . . . . 8:13
Why I am getting Error -21 in the Flex license secured products? . . . . . . . . . 8:14
What should I do if get the error 'Aborting Installation' when I try to install the li-
cense file?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:14
What should I do if I get the error 'Permission Problem' when try to set the
port@hostname in the ALS client config tool? . . . . . . . . . . . . . . . . . . . . . . . . . 8:14
Copyright 1974 to current year. ii 2.0.0.0

Having issues in running the products when connected to VPN? . . . . . . . . . 8:16

Why I am getting Error [18] and Error (-602) after revoking the licenses? . . . 8:17
How do I know that my server is counting down five days to revoke? . . . . . 8:18
List of Error Codes -601 to -610 displayed by the Flex clients . . . . . . . . . . . . 8:20
Copyright 1974 to current year. iii 2.0.0.0

Copyright 1974 to current year. iv 2.0.0.0

Introduction
1 Introduction
The AVEVA Licensing System (ALS) uses Dual License Server technology (DLS) that
consists of two individual license servers based on different proprietary technologies:
1. A Rights Management System (RMS) license server provided by SafeNet that serves
licenses for newer products (e.g. E3D).
2. A Flex license server provided by Flexera that serves licenses to older products (e.g.
PDMS).
The RMS and Flex license servers work in a cooperative manner that effectively allows the
delivery of licenses from a single "pool" of licenses. This means that different applications
that are licensed with the different technologies are able to share those license features.
This is of particular benefit when customers use different versions of the same application,
some of which are licensed with RMS, and some that are licensed with Flex.
This benefits customers by allowing them to license their products without having to
purchase duplicate sets of licenses for each license server.
The following diagram shows a typical ALS configuration using the default license server
ports:
Copyright 1974 to current year. 1:1 2.0.0.0

Introduction
The ALS consists of the following components:
RMS License Server: Services license requests from RMS-enabled applications.
RMS License File: Contains the licenses that can be served by the RMS License
Server.
Usage Log: A log file written by the RMS License Server that contains
details of license check-out and check-in operations
performed by RMS-enabled applications.
Flex License Server: Services license requests from Flex-enabled applications.
Flex License File: Contains the licenses that can be served by the Flex License
Server.
Debug Log: A log file written by the Flex License Server that contains
details of license check-out and check-in operations
performed by Flex-enabled applications.
RULES License Server Services license requests for RULES-enabled applications

(Reserved User Licensing Enforcement System; Refer to
RULES SERVER for further information).
RULES Log A log file written by the RULES server.
You will also notice that there are two ports configured in the ALS: one port is used by the
RMS License Server and one by the Flex License Server. The use of two ports is required
because it is not possible for the two license servers to share the same port.
Dual License Server Operation

The ALS uses Dual License Server technology to allow applications that use the different
RMS and Flex licensing technologies to share license entitlement. This has been achieved
by configuring the Flex License Server so that it notifies the RMS License Server with
details of the licensing activities of the Flex-enabled applications as and when they occur.
The RMS License Server effectively "controls" the Flex License Server and its clients by
allowing or disallowing Flex license check-out and check-in operations based on the
licenses present in the RMS license file.
Log Files
The contents of the RMS Usage Log file, the Flex Debug Log file and the RULES log file,
reflect the operations of the RMS and Flex clients.
Important: The DLS functionality means that the RMS Usage Log also contains the details
of the Flex licensing operations.

Introduction
ALS Windows Services

The three ALS license servers are configured to run as Windows Services. They can be
identified by the following names in the Windows Services panel:
RMS License Server: "Sentinel RMS License Manager_AVEVA"
Flex License Server: "AVEVA DLS Flex Server"
RULES License Server: AVEVA RULES Server
AVEVA License System Console

Previously AVEVA license server software has been managed using the proprietary tools
supplied by the licensing software vendors (typically Flexera). The ALS now consists of two
different licensing technologies and so there is no single toolset that will adequately manage
the ALS as a single unified system.
Further complexities also arise because of the need for two separate license files: in order
for the ALS to function correctly the RMS and Flex license files must be aligned with the
same license entitlement otherwise denial of service can occur.
To make sure that the ALS can be correctly and easily administered an AVEVA License
System Console has been provided that grants easy access to the administrative tasks
most customers are likely to undertake and presents the two underlying licensing systems in
a unified fashion. The ALS Console provides easy access to the following functionality:
Starting/Stopping the ALS
ALS Server Status Query
License File Installation
Server Port Configuration
Client Configuration Tool

The Client Configuration Tool has been provided to enable client PCs to be easily
configured with details of up to three license servers.
Note: The ALS has been specifically designed so that existing FlexMan clients do not need
to be reconfigured if the ALS Server is installed using the detail port settings.

Introduction

2 Client Configuration Tool
The AVEVA Licensing Client Configuration Tool is used to configure a workstation so that
licensed applications can locate up to three license servers where they can obtain the
licenses required to function.
The Client Configuration Tool also allows configuration of a network timeout setting that can
be used to tune performance on networks that offer intermittent connectivity to a license
server. For example, a license server is located on a remote site.
The Client Configuration Tool will usually only need to be used once when installing the first
AVEVA application, however it may be necessary to run it again if the license server
configuration changes.
Important: Before attempting to configure a workstation you must know the hostname and
port number of each license server that is intended for use. If the user does not
have this information, contact the organisation's system administrator or IT
department.
2.1 How License Server Details Are Configured

License servers are identified by a hostname and a port number and this information must
be configured so that the users applications can function. The system administrator should
be able to advise the user of the correct hostnames and port numbers of license servers.
The license server configuration for a workstation is set using the environment variable
AVEVA_LICENSE_SERVER_LIST. An environment variable is used as it permits users to
configure applications to use different license servers by overriding the default workstation
setting in a batch file.
License server host details are configured in the following format:
<port>@<hostname>
Where <port> is the port number used by the license server and <hostname> is the
hostname or IP address of the host on which the license server runs. A typical entry would
look like this:
4545@licserver
Multiple license servers can be configured by separating the details of each license server
host with a semi-colon character (';'):
<port1>@<hostname1>;<port2>@<hostname2>;<port3>@<hostname3>
A typical multiple server entry would look like this:
4545@licserver1;4545@licserver2;4545@licserver3

2.2 Update a Workstation already Configured with

AVEVA FlexMan Licensing
If a workstation is already configured to use FlexMan licensing then you will not need to
reconfigure it, if, the new license server is installed on the same host as the original FlexMan
license server and the new license server is configured to use the default port number of
4545.
Applications that support the AVEVA Licensing System will automatically detect and use
FlexMan license server settings if the workstation has not been configured to use the
AVEVA Licensing System.
2.3 Configure a Workstation using the AVEVA Licensing

System Client Configuration Tool
Although the license server configuration can be set manually the ALS Client Configuration
Tool has been provided to make the task easier. Below is a screenshot of the tool:
The tool allows the configuration of the license server and timeout for the currently logged in
Windows user (via the User Environment settings) or for all users on the workstation (via the
System Environment settings).
The FlexManConfig button will launch the FlexManConfig client configuration tool so that
the workstation can be configured so applications licensed with FlexMan can be used.

3 AVEVA License System Console
The AVEVA License System Console, or ALS Console, is a tool for the customer's system
administrator who will manage the AVEVA licenses. The system administrator is not to be
confused with the AVEVA License Administrator, who supplies licenses, or the customer
end user, who consumes licenses.
If the system administrator is unfamiliar with the AVEVA Licensing System (ALS) refer to
Introduction as it provides an explanation of the ALS and how it works.
The ALS consists of three separate license servers that run cooperatively. Due to the
complexity of configuring the three separate license servers so that they can operate
together a dedicated utility has been provided called the AVEVA License System Console.
The AVEVA License System Console is an easy-to-use GUI that can be used to perform
tasks such as license file installation and stopping and starting the license system.
While it is possible to manually configure the ALS by directly editing configuration files
AVEVA strongly recommends that only the AVEVA License System Console is used to
administer the ALS.
3.1 Install the AVEVA Licensing System on a Clean Host

Installing the ALS Server package is straightforward: the only installation option that can be
changed is the installation directory. Once the server package has been installed it is only
necessary to do the following:
1. Install the license file.
2. Configure the server port numbers used by the RMS and Flex license servers.
3. Optionally configure the workstations.
The following sections provide guidance about how to perform these tasks.
3.1.1 Install the License File

The ALS license file consists of various parts that must be installed using the AVEVA
License System Console. The AVEVA License System Console will automatically shutdown
the license servers, install the RMS and Flex license files, and then restart the servers
automatically.

3.1.2 Choose and Set the Server Port Numbers

After the ALS has been installed it is configured to use the following default ports:
RMS Server: Port 4545
Flex Server: Port 744
RULES Server: Port 4546
AVEVA recommends that the default ports are used if possible. If the user does not want to
use the default ports then they can be changed as follows:
RMS Server: a new port number can be entered via the "Edit Configuration" dialog
accessible via the Query/Configure tab.
Flex Server: a new port can be specified by editing the last field on "SERVER" line
in the Flex license file. An editor (notepad) can be started by clicking
View License File on the Licenses tab).
RULES Server: Always uses the port number after that of the RMS Server.
If AVEVA applications have previously been installed it is highly recommended that the
system administrator uses the same port numbers configured in the workstations that run
the AVEVA applications. To find out these port numbers implement the following:
For workstations running AVEVA applications that are licensed with the ALS run the
ALSconfig.exe tool.
For workstations running older applications that are licensed with the FlexMan
licensing system run the FlexManConfig.exe tool.
When the license server port numbers have been set, the workstations that run the
applications need to be configured so that they can locate the license servers. To do this run
either ALSClientConfigTool.exe or FlexManConfig.exe depending on whether the
applications are licensed with ALS or FlexMan.
Important: If the workstations are already configured with settings for a FlexMan license
server the user can avoid the need to reconfigure the workstations if they do the
following:
1. Install the ALS on the same host as the old FlexMan server (which must be
uninstalled first).
2. Use the default RMS port number 4545.
New applications that are licensed with ALS RMS will automatically use the older FlexMan
settings if no ALS settings are configured. In these circumstances applications will attempt
to communicate with an ALS RMS server on port 4545 on the same host as the configured
FlexMan server host. For example, if there is an existing FlexMan server on a host called
"myhost" and the workstations are configured with the FlexMan setting "744@myhost" the
system administrator can install the ALS server on myhost, set the RMS server port to 4545
and then install the ALS-enabled applications on the workstations without the need to
reconfigure them.

Console Tool
4 Console Tool
The Console Tool consists of three tabs:

Query/Configure: query the server status, view log files, edit license server
configuration.
Start/Stop: start and stop the license servers.
Licenses: install license files and product entitlement, view individual license files.
4.1 Query/Configure
The Query/Configure tab displays the following window:
Query Licensing System

Upon clicking Query the status bars are updated to show the current status of each license
server, whether a server is running, down, or not installed.
Note: The status boxes are not updated dynamically and so users should update the status
by clicking Query when appropriate.
View Log
1. Use the radio buttons to select the license server log file required to view, then click
View Log File: a new window is displayed listing the contents of the license server log
file.

Console Tool
2. If RMS is selected then an additional window before the log file is displayed that allows
the user to choose whether to view the default anonymised log or view a de-
anonymised log file that displays the proper user, host, and display names.
Configure Licensing System

1. Use the radio button to select either RMS or Flex and click Edit Configuration.
2. If RMS is selected the following window is displayed:
Server and License File Location: displays the path of the RMS license server and
license file. This setting cannot be changed.
Server Port: allows the RMS server port to edited.
Network Buffer: The Network Buffer Size Multiplier is a network tuning parameter that
enables the size of the RMS network buffer to be increased. The value is used as a
multiplier for the existing Windows default buffer size which can vary from system to

Console Tool
system (although for most systems it is usually 8 kBytes). Consequently, the actual
buffer size used by the RMS server will not be known until the RMS server is started.
Once started, the RMS server will write an event to the Windows Application Event log
recording the actual size of the network buffer used.
Sites with a large number of users or with a heavily loaded network can experience
instances of their AVEVA applications reporting "error 5". "Error 5" errors indicate that
an application did not receive a response from a license server within the expected
timeframe. This error can occur for several different reasons, however on sites with
many users and/or with heavily loaded networks this problem can be mitigated by using
this setting to increase the size of the socket buffer used by the RMS server.
There is no guidance available as to what value should be used for any given site as a
suitable value needs to be determined by analysis of the site operating environment. It
is therefore strongly recommended that this value is only configured after having
consulted the AVEVA Licensing Department.
WARNING: setting this value to too high a level can impact performance, especially
when using a license-server-list.
Usage Log File: Allows the usage log file name and directory to be configured.
Note: The usage log file name cannot contain three or more continuous underscores.
Clicking Apply validates the entries made on the form and applies the updates to the
configuration.
3. If Flex is selected in the radio button, an Edit Flex Configuration window is displayed
where the Flex Server Port can be changed. If the Edit button is selected here the Flex
configuration file (%AVEVA_LICENSING%\Flex\cadcentre.opt) will be opened in
Notepad. The user can then edit the file and save it as appropriate.
Note:
No validation is carried out if the user has changed the Flex configuration file.
The changes in the RMS log file configuration would only be visible once the ALS
console is restarted.
Support
Creates a directory that can be sent to AVEVA when a licensing support issue is raised.
Refer to Support for further information.
4.2 Start/Stop
The Start/Stop tab allows the user to start or stop the license servers. The window below
the button shows the results of the commands that are used to start or stop the servers so
that any errors can be seen.
Note: It is not possible to stop or start just one license server.

Console Tool
Start Licensing System: Starts the RMS license server, the Flex license server and the
RULES Server.
Stop Licensing System: Stops the RMS license server, the Flex license server and the
RULES Server.
Support
4.3 Licenses
The Licenses tab displays the following window:

Console Tool
View License File

Use the radio button to select the license file to view and then click View License File to
display the appropriate license file.
Install License
1. Browse to locate the license file.
2. Click Install License File.
3. Click Start License File Installation.
4. Click Yes in the Warning message window.
The licenses in the license files are installed, the license servers are restarted and a
successful message is displayed to the user.

Console Tool
Note: Backups of existing license files will be created.
Note: The check and install of the license file will be written to a Console.log file. This is
stored in the default folder C:\AVEVA\AVEVA Licensing System. If there are any
issues in installing the license file using the AVEVA License System Console then
send the Console.log to the AVEVA Support Team.
Entitlement/Revoke
Clicking View Entitlement/Revoke opens a new window that allows the user to view the
licenses and products that they have licenses for. The window displays the amount of
licenses available in a chronological graph to make it easy to visualize the licenses.
Operations
1. The product mapping file is located at the following location:

Console Tool
%AVEVA_LICENSING%\ProductMaps
2. The list of products in the product mapping file are listed on the left screen in a tree
format.
3. On expanding the node for a particular product, all the features belonging to that
product are listed.
4. On expanding each feature, the list of licenses in that feature are listed. For example in
the above screenshot, the following are the products and features read from the
product mapping file:
Product Features
AVEVA PDMS Design-Platform, Isodraw, PDMS, Desi-

Pipefab
5. Continuing with the above example, Feature PDMS has two licenses (Lic0 and Lic1),
each for 10 seats, making a total of 20 seats. When a specific feature is selected, the
entitlements for that feature are displayed on the right side of the dialog.
6. The date range on X axis includes all the licenses for that feature (From earliest start
date to latest end date).
7. The horizontal bars are specific to each license.
8. The vertical bars indicate the total entitlements for all the licenses (of that feature) at a
particular date.
Revoking Entitlements
The Revoke process consists of following steps:
1. Select one of the following options available in the View entitlement Screen
Re-Host Some Licenses

Re-Host All Licenses
2. Once the user clicks on Re-Host Some License/Re-Host All Licenses the options
are disabled.
3. If Re-host All Licences is clicked the following window is displayed:
The user needs to check all three check boxes to proceed.

4. If the user chooses Re-host Some Licenses, the following window is displayed.

Console Tool
The user needs to check the two check boxes to proceed.

5. Once the user has confirmed and clicked Next, the AVEVA License System Console
tool performs the revocation of all the licenses.
On successfully revoking the licenses, one of the following two message are displayed.
Re Host All Licenses
Re-Host Some Licenses
The options disabled earlier can be enabled again by clicking on any product or feature on
the left side of the screen.
On successful revocation, the AVEVA License System Console tool saves the binary data of
Revocation Certificate and that of the Permission Ticket in form of an XML file.

Console Tool
The AVEVA License System Console tool prompts the user to send this file back to AVEVA
as proof that the licenses were indeed revoked.
Note:
The AVEVA License System Console tool revokes all the licenses from the machine
irrespective of the option chosen Revoking Entitlements. The only difference will be the
in the message displayed.
The value for Deferred Revocation Days is read from the Private Vendor Info of AVEVA
"Meta Data License" which should be available on the license server. In case it is not
present or the value of Deferred Revocation Days defined in the license is not valid
(outside 1-30), a default value of 5 days is used.
Support
4.4 Support
Clicking on Support from the main application opens a form that helps the user create a
support bundle consisting of a collection of licensing-related files from the license server
that may be relevant to any issue or query the user has. This facility creates a directory that
can be easily zipped up and sent to AVEVA when a licensing support issue is raised.

Console Tool
The set of check-boxes on the left list a set of commonly collected files and system
information that is likely to help with any support issue. By default, all these standard items
are selected. Any items that are not wanted can be excluded by deselecting.
Additional files such as screen shots or older logs can be added by clicking Add. Each
added file will be listed on the right-hand side.
Clicking Generate Bundle will generate a new dated folder located in
%AVEVA_LICENSING%\SupportBundle. All the selected items and additional files will be
copied into this folder, ready for zipping and sending to AVEVA support. The location and
contents of the bundle will be confirmed by a dialogue as follows; any issues in locating
requested files will be indicated with error messages.

Console Tool
The user can navigate to the latest folder generated by clicking Explore Bundle Directory.
A fresh folder is generated each time Generate Bundle is clicked. This is intended to make
it easy to collect data at various points in a sequence of steps that are being followed to
reproduce a problem. For example, if a problem occurs after starting an application and
accessing a particular piece of functionality the following workflow could be used to produce
three separate support bundles, one before the application is started, one just before the
problem occurs, and one after the problem has occurred:-
1. Start the AVEVA License System Console and open the Support bundle form.
2. Select the files to be included in the bundle.
3. Click Generate Bundle. This will create the first bundle.
4. Start the application.
5. Click Generate Bundle. This will create the second bundle.
6. Access the suspect piece of functionality.
7. Click Generate Bundle. This will create the third bundle.
All three bundles can then be easily zipped up and sent to AVEVA Support for analysis.

Console Tool

Group Reservations
5 Group Reservations
Group reservations are used to restrict the right to run applications for particular users,
computers, or groups. Selected users can be allowed to run certain applications or can be
prevented from accessing applications. This can be used as an additional security measure
and help to balance application usage when the administrator wants to prevent users from
running applications on heavily loaded computers or file servers.
This feature gives the administrator the ability to exercise local administrative controls by
associating a series of groups with each feature and reserving for each group a certain
number of license tokens. Any remaining license tokens are not specifically reserved and
can be used by anyone.
Note: The group reservations capability is only meaningful with a network License
Manager. However, it is not supported when the redundant License Manager pool is
set up.
5.1 Reservation File Characteristics

The reservation file tells how many license tokens are reserved for members of different
groups. For example, the Sales department could be a group with ten members for which 15
license tokens are reserved. The members might be network users or specific computers on
the network. The reservation file might also tell that certain members of the group are
excluded from taking license tokens.
When the License Manager receives a request, it checks whether the user making the
request belongs to a group. If so, and license tokens are available for that group, the
License Manager will issue the token(s) and decrement the token count on the License
Manager. Otherwise, requests will be serviced with tokens that have not been reserved and
that are available.
The following apply to groups:
A maximum of 256 groups, each with 1000 members are supported.
Groups must be mutually exclusive. Different groups for the same feature must not
have common users or computers.
Group names and member names cannot exceed 64 characters each.
The number of license tokens reserved for a feature cannot exceed the number of
concurrent copies specified in the license code for that feature. If the number of license
tokens reserved is greater than the number of concurrent copies specified for the
feature in the license code, the number of tokens specified in the license code will be
used.
To exclude all members of a group from using license tokens for a feature, specify 0
tokens.

Group Reservations
5.2 Creating the Reservation File

1. Start the WlmAdmin tool and select Reservation File from the Edit menu.
2. To make a new reservation file, select New from the File menu or select Open to edit
an existing reservation file.
3. To add user definitions for license tokens, select Add from the Feature menu. The Add
License Reservation Wizard is displayed.
4. Click Next. Enter the feature name=XXX, feature version =1.0 and click Next.
Note: Do not populate the Capacity field.
5. Enter a Group name and the number of Tokens to reserve for that group.

Group Reservations
6. After specifying the above details the Wizard prompts the user to specify the members
of the group. Click Add to add a member.
7. Enter the Name of the Member, then select User or Machine and select Included or
Excluded to specify whether member is allowed or not allowed to run the application.

Group Reservations
8. Click OK to finish the definition.

9. If required, click Remove All to remove all the members or select a specific member
and then click Remove.
10. Click Finish to return to the main screen, the groups and members are updated on the
WLSGRMGR main screen.
11. Once at least one feature has been defined, the user can define another group to use
that feature. To add a new group select Add from the Group menu. Do not add the
same users or computers to different groups using the same feature.
12. Click Save to save the settings: a reservation file 'lsreserv' is created in the My
documents folder that is 'C:\Users\Administrator\Documents\SafeNet Sentinel\Sentinel
RMS Development Kit\Tools'.
13. Copy the 'lsreserv' file into the RMS folder that is 'C:\AVEVA\AVEVA Licensing
System\RMS' and rename it lsreserv_AVEVA.

Group Reservations
14. To save the file directly into the RMS folder 'C:\AVEVA\AVEVA Licensing
System\RMS\', click Save As.
Or
If the user copies the reservation 'lsreserv' file to another folder other than RMS folder then
an environment variable needs to be set, that is Variable Name = LSRESERV_AVEVA and
Value = The folder path to the lsreserv file. Ex. 'C:\AVEVA\AVEVA Licensing
System\RMS\Testing\lsreserv'.

Group Reservations
15. Once the environment variable has been set, restart the License Server using the
AVEVA License System Console.
16. The number of licenses reserved for the particular feature can now be viewed using the
WlmAdmin tool.

Group Reservations
17. If the user runs a RMS secured program, for example AVEVA E3D which has been
reserved and its usage restricted, the following error message is displayed.
18. If the user runs a Flex secured program, for example Hull Design or PDMS 12.0 which
has been reserved and its usage restricted, the following error message is displayed.

Group Reservations
Sample Reservation file contents:

AVEVA201,1.0:Test:1:User1 !User2
This means:
Feature Name - Aveva201
Feature Version - 1.0
Group Name - Test
No of Seats Reserved - 1
License Reserved for the user - User1
License disallowed for the user - User2

Three Redundant License Servers
6 Three Redundant License Servers
To work with the redundant license model, a License Server pool needs to be set up. The
primary License Server in the pool is designated as the leader; the remaining License
Servers become followers. As long as the primary License Server is up, all the tokens
remain with the leader License Server and are not distributed among other License Servers
in the pool.
How it works
A client sends a license request to the primary License Server.
The primary License Server establishes a connection with the client and grants the
license after successful authentication.
When the primary License Server (leader) goes down, the next leader takes over: the
follower License Server having the highest precedence.
The follower License Server then itself maintains the information and fulfils the new
license requests seamlessly (as long as licenses are available).
If the primary License Server (the old leader) comes up, it reclaims leadership and the
control is transferred back to the primary License Server.
6.1 Setting up the Redundant License Servers

The following requirements and recommendations are for system administrators:
1. First, select the computers on which the License Servers will reside.

2. Various factors, including network performance, affect this decision. Because the
leader must communicate with all other redundant License Servers, the leader should
be in an area of the network with good bandwidth.
3. The system administrator must define at least three redundant License Servers. If the
pool is set up with only a single server, the redundant server pool will never be formed.
4. A License Server can exist only in one license pool.
5. Each computer on which a redundant License Server resides must have a static, fixed
IP address. Therefore, do not use DHCP to dynamically allocate IP addresses for those
computers.
6. Reverse DNS resolution is necessary for the redundant License Server setup.
7. Make sure to specify the IP addresses in either IPv4 or IPv6 format. A redundant pool
cannot have mixed servers (both IPv4 and IPv6). Consequently, a redundant server
can work either in IPv6 or IPv4 mode-as long as the server is running or not removed
from the redundant pool.
8. After deciding the License Servers for redundant setup, obtain their locking codes and
pass them to the AVEVA license administrator.
9. Setting up the redundant License Servers requires access privileges to all the
computers and areas of the network on which License Servers are to be installed. If
changes are made to the redundant license file, those changes will not be transferred
to all License Servers in the redundant License Server pool unless network and write
access to each of the redundant License Server computers is allowed. If any of these
computers run Windows, the system administrator must have administrator privileges
to make changes that affect the License Servers on those computers.
10. The License Servers in the redundant License Server pool must have the same
version.
11. The License Servers must preferably be running on the same platforms (such as,
Windows only).
6.2 Configuration and installation of the Three

Redundant Server License File
1. Install the ALS on all the machines of a License Server pool.
2. Generate locking information file on all the machines by double clicking on the AVEVA-
locking.bat file. The bat file can be found in the Aveva\Aveva Licensing
System\RMS\Tools\ folder.
3. Send all the locking information files to the AVEVA license administrator and specify
which machines are to be the primary (leader), secondary, and tertiary license servers
in the License Server pool.
4. Save the license file received from the license administrator in the primary (leader)
server machine.
5. Run the AVEVA License System Console to install the license file on primary (leader)
server. This can be found in Start > All Programs > AVEVA > Licensing System >
Aveva License System Console.

6. Click Licenses tab.

7. Click Browse and select the license file.
8. Click Install License File.
9. Enter server host names and IP addresses of the system (The IP addresses are
populated automatically but should be double-checked as some hosts can have
multiple IP addresses).
Note: Server details should be entered in the same order as you requested the license file
(refer to 3.) that is leader first and followed by secondary and tertiary server details.
10. Click Continue.

11. Click Start License File Installation in the install Aveva license file window.
12. Click Yes in the confirmation window.
The license file installation status success/failure is displayed in the install Aveva license
file window.

Note: The checks and installation details of the license file are written to a Console.log file
and it is stored in the default folder (C:\AVEVA\AVEVA Licensing System\). If there is
a failure in the license file installation then send the Console.log file to the AVEVA
license administrator or AVEVA support engineer.
13. Once you have successfully completed the license installation procedure on the
primary server, the following files will have been created in your AVEVA licensing
installation (by default C:\AVEVA\Aveva Licensing System).
C:\AVEVA\AVEVA Licensing System\RMS\lservrlf_AVEVA.
C:\AVEVA\AVEVA Licensing System\Flex\licenses.lic.
14. You must copy these files to the same directories in your secondary and tertiary
servers.
15. Once you have copied the license files, restart your license services by using the Stop/
Start buttons provided in the ALS Console.
Important: You must ONLY perform the license installation procedure (from 5. to 12.) on
the PRIMARY server, and copy the generated files onto the secondary and
tertiary servers as described. If you perform the license installation procedure
on the secondary or tertiary servers, the licensing system will fail to function
correctly.

RULES SERVER
7 RULES SERVER
The RULES system provides support for a new AVEVA licensing model called "Named User
Licensing". Named User Licensing differs from the floating license model in three major
aspects:
Licenses are restricted to a specific number of named users.
Licenses are locked to a specific user for 30 days from "first use".
Locked licenses can be used by a user on a limited number of devices.
The named users are identified automatically by the RULES server as the first users to
request a license. Once all the licenses are in use, no further users can connect until the
end of the 30 days period for one of the licensed users.
In effect, this is a form of reserved user licensing, hence the acronym: RULES - Reserved
User Licensing Enforcement System. The RULES system is only available with the AVEVA
Insight product at the moment and so users of other products are not affected by the RULES
system and can ignore any RULES-related issues.
The RULES system introduces the following components to the ALS:
A license server, AVEVA_RULES_Server.exe. This server must be running in order for
RULES-enabled applications to function.
Support for starting and stopping the RULES server has been added to the core ALS
Console functions, as well as the ability to view the RULES server log file.
A directory, %AVEVA_LICENSING%\RULES, that contains applications and files that
support the RULES functionality.
7.1 RULES System and Port Configuration

The operation of RULES is fully automatic and no configuration is required by the user.
RULES obtains its operating parameters directly from the RMS license system and so there
are no additional duties for an administrator other than opening a port for the RULES server
on the system firewall.
The RULES server uses its own port to communicate with RULES applications (for
example: AVEVA Insight). The port number is derived from the RMS server port number
thus: the RULES server will use the next highest port after the RMS server port (as defined
by the LSPORT_AVEVA environment variable). For example, if the RMS server is
configured to use port 4545, then the RULES server will automatically use port 4546. The
RULES port number cannot be set independently of the RMS port number.

RULES SERVER
7.2 RULES Client Configuration

RULES clients automatically determine the RULES server port number by using the same
calculation as the RULES server, that is they will use the configured RMS server port
number plus 1.
For example, if a client is configured with a server setting of 123@myServer, then the
RULES client attempts to communicate with a RULES server on port 124 on server
myServer. If the ALS client is already configured to the RMS server port then there is no
need to change the client settings.
Example: In ALS client configuration tool, the administrator needs to mention the RMS
server port (by default 4545) and license server name, that is 4545@servername. The
RULES client then automatically talks to the RULES server on port 4546.

Frequently Asked Questions
8 Frequently Asked Questions
To help troubleshoot any problems AVEVA have complied a list of frequently asked
questions.
8.1 What should I do if the error "AVEVA Installation

Error, Exiting!" is displayed?
When running the AVEVA License System Console for first time, the following error - AVEVA
Installation Error, Exiting! is displayed:
This can happen on Windows servers. It is a Windows timing problem, the installer has set
an environment variable but its value has not yet to be populated in the menus. As a result,
various workarounds are available.
Wait for a few minutes and try again
or (reboot) machine
Or

Navigate to the environment variable, select 'AVEVA_LICENSING' > Click Edit then click
OK to set it again.
8.2 How to generate the ALS Server Locking Criteria?

Run the AVEVA-Locking.bat file, this can be found in the path 'C:\AVEVA\AVEVA
Licensing System\RMS\Tools'. This creates a file called AVEVA-Server-HOSTNAME-
info.txt.
Email this file back to the AVEVA License Administrator along with the server product
requirements.
The license administrator will in turn return a license file for that server.
8.3 What should I do if AVEVA-Server-name-info.txt file

does NOT have a UUID?
When running the AVEVA-locking.bat file the AVEVA-Server-name-info.txt file does NOT
have a UUID listed. See the following example:

Sentinel RMS Development Kit 8.5.3.0020 Host Locking Code Information Utility Copyright
(C) 2012 SafeNet, Inc.
IP address : 192.168.200.56
Disk ID : 0xCD341ADF
Host name : UKCAMD3903
Ethernet address[1] : 18-A9-05-C2-37-21
Hard Disk Serial[1] : 9VMC5AEK
CPU Info String : GenuineIntel Intel(R) Core(TM) i7 CPU Q 740 @ 1.73GHz

6 14 5
UUID : (This is returned Blank No UUID listed)
This sometimes happens on Windows 2003 servers if the ALS system has been installed
and the system has NOT been re-started.
If the server is restarted, then run the AVEVA-locking.bat file a UUID value is returned. A
UUID value is required in order to obtain a license from AVEVA that will work.
8.4 What should I do if AVEVA-Server-name-info.txt file

does NOT have an Ethernet address?
When running the AVEVA-locking.bat file the AVEVA-Server-name-info.txt file does NOT
have an Ethernet address listed. See the following example:
IP address : 192.168.200.56
Ethernet address[1] : (This is returned Blank No Ethernet address)

6 14 5
UUID : BD5E286E-30D0-11DF-BBDA-05C2372118A9
In the registry the first network card listed has a blank in it, or is a network card that RMS
does not use, for example a Phone card/mini network card. When this happens instead of
looking for the next entry echoid/wechoid stops and returns a blank. To fix this problem what
the user must do is carefully edit the registry and move the first network card entry to the
bottom of the list, thus enabling the echoid/wechoid programs to pick up a valid Ethernet
address and list it.
Open the machine registry and navigate to:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\NetworkCards

The following example shows a blank entry:-
To move the blank or problem network card to the bottom of the list, rename the number to a
higher network card number than the last one in the list.
In this example, it is renamed to 91 but it could have been 12.
Once the entry has been changed, the list refreshed, the registry closed and the AVEVA-
locking.bat file run, the AVEVA-Server-name-info.txt file output contains an Ethernet
address listed. See the following example:

Sentinel RMS Development Kit 8.5.3.0020 Host Locking Code Information Utility
Copyright (C) 2012 SafeNet, Inc.
IP address : 192.168.200.56

6 14 5
Now a license file can be requested using that Ethernet address.
Note: If the license file is requested with that network card active, when the returned
license.xml file is to be installed, it MUST be installed with that same network card
active.
8.5 What should I do if I get the error 'locking-code

mismatch' during the license file installation?
This means that the locking criteria supplied to AVEVA to generate the license do not match
the current hardware characteristics of the license server. A customer's license can be
locked to many criteria, and only the license administrator can inform the user of the criteria.
8.6 Where is the composite locking criteria code in ALS

license file?
The first set of lines in the license.xml file starting with the RMS license file version (15) all
have the same locking code starting with *.
The following example code comes just after the NON_REDUNDANT text.
15 PACK_ERM-CS 1.0 LONG NORMAL NETWORK AGGR 2_KEYS INFINITE_KEYS 8 JUL 2015
1 DEC 2015 APP_SHR:254 SLM_CODE 2_LOG_ENCRYPTION_LEVEL NON_COMMUTER
NO_GRACE NO_OVERDRAFT FLOAT NON_REDUNDANT *15QL6UFV6WTR5FW2014,Ni NiL Ni
In this example it is *15QL6UFV6WTR5FW2014
8.7 How can I check the machine is in the same state as

the license code?
Run the program: C:\AVEVA\AVEVA Licensing System\RMS\Wechoid.exe
Click to select the Disk ID, Ethernet Address, and UUID checkboxes.
In this example the Code plus the Selector Values added together make the locking code in
the license.xml file as above.

Locking code = *15QL6UFV6WTR5FW plus the last part of the selector 0x2014 =
*15QL6UFV6WTR5FW2014
8.8 How to check that the output from echoid.exe is the

same as from running Wechoid.exe?
Run the C:\AVEVA\AVEVA Licensing System\RMS\Tools\AVEVA-locking.bat file.
Check that the output from echoid.exe is the same as from running Wechoid.exe.
The output from echoid (Disk ID, Ethernet address[1], and UUID) are same as the output
from Wechoid.exe above.
IP address : 10.0.150.17
Disk ID : 0x884BA25A

CPU Info String : GenuineIntel Intel(R) Xeon(R) CPU W3520 @ 2.67GHz 6

10 5
If different values are obtained at the time of installing the license then there may be a
problem; contact Support/License development.
If locking errors still occur, send the following information to the AVEVA License
Administrator:
The License file
The AVEVA-Server-UKCAMD3903-info.txt file
The screen shot of running wechoid.exe as shown above.
8.9 What should I do if I get the error 'locking code

mismatch' during the license file installation even
though I specified the correct values?
This usually happens on laptop installs. The license server state has changed since
requesting the license servers locking criteria, and now when attempting to start the license
server you get a locking-code mismatch.
For example when running the AVEVA-Locking.bat file, the laptop was using the LAN
network card, and now when attempting to start the license server the laptop is using the
wireless network adaptor.
For example the following are the contents of a AVEVA-Server-info.txt file when a server is
connected over the LAN with wireless network card disabled.
IP address : 10.0.101.38
Disk ID : 0x8771CA45
Host name : UKCAML4161
Ethernet address [1] : 2C-41-38-08-01-9F
Hard Disk Serial [1] : J3360081G1KVBC
CPU Info String : GenuineIntel Intel(R) Core(TM) i5-2540M CPU @

2.60GHz 6 10 7
UUID : 008E337B-321F-11E1-9716-6CC25F06A060
Same machine with Wireless network active (see two Ethernet addresses now):
IP address : 10.0.101.38
Disk ID : 0x8771CA45

Host name : UKCAML4161
Ethernet address [1] : AC-81-12-97-F1-1C
CPU Info String : GenuineIntel Intel(R) Core(TM) i5-2540M CPU @

2.60GHz 6 10 7
UUID : 008E337B-321F-11E1-9716-6CC25F06A060
Locking Code 1 [1] : 381E-*15S SFAW CGQ8 XADQ
Ethernet address [2] : 2C-41-38-08-01-9F
Two workarounds are available:

Place the license server into the same state (as when the .bat file was run when the license
was requested), then run the license.
Note: Once the license file has been installed it will then work which ever network card is
being used, so long as the original card is active /enabled.
Run the (.bat file) again and request a new license file with the new [1] locking criteria. Once
obtained install it, without changing the server state.
8.10 How do I specify all TCP and UDP ports for ALS
through a firewall?
Flex server ports can be set via the AVEVA License System Console > Flex - Edit
configuration in any ALS1.1.1 version and later versions.
The RMS server port can be set via the ALS console > RMS - Edit configuration in any
ALS version.

8.11 How can I see users accessing my ALS/RMS license

server?
All product usage for both old Flex-secured products and newer RMS-secured products is
displayed using the Sentinel RMS License Manager Administration tool
(RMS\Tools\WlmAdmin).

By default, the tool looks for RMS license servers on the default RMS port of 5093. However
AVEVA's default RMS port is 4545. To correct this:
1. Select Edit > Preferences and enter the server port as 4545, then click to select the
Save these preferences check box.
2. Close and start the WlmAdmin tool.
3. Expand the Subnet servers and find the required server name.
4. Click the license feature.
5. If the server is not listed under subnet servers then select Edit > Defined Server List.
6. Enter the server name, then click Add then OK.


8.12 What should I do if FLEXlm lmstat-a does not show

new RMS secured products usage?
FLEXlm lmstat-a does not show new RMS secured products usage. All the products usage
for old Flex secured products and new RMS secured products are shown in the RMS server.
It is the RMS server which controls products usage NOT Flex.
Flex/Lmstat -a will only show clients accessing FlexLM secured products.
To see ALL the AVEVA products usage, use the GUI WlmAdmin tool that is supplied with
ALS.
Or
Use the lsmon.exe to view the details of all the usage. It can be found in the path
C:\AVEVA\AVEVA Licensing System\RMS\Tools folder. Create a .bat file in the same
folder with the following lines in it: -
cd c:\AVEVA\AVEVA Licensing system\RMS\Tools

lsmon.exe yourservername >license-used.txt
Change yourservername to your server name and run the .bat file. It will create a file called
license-used.txt with a snapshot of the keys in the license file and the clients accessing
them.
8.13 How do I perform a silent installation of the ALS

Client configuration Tool?
To silently roll out the ALS Client configuration tool to all the users:
The ALS installer .msi can be run by command line to silently install the whole product by
using the command which is supplied along with a silent-30363(release number).bat file if
the ALS release is on a DVD release.
The bat file basically runs msiexec sending the output to a logfile named with the date and
time, as follows:
set mndate=%DATE:/=-%
set mntime=%TIME:/=-%
set
logfilename=C:\AVEVA\sinstallog\AVEVA_Licensing_install_%mndate%-
%mntime%.log
Then msiexec is run to install ALL ALS writing the output to the logfilename.
Example:
msiexec /i "ALS103\Licensing1.03.msi" /qn REBOOT="ReallySuppress" /l*e
"%logfilename%" /passive ADDLOCAL=ALL
Now to install the Client change ADDLOCAL=ALL to ADDLOCAL=CLI,CLIHLP. If they do
not want the Client Help files then it can be reduced to ADDLOCAL=CLI
Example:
msiexec /i "ALS103\Licensing1.03.msi" /qn REBOOT="ReallySuppress" /l*e
"%logfilename%" /passive ADDLOCAL=CLI

8.14 What should I do if I get Error [18] when I run the RMS
license secured products (ex. Aveva E3D)?
When running any product for the first time, the following error message is displayed:
There are several possible reasons for this.

This could mean that the Specific license key that the product is trying to use is NOT
installed in the RMS license server which is running. A common reason is running
AVEVA ADMIN with a license file with just an AVEVA E3D seat and not one with
AVEVA ADMIN
This could also be due to the new license file being linked to either the wrong locking
criteria or there has been a mistake copying and pasting
The license file in the server has not been installed yet
Run the AVEVA-Locking.bat file in the \AVEVA\AVEVA Licensing System\RMS\Tools
directory.
Send the resulting (AVEVA-Server-SERVERNAME-info.txt), along with the license.xml
file back to the Administrator who issued the license, with a screen shot of the product/
version that produces the error.
8.15 Why I am getting Error 8 in the Flex license secured

products?
If a new Flex 6 licenses.lic part from an installed AVEVA Licensing System server is placed
into an old Flexman5.2 server then following error message is displayed. The example is
from a PDMS application.

8.16 Why I am getting Error -21 in the Flex license secured

products?
If an old Flex 5 license file is placed into the Flex part of the AVEVA Licensing System server
then the following error message is displayed. This following example is from running a
PDMS application.
8.17 What should I do if get the error 'Aborting

Installation' when I try to install the license file?
If all the Flex license keys have expired on a license server, the cadcentre.exe process dies
but the main Flex license server process (lmgrd.exe) is still running.
So when an attempt to install a new license file on that server occurs, the AVEVA license
System Console thinks that the servers are down, but in fact the Flex server/service is still
running. When this happens the following error is displayed.
To overcome this error the Flex service (lmgrd.exe) programs must be stopped, this can be
done by stopping the lmgrd.exe (Aveva DLS Flex service) processes. Once the service is
stopped the new license can be installed.
8.18 What should I do if I get the error 'Permission

Problem' when try to set the port@hostname in the
ALS client config tool?
When setting up a client to use an AVEVA licensing server, the following error is displayed
when running the ALS Client Configuration Tool.

This means that the program needs to be elevated to be run as an administrator.

Select the ALSClientConfigTool.exe, right click > Properties. Select the Compatibility tab
and set the privilege Level to, Run this program as an administrator.

8.19 Having issues in running the products when

connected to VPN?
If using a local AVEVA Licensing server and a VPN client, when stopping the VPN client the
license server stops, or the route to the license server is not restored, and after 8-10
minutes the applications give server lost prompts.
The only way to continue is to restart the license server or re-boot the machine. This can be
fixed if both the RMS and Flex parts of the AVEVA Licensing System are pointed to the
localhost.
This can be done by editing the Flex licenses.lic file using the AVEVA License System
Console.
Change the SERVER line to read: SERVER localhost ANY 744.

This must be done manually each time a new license is installed. Similarly, the ALS client
config must be changed to look for both the RMS and Flex servers on localhost:

To use the WlmAdmin tool to check on the license server usage after configuring localhost
as above, add a Defined Server for localhost:.
8.20 Why I am getting Error [18] and Error (-602) after

revoking the licenses?
This error occurs when the products are run five days after revoking part of the licences or
all licenses.
When running a RMS secured product (ex. AVEVA E3D) the following error is displayed:

Error[18]: No license code is available for feature UNKNOWN on host localhost.
When running an old FLEX secured product (ex. PDMS) the following error is displayed:
Error (-602) INVALID error code
The license server seems to be up and running but once the file RevokeRequest.xml is
created and placed in the folder: C:\AVEVA\AVEVA Licensing System\RMS, any products
will cease to run after five days.
8.21 How do I know that my server is counting down five

days to revoke?
To check the if the server is counting down to revoke, check the end date in the View
Entitlement & Revoke window. For example, if the licenses were revoked on 20 Jan 2014,
they expire on 25 Jan 2014 as follows:

Request a new license file and install it as if the license file has been revoked.
A revoked license server stops serving licenses after five days, if a new license has NOT
been installed onto that server.
After five days when running Wlmadmin accessing the license server and trying to view any
of the installed license keys, the following error is displayed.

Note: The user is also unable to run any products.
8.22 List of Error Codes -601 to -610 displayed by the Flex

clients
The new DLS is not able to convey a meaningful error code back to the Flex based
applications due to the way that the Flex vendor daemon framework works and the fact that
RMS error codes do not align with Flex error codes.
-601: Unable to create a FLUID.
This indicates a problem with the server system environment or possibly a problem with the
DLS server implementation.
-602: Can't get RMS feature info.
This indicates that either the RMS server is offline or some other problem with the server.
-603: Feature renewal time is below the allowed minimum.
This indicates that the RMS license has been incorrectly generated.
-604: Unable to set sharing attributes.
This indicates a problem with the RMS server.
-605: Can't set Customer Data field. (HOST USERNAME DISPLAY).

This indicates a problem with the RMS server.

-606: RMS AF Checkout failed.
Either the licenses have been used, the RMS server is down, or some other problem.
-607: RMS PF Checkout failed.
Either the licenses have been used; the RMS server is down, a problem with the way the
license was generated, or some other problem.
-608: Failed to create map structure.
System problem.
-609: Failed to store map structure.
System problem.
-610: Failed to store map structure.
System problem.



Aveva Licensing System

Uploaded by

Document Informationclick to expand document informationsys

Document Informationclick to expand document information

Copyright:

Available Formats

Aveva Licensing System

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Aveva Licensing System

Uploaded by

Copyright:

Available Formats

AVEVA Licensing System

3rd Party Software

Date Version Comments / Remarks

AVEVA Licensing System

AVEVA Licensing System

AVEVA License System Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3:1

Console Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4:1

Group Reservations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5:1

Copyright 1974 to current year. i 2.0.0.0

Three Redundant License Servers . . . . . . . . . . . . . . . . . . . . . . . . . . 6:1

RULES SERVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7:1

Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8:1

Copyright 1974 to current year. ii 2.0.0.0

Having issues in running the products when connected to VPN? . . . . . . . . . 8:16

Copyright 1974 to current year. iii 2.0.0.0

Copyright 1974 to current year. iv 2.0.0.0

Copyright 1974 to current year. 1:1 2.0.0.0

The ALS consists of the following components:

RMS License Server: Services license requests from RMS-enabled applications.

Flex License Server: Services license requests from Flex-enabled applications.

RULES License Server Services license requests for RULES-enabled applications

RULES Log A log file written by the RULES server.

Dual License Server Operation

Copyright 1974 to current year. 1:2 2.0.0.0

ALS Windows Services

RMS License Server: "Sentinel RMS License Manager_AVEVA"

Flex License Server: "AVEVA DLS Flex Server"

RULES License Server: AVEVA RULES Server

AVEVA License System Console

Client Configuration Tool

Copyright 1974 to current year. 1:3 2.0.0.0

Copyright 1974 to current year. 1:4 2.0.0.0

2 Client Configuration Tool

2.1 How License Server Details Are Configured

Copyright 1974 to current year. 2:1 2.0.0.0

2.2 Update a Workstation already Configured with

2.3 Configure a Workstation using the AVEVA Licensing

Copyright 1974 to current year. 2:2 2.0.0.0

3 AVEVA License System Console

3.1 Install the AVEVA Licensing System on a Clean Host

3.1.1 Install the License File

Copyright 1974 to current year. 3:1 2.0.0.0

3.1.2 Choose and Set the Server Port Numbers

RMS Server: Port 4545

Flex Server: Port 744

RULES Server: Port 4546

Copyright 1974 to current year. 3:2 2.0.0.0

The Console Tool consists of three tabs:

Query Licensing System

Copyright 1974 to current year. 4:1 2.0.0.0

Configure Licensing System

Copyright 1974 to current year. 4:2 2.0.0.0

Note: It is not possible to stop or start just one license server.

Copyright 1974 to current year. 4:3 2.0.0.0

Copyright 1974 to current year. 4:4 2.0.0.0

View License File

Copyright 1974 to current year. 4:5 2.0.0.0

Note: Backups of existing license files will be created.