####################################################
INSTALLATION INSTRUCTIONS  (INSTALL.TXT)
StarQuest Client Access for UNIX OS Version 1.0.4.3 for Linux
Copyright (c) 1996-2003 StarQuest Ventures, Inc. [061203]


Contents:
  **Installation Requirements
  **Installation
  **USING Client Access for UNIX 
  **Known Limitations
  **NLS Packages

####################################################

Note:
This version of Client Access for UNIX contains new procedures
for installation and licensing.  You must install and configure
the StarLicense package before using Client Access for UNIX.


 
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)

  * Root user authority

  * Red Hat Linux 7.3 or above.
Other versions of Linux may work, but have not been tested.

  * OpenMotif (supplied with Red Hat Linux)

  * StarQuest StarLicense package

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.

####################################################


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/linux



3. Excecute the shell script "setup":

# ./setup

This will install Client Access for UNIX to the default location 
(/usr/share/ca400) and run post_install, which creates 
symbolic links and creates desktop items in the Start Menu
for both GNOME and KDE environments.

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 OpenMotif and StarLicense,
and notify you if these appear to be missing.



To remove Client Access for UNIX:

# cd /usr/share
# rm -rf ca400

for Red Hat 7.3:
# rm /usr/share/applnk/Applications/ca400.desktop
# rm /usr/share/gnome/apps/Applications/ca400.desktop

for Red Hat 8.0:
# rm /var/lib/menu/kde/Applications/ca400.desktop
# rm /usr/share/gnome/apps/ca400.desktop

for Red Hat 9.0:
# rm /var/lib/menu/kde/Applications/ca400.desktop
# rm /usr/share/applications/ca400.desktop



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=/usr/share/ca400
PATH=$PATH:$CA400/bin
MANPATH=$MANPATH:$CA400/man
LD_LIBRARY_PATH=$CA400/lib:$LD_LIBRARY_PATH

You may also want to set the environment variable BROWSER to use the
web browser of your choice (e.g. netscape, mozilla, galeon, 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

You can also start Client Access for UNIX by selecting "Client Access
for UNIX" from the Start Menu:

On Red Hat 7.3, it will appear under the Programs/Applications menu 
(GNOME) or the Applications menu (KDE).

On Red Hat 8.0, it will appear under Extras/Others (GNOME) or in the
main part of the Start Menu (KDE).

On Red Hat 9.0, it will appear under Others (GNOME) or in the
main part of the Start Menu (KDE).



Known Limitations
=================

xcabrowser:
The supplied help browser for X Windows (xcabrowser) does not function. 
We recommend using another web browser (e.g. netscape, mozilla) in
place of xcabrowser by setting the environment variable BROWSER.

xca5250:
After selecting Host Print function in xca5250 (X Windows version of the
5250 emulator), the message "Print Operation complete to the default
printer device file" appears at the bottom of the screen but input
will be inhibited.  Use Ctl-R to reset the terminal.

xca5250:
Copy does not work (However, Paste does work)


CAUNIX Linux NLS (National Language Support) package:
=====================================================

Localized support for user interfaces in Client Access is available by
installing the contents of the tar file "lnux-nlv.tar".  During installation,
you will be asked if you wish to install it.  If you choose to install it
later,  extract its contents into $CA400/nls:


# cat linx-nls.tar | (cd $CA400/nls; tar xf - )

This creates the following directories:
de  - German
es  - Spanish
it  - Italian
ja  - Japanese
ko  - Korean
nl  - Dutch
no  - Norwegian
sv  - Swedish
zh_CN  - Simplified Chinese
zh_TW - Traditional Chinese


Additional setup:

* If the name of the locale on Linux differs from the directory name,
you must create a symbolic link in the NLS directory. 

For instance, on Red Hat 7.3, the German locale is called deutsch, rather than
de, so you must create this symbolic link:

# cd $CA400/nls
# ln -s de deutsch


* You may need to modify values in the following tables:

$CA400/etc/ccsid.tab
  change values like "IBM-037" to "IBM037"

$CA400/etc/lang.tab (used by ca5250 & xca5250 emulators):
Add a line for each locale 
e.g. 
copy the line describing the locale "de_DE" and change "de_DE" to "deutsch" 

$CA400/etc/conf/5250lang.cs

$CA400/etc/conf/ccsid.cs

$CA400/etc/conf/lang.cs


Other useful info:

* to see a list of available locales, type:

$ locale -a

* to set your logon to a particular locale, use the LANG environment variable:

$ LANG=deutsch; export LANG   (sh, ksh, bash)
or
% setenv LANG deutsch              (csh)