Beruflich Dokumente
Kultur Dokumente
-1-
Overview
Technical Support
Clients seeking technical support from CMG should first contact our head office
in Calgary via phone (North America: 403-531-1300) or email
(support@cmgl.ca). Support is available during normal Canadian business
hours, Mountain Time.
-2-
-3-
There are a number of steps to be followed when setting up your CMG software
for the first time.
The first step is to install the software on your computer. As a part of this step,
you will be prompted to generate a unique fingerprint for your computer (the
HostID). You need to send this HostID to us so that we may generate your
License File.
After we have generated your License File, you need to install it on your
computer. After this, you will be able to run your CMG software.
Depending on your license configuration you may not need to perform all these
steps for every computer you are installing on.
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
etwork licensing, where the authorization codes are on a designated server and
multiple clients can use that servers 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 CMGs 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 etwork License Server and all other computers
are etwork License Clients.
-4-
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.
-5-
To use the CMG software you will require a License File that is locked to your
system. This file is locked to a combination of unique characteristics of your
computer called the HostID. For example, the HostID may include your
computers Ethernet MAC address.
You will need to send us the HostID information for us to generate your License
File. You will not be able to run CMG software until we have this information
and have issued you the file.
The HostID information can be generated automatically during installation and
also at any time afterward.
Windows
The recommended way to check the HostID information on Windows is to use
the CMG License Utility.
-6-
The CMG License Utility may be started from the Start menu. Press the Get
HostID button to bring up the following dialog:
This will yield the HostID (the 32-bit hard drive number) of the computer
with this output:
rlmhostid v4.0 Copyright (C) 2006-2008, Reprise
Software, Inc. All rights reserved
Hostid of this machine: d8ffec1d
For complete instructions on how to use rlmhostid, check the section Going
Beyond the Basics: Reprise utilities.
-7-
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 much rather have the information as
provided by one of our utilities this guarantees that the licensing is looking at
the correct values.
-8-
-9-
There are two ways you can install your License File.
The recommended method is to use the CMG License Utility. This application
consolidates most of the CMG-specific licensing functions into a single interface
and ensures that your License File is loaded properly.
You may also use the Reprise Server Administration Interface to install your
License File.
If you received your License File via email, save to a file on disk.
2.
- 10 -
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.
- 11 -
6.
Enter cmgl into the ISV field (as shown in figure 3 above) and click
the REREAD LICESES button.
You should now be able to use any CMG application that you are entitled to.
- 12 -
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.
- 13 -
Click the Status link. This will take you to the Status page.
4.
- 14 -
- 15 -
Show License Usage: Click to show any current users of the license.
For more information on using the Reprise License Server Administration
page, see http://www.reprisesoftware.com/RLM_Enduser.html.
You may also access the Reprise License Server Administration
page from another computer. Just use
http://computername:9000 (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 9000.
- 16 -
2.
Click the arrow button at the bottom of the screen and select Create
Diagnostic File.:
3.
4.
Open the file in Notepad or another text editor to view the contents of the
file.
- 17 -
CMG Support may ask you for this diagnostic information when
troubleshooting a problem.
The RLM license server listens on a port (by default, port 2700) for
license requests from any ISV application.
The CMG license server listens on a port (by default, port 3137) for
CMG-specific license requests. The RLM server will provide CMG
applications with this value.
If you want to serve licenses across a firewall you will need to have a known
port for the RLM server and the CMG ISV server and these ports must be open
through the firewall. Although the CMG ISV server port number may be
dynamically assigned by the RLM server, CMG recommends always setting a
specific port number for the CMGL ISV server.
By default, the CMGL ISV server is set to port 3137 in the License File on the
ISV line as follows:
ISV cmgl cmgl cmgl.opt 3137
You may change the port to any other open port by changing this value and
restarting the RLM server. If you remove this value, RLM will assign a port
dynamically at startup. It may assign different values each time the server is
started, so this may be difficult to configure in a firewall environment.
By default, the RLM Server is set to port 2700 in the License File on the HOST
line as follows:
HOST UNKNOWN 66393ca9 2700
You may change the port that the RLM server listens on by changing the value
on the HOST line in the license file and restarting the RLM server. If you do
this, you must edit your CMG_LIC_HOST environment variable to reflect this.
The syntax of the CMG_LIC_HOST environment variable is as follows:
CMG_LIC_HOST=hostname:port
- 18 -
AIX_p4
Linux32
Linux_p4
Linux_x64
Win32
Win_x64
The CMG Options file, which controls the behavior of the CMGL ISV server, is
located in:
<CMG_HOME>\RLMSecure\cmgl.opt
2.
- 19 -
3.
4.
- 20 -
If the application that had the license that was checked in is still
running, it will try to reacquire the license for 30 minutes. If no other
application has checked the license back out, the running application
will require it and will continue running. If it cannot reacquire a license
within 30 minutes, it will exit.
Reprise utilities
All of the Reprise utilities are also available through the Reprise License
Server Administration web page.
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]
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.
- 21 -
rlmremove
Forces an in-use license back into the pool to be used by subsequent
applications.
Usage for rlmremove is:
rlmremove [-q] server-host port isv handle
rlmreread
Forces the license manager to reread the License File.
Usage for rlmreread is:
rlmreread [isv]
isv is the name of the software vendor. To reread all License Files for all
software vendors, enter rlmreread. To reread only the CMG License File, while
leaving other license servers alone, enter rlmreread cmgl.
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]]
option
parameter
-a
(no parameters)
-avail
-i
-l
-n
-p
-u
result
Print all status from rlm and all ISV
servers.
Reports free license availability.
Display license checkout info from ISVs.
Display license pooling info from ISVs.
Display license checkout info from ISVs.
Display license checkout info from ISVs.
Display license checkout info from ISVs.
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.
- 22 -
Each copy of a CMG application you have licensed is enabled by a License Key
Line in the License File we provide to you. CMG uses a model where each copy
of an application you have licensed requires a count of twenty on the License
Key Line. For example, if you have licensed three copies of GEM, there will be
a count of 60 on the gem_unlimited License Key Line.
The CMG graphical applications (Builder, Results, WinProp, and CMOST
Studio) are licensed on a per-user basis. This means that if more than one copy
is run by a user on a given computer, it still only checks out one license. The
simulators, however, are licensed on a per-instance basis. Each time a simulator
is run a license is checked out. For example, if you run two simultaneous copies
of STARS in a session, two licenses (or a License Key count of 40) are checked
out.
CMG enables options through License Key Lines as well. If you have licensed
an option from us (such as Parallel Tokens or Dynagrid) you will see these
options enabled through License Key Lines as well. Note that some older
options (such as a link between IMEX and Forgas) are now enabled for all
customers, and therefore License Key Lines for these options will appear in
every License File.
University licenses enable the use of any of the simulators (IMEX, STARS, or
GEM), but with a limit on the number of grid blocks that may be used in any
model. These licenses are intended for academic usage and may not be used for
commercial work.
- 23 -