Beta LM Tools v7.0 Setup Guide
Beta LM Tools v7.0 Setup Guide
Section 0.
Quick Installation Guide
0.1. Quick installation guide
Users familiar with license management software can quickly browse through the following steps in
order to download & install beta_lm_tools. Numbers in the third column indicate the corresponding
paragraphs where detailed information on each specific step is given.
Action Paragraph
1. Decide on the machine that will be used as license server. If a server redundancy 1.2
scheme is to be used, decide on its type and on the machines that will be used as & 2.2.1
license servers.
2. Log on to BETA CAE Systems server and download beta_lm_tools for each machine 2.2.2
and platform that will be used as a server.
3. On each of these servers, unpack beta_lm_tools and execute the command: 2.2.4
& 2.2.5
beta_lm -host_key
Store the outcome of the above command, which consists of the beta_lm version,
the machine’s hostname, the machine's ethernet card MAC address and a string of
forty (40) characters, like:
BETA LM v7.0
BETA LM Host Name = Gauss
MAC = 00:0f:b0:43:34:9a
BETA LM Host Key = 200a025ec00b5f5e0f1b2e1b3d5e020bd04e5144
On WINDOWS systems only, the administrator has the option to extract the above
key based on another network interface, namely USB or WiFi. To produce such a key,
use the command:
4. Provide the above to BETA CAE Systems. Using these data, BETA CAE Systems will 2.2.6
generate the corresponding license file, usually called license.dat & 5.1
5. Copy the license.dat file on each server and install the beta_lm license daemon using 2.2.7
the commands:
Linux Systems:
beta_lm -f [full_path_to]license.dat -L
[full_path_to]license.log
Windows Systems:
beta_lm -install -f [full_path_to]license.dat -L
[full_path_to]license.log
Alternatively, the single name of the license (license.dat) and the license.log files
can be used, if navigated to the directory where the license file is located.
If the administrator used a USB or a WiFi network interface to extract the server
host key, then this interface should also be declared during installation:
6. Verify that beta_lm is up and running on each server, using the command: 2.2.7
beta_lm_stat -h server_name
The outcome of the above command will display the features available within the
license.dat file.
Note that in the "hardware failover" redundant server scheme, only the server that is
currently the "master" will respond.
7. Modify the BETA_LIC_SRV environment variable to match the server settings. 6.1.1
For example, in the three server "hardware failover" scheme, one can set a & 6.1.2
“permanent” environment variable with BETA_LIC_SRV as a name and
port@server1,port@server2,port@server3 as a value.
8. Launch a licensed application (e.g. ANSA, META) using the provided execution 6.1
scripts.
Action Paragraph
1. Terminate the old version of beta_lm_tools. 3.1.1
2. Log on to BETA CAE Systems server and download beta_lm_tools for each machine 2.2.2
and platform that are used as a server.
3. On each of these servers, unpack beta_lm_tools and install the beta_lm license 2.2.4
daemon using the commands: & 2.2.7
Linux Systems:
beta_lm -f [full_path_to]license.dat -L
[full_path_to]license.log
Windows Systems:
beta_lm -install -f [full_path_to]license.dat -L
[full_path_to]license.log
and start the "BETA LM Service" from:
Control Panel > Administrative Tools > Services
Alternatively, the single name of the license (license.dat) and the license.log files
can be used, if navigated to the directory where the license file is located.
If the administrator used a USB or a WiFi network interface to extract the server
host key, then this interface should also be declared during installation:
4. Verify that beta_lm is up and running on each server, using the command: 2.2.7
beta_lm_stat -h server_name
The outcome of the above command will display the features available within the
license.dat file.
Note that in the "hardware failover" redundant server scheme, only the server that is
currently the "master" will respond.
When updating to a newer version of beta_lm_tools and in case that the server machines have changed
or they are Virtual Machines one should follow the steps as described in section 0.1.
Section 1.
Introduction to beta_lm_tools
1.1. Basic components
beta_lm_tools is the license manager package for use with all products licensed by BETA CAE
Systems and should be downloaded and installed on all machines that are designated as license
servers. The package contains the following:
beta_lm: license daemon that handles the initial contact and communication with the
licensed application through a TCP/IP network protocol. The communication itself is
machine independent, so the licensed application and the license daemon can be running on
different platforms and different operating systems
beta_lm_control: a tool to communicate with the license manager for various tasks
an optional administration options file (usually called license.opt) that can be used by the
license administrator to control various operating parameters of beta_lm. All configurable
parameters that appear in the administration options file remain within the license rights
granted by BETA CAE Systems
Upon installation, the beta_lm license daemon searches for and reads the license file, usually called
license.dat. This is a standard ASCII file storing all licensing information necessary for the proper
and uninterrupted use of the licensed application. This information is related to the license servers
and the respective communication ports, the licensed software packages and features that the
customer can use etc. The license file is created by BETA CAE Systems in accordance to the
requirements set by the customer and is installed by the license administrator.
License server redundancy: two redundancy schemes are currently available - one for load
distribution using more than one servers and one for hardware failover protection
Group licensing: where a group of specific software products or software features can be
set to hold a specific amount of the total available licenses
Shared licensing: multiple executions of the same application by the same user on the same
machine/console will occupy a single license
LINUX
WINDOWS
AMD Athlon, Win2K SP3, WinXP SP1 AMD Athlon, WinXP Pro x64, SP1
INTEL Pentium IV, Win2K SP3, WinXP SP1 INTEL Pentium IV, WinXP Pro x64, SP1
Windows Server 2003/2008 Windows Server 2003/2008
Section 2.
Installing beta_lm_tools
2.1. Overview of actions
The license administrator should take the following actions prior to installing the license
management package:
Select a suitable license server scheme and decide on the platforms to be used as servers
Download beta_lm_tools package for the above platforms
Provide to BETA CAE Systems all information needed to generate a valid license file
Receive a valid license file
Stand-alone Scheme: In this case beta_lm is installed in a single machine that is designated
by the customer as the license server. The server responds to all requests for license and
serves the total number of available licenses. The stand-alone scheme is considered the
default, unless a redundancy scheme is explicitly specified by the customer.
Hardware Failover Scheme: This is a quorum scheme, i.e. a scheme of three license servers
where if any two of the three machines are up and running, the system is functional and
serves the total number of licenses. This scheme is commonly known as two-over-three
scheme and is designed to provide hardware failover protection.
Multiple Servers Scheme: The total number of licenses can be distributed (equally or not) to
any number of machines that will be used as alternate license servers. Under this scheme,
each time a license is requested, the client will try to engage this license from the first server.
Upon denial, the client will automatically request license from the next available server and
so on, until it succeeds or reaches the end. This type of redundancy is best suited for
distributing license requests, but has the disadvantage that if one server becomes
unavailable, the corresponding licenses that this server distributes become unavailable as
well.
For example,
- to install beta_lm_tools v7.0 on a Linux 32bit machine, you need to download the
beta_lm_tools_v7.0_linux.tar.gz file
2.2.3. Verification of the download using Message Digest-5 (MD5) hash function
For example, imagine that you need to verify the correctness of beta_lm_tools_v7.0_linux.tar.gz.
To do so, download the beta_lm_tools_v7.0_linux.tar.gz_md5sum file and place in the same
location as beta_lm_tools_v7.0_linux.tar.gz:
PlatformFiles
beta_lm_tools_v7.0_linux.tar.gz,
beta_lm_tools_v7.0_linux.tar.gz_md5sum
Then open a command shell, switch into this location where these files reside and type the
command:
md5sum -c beta_lm_tools_v7.0_linux.tar.gz_md5sum
If the outcome of the above command is OK, then the compressed file was downloaded
correctly; if not, you need to download it again.
B. WINDOWS Platforms
If the Windows version of the beta_lm_tools package is downloaded on a LINUX machine, then
its correctness can be verified as above, by downloading the respective md5sum file and using
the built-in md5sum command. For example:
PlatformFiles
beta_lm_tools_v7.0_win32.zip
beta_lm_tools_v7.0_win32.zip_md5sum
Then open a command shell, switch into the location where the above files reside and type the
command:
md5sum -c beta_lm_tools_v7.0_win32.zip_md5sum
If the outcome of the above command is OK, then the compressed file was downloaded
correctly; if not, you need to download it again.
Optionally, if you have downloaded the license administration options file license.opt,
copy this file to the location of the beta_lm_tools files, so the contents of the beta_lm_tools
package now become:
B. WINDOWS Platforms
Open a file explorer and double click on the beta_lm_tools compressed zip file. A currently
installed archive package (like WinZIP, WinRAR) or the Windows built-in tool will be launched
Select a suitable location to unpack beta_lm_tools
NOTE: It is recommended to avoid paths with empty spaces, like ..\Program files\ etc. and prefer
an exemplary path, like e.g. C:\beta_lm\ etc
Optionally, if you have downloaded the license administration options file license.opt, copy
this file to the location of the beta_lm_tools files. So, the contents of the beta_lm_tools
package now become:
command
Item description
(all platforms)
name by which this machine is
1 hostname identified within the customer's
network beta_lm -host_key
2 MAC address media access control address
3 host key beta_lm alphanumeric string
Important in WINDOWS platforms only: By default, beta_lm targets the ethernet card in order to
generate the required host key. However, in Windows platforms only, the user can explicitly ask to
generate a host key based on an existing USB or WiFi installed network adapter. To do so, the -ni
(standing for network interface) flag should be used, followed by an argument pointing to the
desired network interface:
NOTE: In both LINUX and WINDOWS platforms, the required host key can also be generated based
on the machine’s Universally Unique Identified (UUID), by using the -ni flag, followed by the
argument UUID:
The process above should be followed on all machines that are designated as license servers. For
example, for a three server hardware failover scheme the customer should provide three sets of
information, one for each server:
Details on the contents of the license file are given in a dedicated paragraph later.
open a command prompt and switch into the folder containing the beta_lm_tools files,
for example:
cd ~/beta_lm_tools/linux_64
beta_lm -f ~/beta_lm_tools/linux_64/license.dat -L
[full_path_to]license.log
NOTE: Alternatively and given that we have navigated to the directory where the license file is
located, the single name of the license.dat and license.log files can be used, instead of the
full file address.
The above command will launch the beta_lm license daemon, read the license file
(license.dat) and write any related messages into a log file (license.log).
Verify that beta_lm is installed and that the total number of available licenses is correct
using the command:
beta_lm_stat -h server_name
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
PRE_POST | Wed Sep 11 2019 | Mon Oct 26 2020 | 5000 first section
NEW_ANSA_CATIA_V5 | Wed Sep 11 2019 | Mon Oct 26 2020 | 300
At the first section, we get information on the active licensed packages along with the
duration and the corresponding credits of each package.
At the second section, we get information about the current usage of each feature,
i.e. of each licensed application that is currently running.
At the third section, the current usage per package is shown. The information is available
both as an absolute value of used credits, as well as a usage percentage, over the total
amount of credits available for this package.
In addition, the contents of the license.log file should initially look like:
NEW LOG AT Tue May 05 08:12:33 2020
FEATURE | USER NAME@HOST | PID | START | END | EXIT_INFO | OS | Version
B. WINDOWS Platforms
open a command prompt and switch into the folder containing the beta_lm_tools files,
for example:
cd c:\beta_lm_tools\win32
by default beta_lm considers that the host key used to produce the license.dat file is based
on the ethernet card of the server machine. In this default case, the beta_lm installation
command should be:
However, if a USB or WiFi network interface was used to build the host key, then the same
network interface must be declared at the installation command. For example, in the USB
case the installation command should be:
NOTE: Alternatively and given that we have navigated to the directory where the license file is
located, the single name of the license.dat and license.log files can be used, instead of the
full file address.
The above command will install a SERVICE for the beta_lm license daemon.
At this stage, licenses are still not available for use, since the SERVICE is not yet "Started".
Go to Start > Control Panel > Administrative Tools and double-click on Services.
This action will display a list with all services installed on the machine.
Locate the BETA LM Service and verify that is has a Stopped status.
Right-click on the BETA LM Service and ask to Start it. During initiation of the BETA LM
Service, the beta_lm license daemon is activated, it reads the license file (license.dat) and
writes any related messages into the log file (license.log).
Right-click again on the BETA LM Service, go to Properties and, under the General tab.
If needed, change the Startup Type to Automatic. This will force the beta_lm license daemon
to automatically start after each reboot.
Verify that beta_lm is properly installed and that the total number of available licenses is
correct using the command:
beta_lm_stat -h server_name
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
PRE_POST | Wed Sep 11 2019 | Mon Oct 26 2020 | 5000 first section
NEW_ANSA_CATIA_V5 | Wed Sep 11 2019 | Mon Oct 26 2020 | 300
At the first section, we get information on the active licensed packages along with the
duration and the corresponding credits of each package.
At the second section, we get information about the current usage of each feature, i.e. of
each licensed application that is currently running.
At the third section, the current usage per package is shown. The information is available
both as an absolute value of used credits, as well as a usage percentage, over the total
amount of credits available for this package.
In addition, the contents of the license.log file should initially look like:
NEW LOG AT Tue May 05 08:12:33 2020
FEATURE | USER NAME@HOST | PID | START | END | EXIT_INFO | OS | Version
Root privileges are required when running beta_lm on a Linux Virtual Machine. The only exception is
when the Virtual Machine is running on a Xen hypervisor. More details are available in the
Confluence KB article: License Manager for Virtual Machines
Troubleshooting actions for installation problems are given at the end of this document.
Available
Feature Description through
WEIGHT: It is the currency of the transaction between the license server and the licensed
FEATURE.
CREDIT: It represents the total amount of credits that become available through the license
file, as well as the amount of credits necessary to launch a specific application or procedure.
2.4.1. FEATUREs and their important keywords (WEIGHT, CREDIT and OPTIONS)
The stand-alone applications that our licensing system, beta_lm, is called to manage are:
ANSA
META
CAD Translators
KOMVOS
RETOMO
NEERE
…and others…
In addition to the above, there exist features (i.e. aspects of functionality or procedures) embedded
in these applications that are also licensed when used, for example:
FEATURE=ANSA
FEATURE=META_POST
FEATURE=NEW_ANSA_CATIA_V5
FEATURE=ANSA_BATCH
FEATURE=ANSA_TOSCA
FEATURE=TOMO
... … …
As mentioned before, the CREDIT determines the maximum number of credits that a FEATURE is
allowed to engage:
In other words, the CREDIT keyword assigns an individual pool of credits that can be used by this
FEATURE only.
Finally, the OPTIONS keyword determines whether a new instance of the FEATURE will engage
additional credits or not, if launched by the same user on the same machine. The ‘shared’ OPTIONS
implies that no extra credits whereas the ‘blank’ OPTIONS implies additional credits.
The PACKAGE is a collection of FEATURES. The most frequently used PACKAGE is the PRE_POST:
PACKAGE=PRE_POST
Each PACKAGE contains a CREDIT keyword to designate a pool of credits that becomes available to
its members:
PACKAGE=PRE_POST, CREDIT=2300
In essence, each FEATURE within a license file can exist either independently or as a member of a
PACKAGE:
When a FEATURE is standing independently within a license file, then this FEATURE
occupies credits from its own, individual, pool of credits that is defined in the CREDIT= value
of the FEATURE
When a FEATURE becomes a member of a PACKAGE, then the number of credits stated in
the CREDIT= value of the FEATURE represent the maximum number of credits that this
FEATURE is allowed to engage from the total number of credits that this PACKAGE can
deliver.
A license file may contain more than one PRE_POST PACKAGE, each distributing a different pool of
credits to its contents (FEATUREs):
PACKAGE=PRE_POST, CREDITS=2432
FEATURE=ANSA, PACKAGE=PRE_POST
FEATURE=ANSA_BATCH, PACKAGE=PRE_POST
FEATURE=ANSA_CATIA_V4, PACKAGE=PRE_POST
FEATURE=ANSA_TOSCA, PACKAGE=PRE_POST
FEATURE=ANSA_UG, PACKAGE=PRE_POST
FEATURE=META_POST, PACKAGE=PRE_POST
FEATURE=META_POST_BATCH, PACKAGE=PRE_POST
FEATURE=META_POST_OLD, PACKAGE=PRE_POST
2.4.3. Examples
Now, let’s try to interpret some sections of the license file in order to gain a better understanding of
these keywords, their interaction and how they control licensing:
21 SN=1,PACKAGE=PRE_POST,CREDIT=2432,ISU=10-oct-2014,EXP=31-jan-2015,SIGNATURE=1e\
42 SN=1,FEATURE=META_POST,PACKAGE=PRE_POST,WEIGHT=33,CREDIT=2432,OPTIONS='shared'\
tional instances by the same user on the same machine will still use the al-
ready engaged 33 credits
What is important in line 42 is that the maximum number of credits that META
can use is 2432. This effectively means that (unlike the rest of the licensed
FEATURES), META can use all the credits that PRE_POST package can deliver.
52 SN=1,FEATURE=NEW_ANSA_CATIA_V5,WEIGHT=25,CREDIT=25,ISU=10-oct-2014,EXP=31-jan-\
53 2015,OPTIONS=' ',SIGNATURE=f7f5776ba498a9730fe1ddfdbde52acbde76432ec0ef5809147\
118 SN=5,FEATURE=TOMO,WEIGHT=100,CREDIT=100,ISU=28-jan-2020,EXP=31-jan-2021,OPTION\
S='shared',SIGNATURE=fdbf1abf1313fa0cccfefd934b73b0aa08e4e16438d55a10d0dc38f74\
When EPILYSIS is called through ANSA, by selecting SOLVE IN ANSA, the ANSA session
freezes and EPILYSIS starts solving, switching the occupied credits from ANSA to EPILYSIS
FEATURE. When solving finishes, credits are switched back to ANSA.
If the option SOLVE OUT OF ANSA is selected, then ANSA remains active for the user to
continue working and EPILYSIS starts by occupying additional 100 credits from the EPILYSIS
FEATURE, (200 credits in total).
If the user needs to run EPILYSIS from ANSA and then load (automatically) the results in
META which is launched, 133 credits are in overall occupied.
NEERE_SERVER
NEERE_ROOM
NEERE_USER
Section 3.
Options and usage of
License Administration Tools
3.1. The beta_lm options
As discussed in earlier paragraphs the beta_lm command initiates the license daemon. The
corresponding command is:
beta_lm -f [full_path_to_the_license_file]*
NOTE: Alternatively, the single name of the license.dat and license.log files can be used, if navigated
to the directory where the license file is located.
Additional flags are:
-h port@server_name flag
* In its simplest form, the "-f" for Linux and "-install -f" flags for Windows would suffice to initiate the
license daemon. However, it is strongly suggested that the "-L" flag followed by a log filename is also
used:
beta_lm -f [full_path_to]license.dat -L [full_path_to]license.log
beta_lm -install -f [full_path_to]license.dat -L
[full_path_to]license.log
In this way the license daemon is able to print in the license.log file useful messages concerning the
service installation, debugging or license monitoring.
A. LINUX Platforms
open a command prompt and terminate beta_lm by issuing a "kill" command followed by any
signal - except "-9" - and the PID of the parent beta_lm process. It is recommended to use
the "-3" (QUIT) or "-15" (TERMINATE) signal for this action.
NOTE: Killing beta_lm using the "-9" signal will cause abnormal termination and the licensing
system will not function correctly, especially in cases where a server redundancy scheme is
used.
B. WINDOWS Platforms
In order to terminate beta_lm in WINDOWS systems, the administrator should access the
"BETA LM Service" from Control Panel > Administrative Tools > Services and select to "stop"
the service.
First, the beta_lm_stat report, which is used to provide information about the current licensing
status.
Second, the license.log file (optional), where the full license communication between the License
Manager and the client machines is recorded, along with several other useful information.
beta_lm_stat –options
with options:
-h [server hostname] : specify the server that information is required from
-a : request individual information about all users
-u [username] : request information about a specific user
-u [username@hostname] : to request information about a specific user, at a
specific host
-s : request extra information about shared sessions. Must
be combined with one of the -a,-u flags
-x : request extra information about active features
(application version, OS, GPU info etc). Must be
combined with one of the -a,-u flags
(a) using the -h [server hostname] flag. For example, if we want to see the status of a
specific license server called server_name, we type:
beta_lm_stat -h server_name
Trying 6007@server_name
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
PRE_POST | Wed Sep 11 2019 | Mon Oct 26 2020 | 5000 first section
NEW_ANSA_CATIA_V5 | Wed Sep 11 2019 | Mon Oct 26 2020 | 300
- At the first section, we get information on the currently licensed packages along with the
duration and the corresponding credits of each package.
- At the second section, we get information about the current usage of each feature, i.e. of each
licensed application that is currently running.
-At the third section, the current usage per package is shown. The information is available both
as an absolute value of used credits, as well as a usage percentage, over the total amount of
credits available for each package.
NOTE: All the above sections are repeated when using the -a and -u flags.
(b) using the -a flag returns information about all active users. We type:
beta_lm_stat –a
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
first section
PRE_POST | Wed Sep 11 2019 | Fri Oct 23 2020 | 5000
ANSA_CATIA_V5 | Wed Sep 11 2019 | Fri Oct 23 2020 | 300 (as before)
50000
(c) using the -u [username] flag returns information about a specific user. For example, if we
type:
beta_lm_stat -u user2
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
PRE_POST | Wed Sep 11 2019 | Fri Oct 23 2020 | 5000
ANSA_CATIA_V5 | Wed Sep 11 2019 | Fri Oct 23 2020 | 300
(d) We can restrict information by indicating the hostname where a user is logged by typing:
beta_lm_stat -u user2@host1
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT
PRE_POST | Wed Sep 11 2019 | Fri Oct 23 2020 | 5000
ANSA_CATIA_V5 | Wed Sep 11 2019 | Fri Oct 23 2020 | 300
(e) We can request more information by using the –x and/or –s options, combined with either
–a or –u:
beta_lm_stat -a –x
beta_lm_stat -a –s
which will result in detailed report for all active shared sessions of each user:
Trying 6007@server_name ....
STATUS REPORT
PACKAGE | ISSUED | EXPIRE | CREDIT first section
PRE_POST | Wed Sep 11 2019 | Fri Oct 23 2020 | 5000
(as before)
ANSA_CATIA_V5 | Wed Sep 11 2019 | Fri Oct 23 2020 | 300
The logged users section shows all the active shared sessions in detail. The initial session, that
engaged the license credits, is recorded with a line starting with (+) and holds a zero PID. All the rest
shared sessions are recorded with a line starting with ( | ). In this case, user 1 has launched 2
different ANSA instances, while user2 has launched 1 ANSA instance only. The total credits used are
shown on the rest of the sections, as normal.
where:
USERNAME@HOST : indicates the user, machine and display console (linux) or session id
(windows) of the running application
EXIT_INFO : indicates the condition under which the application is stopped. Available
messages are:
NORMAL_PROGRAM_EXIT, CLIENT_LOST, IDLE_USER_TIMEOUT,
RELEASED_BY_USER, KILL_USER_BY_ADMIN, TIMED_CREDITS_CHARGED,
FEATURE_RELEASED, NOT ENOUGH PRE_POST CREDITS
Version : the version of the running application (available since ANSA/ META
version 20.1.2 and onwards)
The license.log file also records license request denials due to saturation (NOT ENOUGH PRE_POST
CREDITS). The users that have asked for a license and are currently in the queue are listed and shown
in the .log file. Extra information on the total (the sum of waiting time, so that all the clients in the
queue get a license) and average waiting time is also provided.
Additionally, a more advanced style of the license.log file can be provided. This recording mode is
invoked through the license.opt file (see next chapter ), using the keyword "LOG_STYLE=1".
More specifically, detailed license traffic information, per application session, is reported.
Every single license call, successful or not, is recorded, like shown next:
It is possible to reset the starting time from which statistics for the license.log are calculated,
without terminating the process (see section 3.4).
All information acquired either from the global log file or through the current licensing status is
suitable for input to standard spreadsheet tools (e.g. EXCEL, OpenOffice etc.) for further statistical
processing.
beta_lm_kill_user –options
with options:
beta_lm_kill_user -u user2@host1(:0)
which will kill all processes of user2 that run on host1 using the default display (:0).
NOTE: The beta_lm_kill_user command can be issued only from the user that initiated the
beta_lm daemon (i.e. the Administrator with full administrative privileges). On WINDOWS systems,
the Administrator should be logged in as Root (i.e. as Administrator with full administrative
privileges).
beta_lm_control –options
with options:
Section 4.
The Administrator Options File
4.1. The administrator options file
The administrator options file (license.opt) is a single text file that can be downloaded from BETA
CAE Systems secure site and used by the administrator in order to configure several parameters of
the licensing system. Its use is optional and it serves cases where the administrator wishes to
customize the behavior of the license service with regards to various features.
One or more valid parameters, as outlined in the next sections, can be used. The file should be
edited accordingly and saved in a specific directory, for example at the directory where the
license.dat is located. Additionally the license file (license.dat) should also be edited, using a reliable
editor, concerning the line starting with: OPTIONS=…. Enter there the full path of the license.opt file
and save.
For example:
# Replace FULL_PATH_TO in the next line with the full path of the directory
# where license.opt file resides.
OPTIONS=C:/beta-cae/beta_lm_tools_v7.0/win64/license.opt
The license.opt file is read upon the beta_lm service startup. However, it can also be reloaded,
without interrupting the service, using the command:
beta_lm_control -h [hostname] -reloadopt
- If there are available license credits, BETA License Manager will provide the needed credits and
the user will continue working, without any notification
- If there are no available license credits any more, the application will be interrupted, asking the
user to SAVE & Quit or to retry re-acquiring license
NOTE: When the Idle User Time Out option is active, the respective notification appears in the
application’s terminal upon start-up. Older application versions report at starting that
IDLE_USER_ TIMEOUT less than 20min is not accepted. In those versions, the idle time setting
automatically switches to 20min, releasing credits after 20min, as expected.
Apart from setting the idle time limit, it is also possible to configure the applicability of this limit
per user, group of users, IP addresses or hostnames. The filtering options for configuring the idle
user timeout are applicable since versions 19.1.7, 20.0.4, 20.1.2 and 21.0.0 onwards. It is also
possible to configure the idle time limit to be enabled or disabled during specific timeframes within
the day (since version 21.0.0 onwards). The appropriate syntax and some examples of each filtering
option are provided in the tables below:
Example Description
IDLE_DISABLE ANSA users=demo,demo1 The feature ANSA will not be subject to the
idle user timeout for the listed users.
IDLE_DISABLE ANSA groups=group1,group2 The feature ANSA will not be subject to the
idle user timeout for users belonging to the
listed groups.
IDLE_DISABLE ANSA hosts=WIN100,LIN200 The feature ANSA will not be subject to the
idle user timeout when it is launched by the
listed hosts.
IDLE_DISABLE ANSA ips=192.168.2.1,192.168.2.3 The feature ANSA will not be subject to the
IDLE_DISABLE ANSA ips=192.168.2.1-192.168.2.6 idle user timeout when it is launched by the
listed IP addresses.
IDLE_DISABLE ANSA ips=192.168.2.0/8
NOTE: The syntax 192.168.2.0/8 means that
the last 8 bits of the defined IP address will
be ignored.
IDLE_ONLY ANSA users=demo,demo1 Only the feature ANSA will be subject to the
idle user timeout and only for the listed
users.
IDLE_ONLY ANSA groups=group1,group2 Only the feature ANSA will be subject to the
idle user timeout and only for users
belonging to the listed groups.
IDLE_ONLY ANSA hosts=WIN100,LIN200 Only the feature ANSA will be subject to the
idle user timeout and only when it is
launched by the listed hosts.
IDLE_ONLY ANSA ips=192.168.2.1,192.168.2.3 Only the feature ANSA will be subject to the
IDLE_ONLY ANSA ips=192.168.2.1-192.168.2.6 idle user timeout and only when it is
NOTE: All the filters above can be used with the syntax “=*” to include all users, groups, IPs,
hosts, respectively.
Example Description
DENY ANSA users=demo,demo1 The feature ANSA will not be available to the
listed users.
DENY ANSA groups=group1,group2 The feature ANSA will not be available to the
users belonging to the listed groups.
DENY ANSA hosts=WIN100,LIN200 The feature ANSA will not be available when
launched by the listed hosts.
DENY ANSA ips=192.168.2.1,192.168.2.3 The feature ANSA will not be available when
DENY ANSA ips=192.168.2.1-192.168.2.6 launched by the listed IP addresses.
DENY ANSA ips=192.168.2.0/8 NOTE: The syntax 192.168.2.0/8 means that
the last 8 bits of the defined IP address will
be ignored.
ALLOW_ONLY ANSA users=demo,demo1 Only the feature ANSA will be available for
launching and only by the listed users.
ALLOW_ONLY ANSA hosts=WIN100,LIN200 Only the feature ANSA will be available for
launching and only when launched by the
listed hosts.
ALLOW_ONLY ANSA ips=192.168.2.1,192.168.2.3 Only the feature ANSA will be available for
ALLOW_ONLY ANSA ips=192.168.2.1-192.168.2.6 launching and only when launched by the
listed IP addresses.
ALLOW_ONLY ANSA ips=192.168.2.0/8
NOTE: The syntax 192.168.2.0/8 means that
the last 8 bits of the defined IP address will
be ignored.
NOTES:
a) All the filters above can be used with the syntax “=*” to include all users, groups, IPs, hosts,
respectively.
b) It is also possible to use negative values as limits for the allowed features. In such cases,
when a feature is subject to shared licensing, the total number of shared feature sessions is
limited. For instance, assuming ANSA has been granted shared licensing:
LIMIT ANSA:-2 users=demo1,demo2 means that if a user launches two instances of
ANSA in the same machine, the limit will have been reached hence no third ANSA will be al-
lowed to be launched, by anyone. This serves cases where limiting of hardware resources is
required. It is noted that although the two instances of the same feature by the same user in
the same machine will be counted as individual, the credits occupied will still be counted
once, as expected due to the shared licensing nature of the particular feature.
c) When a license is denied due to one of the above options, the following message
(or a similar one, based on the
application version), appears
in the terminal window:
Section 5.
The License.dat File
5.1. The license.dat file
The license file license.dat holds all information that is necessary for the proper and uninterrupted
use of the licensed application. This file is unique and is created for use with the customer's
designated license servers and respective license scheme. Moreover, since it is a file required by the
beta_lm to manage all licensed applications, it should be installed to every server that is running a
beta_lm daemon.
- Lines 6-15 represent the editable section of the license file. In line 10 the administrator may
optionally provide the location of the "administration options file", which contains all
configurable parameters of the licensing system (see Section 4).
- Line 13 holds information about the license server machine and communication port, so the
administrator should fill in the corresponding values. Note that the default communication
port is 6007. Normally, a license file has one SERVER line. If more SERVER lines appear it
means that a license scheme with redundant servers is used.
- Whatever follows below line 15 belongs to the not-editable section and any modifications
will result in license termination. This not-editable section contains all licensing specifications
(such as software groups, total number of credits and duration of each group etc) and is
created by BETA CAE Systems based on a unique key that is supplied by the customer.
The licensing specifications are divided into sections which in turn are characterized by a
serial number, an identification, the duration and an encrypted digital signature key. A brief
description of the corresponding flags used in these sections is given below:
Flag Description
SN= This is the serial number of the current section of the license file.
OPTIONS= Line 17: This is the company name for which the license file is
prepared for and installed.
Lines 26, 30 and 34: Additional options related to the current
'shared' section.
Note that in line 26, the 'shared' option specifies that the current
licensed application (ANSA) will reserve a single license if it is
requested by the same user for the same machine/console.
CREDIT= Total credits available for this section. If this section belongs to a
PACKAGE or FEATURE, then these are the total credits for this
package or feature.
WEIGHT= This is the "weight" of a FEATURE, i.e. the number of credits that
are reserved by one instance of the FEATURE. The weight of all
currently running FEATUREs cannot exceed the corresponding
number of CREDITS assigned to this FEATURE. For example, in line
29, it is apparent that up to a total of 8 ANSA_CATIA instances are
allowed to run, since the weight of each one is 25 and the total
credits are 200.
MAINTENANCE= This is the maintenance expiration date for either the PACKAGE or
the FEATURE. It is used only for licenses that do not include
unlimited maintenance or for perpetual licenses. The message:
FEATURE [Feature_Name] EXCEEDED MAINTANANCE PERIOD will
appear in the log file monitoring the license.
TZOFFSETMIN= This only appears when a license file is locked to machines that
TZOFFSETMAX= have a Time Zone which falls between the minimum and maximum
offset – TZOFFSETMIN and TZOFFSETMAX, respectively,
compared to the server. The message: FEATURE [Feature_Name]
EXCEEDED TIMEZONE RANGE will appear in the log file monitoring
the license.
Section 6.
Running a Licensed Application
6.1. Searching for a valid license
When the end-user launches an application, this client application will search on several locations to
find the license server name(s). On each server it will search for available floating licenses. The
locations are searched in a sequential order and are given below:
!NOTE: If the search fails in all above locations, the application will not start. The license server
name(s) is indicated at the SERVER line of the license.dat file provided by BETA CAE Systems.
Locations 1, 6, 7 and 8 point directly to the provided server name, while locations 2, 3, 4 and 5 point
to the SERVER line of the license.dat file.
Location 1. The end-user has the option to declare a specific license server by its name or
IP-address, using the -h flag:
ansa -h port@server
or
ansa -h port@ip
When a redundancy scheme is used, the above command should be like:
ansa -h port@server1,port@server2,port@server3
Location 2. In addition, it is possible to run the application using the -f option to point to the
license.dat e.g.:
ansa -f [full_path_to]license.dat
Location 4. ANSA_HOME (or META_POST_HOME) is a variable defined by the application and corre-
sponds to the pathname of the config folder inside the application’s installation directory. This op-
tion requires the license.dat file to be placed within this folder.
Location 5. This option requires the license.dat file to be placed within the current directory. The
current directory corresponds to a directory that can be defined in three ways:
The directory where the application is invoked when called from a shell or command prompt.
The “Start in” directory when the application is invoked through a Windows shortcut.
The directory defined with the –changedir running argument.
Location 8. This option points to the server name set as ansa_srv in the DNS server.
Location 9. This option matches the server name with the localhost name.
In its simplest form, a licensed application needs to know where in the network, does the
BETA_LIC_SRV environment variable points to. In turn, BETA_LIC_SRV should point to the server or
servers (single server or redundant servers), as these are listed in the corresponding license.dat
file. Related examples are given in the following paragraphs.
SERVER=plank,PORT=6007
LINUX systems:
setenv BETA_LIC_SRV 6007@plank
(in the .cshrc file for csh or tcsh Unix shell)
or
export BETA_LIC_SRV=6007@plank
(in the .bashrc file for bash Unix shell)
WINDOWS systems:
Variable name: BETA_LIC_SRV
Variable value: 6007@plank
(under Control Panel> All Control Panel Items> System> Advanced system settings> Environment
variables> System variables> New)
The ANSA_SRV is defined in a similar manner by setting a variable with ANSA_SRV as name and
6007@plank as value.
Accordingly, the BETA_LIC_FILE is defined by setting a variable with BETA_LIC_FILE as name and
the [full_path_to]license.dat as value.
SERVER=gauss,PORT=6007
SERVER=hilbert,PORT=6007
SERVER=riemann,PORT=6007
In such cases, the licensed application needs to know all alternate servers that may provide the
requested license. Consequently, the BETA_LIC_SRV environment variable should be set as:
LINUX Systems:
setenv BETA_LIC_SRV 6007@gauss,6007@hilbet,6007@riemann
(in the .cshrc file for csh or tcsh Unix shell)
or
export BETA_LIC_SRV=6007@gauss,6007@hilbet,6007@riemann
(in the .bashrc file for bash Unix shell)
WINDOWS Systems:
Variable name: BETA_LIC_SRV
Variable value: 6007@gauss,6007@hilbert,6007@riemann
(under Control Panel> All Control Panel Items> System> Advanced system settings> Environment
variables> System variables> New)
The ANSA_SRV is defined in a similar manner by setting a variable with ANSA_SRV as name and
6007@gauss,6007@hilbert,6007@riemann as value.
Accordingly, the BETA_LIC_FILE is defined by setting a variable with BETA_LIC_FILE as name and
the [full_path_to]license.dat as value.
NOTE: When defining more than one server, “blank spaces” should not exist in-between the server
names.
When more than one servers are declared in the BETA_LIC_SRV variable, the client application will
request for a license by checking these servers in a specific search order: At first, the client will
check the first declared server and then will start checking backwards from the last server to the
second.
LINUX Systems:
setenv BETA_LIC_SRV server1,server2,....server(n-1),server(n)
(in the .cshrc file for csh or tcsh Unix shell)
or
export BETA_LIC_SRV=server1,server2,....server(n-1),server(n)
(in the .bashrc file for bash Unix shell)
Command: echo $shell to get the shell type (e.g. /bin/tcsh)
WINDOWS Systems:
Variable name: BETA_LIC_SRV
Variable value: server1,server2,....server(n-1),server(n)
(under Control Panel> All Control Panel Items> System> Advanced system settings> Environment
variables> System variables> New)
In such cases the client will check the servers in the following order:
The launching of any application licensed by BETA CAE Systems (e.g. ANSA or META) from within
any type of Virtual Machine may (depending on the application’s version) disable the “sharing” of
credits for this application. In other words, any instance of an application launched through a Virtual
Machine may not share the same license and will occupy the prescribed number of credits.
By pressing the OK button, the application can search again for available licenses. With this option,
the end-user can practically bypass the Idle User Timeout setting.
Section 7.
beta_lm On The Go
7.0. Introduction to beta_lm On The Go
From version 6.1 and on, beta_lm fully supports the usage of a USB Ethernet/WiFi card for the
license server.
For more detailed information regarding the USB Ethernet/WiFi card and the general beta_lm On The
Go features and functionalities, you may refer to the following section.
beta_lm On The Go is supported ONLY for Single server scheme and ONLY on Windows platform.
Redundant NO LINUX/MacOS NO
(32bit/64bit OS Version)
In case someone needs to go on a trip with a laptop and needs to launch a Licensed Application
(ANSA/META), then they can take the USB adapter and connect it on the laptop. In this way they will
have an active license at the laptop that can be "returned" upon their return.
The advantage of this scheme is that there is one license that can be taken and used by any
computer
with no interaction from our side, and this license’s cost can be included on the total year budget.
Of course, the disadvantage is that when the USB is away, there is one less license available.
Multiple Server scheme: e.g. server_1 and one USB license on server_2, then the client machines will
have BETA_LIC_SRV = server_1,server_2
The execution of this command will provide the three pieces of information that BETA CAE Systems
requires in order to build a valid license for the selected license scheme. This information, its
description as well as the respective command that should be used to obtain, is given in the table
below:
Section 8.
Troubleshooting beta_lm
8.1. Troubleshooting beta_lm
Troubleshooting actions for problems encountered during installation or operation of the beta_lm
license management tools are given in this paragraph. Since most of these problems are reported in
the "license log" file, it is recommended to use the -L flag during the installation of the beta_lm
license daemon (see paragraph 2.2.7).
The following table presents a list of common errors along with the corresponding description and
recovery action.
platform: WINDOWS
SERVER=hostname,PORT=6007 to
SERVER=hostname.localdomain,PORT=6007 or
ERROR 1067: The process terminated SERVER=localhost,PORT=6007 or
unexpectedly SERVER=IP_ADRESS,PORT=6007
platform: WINDOWS
platform: ALL
platform: ALL
platform: ALL
SERVER APPLICATION ERROR description: beta_lm has encountered a serious system error.
platform: ALL
SERVER Invalid License File
description: The license.dat file has an invalid SERVER= line.
platform: ALL
Failed FILE address resolution description: beta_lm cannot resolve the server name or IP
address.
recovery: Verify that the SERVER= line of the license.dat file has
platform: ALL
ERROR Option -L, file name TOO BIG
description: the file name specified for the log file is too big.
platform: ALL
ERROR Options : check syntax
ERROR Option -c : REMOVE description: Invalid options were used during installation.
ERROR Option -F : REMOVE
recovery: Use valid options. Refer to paragraph 3.1.
platform: ALL
platform: ALL
platform: ALL
platform: ALL
platform: ALL
platform: ALL
platform: ALL
License Error at Line : #
description: There is an error in this particular line of the license.dat
file.
platform: ALL
Disabled # Credits of Package
description: These particular credits of the specific feature or
Disabled # Credits of Feature
package contained in the license.dat file are disabled (possibly the
feature or package has expired).
Communication Failed description: The communicated server does not currently serve any
licenses, i.e. is a slave server. Please circle through the rest of the
redundant servers.
platform: ALL
platform: ALL
platform: ALL