Advanced Server for OpenVMS
Guide to Managing Advanced Server Licenses


Previous Contents Index

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 that 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 the OK button 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. Refer to Appendix B, Server Messages, for more information.
  5. Choose OK to confirm and return to the Main menu.

4.5.5 Generating Product Reports

To generate a product report, follow these steps:

  1. From the View menu, choose Products.
  2. From the List of License Products screen, choose the product you want to generate a report for.
  3. From the Actions menu, choose Generate Product Report.
    The system displays the File Name dialog box.
  4. Enter the name for the report in the File Name dialog box.
  5. Choose OK to confirm and return to the Main menu.

By default, the report is written to the current default directory, unless another directory is specified in the File Name dialog box.

4.5.6 Sorting Product Displays

You can sort the display of the products in the List of License Products screen. You can sort by:

By default, the list of products are displayed by product name. Use the following steps to specify a different sort option:

  1. From the View menu, choose Products.
  2. From the Actions menu, choose Sort By...
    The system displays the Sort Options for Products screen shown in Figure 4-8, Sort Options for Products Screen.
  3. Choose the sort option you want.
  4. Choose OK.

Figure 4-8 Sort Options for Products Screen


4.6 Performing License Group Tasks

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

4.6.1 Creating License Groups

When the file server software is initially installed, the Default group and the Server-Based group are created automatically. Any license products that are loaded onto the system are automatically placed in the Default group. To enable server-based licensing, you must allocate licenses from the Default group to the Server-based group.

You can create user-defined license groups. These additional groups are for client-based licensing and are used to organize the distribution of licenses. The groups you create typically reflect the organizations that you support. For example, you may create the groups Engineering, Finance, and Marketing because these are the organizations you support. To utilize these groups, client software is configured so that a license is requested from that group.

To create a group, follow these steps:

  1. From the Main menu bar, choose View.
  2. From the View menu, choose Groups.
  3. From the Actions menu, choose Add.
    The dialog box shown in Figure 4-9, Add New Group Screen, appears.

    Figure 4-9 Add New Group Screen


  4. Enter the name of the group you wish to create, and choose OK.

When you create a group, the license allocation is set to zero. You must use the Modify Group function to allocate licenses to the new group.

4.6.2 Listing Licenses in a Group

You can use the License Manager to determine how many licenses from each product have been assigned to each group. To list how many licenses have been assigned to a specific group, follow these steps:

  1. From the View menu, choose Groups.
  2. From the List of License Groups screen, choose a Group.
  3. From the Actions menu, choose Show Details (or double-click on the group).
    A Clients screen similar to the one shown in Figure 4-10, Clients Screen for Clients in a Group, appears.

Figure 4-10 Clients Screen for Clients in a Group


4.6.3 Allocating Licenses to a Group

When you create a group, no licenses are automatically allocated to it. To allocate licenses to a group, you move them from the Default group to the group you want them in. You can allocate licenses at any time to any group except the Default group.

Note

You cannot allocate licenses to the Default group. If you specify a product under the Default group, you can set only its alert level in this dialog box.

To allocate licenses to a group, follow these steps:

  1. From the View menu, choose Groups.
  2. From the List of License Groups screen, choose the group that you want to allocate licenses to.
  3. From the Actions menu, choose Modify...
    The system displays the dialog box shown in Figure 4-11, Modify License Product Allocation Screen.

    Figure 4-11 Modify License Product Allocation Screen



    Each field in the dialog box is displayed with a value. You can change the allocation and alert fields.
  4. When you have finished entering values, press Return and choose OK.

Table 4-3, Allocation and Alert Field Descriptions, describes the fields in the Modify License Product Allocation Screen.

Table 4-3 Allocation and Alert Field Descriptions
Field Description
Product The name of the product you chose. You cannot alter this field.
Max The number of licenses in the Default group that are available for you to allocate to the group. If there are no available licenses for the product, the value of this field is 0. You cannot alter this field.
Alert The number of licenses of this product allocated to this group that triggers a message warning you that the licenses used have reached this level. For example, if you have 100 product licenses allocated to the Services Group and have set the alert level to 90, when you have used the 90th license of this product in the Service Group, you receive a warning message.
Allocation The number of licenses you want to allocate to the group. If licenses have been previously allocated, the value displayed for this field tells you how many. If no licenses have been previously issued, the value displayed is 0.

You can change this number to any number from 0 to the number indicated in the maximum field. If you decrease the number, the difference is returned to the Default group. If you increase the number, the increment is deducted from the Default group.

To allocate licenses, add a number to the value displayed for this field that is equal to or less than the value of the maximum "Licenses available to issue" field.

You cannot allocate more licenses to the group than are available from the Default group. However, you can add the available licenses in the Default group to any that you have already issued.

4.6.4 Re-allocating Licenses to Another Group

If you have excess licenses in one group and not enough in another, you may want to change license allocations. To re-allocate licenses, you move licenses from one group to the Default group and then allocate the licenses in the Default group to another group.

To re-allocate licenses to another group, follow these steps:

  1. From the Main menu bar, choose View.
  2. From the View menu, choose Groups.
  3. From the list of groups displayed in the Main screen, choose the group that you want to remove licenses from.
  4. From the Main menu bar, choose Actions.
  5. From the Actions menu, choose Modify...
    The system displays the Product Allocation screen.
  6. Modify the license allocation and choose OK.
    The licenses that you remove are returned to the Default group. The main screen is displayed
  7. From the Product Allocation screen, choose the group that you want to increase the number of licenses allocated to.
  8. From the Actions menu, choose Modify...
  9. In the Product Allocation screen, increase the number of licenses allocated to the group and choose OK.

4.6.5 Removing Groups

Removing a group deletes the group and causes the following actions:

Note

Clients that request licenses from this group must be reconfigured to request licenses from a different group. Refer to Chapter 5, Configuring Client Software, for more information.

To remove a group, follow these steps:

  1. From the View menu, choose Groups.
  2. From the List of License Groups screen, choose the group you want to remove.
  3. From the Actions menu, choose Remove.
    The system displays the Confirm Group Removal dialog box.
  4. Choose Yes to remove the group.

Note

Any user-defined license group can be removed; the predefined Default group and the Server-Based license group cannot be removed. Removing a license group has the following consequences:
  • Any licenses from the selected group that have been assigned to clients are revoked.
  • All licenses allocated to the group you are removing are redistributed back to the Default license group.

4.6.6 Setting the Alert Levels for Groups

To set the alert levels, follow these steps:

  1. From the View menu, choose Groups.
  2. From the List of License Groups screen, choose the group you want to set the alert level for.
  3. From the Actions menu, choose Modify...
  4. Set the alert level.
  5. Choose OK to confirm and return to the Main menu

Note

You cannot set the alert level for the Server-Based group of licenses.

4.6.7 Generating Group Reports

To generate group reports, follow these steps:

  1. From the View menu, choose Groups.
  2. From the List of License Groups screen, choose the group you want to generate a report for.
  3. From the Actions menu, choose Generate Group Report.
    The system displays the File Name dialog box.
  4. Enter the name for the report in the File Name dialog box.
  5. Choose OK to confirm and return to the Main menu.

By default, the report is written to the current default directory, unless another directory is specified in the File Name dialog box.

4.6.8 Sorting Group Displays

You can sort the display of the groups by:

To specify a sort option, follow these steps:

  1. From the View menu, choose Groups.
  2. From the Actions menu, choose Sort By...
    The system displays the Sort Options for Groups screen shown in Figure 4-12, Sort Options for Groups Screen.

    Figure 4-12 Sort Options for Groups Screen


  3. Choose the sort option you want.
  4. Choose OK.

4.7 Performing Client License Tasks

Details about a client are available to the License Manager when the client is assigned a license or when an existing license is verified. If a client does not have a user name as configured by the PATHWORKS Client Configuration utility (PWSETUP), the client appears as <noname>.

You can perform the following client-related tasks:

4.7.1 Revoking Client Licenses

When you revoke a client's license, you can re-assign the license to another client or to the same client the next time the client requests a license from that group. When a client's license is revoked, the client must request a new one to access the file server again.

You may want to revoke a client's license for any of the following reasons:

To revoke a license assigned to a client, follow these steps:

  1. From the View menu, choose Client Licenses.
    The system displays the List of Client Licenses screen as shown in Figure 4-13, List of Client Licenses Screen.

    Figure 4-13 List of Client Licenses Screen


  2. Select the client license you want to revoke. Make sure the client with the desired product is selected (highlighted).
  3. From the Actions menu, choose Revoke.
    The system displays the Confirm Revocation of Client License dialog box as shown in Figure 4-14, Confirm Revocation of Client License Screen.

    Figure 4-14 Confirm Revocation of Client License Screen


  4. Choose Yes to revoke the license.

4.7.2 Showing Client Details

You can show the following detailed information about each client. These details are gathered when the client workstation requests a license from the license server.

Table 4-4 Client Details Field Description
Name Meaning
Client Name The name of the client.
Client ID The unique client identifier (most often the address from a network adapter card in the client system).
User name The user name configured with the PATHWORKS Client Configuration utility.
NetBIOS name The machine name of the workstation.
TCP/IP host The name of the TCP/IP client node.
DECnet node The name of the DECnet client.
Product The license product assigned to the client.
Group The group name from which the license was assigned.
Timestamp The date and time the license was issued.

To show details for a client, follow these steps:

  1. From the View menu, choose Client Licenses.
  2. From the List of Client Licenses screen, choose the client for which you want to show details.
  3. From the Actions menu, choose Show Details (or double-click on the client).
    Detailed information for that client, similar to that shown in Figure 4-15, Client Details Screen, appears.

Figure 4-15 Client Details Screen


4.7.3 Sorting Client License Lists

You can sort the order in which clients are displayed in the List of Client Licenses screen. To specify a sort order, follow these steps:

  1. From the View menu, choose Client Licenses.
  2. From the Actions menu, choose Sort By...
    The system displays the Sort Option for Licenses dialog box shown in Figure 4-16, Sort Options for Licenses Screen.

    Figure 4-16 Sort Options for Licenses Screen


  3. Choose the sort option you want and select OK.

4.7.4 Generating Client License Reports

You can generate client license reports showing all client licenses that are currently in use, including the following information:

You can change the order of the client license information by using the Sort option as described in the Section 4.7.3, Sorting Client License Lists. To generate a client license report, follow these steps:

  1. From the View menu, choose Client Licenses.
  2. From the Actions menu, choose Generate Client Report.
    The system displays the File Name for Report dialog box shown in Figure 4-17, File Name for Report Dialog Box.

    Figure 4-17 File Name for Report Dialog Box


  3. Enter the name for the report in the dialog box and choose OK.
    Unless a directory is included in the file name, the report is placed in the current default directory.


Previous Next Contents Index