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.