Introduction

Frequently Asked Questions

Chapter 2: Administration Tasks

This chapter explains the tasks for setting up and running the License Management Facility.

2.1 Summary of Administration Tasks

There is little to do to administer the License Management Facility, since the facility runs automatically without manual intervention. However, there is some setting up and some occasional monitoring to do.

The administration tasks are:

Decide what licenses to order
Install the licensed products and the License Management Facility
Start up the License Manager, unless you have set it up to start automatically
Install the license keys for the licensed products
Review the licenses in use from time to time, redistributing existing ones or adding new ones as necessary
Ensure the License Manager is running properly.

2.2 Deciding What Licenses to Order

When deciding how many licenses to order of each type, consider that:

You are not licensed to use the same license key on more than one machine at any one time. So if you have two machines, you require two license keys.
Each license key is for use only with the platform-specific product with which that license key was issued. Therefore the product version and platform must match if you want to move a license key from one machine to another.
You can purchase additional license keys at any time, to enable more users to use a licensed product.
Typically licenses are for an unlimited time. However, for products under evaluation, the license is granted for a limited time.

For full information on licensing, see your MERANT Micro Focus End user License Agreement and associated license information shipped with Micro Focus software.

2.3 Installing the License Management Facility

You must install the License Management Facility on every system that runs licensed products. You need only one License Management Facility on each system, regardless of the number of the licensed products.

You can either install the License Management Facility independently or as part of installing a licensed product. If you do not install the Licence Management Facility as part of the product, you can install it later by going to the lmf subdirectory of the directory where the product was installed, and entering:

sh lmfinstall

See the booklet supplied in the software CD jewel case for details of how to install the License Management Facility.

2.4 Starting the License Manager

The installation process gives you the option of automatically starting up the License Manager every time the system is booted. If you did not choose the automatic startup, you need to start the License Manager manually every time you boot the system.

To start the License Manager manually:

Login as root.
Go to the directory where the License Management Facility is installed, which is /usr/lib/mflmf or /opt/lib/mflmf by default, depending on the operating system.
Enter the following command:
```
sh mflmman [FORCE|WAIT] [TRACE]
```

FORCE, WAIT and TRACE are optional. You use them as follows:

FORCE

The License Manager does not by default start up if there are still licensed tasks running that were started from a previous run of the License Manager.

In this situation, you can use the FORCE directive to force License Manager to first terminate the previously started licensed tasks, and then to start.

WAIT

This directive suspends the License Manager until any outstanding licensed tasks from a previous License Manager run have finished.

Use this directive when you do not want existing licensed tasks to be terminated prematurely, and want to wait for them to complete naturally.

TRACE

Without this directive, the License Manager maintains a log of the License Manager activity in the file, MF-LMF.log.

This directive records additional information in the log file. This file is mainly for MERANT Product Support to use to help you solve any problems you might have with the License Management Facility.

Use this directive if unusual behavior has occurred. Do not use it by default, as the log file can become very large.

If you decide later, after the installation process, that you want to start License Manager automatically at boot time, you can set this up as follows:

For SCO OpenServer systems, copy the script mflmrcscript from the directory where you installed the License Management Facility into the /etc/rc.d/7 directory.
For other systems, copy the script into the /etc directory.
For SCO OpenServer systems, you need not do anything else.
For other systems, add the following entry to your /etc/inittab file:
```
mF:2345:wait:sh /etc/mflmrcscript > /dev/null 2>&1
```
Refer to your operating system documentation for more details.

2.5 Installing License Keys Initially

Before users can use licensed products, you need to install the license keys for those products. Each license key unlocks a licensed product, enabling the product to be used.

Installing a license key is a separate procedure from installing the licensed product. This enables you to add more license keys at any time, without reinstalling the licensed product.

You can install a license key from the command line or by using the menu interface of the License Administration Services. To get started quickly, install them from the command line, as follows:

Go to the directory where the License Management Facility is installed, which is /usr/lib/mflmf or /opt/lib/mflmf by default, depending on the operating system.
Enter:
```
sh mflmcmd
```
When prompted, enter I.
When prompted enter the serial number, which is printed on your License Key Folder.
When prompted enter the license number, which is also printed on your License Key Folder.
The license is then added to the license database.

2.6 Starting the License Administration Services

The License Administration Services provides a menu-driven interface for managing Micro Focus product license keys, including installing and uninstalling license keys, and reviewing the licenses installed.

Before using the menu interface, your terminal must be set up to support the necessary screen handling and the associated function keys. You need to configure your environment so that:

Your TERM environment variable is set to the terminal type you are using.
There is an entry for your terminal type in the terminfo database.
The terminfo entry for your terminal type contains the key sequences required for using the License Administration Services.

We recommend that you read the on-disk document terminfo.txt (located in the mflmf directory) before proceeding.

To start the License Administration Services:

Go to the directory where the License Management Facility is installed, which is /usr/lib/mflmf or /opt/lib/mflmf by default, depending on the operating system.
Display the License Administration Services main menu, by entering:
```
sh mflmadm
```
To get help using the License Administration Services, press F1=Help, which displays information about the current menu.

Tip If the function keys, such as F2 and F3 are not available on your UNIX terminal, you can press / followed by the number of the function key. For example, press /2 for F2. See the appendix UNIX Key Usage Chart for a complete list of keys.

2.7 Installing License Keys Using the License Administration Services

Before users can use licensed products, you need to install the license keys for those products. Each license key unlocks a licensed product, enabling the product to be used.

Installing a license key is a separate procedure from installing the licensed product. This enables you to add more license keys at any time, without reinstalling the licensed product.

To install a license key using the menu interface of the License Administration Services:

Go to the License Administration Services Main menu.
Press F2=key and enter the license key, which comprises the serial number and license number printed on the License Key Folder.
Press enter to accept the license key you just entered. Details of the product and license key type are displayed.
Press F3=install to add these details into the license database.
Press F6=more and F3=refresh, to activate your license so that you can run the product.

2.8 Reviewing, Adding and Redistributing Licenses

From time to time, you need to check what licenses are installed. You might then need to order more licenses or change the distribution of existing licenses among users and machines.

To review the licenses in use, from the Main menu of the License Administration Services, press F5=Browse. You can look through the licenses already loaded by pressing F2=Previous and F3=Next. Press F5=End-browse to return to the Main menu.

If you require more licenses, because for example, more users want to use one of the licensed products, contact your Sales Representative to order them.

If you need to move an existing license from one machine to another, uninstall the license key first from one machine and then install it on the other machine. For instructions on how to do this, see the sections Uninstalling a License Key and Installing a License Key in this chapter.

2.9 Uninstalling a License Key

To uninstall a license key, from the Main menu of the License Administration Services, press F2=key, and enter the serial number and license number printed on the License Key Folder. Then press enter and press F4=uninstall.

2.10 Ensuring the License Manager Is Running Properly

The License Manager runs continuously and does not require any manual intervention. It communicates through the console, reporting status and activity such as that the License Manager process has started. The License Manager process, mflm_manager, is a free-standing separate process, running as a daemon.

To confirm that the License Manager is running:

Go to the directory where License Management Facility is installed, which is /usr/lib/mflmf or /opt/lib/mflmf by default, depending on the operating system.
Enter the command:
```
./lmfgetpv
```
If the License Manager is running, lmfgetpv tells you the version number of the running License Manager and the path from where it was loaded. Otherwise, you are told that the License Manager is not running.

The license database is automatically backed up. In the unlikely event of a problem, the License Administration Services detects the problem at startup and gives you the option of restoring from backup. The license database files are mflmdb, mflmdb.idx, mflmdbX, and mflmdbX.idx.

If you encounter a serious problem, contact Product Support for help in resolving it. (See the MERANT Micro Focus Contact Information booklet for more details.) They might ask you to:

Suspend license checking for a short period while the problem is solved. To do this, from the Main menu of the License Administration Services, press F6=More, enter the details supplied by Product Support, and press F4=Suspend.
Print and send them a copy of the file, mflm-history. This file contains a record of the license key activity, such as which license keys have been installed and when.
Send them a copy of the file, MF-LMF.log, which is in the directory where the License Management Facility is installed.

2.11 Stopping the License Manager

To stop the License Manager running:

Log in as root.
Go to the directory where you installed the License Management Facility, which is /usr/lib/mflmf or /opt/lib/mflmf by default, depending on the operating system.
Enter the following command:
```
./lmfgetpv k
```

Introduction

Frequently Asked Questions