Sun WorkShop Installation and Licensing Reference

Sun's User License Scheme

Sun uses GLOBEtrotter Software, Inc.'s FLEXlm license manager software to manage Sun WorkShop user licenses.

The machine running the license manager daemon is called the license server. Requests come from application servers. An application server is any computer on which an application is installed.

The License File

The license administrator installs the license file (licenses_combined file), which is a text file that contains licensing data. This file contains information about the server nodes and vendor daemons and at least one line of data (FEATURE or INCREMENT) for each licensed product.

The license file, or a copy of it, must be accessible to every machine running the licensed software and each machine designated as a license server. This file is located on the license server in the /etc/opt/licenses directory.

To display all installed licenses, type:

% cd /etc/opt/licenses

% lmstat -a -c licenses_combined

For more information, see the lmstat man page.

Elementary License Files

The elementary license files are subsets of the licenses_combined file. Elementary license files are located in the install-directory/SUNWspro/license_dir directory on each application server (the default install-directory is /opt). License files for Sun WorkShop products have file names in the form sunpro.lic,n (for example, sunpro.lic,1). The n is a string, usually an integer, assigned during installation to identify a particular license file.

Sun WorkShop software checks the installation directory for licenses. The product software automatically looks for the elementary license file relative to where it was installed.

In a multiple independent license server configuration, application servers might be served by more than one license server. Each license server is represented by an elementary license file on the application servers. Each application server must contain at least one elementary license file. Each elementary license file contains the license server information and the product license.

The License Manager Daemon

The license manager daemon starts and restarts the vendor daemons, which grant or deny licenses to the licensed software. When a user starts an application, the application looks at the elementary license file for the name of the license server and contacts the license manager daemon (lmgrd.ste) on that server. If a license token is available, the user is granted the use of the application. If a license token exists but is not currently available (for example, if other users have checked out all the license tokens), the user will be put into a queue.

Note -

Sun uses the lmgrd.ste license manager daemon, which is identical to FLEXlm's lmgrd license manager daemon.

The Vendor Daemon

The license manager daemon handles communication between the application and the vendor daemon. The vendor daemon, which runs on the license server, tracks which users have licenses for a given product, how many licenses are checked out, and how many licenses are currently available. Sun WorkShop 5.0 products use the sunwlicd vendor daemon (releases prior to Sun WorkShop 5.0 used the suntechd vendor daemon). If the vendor daemon terminates, users lose their licenses. When the license manager daemon restarts the vendor daemon, users regain their licenses automatically.

Sun WorkShop Software

Sun WorkShop software is linked with the program module (the license library) to communicate with the license server. When the software is in use, it communicates with the vendor daemon to request a license.

The `daemon_options` File

The daemon_options file is installed in the /etc/opt/licenses directory. The daemon_options file allows you to:

Reserve licenses for specified users, hostnames, or display names

Allow or deny use of applications based on user, hostname, or display name.

Control the information logged about license use

When lmgrd.ste starts the vendor daemon, the vendor daemon receives the location of the daemon_options file. This location is identified in the product's license file on the DAEMON line. If no file is listed, the daemon will not use any options file. Only one options file per vendor daemon is allowed.

To modify the daemon_options file, use the options listed in Table 2-1. For feature names, see Appendix A in Sun WorkShop Quick Install.

Table 2-1 daemon_options Options


Command	Description
`EXCLUDE`	Denies a user access to a feature
`EXCLUDEALL`	Denies a user access to all features of this vendor daemon
`GROUP`	Defines a group of users for use with other options
`HOST_GROUP`	Defines a group of hosts for use with other options
`INCLUDE`	Allows a user access to a feature
`INCLUDEALL`	Allows a user to access all features served by this vendor daemon
`LINGER`	Causes licenses to be held by the vendor daemon for a period of time after the application checks them in or exits
MAX	Limits use for a particular feature/group and prioritizes use among users
`NOLOG`	Turns off logging of certain items
`RESERVE`	Saves licenses for a user
`#`	Specifies that the text that follows is a comment, not a command

The following is an example of a daemon_options file:

#Don't log IN, OUT, and QUEUED
NOLOG IN
NOLOG OUT
NOLOG QUEUED
LINGER workshop.c.sparc 300
LINGER workshop.cc.sparc 300
#RESERVE number feature {USER | DISPLAY | GROUP} name
#INCLUDE feature {USER | DISPLAY | GROUP} name
#EXCLUDE feature {USER | DISPLAY |GROUP} name
RESERVE 1 workshop.c.sparc USER pat
RESERVE 3 workshop.tools.sparc USER lee
EXCLUDE workshop.c.sparc USER joe

The sample daemon_options file was edited to specify:

The license log will not record licenses checked in, checked out, or queued.
The C and C++ compiler licenses will delay for 300 seconds before returning licenses to the license server for use by other developers.
One C compiler license is for use only by pat.
Three Sun WorkShop IPE licenses are for use only by lee.
No C compiler license is for use by joe.

Note -

For redundant server configurations, the daemon_options file must be the same on each server. For multiple independent server configurations, the daemon_options file can be different on each server.

To minimize server down time when changing the daemon_options file, follow these steps:

Make the needed changes to the daemon_options file.

Stop the license daemon.

See "Stopping and Restarting the License Daemons".

Restart the license daemon.

See "Stopping and Restarting the License Daemons".

Note -
If you modify the daemon_options file, your changes do not take effect until the license daemon is started or restarted.

For more information about the options file, visit the GLOBEtrotter Software, Inc. site on the World Wide Web:

http://www.globetrotter.com/chap5.htm