HBM Prenscia Licensing Installer

User Guide

Licensing Installer NC-LIC-INS 18.00.01 1

About this Manual

Copyright Notice
All of this documentation, and the software it describes, are copyrighted with all rights reserved. Under copyright laws,
neither the documentation or the software may be copied, photocopied, reproduced in any way, translated, or converted
into any machine-readable form or any electronic medium, in whole or in part, without express written permission from
HBM United Kingdom Limited (HBM). Failure to obtain such permission may result in prosecution. Please refer to the
About screen in the software for details on third party software used and respective licenses and/or copyright notices.

This software is protected under copyright law and is licensed for use only by a user who has obtained the necessary
license, or in the case of a multi-user license may only be used by up to the maximum number of users specified in the
license agreement. The sale, lease, hire rental, or any other reassignment of the product to, or by, a third party without the
prior written consent of HBM is expressly forbidden.

© 2017 HBM United Kingdom Limited. All worldwide rights reserved.

All other trademarks are the property of their respective owners.

Warranty Notice
While HBM makes the product as reliable as is reasonably possible, HBM does not warrant that the product will function
properly under all hardware platforms or software environments. Certain combinations of third party software and/or
manufacturers modifications to hardware and software may impact upon the operation of HBM software. HBM has tested
the software and reviewed the documentation but HBM makes no warranty, implicit or explicit, with respect to the
product, its quality, performance, merchantability, or fitness for a specific usage. This software and documentation are
licensed “as is” and you—the licensee—assume the entire risk as to their quality and performance when you use the
product.

Liability Notice
HBM will not be liable for damages arising from the results, direct or indirect, special, incidental, or consequential, of the
licensee's usage or misusage of the product, even if advised of the possibility of such damages. In particular, and without
prejudice to the foregoing, HBM has no liability for any programs or data stored or used with HBM software, including
the costs of recovering such programs or data.

Feedback and Customer Support

For issues involving the installation or use of your software or its documentation, please e-mail us at:
ncodesupport@hbmprenscia.com or reliasoftsupport@hbmprenscia.com, to find support information for your country.

Licensing Installer NC-LIC-INS 18.00.01 2

Contents

1 Introduction .............................................................................................................................................. 4
2 Microsoft Windows Installation ............................................................................................................... 4
2.1 Installing HBM Prenscia Licensing ................................................................................................... 4
2.2 Uninstalling HBM Prenscia Licensing ............................................................................................... 8
3 Linux Installation ....................................................................................................................................... 9
3.1 Linux GUI Installation ....................................................................................................................... 9
3.2 Linux GUI Un-install ........................................................................................................................ 12
3.3 Linux Console Installation .............................................................................................................. 13
3.4 Linux Console Un-Install ................................................................................................................. 13
3.5 Linux License Server Configuration ............................................................................................... 13
4 Installation Directories............................................................................................................................ 15

Licensing Installer NC-LIC-INS 18.00.01 3

1 Introduction
This document describes the steps to install HBM Prenscia Licensing as a standalone application. HBM Prenscia
Licensing uses LM-X licensing (X-Formation). A valid LM-X license (license.lic) is required to complete the license
configuration but is not required for installation.

2 Microsoft Windows Installation

2.1 Installing HBM Prenscia Licensing

The figures below display the 64-bit version of the software; 32-bit dialogs are similar, but not identical.

NOTE: You need administrative privileges to install this software.

1. Exit all Microsoft Windows programs.

2. Launch the installation program (licinst.exe) from the downloaded folder (unzipping it first if necessary).

NOTE: If HBM Prenscia Licensing detects a later version on the target machine you will get a message telling you
this and the installer will close. If you wish to installer an older version you should uninstall the newer version first.

Fig. 1.

NOTE: HBM Prenscia Licensing may also be launched from within another installation program rather than directly,
by using licinst.exe.

Licensing Installer NC-LIC-INS 18.00.01 4

 Fig. 2.

3. Please read the License Agreement. To continue the installation, choose the I accept the terms of the license
agreement option and click Next.

Fig. 3.

Note: You must scroll to the end of the agreement to accept the terms.

4. On the Choose Install Folder dialog, enter the location to which you want to install the software or click Next to
accept the default:

Licensing Installer NC-LIC-INS 18.00.01 5

 C:\Program Files\HBM Prenscia\Licensing for 32-bit

C:\Program Files (x86)\HBM Prenscia\Licensing for 64-bit

Note: The installation location may be slightly different on some operating systems.

Fig. 4.

5. Before beginning the installation process, read the Pre-Installation Summary dialog to verify the installation
options you have chosen, and then click Install.

Fig. 5.

Licensing Installer NC-LIC-INS 18.00.01 6

You will see the following dialog when the installation is complete:

Fig. 6.

6. Click Done.

7. The Licensing Administration Tool is launched.

Fig. 7.

8. Click Help to access the Licensing Administration help documentation and continue with the configuration or click
Exit to close the License Administration Tool.

Note: To launch the Licensing Administration Tool, from the Microsoft Windows Start button select All Programs > HBM
Prenscia Licensing, followed by Licensing Administration.

Licensing Installer NC-LIC-INS 18.00.01 7

2.2 Uninstalling HBM Prenscia Licensing
1. Open the Windows Control Panel > Programs: Uninstall a program (or Programs and features).

2. Click on HBM Prenscia Licensing to open the Uninstall HBM Prenscia Licensing dialog.

Fig. 8.

3. To remove the installation, click the Uninstall button, once complete you will see the following dialog:

Fig. 9.

4. Click the Done button.

Licensing Installer NC-LIC-INS 18.00.01 8

3 Linux Installation
3.1 Linux GUI Installation

1. Browse to the directory containing the file licinst.bin and launch the installation program using ./licinst.bin.

Alternatively the setup script setup may be used.

NOTE: If HBM Prenscia Licensing detects a later version on the target machine you will get a message
telling you this and the installer will close. If you wish to installer an older version you should uninstall the
newer version first.

NOTE: HBM Prenscia Licensing may also be launched from within another installation program, rather than
directly with the setup files as described here.

Fig. 10.

2. Please read the License Agreement. To continue with the installation, choose the I accept the terms of the license
agreement option and click Next.

Licensing Installer NC-LIC-INS 18.00.01 9

 Fig. 11.

Note: You must scroll to the end of the agreement to accept the terms.

3. At the Choose Install Folder dialog, enter the location to which you want to install the software or click Next to accept
the default:

Fig. 12.

4. Before beginning the installation process, read the Pre-Installation Summary dialog to verify the installation options
you have chosen, and then click Install.

Licensing Installer NC-LIC-INS 18.00.01 10

 Fig. 13.

You should see the following dialog when the installation completes:

Fig. 14.

5. Click Done.

Licensing Installer NC-LIC-INS 18.00.01 11

3.2 Linux GUI Un-install
1. Browse to the directory containing a previously installed HBM Prenscia licensing. Browse into the sub-
directory _HBM Prenscia Licensing_installation. Type in the command “Change HBM Prenscia Licensing
Installation” and press enter.

Fig. 15.

2. To remove the installation, click the Uninstall button. When uninstall is complete you will see this dialog:

Fig. 16.

Licensing Installer NC-LIC-INS 18.00.01 12

 3. Click the Done button.

3.3 Linux Console Installation

Note: If you install using the console, you should do any future repair or uninstall with the console also.

1. Browse to the directory containing the file licinst.bin and launch the installation program using ./licinst.bin –i
console and press enter.

Alternatively the setup script setup-console may be used.

2. Introduction text is displayed, press the enter key to move on to the next stage.

3. License Agreement text is displayed. You will need to read and agree to this to continue the installation. Press Y
to continue, or N to exit.

4. Choose Install Folder text is displayed. Type in a path to install to followed by the enter key or just press enter
to accept the displayed default.

5. Pre-Installation Summary text is displayed. Before beginning the installation process, read the Pre-Installation
Summary dialog to verify the installation options you have chosen, and then press enter to install.

3.4 Linux Console Un-Install

1. Browse to the directory containing a previously installed HBM Prenscia licensing. Browse into the sub-
directory _HBM Prenscia Licensing_installation. Type in the command “Change HBM Prenscia Licensing
Installation” –i console and press enter.

3.5 Linux License Server Configuration

The following files are required to run the server license, and can be found in the <HBM Prenscia install>/Licensing/bin
directory of your installation:

• liblmxvendor.so

• lmxendutil

• lmx-serv

In addition to these files the installation will generate a default license configuration file called hbmuk-serv.cfg in the
<HBM Prenscia install>/Licensing/config directory. This configuration file is an ASCII text file, which can be opened and
modified using any text editor. The configuration file can be used to set the TCP listen port, path to the license file and
path to the log file.

Decide where you wish to place the LM-X license file and copy it to that location.

(This will usually be in the <HBM Prenscia install>/Licensing/license directory of your installation.)

Licensing Installer NC-LIC-INS 18.00.01 13

We recommend using the configuration file when starting the license server, the path to the license file should be set
to your license file name by editing the following line:

# or on Linux

# LICENSE_FILE = ../license/123456.lic

Remove the comment ‘#’ notation and set the license file name appropriately.

Advanced license server configuration will require further editing of the hbmuk-serv.cfg configuration file for example:

• Setup of High-availability Licensing (HAL) also known as redundant license servers.

• Options for restricting license server usage on the network

The default configuration file contains example syntax for these settings that is commented out; further information
on the options available may be found on the X-Formation website:

https://docs.x-formation.com/display/LMX/LM-X+End+Users+Guide

The server license may be started from the <HBM Prenscia install>/Licensing/bin directory; the syntax for this is as
follows:

lmx-serv [-background -config configfile -licpath licensefile -logfile logfile -port portnumber]

Where the switches (long version/short version) are as follows:

-background -b Run the license server as a daemon in the background.

-config -c Specify an optional path to the hbmuk-serv.cfg configuration file. Typing the full path is required. If the server
is run without the -c parameter, it will use default settings.

-licpath -l Specify an optional license file path that will be read in addition to those specified within the hbmuk-serv.cfg
configuration file. If no default license is defined in the configuration file and the -l parameter is not specified (or no
license can be found in given location), the server will look for all .lic files in its directory.

-logfile -lf Specify an optional logfile path, which will override any logfile settings in the hbmuk-serv.cfg configuration
file.

-port -p All Specify an optional port number, which will override the port number set in the configuration file.

A typical example of running as a daemon in the background is as follows:

lmx-serv -b -c ../config/hbmuk-serv.cfg

The LM-X end user utility lmxendutil may be used to remotely shutdown or restart the license server:

lmxendutil –shutdownserver [-host host –port port –password password ]

lmxendutil -restartserver [-host host –port port –password password ]

For example:

lmxendutil –shutdownserver –port 6220 –password MyPassword123

Licensing Installer NC-LIC-INS 18.00.01 14

The default password for remote shutdown is MyPassword123, this may be set within the configuration file.

4 Installation Directories
HBM Prenscia Licensing may be installed in any directory. The following subfolders are created in the Licensing
subfolder installation destination directory:

…/bin HBM Prenscia Licensing executable components and supporting libraries

…/config License server configuration file

…/docs Documentation (in PDF format)

.../HBM Prenscia Licensing_installation Installation files

…/jre Java Runtime Environment files

.../license Created to hold the license file

…/log Default location for license server debug and CDS log files

Licensing Installer NC-LIC-INS 18.00.01 15

© HBM United Kingdom Limited. All rights reserved. All details HBM
describe our products in general form only. They are not to be 26555 Evergreen Road - Suite 700 -
understood as express warranty and do not constitute any Southfield, MI 48076 - USA
liability whatsoever. Tel. +1 248 350 8300 - Fax: +1 248 350 1678
Email: info@hbmprenscia.com -
http://www.hbmprenscia.com/

measure and predict with confidence

Licensing Installer NC-LIC-INS 18.00.01 16