RADE

C++/Java Interactive Dashboard

Setting up the Licensing for CAA RADE V5 Products

How to choose and set your licenses for the RADE tools

Technical Article

Abstract

This article describes the basic operations to set up your licensing configuration for the RADE development environment. Each user needs to explicitly specify which licenses he will acquire when launching any of the tools provided within the RADE offering.

You will learn how to customize your environment to tell which license you wish to acquire, how to modify these settings, how to use the interactive product allowing you to do this.

What You Need to Understand About the Licenses
How to Reserve Licenses for Your Products
How to Start the Licensing Manager
License Expiry Date Warnings
In Short

What You Need to Understand About the Licenses

Whenever you launch a RADE product, a set of licenses is acquired during the execution of that product. This set of licenses is explicitly chosen by the user, and each user is responsible for acquiring the correct license to allow his product to run. You will not be able to work with any of the RADE products until you have first reserved the corresponding licenses. Licenses come in two flavors:

Configuration licenses
Configuration plus add-on license.

Products belong to one or several different configurations. By acquiring a configuration license, you enable all the products within that configuration to run. Some products are also available as add-ons on existing configurations. The configuration plus add-on license enable all the products of the configuration plus the products declared as add-ons to run.

[Top]

How to Reserve Licenses for Your Products

The licenses you wish to acquire for a specific product are stored in a setting file. You inform the setting file by using the " RADE Tools Licensing" interactive application. This application consists of a single panel as shown in the image below:

This window is divided into three parts:

The upper part of the window displays information relative to your computer and licensing server:
- Target Id: specifies the target id of your computer
- Display Type: informs you whether you are running on a local or remote display:
  - Local: you are running on a local display and you are working with nodelocked or server licenses
  - Remote: you are running on a remote display and you are working with server licenses
- Active servers: if you are using network licensing, the list of all active and available license servers is displayed
  If you are using nodelocked license, Active servers is set to "None".
The left-hand part shows you the various products available within RADE
The right-hand part shows you the licenses available on the licensing server or in the nodelock file, cross-referenced with what you have installed on your computer.

The License Manager allows you to reserve the same licenses for all the products available on the RADE CD, or to individualize the licenses reserved for one particular product of the RADE CD.

The "+" button is displayed next to the license in the list. Clicking this button lets you switch between compact mode (the default) and expanded mode. In compact mode, the license imported is already reserved. Click the "+" button to switch to expanded mode. In this mode, a sub-list is displayed containing the list of all the installed licenses, preceded by the Any License option.

A list of licenses may exist, for example, when you have several identical configuration licenses with different serial numbers. This can be the case, for example, when licenses are served by different servers or in the nodelock file, or set up for use by different groups.

Your administrator may instruct you to reserve a specific license in the list.

If not, just click the Any License option, which means that you consider any of the licenses in the list to be sufficient for your needs.

The status No License appears next to configurations which have been installed, but for which you do not have a license. The configuration name is grayed out in the list, and the check button cannot be checked.

The status Available appears next to configurations which have been installed and for which you have a valid license.

Check the check buttons for the configurations for which you want to reserve a license.

After checking the licenses you wish to reserve, press the Apply button and exit the licensing manager. You need to restart a product after reserving configuration licenses.

Licensing settings are stored in a settings file named RADELicensing.xml. For the RADE tools, the location of this setting file can be parameterized with the environment variable RADECATSettingPath. A default value is provided should this variable not be set. Remember that if you wish to use this variable, then it must be active when you start the License Manager Tool, as well as when you start the RADE tool for which the License settings are set.

[Top]

How to Start the Licensing Manager

You can start the licensing manager tool by running the following command:

On Windows: $RADE_INSTALLATION_PATH$/$OS$/code/bin/CATVBTLicenser.exe
On UNIX: catstart -run CATVBTLicenser in $RADE_INSTALLATION_PATH$/$OS$/code/command

where:

RADE_INSTALLATION_PATH is the location where you installed the RADE CD.
OS is the operating system tag (eg. solaris_a, intel_a, aix_a, hpux_b, etc.).

[Top]

License Expiry Date Warnings

The Alert control in RADE Tools Licensing (CATVBTLicenser) enables you to be informed by a message (popup for interactive applications and written in logs for batch applications) that a license will soon expire.

Information about license expiry dates is already available via the Nodelock Key Management tool which lists nodelock licenses and the remaining validity duration using a color code:

Green means more than 30 days before expiration
Orange means less than 30 days before expiration
Red means already expired.

Regarding concurrent licenses, LUM tools allow the administrator to manage licenses and in particular to determine license expiry dates.

But neither method provides end users with advanced warnings of imminent license expiry.

The Alert control lets you set the number of days before the license expiration from which the expiry message will be issued.

It is set by default to 30 days, and is enabled by default. You can change the number of days, as shown above. This means that if a granted license is going to expire within the entered number of days, a message or a warning popup will be displayed.

The message or the warning popup is displayed as soon as a license is granted. This means that the message will appear each time you start a batch command (such as mkmk from MAB, mkodt from CUT, mkCheckSource from CSC, adl_ls_co from SCM or mkmancpp from CDG), open a V5 workspace or use a command requesting a new license using the dashboards (IRAD6, Visual .NET, SCM gui).

Note that:

The maximum value you can set is 90 days
If you do not want to be warned by a popup when acquiring a license, set the value to 0 to disable the alert
The tooltip message displayed when pointing at the control indicates that the value is between 0 and 90 days.

The alert is available only for nodelock (and consequently offline) licenses.

If more than one license is about to expire, the popup will display a message like this:

The following granted license(s) will soon expire: CDC (2118..R1) in 10 days DMC (2126..R1) in less than 24 hours (Launch CATVBTLicenser and enter 0 for Alert value if you no longer wish to display this message)

[Top]

In Short

You cannot start any of the RADE tools before defining the licenses you wish to reserve for that tool.
The "RADE Tools Licensing" application allows you to define the licenses you wish to reserve
You can manage the period of time during which warnings are issued when licenses are near to expire.

History

Version: 1 [Jul 2002]	Document created
[Top]