Document revision date: 30 March 2001
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

Compaq Advanced Server for OpenVMS
Guide to Managing Advanced Server Licenses


Previous Contents Index

3.5.1 How License Database Changes Impact the License Server

After a license database update occurs, the new numbers you see in the License Manager screens may indicate that you must make some adjustments to your group license allocations.

Changes made to the number of available client-based licenses impact the License Server and clients in the following ways:

When licenses have been unloaded or deleted, use one of the following strategies to accommodate client needs:

3.5.2 Scheduling the LMF Synchronization

LMF synchronization occurs when the License Server database is updated to reflect the system's LMF database. You can schedule the LMF synchronization to occur when it is most convenient for your system. By default, the synchronization operation occurs at 00:01 system time. To specify a different time for the synchronization to occur, define the logical name PWRK$LSLMFSYNCHMINUTES in the system logical name table equal to the number of minutes past midnight that the LMF synchronization occurs.

For example, if you want the LMF synchronization to occur at 4:15 A.M., compute the number of minutes after midnight:


4:15 AM = (4 hours x 60 minutes/hour) + 15 minutes 
        = 255 minutes past midnight 

Then add the following line to the system's startup command procedure:


$ DEFINE/SYSTEM PWRK$LSLMFSYNCHMINUTES 255 

New synchronization times take effect only after the file server is restarted after the new value is established.


Chapter 4
Managing Licenses on the OpenVMS Platform

This chapter describes how to configure, start up, and use the License Manager to manage client licenses from an OpenVMS server. It discusses the following topics:

4.1 Getting Started with the License Manager

The OpenVMS account used to run the License Manager must have the following privileges:

4.1.1 Starting the License Manager

To start the License Manager, enter the following command from the system where the License Server is running:


$ ADMINISTER/LICENSE_MANAGER 

When you start the License Manager, the screen shown in Figure 4-1, Main Menu Screen, appears.

Figure 4-1 Main Menu Screen


The menu toolbar contains the following menu items:

To select a menu, press F10 or PF1 and PF1 again. The system displays the View menu as shown in Figure 4-2, Main Menu with View Menu Displayed.

Figure 4-2 Main Menu with View Menu Displayed


If you want to display one of the other menus, use the arrow key to move the cursor to that menu, or use your mouse.

4.1.2 Getting Help with the License Manager

To display information about using the License Manager, choose Help from the menu bar. The Help menu displays two options:

Select the appropriate help option. To exit the help screen, press Return. To exit the list of topics, press F10.

4.1.3 Exiting the License Manager

To exit from the License Manager, follow these steps:

  1. From the menu bar, choose View.
  2. From the View menu, choose Exit.

4.2 Configuring the License Server

If you attempt to start the License Manager when the License Server is not running on the system, the message shown in Figure 4-3, License Server Error Message, appears.

Figure 4-3 License Server Error Message


If the License Server has not been configured to run, you must reconfigure the file server. Run the initial configuration procedure (PWRK$CONFIG.COM) and specify that you want to run the License Server. For information about configuring the file server, and additional information about the PWRK$CONFIG.COM command procedure, refer to the Server Installation and Configuration Guide for your Advanced Server product.

In an OpenVMS Cluster, if you attempt to start the License Manager on a node that is not running on the active License Server and the License Server is active on another member of the cluster, the error message in Figure 4-4, License Server Startup Error Message, appears.

Figure 4-4 License Server Startup Error Message


To run the License Manager, issue the ADMINISTER/LICENSE_MANAGER command on the node that is running the active License Server (defined as ALPHA in the License Server Startup Error Message).

4.3 Navigating in the License Manager

The following tables describe the keys and buttons you use to navigate within and between the License Manager screens. You can control the License Manager using a mouse or using keys on the keyboard. Using the mouse, you can navigate through the License Manager screens by pointing and clicking on the desired item to select (highlight) items in the menus, scroll boxes, or dialog boxes. This discussion assumes you are using a DECterm window or an equivalent emulator.

Table 4-1 Keys for Navigating Screens
Use this key... To...
Arrow keys Navigate up and down lists and input fields, and across menu options and buttons.
F10 Select a menu.
Comma (keypad) Enable and disable selection of multiple lines in a scroll region. When you perform an action on multiple lines (for example, removing a group), a confirmation box is displayed. For information on confirmation box options, see Table 4-2, Confirmation Box Selections.
Space bar Enable or disable the item selection. Selected items are highlighted.
Tab Move the cursor from group to group.
Return Display the screen or dialog box associated after selecting a task and remove the message window after an error message has been displayed.
Hot key Select the menu item list or input field whose hot key is highlighted. Used with PF1, they are the letters in the menu items that are underlined. For example, press PF1 G at the View menu for a list of server groups.
Enter... To select...
PF1, V View Menu
PF1, A Actions Menu
PF1, O Options Menu
PF1, H Help

Table 4-2 Confirmation Box Selections
Select... To...
YES Confirm the action for each item selected.
YES TO ALL Perform the action on all selected items.
CANCEL Cancel the action.

Table 4-3 Buttons for Navigating Screens
Use this button... To...
OK Confirm the actions you performed on a particular screen. After choosing this button in a dialog box associated with a screen, you are returned to the screen. After choosing this button at the bottom of a screen, you are returned to the previous screen.
Help Display help text. To exit the screen, press Return. To exit the list of topics, press F10.
Cancel Cancel the actions you just performed.

4.3.1 Navigating Fields in a Dialog Box

When you enter values in a dialog box that has several fields, use the up and down arrow keys to navigate back and forth between the fields. You can back up through the fields in this way to change a value as long as you have not pressed Return to commit the values.

4.4 Performing License Server Tasks

License Server tasks include managing the License Server log files and enabling and disabling the License Server. These tasks are performed through the following Options menu items:

4.4.1 Disabling and Enabling the License Server

In most cases, invoking the License Manager enables the License Server. Compaq recommends that you disable the License Server before you use the License Manager to add, move, or remove any licenses within license groups. However, it is not necessary to disable the License Server before performing other operations. If the License Server is enabled while you manage licenses, it can assign the same licenses you are managing, causing unpredictable results.

Whenever you exit the License Manager, the License Server is automatically reenabled.

In certain circumstances, if the License Server finds no License Server state file in the PWRK$LICENSE: directory, the License Server disables itself, logs a message in the License Server log file and operator console, creates the default License Server state file, and remains disabled until the License Manager enables it. For additional information about the License Server state file, see Section 3.1, License Server State Files.

To disable or enable a License Server, follow these steps:

  1. From the Main menu bar, choose Options.
  2. From the Options menu, choose Server Enable/Disable ...
    The screen shown in Figure 4-5, Server Enable/Disable Screen, appears.

    Figure 4-5 Server Enable/Disable Screen


  3. Choose either Enable Server or Disable Server. An asterisk next to the option means that the option is selected.
  4. Press Return or choose the OK button to complete the operation and return to the Main menu.

4.4.2 Performing Log File Tasks

You can perform the following log file tasks using the License Manager:

You can read or purge old versions of the server log file as you would any OpenVMS file. The file name and location is:


PWRK$LOGS:PWRK$LICENSE_SERVER_servername.LOG 

PWRK$LOGS is defined in the system logical name table when the License Server is started. The servername is usually the OpenVMS Cluster alias or the node name of the system the License Server is running on. For example, if your node is NASCAR, the file name and location is:


PWRK$LOGS:PWRK$LICENSE_SERVER_NASCAR.LOG 

4.4.2.1 Enabling Events for Logging

You can enable logging for events associated with the following operations:

You can disable the logging of all events except server startup and fatal server errors.

If you are experiencing any problems with the license management software, Compaq recommends that you enable the logging of all types of License Server events. This will provide you with a comprehensive log file that provides information to assist in troubleshooting licensing problems.

4.4.2.2 Selecting Events for Logging

To select the events you want to log, follow these steps:

  1. From the Main menu bar, choose Options.
  2. From the Options menu, choose Log File Options...
    A screen similar to the one shown in Figure 4-6, Log File Options Screen, appears.

    Figure 4-6 Log File Options Screen


  3. Select the events for which you want to enable or disable logging.
    Using the space bar or the mouse, toggle the event to either enabled or disabled. A mark (X) next to the event indicates that the event is enabled. You cannot disable server startup events or fatal server error events.
  4. Choose OK to confirm or one of the following options:
    Option Description
    Cancel Cancel your selections.
    Clear All Clear all settings.
    Select All Select all settings.
    Help Get help on log file options.
    Start New Logfile Create a new log file instead of continuing to append information to the existing log file. The log file can become long. This option allows you to start a log file from today.

4.4.2.3 Creating a New Version of the Log File

A log file can grow quickly when tracking many events. When a log file becomes too large, you can create a new version of the file.

To create a new version of the log file, follow these steps:

  1. From the Main menu bar, choose Options.
  2. From the Options menu, choose Log File Options...
  3. From the Log File Options screen, choose Start New Logfile.
  4. Choose OK in the Confirmation screen.
  5. Choose OK in the Log File Options screen.

Note

1 These events have logging enabled by default when the License Server is first started.

4.5 Performing License Product Tasks

You can use the License Manager to perform the following product license tasks:

4.5.1 Adding Product Licenses

To add new or additional product licenses to the License Server, follow these steps:

  1. From the View menu, choose Products.
  2. From the Main menu bar, choose Actions.
  3. From the Actions menu, choose Add...
    The screen shown in Figure 4-7, Add License Product Screen, appears.

    Figure 4-7 Add License Product Screen


  4. Enter the license product name in the text entry field, for example, PWLMXXXCA07.03.
  5. Choose OK.

You can use the same procedure to add additional product licenses later.

4.5.2 Removing Product Licenses

When a product is no longer needed, remove its licenses. You cannot remove a single license for the product with the License Manager; you must remove the product, which in turn removes all licenses.

Note

When removing the product licenses from the License Manager, first remove them from the LMF database as described in the OpenVMS License Management Utility Manual. If you do not remove the licenses from the LMF database, they may continue to be assigned to clients.

Removing all licenses for a product from the License Manager and the LMF database prevents clients from acquiring a license the next time they try. If removed licenses are currently assigned to clients, those licenses are revoked and the client is informed that the license was revoked the next time the client attempts to verify the license.

To remove all licenses for a product, follow these steps:

  1. Remove the licenses from the LMF database as described in the OpenVMS License Management Utility Manual.
  2. From the View menu, choose Products.
  3. From the List of License Products screen, choose the product you want to remove.
  4. From the Actions menu, choose Remove.
    A dialog box appears in which you can confirm or cancel the removal.
  5. Choose OK to confirm the removal.

4.5.3 Listing Product Allocations

To display the groups that have licenses allocated from a specific product, perform the following steps:

  1. From the View menu, choose Products.
  2. From the List of License Products screen, choose the product you want to display allocation details for.
  3. From the Actions menu, choose Show Details (or double-click on the product).
    The system displays a list of groups that have allocations of the selected product.
  4. Choose OK to confirm and return to the Main menu.

4.5.4 Setting the Alert Level for Product Licenses

To set the alert level for product licenses, perform the following steps:

  1. From the View menu, choose Products.
  2. From the List of License Products screen, choose the product you want to set the alert level for.
  3. From the Actions menu, choose Modify.
  4. Set the alert level. If the alert level is set to zero (0), you will not receive an alert when no licenses are available. The maximum value you can set the alert level to is the total number of licenses. As you manage licenses, you want to set the alert level to the number that makes most sense in your environment. When the number of licenses drops to this level, you receive an alert.
    When the number of assigned licenses reaches this value, an entry is added to the License Server log file. For more information, see Appendix A, Server Messages.
  5. Choose OK to confirm and return to the Main menu.


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6554PRO_004.HTML