StarQuest Technical Documents

Adding Client Access License Manager to the Boot Process (HP-UX, SunOS)

Last Update: March 10, 1998
Product: Client Access for UNIX
Operating System: HP-UX, SunOS
Article ID: SQV00CA004

Problem

As of August 2005, all current shipping versions of CAUNIX use StarLicense licensing in place of Flex licensing. Although the details of starting the License Manager at reboot have changed, the concepts below still apply. Please contact StarQuest Support if you need assistance.

Client Access requires a Flex license for the applications to work. After licensing the software for the first time, it is not added to the boot process. The following steps outline how to ensure that the license manager daemon will come up on each reboot.

Solution

To get Client Access's license manager to restart on reboot, you need to create a script in the /etc/rc2.d directory that points to the $CA400/etc/conf/rc.ca400 file under SunOS. For HP-UX, the file needs to be put in /sbin/rc2.d.

STEP 1

Log in as super-user (root), or switch your effective user ID to super-user with the "su" (switch user) command:

$ su - root

root's Password:

% id

uid=0(root) gid=0(system)

%

STEP 2

If you have not already done so, you should create an "rc" script to restart the Client Access license manager at boot-time. This can be done (at the same time the product is licensed) by running the "lmadmin" (License Manager Administration) program. If you have already licensed Client Access, please move to STEP 3.

Set environment variable "CA400" to the full pathname of the directory in which Client Access is installed and configured. Also set "STARLM" to the full pathname of the directory in which you installed the "STARLM" license manager package. For example,

% CA400=/usr/lpp/ca400

% STARLM=/usr/lpp/starlm

% export CA400 STARLM

Run program "lmadmin" and respond to all prompts carefully. Before the program exits it will deposit a customized "rc" script for you in the file ${CA400}/etc/conf/rc.ca400

Following is the output of a sample session using "lmadmin":

% cd ${CA400}/etc

%< ./lmadmin/p>

Do you wish to license the Client Access package (y/n)? yes

Enter license key: abcd1234efgh4568ijkl

Enter license expiration date: 31-jan-1999

Enter number of users to be licensed: 8

...

Do you wish to start the license manager daemon (y/n)? yes

Starting license manager daemon...

% cd ${CA400}/etc/conf

% cat rc.ca400

!/bin/sh

#

# @(#)Start daemons required by Client Access package

#

CA400=/user/lpp/ca400

STARLM=/user/lpp/ca400

LMGRD_PATH=${STARLM}/bin/lmgrd

LICENSE_FILE_PATH=${CA400}/etc/conf/license.dat

LOG_PATH=${CA400}/etc/conf/license.log

nohup ${LMGRD_PATH} -c ${LICENSE_FILE_PATH}

1>${LOG_PATH} 2>&1 &

STEP 3

HP-UX

Create a script in the /sbin/rc2.d directory with a name beginning with Snnn, where nnn is a 3 digit number greater than 800. The S shows the operating system that at init state 2, the named file should be run with the start parameter. The 3 digit number that follows has to be greater than 800, at which time the operating system will be functional. It is safest to use 990, making the file S990ca400. Edit the script, with vi or a text editor, and add the line ${CA400}/etc/conf/rc.ca400(where shell environment variable "CA400" contains the full path-name of the directory in which Client Access is installed and configured).

Be certain the file mode allows read/write/execute access by super-user but READ-ONLY access for all other users:

% cd /sbin

% chmod 0744 S990ca400

% ls -l S990ca400

-rwxr--r-- 1 root system 45 Jan 31 1997 S990ca400

SunOS

Create a script in the /etc/rc2.d directory with a name beginning with Snn, where nn is a 2 digit number greater than 80. The S shows the operating system that at init state 2, the named file should be run with the start parameter. The 2 digit number that follows has to be greater than 80, at which time the operating system will be functional. It is safest to use 99, making the file S99ca400. Edit the script, with vi or a text editor, and add the line ${CA400}/etc/conf/rc.ca400(where shell environment variable "CA400" contains the full path-name of the directory in which Client Access is installed and configured).

Be certain the file mode allows read/write/execute access by super-user but READ-ONLY access for all other users:

% cd /etc

% chmod 0744 S99ca400

% ls -l S99ca400

-rwxr--r-- 1 root system 45 Jan 31 1997 S99ca400

STEP 4

If you logged in as super-user (in STEP 1), log out now. If you used the "su" command to switch your effective user ID to super-user, type "exit" to return to the parent shell (the shell you were using when you started STEP 1 above).

The system is now configured to restart any required Client Access daemons the next time a reboot occurs.


DISCLAIMER

The information in technical documents comes without any warranty or applicability for a specific purpose. The author(s) or distributor(s) will not accept responsibility for any damage incurred directly or indirectly through use of the information contained in these documents. The instructions may need to be modified to be appropriate for the hardware and software that has been installed and configured within a particular organization.  The information in technical documents should be considered only as an example and may include information from various sources, including IBM, Microsoft, and other organizations.