Professional Documents
Culture Documents
cmgl.ca
This publication and the application described in it are furnished under license
exclusively to the licensee, for internal use only, and are subject to a
confidentiality agreement. They may be used only in accordance with the terms
and conditions of that agreement.
All rights reserved. No part of this publication may be reproduced or transmitted in
any form or by any means, electronic, mechanical, or otherwise, including
photocopying, recording, or by any information storage/retrieval system, to any
party other than the licensee, without the written permission of Computer Modelling
Group.
The information in this publication is believed to be accurate in all respects.
However, Computer Modelling Group makes no warranty as to accuracy or
suitability, and does not assume responsibility for any consequences resulting from
the use thereof. The information contained herein is subject to change without
notice.
The license management portion of this program is based on:
™Trademark of Computer Modelling Group Ltd. Copyright © 2017 Computer Modelling Group Ltd.
† Other company, product and service names are the properties of their respective owners.
Overview ............................................................................................................................... 5
About This Document ............................................................................................................................... 5
About the Reprise License Manager ........................................................................................................ 5
Technical Support ..................................................................................................................................... 6
Overview of the Installation and Licensing Process .................................................................... 7
Types of Licensing .................................................................................................................................... 7
Standalone ........................................................................................................................................... 7
Network ................................................................................................................................................ 7
Installation and Authorization Process ..................................................................................................... 7
Setting Up a Standalone Installation .................................................................................................... 7
Setting Up a Network Installation ......................................................................................................... 8
Configuring the Network License Server .............................................................................................. 8
Configuration of the Network License Clients ...................................................................................... 8
Generating a HostID and Sending it to CMG ............................................................................. 9
Generating a HostID during Installation .................................................................................................... 9
Windows ............................................................................................................................................... 9
†
Linux .................................................................................................................................................... 9
Generating a HostID after Installation ...................................................................................................... 9
Windows ............................................................................................................................................... 9
Linux ................................................................................................................................................... 10
Other Methods of Generating HostID Information .................................................................................. 10
rlmhostid Utility ................................................................................................................................... 10
Direct Method ..................................................................................................................................... 11
Sending the HostID Information to CMG ................................................................................................ 11
Starting the License Server ..................................................................................................... 12
Starting the License Server on Windows ................................................................................................ 12
Starting the License Server on Linux ...................................................................................................... 12
Installing Your License File ..................................................................................................... 13
Installing Your License File Using the CMG License Utility .................................................................... 13
Installing Your License File Using the Reprise Server Administration Interface .................................... 13
Checking License Status ......................................................................................................... 16
Checking License Status Using the CMG License Utility ....................................................................... 16
Checking License Status Using the Reprise License Server Administration Page ................................ 16
Going Beyond the Basics ....................................................................................................... 19
Roaming.................................................................................................................................................. 19
Checking Out Licenses ...................................................................................................................... 19
Advanced Check Out ......................................................................................................................... 20
Using Checked-Out Licenses ............................................................................................................. 20
Checking In Licenses ......................................................................................................................... 21
Additional Information About Roaming ............................................................................................... 21
Getting Diagnostic Information ............................................................................................................... 21
Configuring RLM in a Firewall Environment ........................................................................................... 22
Using Failover Licensing ......................................................................................................................... 22
Installation .......................................................................................................................................... 23
Post-Installation .................................................................................................................................. 23
Installing the License Code Files ........................................................................................................ 23
All support issues should go directly to CMG technical support. Reprise Software does not
provide end user support.
Types of Licensing
CMG software supports two different types of licensing: Standalone licensing, where the software
will only work on a single designated computer, and Network licensing, where the authorization
codes are on a designated server and multiple clients can use that server’s licenses.
The type of licensing you use is determined by how you have licensed the software from CMG.
Standalone
Standalone licensing restricts usage of CMG products to the computer the License File is
installed on.
With Standalone licensing, you are allowed to run multiple simultaneous copies of CMG’s
graphical applications on your computer. CMG simulators are limited to a fixed number of
simultaneous copies as per your license agreement.
Network
Network licensing allows multiple computers to use the software over a network. One computer is
the Network License Server and all other computers are Network License Clients.
The Network License Server is the computer where the RLM licensing server is running and the
License File is installed. Applications on the Network Licensing Client pull licenses from this
computer when they need them.
Windows
When the installation is almost complete, you will be asked if you want to generate your HostID
information. Fill in the required contact information and then save it to your hard disk.
Linux†
When the installation is almost complete, you will be asked if you want to generate your HostID
information. If you do so, it will automatically be saved to the file <CMG_HOME>/hostid.info. You
should edit this file to include your contact information.
Windows
The recommended way to check the HostID information on Windows is to use the CMG License
Utility.
The CMG License Utility may be started from the Start menu. Press the “Get HostID…” button to
bring up the following dialog box:
The information you enter does not affect the actual HostID that is generated. It just helps
ensure that we can find your order in our system.
You may save this information to a text file to email to CMG for generation of your authorization
codes. See Sending the HostID Information to CMG on page 11.
Linux
The utility cmghostid.sh will generate the HostID information and print it to standard output. You
can redirect the output to a file and send it to CMG. In a command prompt change to the
$CMG_HOME directory and run the command rlmsecure/cmghostid.sh.
rlmhostid Utility
RLM supplies a HostID utility (rlmhostid) which can be found in the RLMSecure directory. It is a
console application, so it must be used from within the Windows Command Interpreter (also
known as the command prompt or DOS shell).
Basic usage is
cd %CMG_HOME%
RLMSecure\Win_x64\rlmhostid -32
This will yield the HostID (the “32-bit hard drive number”) of the computer with this output:
rlmhostid v11.1
Copyright (C) 2006-2017, Reprise Software, Inc. All rights reserved.
Direct Method
The values that the CMG HostID utility and rlmhostid report are not encrypted and you may
therefore simply report the Ethernet MAC address, IP address, hostname and hard disk ID to us if
you have access to that information. This should be a last resort as we would rather have the
information as provided by one of our utilities – this guarantees that the licensing is looking at the
correct values.
To install your License File using the CMG License Utility, follow these steps.
1. If you received your License File via email, save it to a file on disk.
2. Start the CMG License Utility from the Start menu.
3. Press the “Load License File…” button and browse to the License File on your disk. Press
OK. The CMG License Utility will scan the file for correctness and load it into the RLM
License Server.
Installing Your License File Using the Reprise Server Administration Interface
You may also install your License File through the Reprise Server Administration Interface. Follow
these steps on the license server computer.
1. Copy the file to the <CMG_HOME>\RLMSecure directory.
2. Rename it “cmgl.lic” if it does not already have that name.
3. Open an Internet Web browser (for example, Internet Explorer, Mozilla Firefox or Opera).
4. In the Address/URL bar, enter http://localhost:5054/. This accesses the Reprise License
Server Administration page for the local computer.
If the localhost address does not work, try http://127.0.0.1. If this does not work,
ensure the CMGL RLM Service is running.
5. Once the Reprise License Server Administration page is displayed, click on the
Reread/Restart Servers link. The Reread/Restart Servers page will be displayed.
The computer you are getting licenses from is shown in the first line of the grid. Standalone
configurations will show either localhost or 127.0.0.1.
If the RLM Service is running on your computer, this is shown as well.
The CMG License Utility does not show expired licenses, nor does it account for licenses that
have been checked out.
CMG applications require twenty keys in the authorization codes file per use. This is
indicated by the “count” in the Number of Licenses column.
Checking License Status Using the Reprise License Server Administration Page
You can get further information about the licenses available by using the Reprise License Server
Administration Page. This page is accessed via your Internet Web browser.
You do not need to be connected to the Internet to access the Reprise License Server
Administration Page.
1. Open an Internet Web browser (for example, Internet Explorer, Mozilla Firefox or Opera).
2. In the Address/URL bar, enter http://localhost:5054/. This accesses the Reprise License
Server Administration page for the local computer.
4. If your CMG software has been installed correctly with proper authorization codes, there
will be a CMG row in the table of ISV Servers. Click on the Server Status button in the
cmgl row. This takes you to the ISV cmgl status page.
You may also access the Reprise License Server Administration page from another
computer. Just use http://computername: 5054 (where computername is the name of the
license server computer) as the address in your Web browser. If you have changed the
port number the RLM Web server is listening on, use that number instead of 5054.
The Check Out Licenses For Roaming dialog box has several components:
LicenseServer: Allows you to select which license server to check licenses out from. By default,
this is your normal license server.
Maximum Days to Roam: The number of days to check the license out for. At the end of this
period your license will be automatically returned to the license server. You can check out a
roaming license for one to thirty days. Note that checking a license out for one day means that
you will have it until midnight of the following day (i.e. if you check a license out on Tuesday, it will
remain checked out until the end of Wednesday).
Check boxes for individual CMG products: If you want to check out GEM, check the GEM
box. If you want to check out Builder and Results, you’ll need to check the Builder box and the
™ ™
Results box. GEM, IMEX and STARS have additional options for checking out, which will be
explained below.
1. This section shows which simulator license to check out. Most clients will only have one
kind of simulator license, but multiples are possible.
A normal simulator license (for example, GEM, IMEX and STARS) allows unlimited
gridblocks and can be used to run that one simulator only.
A gridblock-limited license (for example, GEM 100K, IMEX 50K, STARS 10K) allows only
the specified number of gridblocks.
Solver licenses (SOLVE STARS, SOLVE GEM/IMEX, SOLVE University, SOLVE CSB)
can work with multiple simulators. Some have gridblock limits (SOLVE University: 10,000
Gridblocks, SOLVE CSB: 1000 Gridblocks).
Pick the license you want to use and it will be checked out.
2. This section shows the options for a Parallel license. Checking the Parallel box will also
check out one parallel token from the server, allowing the local machine to run up to four
threads. You can choose either a simulator parallel license or a Solver parallel license
(which will work with all three simulators).
You should only disable an option if you are absolutely certain you won’t need it.
3. This section shows the various optional licenses available with the simulator. All available
options are enabled by default and will be checked out unless you uncheck them first.
Dynamic Gridding is shared by all three simulators, so if you enable or disable it for one
simulator, you will enable or disable it for all simulators.
Only licenses that have been checked out will appear in the list. All licenses will automatically
have their boxes checked. If you only want to check in some licenses, you will need to select
which licenses should be checked in and which ones should be ignored.
CMG Support may ask you for this diagnostic information when troubleshooting a
problem.
Installation
You should identify which two computers are going to be the primary license server and the
failover license server. When installing, choose Network Server as the licensing type. We
recommend installing just the license server software in this situation.
Post-Installation
When sending CMG the hostid information, please let us know your intention to set up failover
licensing. Include the hostid information for both machines, clearly indicating which the primary
license server is, and which the failover license server is.
Final Thoughts
Even with failover licensing, it is still possible for the licensing to fail:
• Both servers might fail simultaneously. You should choose your license servers such
that this is unlikely (for example, make sure they don’t share the same power).
• The network may fail, leaving the client computer unable to communicate with either
license server.
To modify the RLM Options file, first click the Status button (A) to show the status pane. Then
click the EDIT rlm Options button (B). This brings up the Edit rlm Options pane:
Accessing the RLM Web interface from a different machine will only allow the user to see current
license status – they will not be able to remotely edit options or load/remove licenses or shut
down the licensing service.
Finally, we need to click the Update Options button and the Reread/Restart Servers button.
There are many more ways to restrict license usage in the ISV options. Check the section on The
ISV Options File in the RLM License Administration Manual available from
http://www.reprisesoftware.com/RLM_License_Administration.pdf.
7. Click Finish. The drivers are installed and you are ready to use the RLMID1 devices.
Note: An RLMID1 device can be used by any RLM-licensed application on the system, in
other words, there is nothing ISV-specific about the device.
rlmdown
Shuts down the license server(s).
Usage for rlmdown is:
rlmdown [isv]
isv is the name of the software vendor. To shut down all rlm servers, enter rlmdown. To shut
down only the CMGL server, while leaving other license servers alone, enter rlmdown cmgl.
rlmhostid
Reports the HostID information for the computer.
Usage for rlmhostid is:
rlmhostid -q [[-]32|ether|ip|internet|host]
Each command line option reports a different piece of HostID information, as follows:
• rlmhostid -32 reports the computer’s 32-bit hard-disk ID.
• rlmhostid -ether reports the Ethernet MAC address.
• rlmhostid -ip and rlmhostid -internet report the computer’s IP address.
• rlmhostid -host reports the computer’s hostname.
The –q option suppresses the utility’s banner and copyright information.
rlmnewlog
Creates a new logfile for recording licensing transactions and errors.
Usage for rlmnewlog is:
rlmnewlog isv log-file-name
isv is the software vendor – cmgl for example – and log-file-name is the name of the new logfile.
rlmremove
Forces an in-use license back into the pool for use by subsequent applications.
Usage for rlmremove is:
rlmremove [-q] server-host port isv handle
server-host is the machine that the license server is on.
port is the port used to communicate with the server.
isv is name of the software provider – cmgl for CMG licenses.
handle is the handle of the application using the license.
Server-host, port and handle are all provided by rlmstat.
rlmstat
Retrieves status from the license servers and prints it. Control over the status retrieved from
rlmstat is specified as follows:
rlmstat [-a] [-i [isv]] [-l [isv]] [-n [node]] [-p [product]] [-u [user]]
rlmswitch
Switches the debug log info to a new file
Usage for rlmswitch is:
rlmswitch [isv] new-file
rlmswitch causes the server isv to close the current debug log file and begin output to new-log-
file-name. If isv is not specified, or if specified as rlm, the rlm server's debug log is switched.