Problem:

Appserver 6.6 Licensing FAQ

Resolution:

BAS 6.6 Licensing

This document contains the following topics:

1. Appserver 6.6 Licensing FAQ

What"s new in 6.6

In BAS version 6.6, licensing is quite similar to version 6.5.

The following are new in version 6.6:

• Migrating from the previous versions (like 6.0 and 6.5 etc.) is not supported.
  
  Licenses from the previous versions of the Borland Enterprise Server (6.5, 6.0, 5.x etc) will not work in BAS 6.6. Users have to request a new 6.6 license to use the 6.6 product.

• Network licenses are not supported.
  
  In BAS 6.6, the users cannot use Belise (Borland"s license server), or FlexLM (a popular third-party license server found in many IT environments). These are not supported.

• Trial licenses are removed.

Trial licenses are removed in BAS 6.6. They have been replaced by development licenses (free).

• Cannot use Visibroker stand-alone server features.
  
  Appserver and Visibroker are now separate install bases. Appserver users will not be able to use stand-alone visibroker server features.

• BDOC licensing features merged into AppServer licensing.

The BDOC features are now supported as a part of the Appserver license so that a user could use the management functionality.

• User locked licenses are not supported.

Node-Locked Licenses explained

You must apply and register a separate license for each host on which you want to run a BAS licensed component.
Licensing of BAS is based on the Sanctuary licensing architecture used by most other Borland products. Sanctuary provides for more secure licensing. In BAS, the licensing type used is Node-locked. The Node-locked license is locked to the system on which it is applied and activated. You cannot copy this license to another system, and it cannot be accessed from a product running on another system.

Important: There is no grace period. You MUST activate your license before the product will run. For Node-locked licenses this means registration, and is achieved most easily when your host machine has Internet connectivity.

Applying licenses to product installations

This section explains how to apply Node-locked licenses to your product installation.

Before you begin

Things you will need:

• The Serial Number and Key for each license. These will either arrive in your product packaging, or you can receive them by email.
• A Borland Developer Network (BDN) account. If you don"t already have an account, you will be able to create it during the registration/activation process.
• Internet access. This is required to register your license and obtain an activation file. Internet access can be from any system ? not necessarily the system on which your product is installed.

Using the lmadm tool

Node-locked licenses are applied using the lmadm tool found in your installation"s bin directory (/bin/lmadm). The lmadm tool, depending upon the command arguments that are used, can run:

• Borland product registration Wizard to register product and activate its license
• License Manager GUI used to register and activate a license
• Command line interface to manage your licenses

If you use the Borland product installer wizard, you will be offered an option to run the Borland product registration Wizard automatically at the end of your installation. You can always register licenses at any time using lmadm directly. The lmadm License Manager GUI is also available as a tool in the Borland Management Console (menu command Tools>License Manager), and this can be used to manage licenses on remote hosts.

Registration requires that you be a Borland Developer Network (BDN) member. If you are not a member, you can create membership while you are in the process of registering your license, as described in the instructions below.

GUI-based registration and activation

1. Either select the option at the end of the GUI install to Register your license, or run the command:

      /bin/lmadm
   

   The default install directory is C:\\Borland\\BDP on Windows, and /opt/borland/bdp on Unix and Linux.
   
   This will display the Registration Wizard. To register your license, select "Have Serial Number" and click Next.
2. Enter your Serial Number and Key and click Next.
3. Select your Registration method and click Next.
   
   The Wizard will guide you through the steps required to register and activate your license.
   
   You can select:
   • Direct ? This method requires that the system have an Internet connection. It will guide you through all required steps and will automatically activate your license for you. This is the simplest method if your system is connected to the Internet.
   • Email ? You will send your registration request using email (from any system), and will receive an activation file by email that you can apply to your installation.
   • Web page ? Similar to email, except you will register by visiting the Borland web site.
   • Telephone ? You will provide information to a Borland representative, who will send you your activation file by email or mail.
4. If you did not choose Direct in step 3, you will receive an activation file. To complete the activation process simply copy this file into the /license directory and it will be applied automatically when you start your product.

Command line registration and activation

If you do not have a GUI environment, or if you want to register your license remotely using Telnet, run the command:

   /bin/lmadm -i console

This will display a selection of commands that will allow you to manage your licenses. These commands are:

  [0] Direct register (requires internet connection)

  [1] Register using Web, and receive activation file via email

  [2] List all licenses

  [3] Disable a license

  [4] Enable a license

  [5] Get network account name
 [6]Release large distribution license

  [7] Save
 [8]Quit

Direct registration and activation

1. If the system on which your product is installed has an Internet connection, enter 0 (zero) and press Enter to use [0] Direct register.
2. This will prompt you to:
   
   1. Enter your serial number
   2. Enter your key
   3. And either:
      • Enter your Borland Developer Community (BDN) username and password, or
      • Enter information enabling you to create a BDN account.

When you"ve completed these steps, the license will be activated and you can begin using your product.

Indirect registration and activation

1. If your system does not have an Internet connection, enter 1 and press Enter to use [1] Register using Web.
2. The tool will:
   1. Display the URL of the Borland registration web site that you must visit to register.
   2. Display a KEY number that you will need when you visit the Borland registration web site.
3. To complete your registration, visit the Borland registration web site, enter your BDN account info (or create one), and enter your serial number and the KEY the lmadm tool displayed.
   
   An activation file that contains instructions on how to activate your license will arrive by email.
4. Copy the activation file to the system on which your product is installed, into the /license directory. Starting your product will activate the license automatically.

Remote registration and activation

Using the Management Console

Some points of interest regarding this feature:

• To support the remote registration and activation, the SCU process acts as the remote licensing agent. The SCU has been modified so that it will start without a license. Thus, a remote console can connect to it to apply licenses remotely.
• The Management Console does not, itself, require a license. Therefore it can be installed on any convenient machine for the purpose of applying licenses to other installations.
• Any BAS license can be applied using this technique, as long as the SCU is running at the time of licensing on the target host. The licenses applied will be available for all licensed components.
• This feature will work only if you have received a Serial Number and Key (Node-locked license) with your license.

To register and activate licenses on a remote host:

1. After installing BAS on the desired hosts, start the SCU process of each installation. (by default c:\\borland\\bdp\\bin\\scu.exe).
2. From a Management Console installed on any host, log in and discover each of the remote SCU processes. These will appear as agents under the Agents folder in the Console.
3. In the Agents folder, select an agent you want to license.
4. Select the License tab on the right-side view. This will display the current license status.
5. Right-click on the agent node in the tree, and select the Register command. This will open the Registration Wizard.
6. Enter your licensing information into the Registration Wizard as it is requested.

Important: The License Manager tool available in the Management Console"s Tools>License Manager command can only license the installation local to the running Console. It cannot be used for remote licensing.

Using lmadm over Telnet

To register and activate a license on a remote system without running an SCU on the system, you must Telnet into a system and run lmadm in the command line mode.