####################################################
INSTALLATION INSTRUCTIONS (INSTALL.TXT) for HP-UX
StarQuest Client Access for UNIX OS Version 1.0.4.4 for HP-UX
Copyright (c) 1996-2005 StarQuest Ventures, Inc. [081505]
**Initial Installation
####################################################
INSTALLATION REQUIREMENTS
-------------------------
Make sure you have each of the following before you proceed:
* AS/400 running OS400 V3R1 or above
PTFs: You should have the latest PTFs available
from IBM for the Host Socket Servers installed
on your AS400.
* TCP/IP and access to one or more AS/400 servers
* Sufficient disk space for installation
(approx. 20MB plus 20MB for temporary files)
* Root user authority
* HP-UX 11.11 or above installed on your system
* ( X WINDOW ONLY) COSE Icons: Install CDE Runtime from the HP
System CD.
Client Access for UNIX can be installed on a server or on as many
clients as needed. Your license agreement provides a certain
number of concurrent connections.
If you will be developing applications using the Client Access for UNIX
APIs with languages other than aC++, please contact StarQuest Support
for important information.
QUICK INSTALLATION INSTRUCTIONS
===============================
1. Logon to UNIX as root.
2. cd to the directory containing the
Client Access for UNIX installer for your UNIX platform.
# cd /mnt/cdrom/caunix/hp-ux
3. Excecute the shell script "setup":
# ./setup
This will install Client Access for UNIX to the default location
(/opt/ca400) and run post_install, which creates
symbolic links and creates desktop items.
You will be prompted if you wish the install the NLS
(National Language Support) package for localized user interfaces.
The installer will also check for the presence of StarLicense,
and notify you if these appear to be missing.
NOTE:
The NLS packages were created with HP-UX 10.20, and require
the -x allow_incompatible=true option:
e.g.
swinstall -x allow_incompatible=true -s hp-ux/nlv2923 CA400.NLV2923
or, in the swinstall GUI, select the option "Allow installation of
incompatible software".
You will see the following warning when installing the NLS packages;
you can ignore the warning.
WARNING: "emma.isqv.com:/": 1 products are not compatible for this
system's architecture or operating system. If the OS has been
updated since this product was installed, a newer version
should be installed if available.
To remove Client Access for UNIX:
Type:
# swlist | grep "Client Access"
to seee which ca400 packages are installed.
# swremove NLVxxxx for all NLS packages that are installed.
# swremove CA400
USING Client Access for UNIX
============================
Once you have installed Client Access for UNIX, you will need to set up your
user profile with the appropriate files and environment variables.
Add the following environment variables to your .profile or .cshrc:
CA400=/opt/ca400
PATH=$PATH:$CA400/bin
MANPATH=$MANPATH:$CA400/man
SHLIB_PATH=$CA400/lib:$SHLIB_PATH
You may also want to set the environment variable BROWSER to use the
web browser of your choice (e.g. netscape, mozilla, lynx, opera)
in place of the supplied cabrowser and xcabrowser when viewing the
documentation and help files:
BROWSER=netscape
Run StarQuest Client Access for UNIX OS by using one of these commands:
X Window: xcamenu
Character-oriented terminals: camenu
