####################################################
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]



Contents:
  **Installation Requirements
  **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