Installing AskPlus on HPUX

From Vital Soft Wiki
Revision as of 16:31, 16 November 2023 by Johno (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Installing AskPlus on HPUX Systems

Downloading AskPlus E.8.5.4

We recommend that you right-click and choose "Download linked file as..." (or the equivalent option) as this should prevent your browser from automatically unzipping the file during the download. For verification purposes, the md5sum and cksum values are displayed below the download links.

  • Itanium
$ md5sum ASK64_eloq_e854.gz
1531462bab0088a44048db2d9e79e67d ASK64_eloq_e854.gz
$ cksum ASK64_eloq_e854.gz
3724625910 3419089 ASK64_eloq_e854.gz
  • RedHat RHEL
$ md5sum ASK64_eloq_e856.gz
fe1e4c716569c886ade40d67536cdf72  ASKRH_eloq_e856.gz
$ cksum ASK64_eloq_e856.gz
370625537 1970028 ASKRH_eloq_e856.gz
  • PA-Risc. Note E.8.5.0 is the most recent version available for PA-Risc.
$ md5sum ASK_eloq_e850.gz
777a6719b6104122146c4a440bb61ff5 ASK_eloq_e850.gz
$ cksum ASK_eloq_e850.gz
641509285 1775260 ASK_eloq_e850.gz

Note: Some browsers may automatically uncompress the file during download. If this happens, the ".gz" extension will be removed. In this case, skip the "gunzip" step in the instructions below.

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

Existing clients should use these instructions to update AskPlus.

Installation

Follow these steps to install and configure AskPlus on UNIX or Linux. 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.

1. Login as root.

2. Create a new user called askplus. Create a directory where you want to install the AskPlus software. Create a new directory, for example:

/opt/askplus

3. Create a symbolic link that will provide direct access to the directory just created. Type:

ln -fs /opt/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.

4. 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

To check if a port is in use, type these two commands:

grep 30501 /etc/services
netstat -a | grep 30501

5. Switch to the /ASKPLUS directory

cd /ASKPLUS

6. Transfer the AskPlus distribution file 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.

  • For Itanium systems the file is called: ASK64_eloq_e854.gz
  • For RedHat RHEL systems the file is called: ASKRH_eloq_e856.gz
  • For PA-Risc systems the file is called: ASK_eloq_e850.gz

These instructions assume that the name of the file is ASK64_eloq_e854.gz.

7. The file that was transferred in the previous step is a compressed tar file. To uncompress and expand this file, enter these commands:

gunzip ASK64_eloq_e854.gz
tar -xvf ASK64_eloq_e854

8. Modify the properties of the vsrvtcp program file. Type:

chmod +s vsrvtcp

9. Login as askplus and make sure you are in the /ASKPLUS directory. Type:

login askplus
cd /ASKPLUS

10. Complete the installation by running the vinstall script. If you are installing AskPlus to use with Eloquence, type:

./vinstall

Special Note for Eloquence Users

By default, the Eloquence libraries are expected to be located in a specific directory that is configured in the askplus script file. If this is not correct, you need to make sure that the parameter LD_LIBRARY_PATH includes the correct path. Edit the askplus script (/ASKPLUS/askplus) and update the LD_LIBRARY_PATH variable to supply the correct path. To locate the path, type:

find / -name libeqdb.so -print

Examples for Eloquence 8

Validaing AskPlus

On RedHat Linux servers, AskPlus must be validated before you can complete the install. Contact Vital Soft with the installation number generated by the following command:

 /ASKPLUS/askplus -ig

If you get an Eloquence library error, make sure you check the section above to verify the LD_LIBRARY_PATH.

When you receive the validation code from Vital Soft, enter it using:

 /ASKPLUS/askplus -is

To check that the validation is correct, re-enter:

 /ASKPLUS/askplus -ig

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:

ITANIUM Example :
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
ASKPLUS/Unix E.8.5.4 (64 bits) ready !
RedHat Example :
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
ASKPLUS/Linux E.8.5.6 (64 bits) ready !
PA-Risc Example :
Copyright LSWE (c) 1978-2020. Distributed by Vital Soft, Inc.
ASKPLUS/Unix E.8.5.0 (32 bits) 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

Creating the Macro File

The final step is to create the macro file using the sample files provided.

 cd /ASKPLUS/visimage
 ../load_macros

For immediate technical support contact support@vital-soft.com or call 1-800-848-2576 ext 21.