StarQuest Technical Documents
Client Access for UNIX Quick Start Guide
Last Update: 23 March 2009
Product: Client Access for UNIX
Version: 1.0.5
Article ID: SQV00CA001
Abstract
This Quick Start Guide describes how to install, license, 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 Configure StarLicense
Step 4: Set Environment Variables
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
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
|
Note to Linux Users: The StarQuest installer for CAUNIX is designed to work with Red Hat Linux, but it should also work for other Linux distributions. If you run the installer on a different Linux distribution:
|
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 CAUNIX 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. The non-English language support is optional. Following is an example of the prompts and responses for running the scripts on a Linux computer.
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 Configure StarLicense
The StarLicense software 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.)
To license the software, you need the Download Instructions that were sent to the email address specified in the StarQuest Product Download Request form. You need these instructions and Internet access to license the software. If you do not request a license key, you can install the StarLicense software now and license the software at a later time.
Install StarLicense
- 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 StarLicense 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 are not prepared to request a 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 license key.
- Answer y (Yes) if you are prepared to request a license key and want to enter it now.
Request License and Configure StarLicense
If you opted to administer StarLicense after the installation, you will be presented with the StarLicense Configuration Menu. Or, enter configure from the StarLicense installation directory to display the StarLicense Configuration Menu. The StarLicense Configuration Menu presents the following options:
StarLicense Configuration Menu
1) Add license with Registration Key (via Internet)
2) Add license with License Key
3) Remove a License Key
4) Start License Server daemon
5) Stop License Server daemon
6) Display License Server status
7) Test licensing checkout
8) Display StarLicense configuration
9) Configure client to use a remote License Server
10) Remove a client-server connection
11) Licensing Help
12) Exit
If the computer running StarLicense has access to the Internet, follow the Online Licensing Instructions below. Otherwise, follow the Alternate Licensing Instructions.
Online Licensing Instructions
- Select option 1) Add license with Registration Key (via Internet).
- If you want to license this particular computer, answer yes (y) to the prompt. If you want to license a different computer, follow the Alternate Licensing Instructions below.
- Copy the Registration Key from the download confirmation email and paste it into the Registration Key field of the licensing window. Press Enter and allow time for StarLicense to connect to the StarQuest licensing server to obtain a license key. If the request fails, correct the error and retry or use the Alternate Licensing Instructions below.
- After a license key is obtained, a Listener is configured. Enter the IP Address that StarLicense should listen on. If you want StarLicense to listen on all configured IP Addresses, leave this field blank. Press Enter.
- Type the port number that you want StarLicense to listen on for licensing requests. If the default port, 4999, is acceptable, leave this field blank and press Enter.
Alternate Licensing Instructions
- From a computer that has access to the Internet, click on or browse to the following URL:
http://starcust.starquest.com/Registration/index.html#license
- On the StarQuest Online Licensing Form web page, enter in the e-mail address used for the original download request and the Registration Key you received in the download confirmation email.
- Enter the IP Address of the computer where StarLicense is installed. If the computer has multiple IP Addresses configured, any one of the IP Addresses can be used. Enter the address in decimal dot notation (e.g., 192.168.44.12).
- Select the License Server radio button. Click Next.
- Review the information provided. If any changes are required, click Previous and modify the values as needed. Otherwise, click the Accept button.
- Copy the license key for use in Step 8. You will also receive an e-mail with the license key.
- From the StarLicense Configuration Menu, choose option 2) Add license with License Key.
- Type (or paste the copied string) at the License Key prompt and press Enter.
- After a license key has been entered, a Listener is configured. Enter the IP Address that StarLicense should listen on. If you want StarLicense to listen on all configured IP Addresses, leave this field blank. Press Enter.
- Enter in the port number that you want StarLicense to listen on for licensing requests. If the default port, 4999, is acceptable, leave this field blank and press Enter.
Start StarLicense
After configuring StarLicense with a license key, return to the StarLicense Configuration Menu and select option 4) Start License Server daemon.
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
StarLicense Release Notes
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.