Once you have installed INTV! on your Unix workstation as outlined in the previous chapter, you are ready to install your license keys. Installing your license keys activates INTV!. In this chapter, the following topics are discussed:

• FLEXlm licensing
• Obtaining your license keys
• Installing your license keys

MDL employs a licensing system, either node-locked or floating, to track usage of INTV!. This system helps control the use of INTV! on your network.

MDL’s INTV! uses version 3.0 of Globetrotter’s FLEXlm network license management package. FLEXlm is the industry standard for license management and provides you with the highest level of compatibility when working with software licensed from other vendors.

Normally each workstation (or node) on which you want to run INTV! requires its own node-locked license key which is specific to that machine. However, FLEXlm also offers another type of software license that is available anywhere on your network. These floating licenses allow any workstation on your network to obtain a license to run INTV!. Floating licenses allow you to make more efficient use of fewer licenses by sharing them among several machines. When you purchased INTV!, you selected either node-locked keys or floating keys with a fixed number of floating user licenses.

More information on FLEXlm can be found in Appendix A, "Technical Issues".

If you purchased floating licenses for INTV!, you need to designate one workstation (or host) to act as your site’s License Server. This workstation issues licenses when available and tracks the number of licenses currently in use. It must be able to communicate with all workstations on which you plan to run INTV! and should be active at all times. Many sites may already have a centralized workstation designated as the License Server for all software products at that location. If so, you may wish to use that machine to manage your INTV! licenses as well. If your site uses the FLEXlm License Manager for other software products, you may want to combine the license files. See Appendix A, "Technical Issues", for information on working with licenses for multiple products. A machine may act as License Server for the software without actually using the software itself.

If you purchased a node-locked license for your INTV! software, then each workstation has its own unique license and acts as its own License Server.

Under the FLEXlm license management system, a License Manager process called lmgrd runs in the background and handles license requests. Your License Server starts a License Manager at boot time. When a user attempts to run INTV!, the software queries the License Manager to request a license. If there are no licenses available (perhaps all of the available licenses are currently in use), then the request is denied. Otherwise, the License Manager allows INTV! to run and checks out the appropriate licenses to the user, reducing the number of available licenses. When the user quits INTV!, the License Manager reclaims the licenses and increases the number of available licenses.

Licensing information is stored in a license file, normally called license.dat. The license.dat file is used by both the License Manager and INTV!.

When your License Manager starts at boot time, it reads the license.dat file to determine the number and types of licenses available. When INTV! is started, it reads the license.dat file to determine which machine will be its License Server. Every workstation running INTV! must have access to the license.dat file.

If you are running INTV! on multiple workstations, as is usually the case for a floating license, then you must either copy the license.dat file to each workstation or place it on an NFS mounted partition available to everyone. The License Manager itself runs only on the License Server.

You need to obtain a set of licenses from MDL to activate INTV!. Each set of licenses is unique to your installation and is generated based on the software you have purchased and the workstation(s) you are using. You need to fax a copy of the completed MDL Product Registration Form to MDL to obtain your licenses.

You need to complete the MDL Product Registration Form, included with INTV!, for each workstation acting as a License Server. If you are using node-locked licenses, you need to complete a copy of the form for each workstation to be licensed.

The information returned with the MDL Product Registration Form is entered into our customer database which allows us to provide you information regarding program updates and other offerings as they become available.

Be sure that you accurately specify the Serial Number of your INTV! software. This Serial Number is located on the inside front cover of the "INTV! User’s Guide" and also on the outside spine of the software packaging. Keep a record of the Serial Number. It is required for support and maintenance contacts.

We need to know the hostid of your License Server to generate your licenses. A hostid is a unique alphanumeric string used to identify a particular workstation.

Run the program lmhostid, which is located in the bin subdirectory in the INTV! installation directory to determine the hostid for a particular workstation. For example, if you installed INTV! in /opt/insoft/intv you would issue the following command:

# /opt/insoft/intv/bin/1mhostid

The lmhostid command returns a string of letters and numbers. This is the workstation’s hostid. Enter this value in the System Hostid blank of the MDL Product Registration Form. If you purchased floating keys, don’t forget to specify the number of licenses purchased.

After you receive your licenses from MDL, you will need to install them on your License Server. Follow these steps to install the licenses on a License Server:

1. Log in as root.

2. Change to INTV!’s installation directory. For example, if you installed INTV! in /opt/insoft/intv, enter the following command:

# cd /opt/insoft/intv

3. Run the program ISLicense from the bin subdirectory of INTV!’s installation directory:

# ./bin/ISLicense

The licensing script attempts to locate the directory where INTV! is installed on its own. If the location that the script chooses is wrong, or the script can’t find INTV!, you will need to enter the correct path for INTV!’s home directory.

4. The script will ask if the directory it resolved as INTV!’s home is correct; if it isn’t, enter the correct directory now.

5. INTV! will then ask where you would like the license.dat file to be stored. The script will suggest a default location (/etc/insoft/license.dat). If you wish the license.dat file to be stored somewhere else, you should enter that location now. Note that if you install the license file in the default location, you will not need to set the LM_LICENSE_FILE before running INTV!.

6. Next, the licensing script will ask you where you would like the license.log file to be located. The license.log file stores information returned by the licensing script. If you wish to put it in the default location, hit enter; otherwise type in the location where you would like it to reside.

After entering this basic information, you will begin the actual licensing of the application. All of the information required for this portion of the installation will be sent to you by the MDL support staff when you request your license keys.

7. The licensing program needs to know if you are installing node-locked or floating licenses for the listed feature.

8. You will be prompted to enter the feature you wish to license. The features that you can license are as follows:

opendve.engine—This feature allows the use of the ISconferenceEngine process. The Conference Engine is essential for using OpenDVE applications like INTV!. Each user running INTV! must have an opendve.engine license. You must enter the license information for this feature if you have elected to license any of the INTV! packages.

intv.chooser—An INTV! chooser license allows you to run the INTV! Media Chooser on the workstation.

intv.station—An INTV! station license allows you to run the INTV! Station software on the workstation.

9. Enter the 20 character license key assigned to your workstation for the listed feature and press Return. You must enter the license key exactly as returned by MDL.

The licensing program needs to know if you are installing node-locked or floating licenses for the listed feature.

10.Select the appropriate license type, either node-locked or floating, and press Return. INTV! will not function properly if you do not select the correct license type.

You need to specify the number of licenses assigned to the listed feature. For most license features, this value controls the number of users who can use the license simultaneously.

11.Enter the number of licenses assigned to the listed feature and press Return.

The licensing program asks if you are installing a permanent license for the listed feature. A permanent license is one that has been purchased and has no expiration date or other usage limitations. Answer "No" if you are installing license keys for a demonstration or evaluation of unpurchased software with an expiration date.

12.Answer "No" if you are not installing a permanent license.

If you are installing a license for a demonstration or for evaluation of unpurchased software assigned an expiration date, you will be asked for the expiration date. After the expiration date has passed, you are no longer able to run INTV!. An expiration date of 01-jan-00 indicates that the key is permanent and has no expiration date. You must enter the expiration date exactly as returned to you by MDL. If you do not, your licenses will not work and you will be unable to run INTV!.

After you have entered this information,

13.You are asked to repeat steps 7 through 10 for each feature that you have chosen to license. Enter the appropriate values when prompted.

Once you have entered the license information for all selected features, the license script creates a license file named license.dat in the location that you specified. The default location is:

/etc/insoft/license.dat

The licensing program merges licensed features into an existing license.dat file or, if necessary, creates a new license file. If you want, you can edit the file manually, but be sure to follow the FLEXlm format exactly as outlined in Appendix A, "Technical Issues".

If your site uses the FLEXlm License Manager for other software products, you may want to combine the license files. See the Using INTV! With Other FLEXlm Products section of Appendix A, "Technical Issues", for more information.

Every workstation running INTV! must have a valid license file. For workstations using floating keys, you must provide a copy of the license.dat file from the workstation acting as the License Server. It is often useful to place the license file in a directory available to any machine on the network. The license file’s location must be defined at runtime by the LM_LICENSE_FILF environment variable, unless you installed it in the default location.

The licensing program also adds commands to your system’s boot procedure for starting the License Manager at boot time. Either an /etc/init.d/lmgrd or /etc/rc.InSoftLicense script is created, depending on your platform’s operating system and boot-script naming convention. Be sure to modify the appropriate startup scripts if you ever change the location of your license file.

The boot-scripts starting the License Manager specify a log file where the License Manager outputs error messages. By default, this log file is license.log file located in the /etc/insoft directory. The default location is:

/etc/insoft/1icense.log

You can, however, edit the boot-scripts to change the location of the error log file.

If you encounter licensing problems, look in this log file for information that could help you locate the trouble.

Return to MDL Home Page