Installing AskPlus on HPUX
Contents
Installing AskPlus on HPUX Systems
Installing AskPlus for the first time
Installation on UNIX systems is done by creating the appropriate user and directory and loading a file called ASKPLUS. The host installation should be performed by the AskPlus/Visimage Administrator or the system operator. If you have any questions, please call our technical support staff.
Upgrading AskPlus
Before starting the installation, you must ensure that AskPlus is not in use and that the TCP/IP Listener process (vsrvtcp) is not running. See section 2.4 for instructions on stopping the listener process.
The installation loads new files, but does not overwrite the current version of AskPlus. The newest version will become the default version; however previous versions will still be installed and available. Parts of the installation may fail if any of the AskPlus files are in use.
Site-specific configuration files (Manager Files and vsrvtcp.ini) will not be overwritten. The Summit macrodef file WILL be overwritten. If you have modified this file, please make a copy before continuing with the installation.
Installation
Follow these steps to install and configure AskPlus/UX. Most of these steps are done while logged in as root. (Use “login root” or “su -” to ensure that the superuser login script is run.) Make sure that you login as askplus to complete the installation.
NOTE: Existing users upgrading AskPlus, skip to step 6
1. Login as root.
2. If AskPlus has been installed previously on your system, skip to step 6.
3. Create a new user called askplus. The home directory for this user should be the directory where you want to install the AskPlus software. Create a new directory, for example:
/usr/askplus
4. Create a symbolic link that will provide direct access to the directory just created. Type:
ln -fs /usr/askplus /ASKPLUS
This symbolic link makes it easy to run AskPlus without adding the AskPlus directory to your path. It also makes it possible to move the files without modifying any commands that refer to the link.
5. Add a new service to your host services file. Add the following line to your host services file (/etc/services): askplus 30501/tcp #AskPlus/Visimage server
Existing users, login as root and start here:
6. Switch to the /ASKPLUS directory
cd /ASKPLUS
7. Existing customers must stop the vsrvtcp listener process before continuing. This will disconnect any users that are currently running Visimage.
./kill_vsrvtcp -stop_all
8. Transfer the AskPlus distribution file (ASKPLUS.gz) to the host. The file must be transferred to the host using a BINARY transfer. Use FTP, or a terminal emulator to transfer the file. These instructions assume that the name of the file is ASKPLUS.gz. Your file may have a different name. Substitute the name of your file (making sure that you use the appropriate case) for ASKPLUS in these instructions.
9. The file that was transferred in the previous step is a compressed tar file. To uncompress and expand this file, enter these commands:
gunzip ASKPLUS.gz tar -xvf ASKPLUS
10. Modify the properties of the vsrvtcp program file. Type:
chmod +s vsrvtcp
Finally, 11. Login as askplus and make sure you are in the /ASKPLUS directory. Type:
login askplus cd /ASKPLUS
12. Complete the installation by running the vinstall script. If you are installing AskPlus to use with Eloquence, type:
./vinstall
NOTE: If you are installing AskPlus to use with an Oracle database, type:
./vinstall oracle
Special Note for Eloquence Users
By default, the Eloquence libraries are expected to be located in the directory /opt/eloquence6/lib/pa20_32. If this is not correct, you need to make sure that the parameter SHLIB_PATH includes the correct path. Edit the askplus script (/ASKPLUS/askplus) and update the SHLIB_PATH variable to supply the correct path. To locate the path, type:
find / -name libeqdb.sl -print
Special Note for Oracle Users
By default, the Eloquence libraries are expected to be located in the directory /$ORACLE_HOME/lib. If this is not correct, you need to make sure that the parameter SHLIB_PATH includes the correct path. Edit the askplus script (/ASKPLUS/askplus) and update the SHLIB_PATH variable to supply the correct path. To locate the path, type:
find / -name libcintsh.sl.* -print
Verifying AskPlus
To verify that the programs have been properly installed, type the following command:
/ASKPLUS/askplus
If everything has been properly installed you will see something like this:
Copyright ARES (c) 1978-2005. ASKPLUS/UNIX <version> ready! >
Type EXIT, to exit the AskPlus program.
Accessing Eloquence Data
AskPlus should now be ready to use. Type the following commands to see if you can access your Eloquence data:
/ASKPLUS/askplus open localhost:eloq-LIVE/MEMBRS,LOOKUP; form sets exit
Accessing Oracle Data
AskPlus should now be ready to use. Type the following commands to see if you can access your Oracle data:
/ASKPLUS/askplus open oracle username, password; form sets exit
For immediate technical support contact support@vital-soft.com or call 1-800-848-2576 ext 21
