PSE FLEXlm Installation Instructions for Win-

dows
March 2017

This document is the property of Process Systems Enterprise Ltd.

No part of the material contained herein may be copied, distributed, published,

retransmitted or modified, in any way without the prior written consent of Process
Systems Enterprise Ltd.
PSE FLEXlm Installation Instructions for Windows

March 2017

© 2017 Process Systems Enterprise Limited

Process Systems Enterprise Limited

5th Floor East
26-28 Hammersmith Grove
London W6 7HA
United Kingdom

e: support.gproms@psenterprise.com
w: www.psenterprise.com
Trademarks

gPROMS, ModelBuilder, ProcessBuilder, Formulated Products, gCOAS, gCRYSTAL, gSOLIDS, gFLARE, gFUELCELL, gPOWER and gCCS are
registered trademarks of Process Systems Enterprise Limited ("PSE"). All other registered and pending trademarks mentioned in this mater-
ial are considered the sole property of their respective owners. All rights reserved.

Legal notice

No part of this documentation or associated materials may be copied, distributed, published, retransmitted or modified in any way
without the prior written consent of PSE. This document is the property of PSE, and must not be reproduced in any manner without
prior written permission.

Disclaimer

PSE software products provide an environment for modelling the behaviour of complex systems. While they provide valuable insights into
the behaviour of the system being modelled, this is not a substitute for a full understanding of the real system and any dangers or risks
that may be present. Except as otherwise provided, all warranties, representations, terms and conditions, express and implied (including
implied warranties of satisfactory quality and fitness for a particular purpose) are expressly excluded to the fullest extent permitted by
law. PSE Software products provide a framework for applications which may be used for supervising a process control system and ini-
tiating operations automatically, however they are not intended for environments which require fail-safe characteristics from the super-
visor system. PSE specifically disclaims any express or implied warranty of fitness for environments requiring a fail-safe supervisor. Nothing
in this disclaimer shall limit PSE's liability for death or personal injury caused by its negligence.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page ii

 PSE FLEXlm Installation Instructions for Windows

Table Of Contents

1 OVERVIEW 1
1.1 SUPPORTED WINDOWS VERSIONS 2
2 UNINSTALLING EXISTING FLEXLM LICENSE MANAGERS 3
3 UNINSTALLING EXISTING LMADMIN LICENSE MANAGERS 5
4 INSTALLATION 7
5 CONFIGURATION 10

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page iii

 PSE FLEXlm Installation Instructions for Windows

1 Overview

Caution
Starting with version 11.14, the default location of license and log files has changed due to
tightened security policies which let the license manager run under credentials of a system
account, LOCAL SERVICE, that has lower permissions than in previously versions.

Refer to the topic "Configuration" for details.

Installation of the FLEXlm (also called FlexNet) software is only required on the system
that will act as license server. It is not required on the client systems that will run PSE
Software - unless of course you wish to run the software and the license server on the
same system.

This document describes the procedures for the following tasks 1 related to the PSE license manager for
Microsoft Windows®:

l A completely fresh installation and configuration

l The update of an existing installation
l Uninstallation of lmadmin or FLEXlm.

To perform an update:

1. Back up existing license and options files.

2. Uninstall an existing license manager. The procedure for uninstalling previous versions depends on the
type of license manager that has been installed previously, lmadmin or FLEXlm.
3. Perform a fresh installation and configuration.

The installed version can be determined using FLEXlm Utilities from the FLEXlm for PSE Windows Start Menu
group, where the About box in the Help menu displays the version number.

Prerequisites to performing the installation are the installer and at least one license file, which should have
either been received from PSE's license administration, or already exist as part of a previous license man-
agement installation. Administrative privileges are required for all steps.

For Microsoft Windows, two installers exist, one for the 32-bit and one for the 64-bit version of the operating
system:

Windows version Installer

32-bit FLEXlm-PSE-11.14.0.1-i86_n3.exe

64-bit FLEXlm-PSE-11.14.0.1-x64_n6.exe

1This document at present only covers single license severs. For installation and maintenance of multiple,
redundant servers, please contact PSE support.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 1

 PSE FLEXlm Installation Instructions for Windows

For further background reading on the administration of PSE's license management technology, the FlexNet
License Administration Guide is recommended (customer login required).

1.1 Supported Windows versions

FLEXlm for PSE is supported on the following Windows versions, both in 32-bit and 64-bit:

l Windows 7 SP1 or later, as the Professional and Ultimate editions

l Windows 8 or later, as the Professional or Enterprise editions
l Windows Server 2008 SP1 or later.

Windows XP and Windows Server 2003 are not supported and it is not possible to add support for them.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 2

 PSE FLEXlm Installation Instructions for Windows

2 Uninstalling existing FLEXlm license managers

As a first step, determine if a PSE FLEXlm license manager installation exists. On Windows 7, use the Windows
Control panel and select Programs and Features. On Windows 8 and later, use the Apps and features system
setting. There, search for an entry named FLEXlm for PSE, typically appended by a version number. If such an
entry exists, continue with the steps below. If not, determine if lmadmin is installed instead. If neither is
present, no uninstallation is required.

The following steps need to be performed for a complete uninstallation. Read them before proceeding.

1. Execute theFLEXlm Utilities tool from the FLEXlm for PSE Windows Start Menu group. Make sure that
Configuration using services and LMTOOLS ignores license file path environment variables are selected
and checked, respectively.

2. Then, switch to the Config Services tab and note the path to the license file or the license directory.

Ensure that a backup copy of all license files is taken, for instance by copying them to a safe location
using Windows Explorer.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 3

 PSE FLEXlm Installation Instructions for Windows

3. On the Start/Stop/Reread tab, click on the Stop Server button.

4. On the Config Services tab, click on the Remove Service button.

5. Quit the utility.

6. In the Control Panel or system setting for adding and removing programs, choose and uninstall FLEXlm
for PSE. Under rare circumstances, you may have more than one entry and need to uninstall all of
them.
7. The uninstaller leaves behind a number of items in the installation directory (for instance log files or
license files). Typically, there is no need to keep the log files – unless otherwise instructed – but the
license files should be retained for later use by copying them to a safe location as explained in Step 2.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 4

 PSE FLEXlm Installation Instructions for Windows

3 Uninstalling existing lmadmin license managers

First, determine if a FlexNet Publisher License Manager installation exists. On Windows 7, use the Windows Con-
trol Panel and select Programs and Features. On Windows 8 and later, use the Apps & features system setting.
There, search for an entry named FlexNet Publisher License Manager. If such an entry exists, continue with the
steps below. If not, determine if FLEXlm for PSE is installed instead. If neither is present, no uninstallation is
required.

The following steps need to be performed for a complete uninstallation. Read them before proceeding.

1. Ensure that a backup copy of all license files is taken, for instance by copying them to a safe location
using Windows Explorer. They are typically located in the following directory:

Windows
Installer
version

32-bit C:\Program Files\FlexNet Publisher License Server Man-

ager\licenses\PSELMD

64-bit C:\Program Files (x86)\FlexNet Publisher License Server

Manager\licenses\PSELMD

2. Stop the lmadmin Windows service. In order to locate the service, on Windows 7 open the services Con-
trol Panel, and on Windows 8 or later, in system settings search for the word services and open View
local services.

In the Control Panel that now opens, scroll to the entry named lmadmin and stop the service. This can
be achieved by using the context menu of the entry or by opening its specification dialog, for instance
with a double click.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 5

 PSE FLEXlm Installation Instructions for Windows

3. Then, uninstall FlexNet Publisher License Manager. As described at the top, open the Windows Control
Panel Programs and Features (Windows 7) or the Apps & features system setting (Windows 8 or later)
and locate and uninstall the entry named FlexNet Publisher License Manager.

This will launch an uninstaller that will guide you through the process.

Under rare circumstances, the uninstaller may fail and display the following error message:

Should this happen, do the following:

a. Open the Control Panel for the service as in step 2 and change the service's Startup type to dis-
abled. This will prevent the service from starting up inadvertently while it is not completely
removed.
b. Contact PSE support, support.gproms@psenterprise.com, on how to best proceed.
4. The uninstaller leaves behind a number of items in the installation directory (for instance log files or
license files). Typically, there is no need to keep the log files – unless otherwise instructed – but the
license files should be retained for later use by copying them to a safe location as explained in Step 1.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 6

 PSE FLEXlm Installation Instructions for Windows

4 Installation
The installation starts with the execution of the installer.

1. Execute the matching installer for the Windows version. Below, the initial screen for the 64-bit Win-
dows is shown.

Click Next to continue.

2. The next screen presents a choice of components to install. You should select them all.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 7

 PSE FLEXlm Installation Instructions for Windows

3. Accept the default for the Destination Folder in the following screen, unless you have been instructed
by PSE support to change it.

4. The Start Menu Group default entry is the best choice and, again, it should only be changed when
instructed to do so by PSE support. Clicking Install will perform the actual installation.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 8

 PSE FLEXlm Installation Instructions for Windows

5. Once the installation has finished, it is possible to directly launch the configuration utility. Accept the
default ticked checkbox (unless you want to perform the configuration at a later time). This will begin
the configuration stage. If this box is not ticked, FLEXlm Utilities can be launched from the FLEXlm for
PSE Windows Start Menu group.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 9

 PSE FLEXlm Installation Instructions for Windows

5 Configuration

Caution
Starting with version 11.14 of FLEXlm for PSE, the default location of license and log files has
changed on Windows for reasons of improved security. The new default now is:
C:\ProgramData\FLEXlm

This contains the subdirectories:

C:\ProgramData\FLEXlm\licenses

C:\ProgramData\FLEXlm\logs

With standard user settings, these directories are not visible in Windows Explorer but can
be typed into the address bar of Windows Explorer. This may be inconvenient and, as a mit-
igation, there is a License and log files Windows Start Menu entry in the FLEXlm for PSE
group that directly opens this location.

The license server configuration is performed using the FLEXlm Utilities. They are normally launched at the end
of the installation procedure, but they can also be accessed from the FLEXlm for PSE Windows Start Menu
group.

1. The utility opens on the Service/License File tab. Nothing needs to be changed here. Select the Config
Services tab at the top right, which will take you to the second step.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 10

 PSE FLEXlm Installation Instructions for Windows

2. The Config Services tab lets you change a number of settings: the windows service name, paths to the
executables and license files, as well as the log file location. Unless specifically instructed by
PSE support, do not change any of the defaults.

Caution
If the location of the log file is changed from its default, it needs to be ensured that
the chosen location has write permissions for the system account LOCAL SERVICE. If
the log file cannot be written to, the service will fail to start.

Please note the location of the path to the license file. This location is, typically, a directory where one
or more license files can be stored1.

When updating from version 11.14 or later: if defaults have been chosen, the
configured location of the license files remains the same during an update. Since
an uninstallation does not remove license files, they should still be present in this
location. Double-check the directory to verify that this is true.

This does not apply when updating from earlier versions.

Once it is confirmed that all settings are correct, click on Save Service and confirm in the following dia-
log:

1License files are usually provided by PSE Licensing by email.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 11

 PSE FLEXlm Installation Instructions for Windows

3. Copy all license files into the license file path noted in the previous step. It is assumed that the license
files have already been adapted to the license server details, as explained in the instructions that come
with each license file.

Note: This step is usually not required when the license server is being updated.

4. Once all license files are present in the configured location, the license server can be started from the
Start/Stop/Reread tab using the Start button.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 12

 PSE FLEXlm Installation Instructions for Windows

5. A successful start is denoted in the status bar at the bottom of the dialog.

It can be further confirmed by switching to the Server Status tab and clicking on the Perform Status
Enquiry button. Scrolling down should show lines stating that both the license server and the vendor dae-
mon are up.

If the start is not successful, collect the following information and files:

lNote the message in the status bar (perhaps taking a screenshot of the dialog)
lCreate a copy of the log file (for its location see the Config Services tab)
l Create copies of all license files in exactly the form they are used; do not copy the files just as
they were sent
l In the Server Status tab, take a copy of the output from the status enquiry.
Then copy all of the above into an email to PSE support.

6. This completes installation and configuration. If you have questions or need assistance, please contact
PSE support.

Commercial in confidence

© 2017 Process Systems Enterprise Limited Page 13