Installing AskPlus on HPUX

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. Instructions for 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

Examples for Eloquence 8

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:

PA-Risc Example :
Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
ASKPLUS/Unix E.8.x.x (32 bits) ready ! Thu Jan 16 16:27:04 2014

ITANIUM Example :
Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
ASKPLUS/Unix E.8.x.x (64 bits) ready ! Thu Jan 16 16:27:04 2014

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