PreviousWhat is Application Server Licensing? Administering AS LicensesNext"

Chapter 2: Installing AS Licenses

This chapter describes how to install AS Licenses using AppTrack.

2.1 Enabling AppTrack

In this version of Object COBOL for UNIX, AppTrack is disabled by default. You can enable AppTrack by renaming the file ASSIG, which exists in the $COBDIR directory, to any other name. To disable AppTrack at any time, rename the file to ASSIG.

Note: It is the presence or absence of the file ASSIG that determines whether AppTrack is enabled. You should not, therefore, enable AppTrack simply by deleting this file, otherwise you will not be able to disable AppTrack at a future date.

2.2 Automatic License Installation

If you have purchased your application from a third-party, first refer to the supplier's documentation on installing AS Licenses. The supplier might have tailored the license installation so that it happens automatically when the application is installed on your system, in which case you do not have to do anything. It is more likely, however, that you will have to install AS Licenses yourself.

2.3 Installing Licenses Manually

In most cases you will need to install AS Licenses manually. To do this:

  1. Login to the user account from which you will run your application.

  2. Start the AppTrack license administration utility by typing the following command at the command prompt:
  3. If yours is the first licensed application to be installed on the system, you are asked to create a password.

    Enter six characters, each of which can be alphabetic and/or numeric. Make sure that you keep a secure record of this password. You need to enter the password each time you want to use any of the License Administration facilities, including installing and uninstalling licenses.

    It is possible to specify that a password is not required by typing six spaces for the password. It is recommended, however, that you do use a password, as this protects your AS licenses from being copied by someone else, and prevents any unauthorized person from tampering with your License system.

    If other licensed applications already exist on the system then a password will already have been set up; type the password (unless the password has been set to spaces).

    When you have typed the password, a menu is displayed.

  4. Press 3 (License Install) to install the AS licenses.

    You are prompted to type in the serial number and the license number of the License Key. The License Key can be obtained from Press Return after entering each number.

    If you make a mistake while typing in the serial number, use the Backspace key to delete the characters in error, and retype the number. If you realise that you have made a mistake after entering the serial number, press Return again, and the installation ends (a message is displayed telling you that the License key is invalid, which you can ignore in this case). Similarly, if you change your mind about installing a license, press Return until a message is displayed that tells you the License key is invalid, and then continue.

Follow the installation procedure above for each AS license you want to install. You can confirm which license keys you have installed for your application by selecting option 1 (License List) from the menu; this displays the installed license details on the screen. Press 9 (Quit) to exit the license administration utility when you have finished.

2.4 Problems Installing AS Licenses

If you enter the command:


and a message such as:

/asadmin not found

is displayed, and nothing else happens, then simply logging into the correct user is not sufficient to set up your environment to run the License Administration utility.

You need to establish where the Application Server for your application has been installed. It might be that you had to install Application Server yourself, as part of the installation instructions from your supplier. In that case, you should have a record of the installation directory. If so, enter the following commands, where cobol-installation-directory is the full path of the directory in which Application Server is installed:

export COBDIR

Use upper and lower case exactly as shown; for example:

export COBDIR

Now try using the original command again:


If you don't know the directory in which Application Server is installed, the documentation that came with the application might tell you. If not, you can scan your system looking for all directories which contain the License Administration utility, by using the command:

find / -name asadmin -print

The resulting display from this command might contain lines telling you that you do not have access to certain directories. Ignore these. One of the lines output by this command should be:


For example, you might find that the line:


is displayed. In this case, Application Server is installed in the directory /usr/lib/cobol.

If the output of the find command does not list any directories containing asadmin, then Application Server is not installed on your system. Consult your supplier's documentation to check you have installed the application correctly. If this is of no help, contact your supplier and explain the problem.

If the output of the find command displays more than one directory containing asadmin, note that only one of these is for your application. The other instances are for applications installed and in use by other users on your system. You can check the date each asadmin was installed to see which is yours, by using the following command for each directory listed:

ls -l cobol-installation-directory/asadmin

If you are still unsure, ask your system administrator which AS directories belong to other users. Other users can find out which AS directories belong to them by running their copy of asadmin, and selecting option 2 (License Summary).

Once you have ascertained which AS directory relates to your application, make a note of the directory for future use, and return to the beginning of this section to start the License Administration utility.

2.5 Uninstalling AS Licenses

You must uninstall an AS License if you want to install the license on a different system. To uninstall a license, type:


After entering any requested password, a menu is displayed. Select option 4 (License Uninstall) to select the uninstall option, and proceed exactly as for license installation. If you are unsure which license keys you have installed for your application, select option 1 (License List) from the menu to list details of licenses to the screen. You can then select the license keys you wish to uninstall.

2.6 Passwords

After you create a password for AppTrack, you might find that the next time you run the utility, you are again prompted to create a password. This happens if you exit the license administration utility after setting the initial password, but do not install a license and there are no other Application Servers installed on the system.

All licenses that you install are stored on a license database that is created the first time you, or any user of a different Application Server, installs a license. Since the password you select is also installed on the license database, there is nowhere to save the password until the database is created. Once you have installed a license, and the database is created, then the password is saved. This is so, even if you delete all licenses from the license database. Note that there is only one password for the license database. If other Application Servers are installed on the system and administered by other users, then you all share the same password.

Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.

PreviousWhat is Application Server Licensing? Administering AS LicensesNext"