StarQuest Technical Documents
Client Access for UNIX Quick Start Guide
Last Update: 6 September 2005
Product: Client Access for UNIX
Version: 1.0.5
Article ID: SQV00CA001
Abstract
This Quick Start Guide describes how to install and configure the Client Access for UNIX (CAUNIX) software on all supported UNIX platforms. It covers the following major tasks:
Step 1: Prepare the CAUNIX and StarLicense Packages for Installation.
Step 3: Install and Administer StarLicense.
Solution
The following sections guide you through the steps that are summarized in the preceding Abstract.
Step 1: Prepare the CAUNIX and StarLicense Packages for Installation
You can download the Client Access for UNIX and StarLicense for UNIX software from the StarQuest Ventures Web site, http://www.starquest.com. If the packages you download from StarQuest are compressed (i.e., .Z files), uncompress them to a temporary directory using the uncompress <filename> command, as shown in the following examples for the Linux packages.
# uncompress caunix_linux.tar.Z
# uncompress starlicense_linux.tar.Z
Untar the files using the tar -options <filename> command.
# tar -xvf caunix_linux.tar
# tar -xvf starlicense-linux-rpm.tar
Step 2: Install CAUNIX
Log on as the root user. From the temporary directory that contains the CAUNIX installation source files, run the setup script to start the installation.
# cd /tmp/caunix # ./setup
The installation process installs the CAUNIX software into the default directory, as shown in the following table for each supported UNIX platform.
| UNIX Platform |
Default Installation Directory |
|---|---|
AIX |
/usr/lpp/ca400 |
HP-UX |
/opt/ca400 |
Linux |
/usr/share/ca400 |
Solaris |
/opt/ca400 |
Answer Yes (y) when prompted to install Client Access for UNIX and run the post_install script, as shown in the example below. The non-English language support is optional.
This script uses tar to install Client Access for UNIX to /usr/share/ca400 and should be run as root.
Do you wish to continue (y/n)? y
This script will now run /usr/share/ca400/etc/post_install
Do you wish to continue (y/n)? y
Installation done.
Be sure to set the environment variables $CA400 and modify $PATH and $LD_LIBRARY_PATH before using Client Access for UNIX.
Would you like to install language support for non-English locales (y/n)? y
Checking for pre-requisites:
OpenMotif is required for using the X Windows applications.
Your system has:openmotif-2.2.3-6.FC3.1
The StarLicense package was not found.
You must install the StarLicense package and configure a valid license before using Client Access for UNIX.
Step 3: Install and Administer StarLicense
You must have a license to use the CAUNIX software. The StarLicense product manages the licenses for all StarQuest products and is available for download from the StarQuest Web site. (See Step 1: Prepare the CAUNIX and StarLicense Packages for Installation. ).
If you have a license key from StarQuest for using the CAUNIX product, you can enter it and license the product during this step. If you do not yet have a license key, you can install the StarLicense software now and access the StarLicense Configuration Menu after you receive your license key.
Log on as root user. From the temporary directory that contains the StarLicense installation source files, run the setup script to start the installation. The installation process installs the StarLicense software into the default directory shown in the following table for each supported UNIX platform.
| UNIX Platform |
Default Installation Directory |
|---|---|
AIX |
/usr/lpp/starlicense |
HP-UX |
/opt/starlicense |
Linux |
/usr/share/starlicense |
Solaris |
/opt/starlicense |
As the setup script runs, you must respond to various prompts and reminders, answering y (Yes) to proceed with the installation. Following is an example of the prompts and responses for running the script on a Linux computer.
# ./setup
This script uses rpm to install StarLicense for UNIX to /usr/share/starlicense and should be run as root.
Do you wish to continue (y/n)? y
After the StarLicense software is installed, a prompt appears to ask if you want to administer the StarLicense server.
Answer n (No) if you do not have your CAUNIX license key yet. After you obtain a license key enter configure from the StarLicense installation directory to display the StarLicense Configuration Menu and enter the key.
Answer y (Yes) if you have a CAUNIX license and want to enter the key now.
The StarLicense Configuration Menu presents the following options:
StarLicense Configuration Menu
1) Configure a client connection to a License Server
2) Set up a License Server
3) Install a local client license
4) Start the License Server daemon
5) Stop the License Server daemon
6) Display status of the License Server daemon
7) Display StarLicense configuration
8) How to contact StarQuest for a license key
9) Exit
Select option 2) Set up a License Server. Enter the license key provided by StarQuest Customer Support and press Enter to continue. The following shows an example of the prompts and responses for setting up a license server, using a fictitious license key, accepting the default TCP/IP Interface, and the default TCP/IP port address of 4999.
Enter license key: 0A971D69D75D52535C8F2BA752908B3B
starlic-admin server-key-add 0A971D69D75D52535C8F2BA752908B3B
Ok
Enter TCP/IP interface [0.0.0.0]:
Enter TCP/IP port address [4999]:
starlic-admin server-listener-add 0.0.0.0 4999
Ok
[Press RETURN to continue]
Press Enter to return back to the menu.
At the StarLicense Configuration Menu select option 1) Configure a client connection to a License Server. The following example prompts and responses show how to configure a connection for the CAUNIX product, which uses CA for the product ID (ProdID).
Enter Hostname or TCP/IP address of the license server: localhost
Enter TCP/IP port address [4999]:
Enter ProdID (SQ=StarSQL or StarSQL for Java; CA=Client Access for UNIX): CA
starlic-admin client-server-add SQ localhost 4999 PRI
Ok
[Press RETURN to continue]
Press Enter to return to the main menu and then select option 4) Start the License Server daemon to start StarLicense. After the daemon starts, press Enter to return to the main menu and select option 9 to exit the Configuration Menu.
Step 4: Set Environment Variables
Each CAUNIX user must have the appropriate environment variables specified in their .profile or .cshrc file. The following table shows the environment variables, as appropriate for each of the supported UNIX platforms, that must be defined for CAUNIX.
| UNIX Platform |
Environment Variables |
|---|---|
AIX |
CA400=/usr/lpp/ca400 PATH=$PATH:$CA400/bin MANPATH=$MANPATH:$CA400/man LIBPATH=$CA400/lib:$LIBPATH |
HP-UX |
CA400=/opt/ca400 PATH=$PATH:$CA400/bin MANPATH=$MANPATH:$CA400/man SHLIB_PATH=$CA400/lib:$SHLIB_PATH |
Linux |
CA400=/usr/share/ca400 PATH=$PATH:$CA400/bin MANPATH=$MANPATH:$CA400/man LD_LIBRARY_PATH=$CA400/lib:$LD_LIBRARY_PATH |
Solaris |
CA400=/opt/ca400 PATH=$PATH:$CA400/bin MANPATH=$MANPATH:$CA400/man LD_LIBRARY_PATH=$CA400/lib:$LD_LIBRARY_PATH |
English language users also may want to set in the user's profile the LANG variable to C or en_US. Non-English language users should contact StarQuest Customer Support for instructions on how to configure CAUNIX to support other languages.
Step 5: Configure CAUNIX
Run the camenu or xcamenu command to launch the Client Access for UNIX OS Main Menu. Note that you will need to have StarLicense properly configured with a temporary or permanent license key in order to configure and use CAUNIX.
CLIENT ACCESS FOR UNIX OS -- MAIN MENU
1) 5250 Emulator
2) File Transfer
3) Remote Command
4) Server Manager
5) Configuration
6) Help
Each CAUNIX user must configure one or more servers in the Server Manager. Select option 4) Server Manager to configure a connection to the AS/400.
Tab to [Add] and press Enter. Enter either the network host name or the IP address of the AS/400 computer. When prompted, enter a valid AS/400 User ID and Password combination.
If CAUNIX is able to make a connection to the AS/400, the server will be listed in the Server Manager list. If an error occurs, resolve the problem or contact StarQuest Customer Support for assistance.
After a server has been successfully added via the Server Manager, you can run any of the CAUNIX applications, such as the 5250 Emulator or Remote Command, from the CAUNIX Main Menu. You also can run the applications directly from the $CA400/bin directory, such as ca5250, caftp, carc, xca5250, xcaftp, xcarc.
|
Use ESC+M to access the menu of any CAUNIX applications that use a character-oriented terminal interface. |
Additional References
Client Access for Unix man pages
Client Access for UNIX User's Guide
DISCLAIMER
The information in technical documents comes without any warranty. 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 information in technical documents may be gathered from various sources, including IBM, Microsoft, and other organizations.