View source for Installing AskPlus on HPUX

==Installing AskPlus on HPUX Systems==

===Downloading AskPlus{{AskPlus_Current_Version_Upper}}===

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.

* [https://www.vital-soft.com/download/secure/software/ASK_eloq_{{AskPlus_Current_Version_Lower}}.gz Download] the install file for '''PA-Risc'''.

 $ md5sum ASK_eloq_e847.gz
 5e02e481b24bc96edc16b9988fe2a96f ASK_eloq_e847.gz
 $ cksum ASK_eloq_e847.gz
 1744700389 1857802 ASK_eloq_e847.gz

* [https://www.vital-soft.com/download/secure/software/ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz Download] the install file for '''ITANIUM'''.

 $ md5sum ASK64_eloq_e847.gz
 1cb65514bdbc19795ae833b4402095a2 ASK64_eloq_e847.gz
 $ cksum ASK64_eloq_e847.gz
 2142157918 3495341 ASK64_eloq_e847.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 [[Updating AskPlus|these instructions]] to update AskPlus.

===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.'''

1. Login as root.

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

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

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

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_{{AskPlus_Current_Version_Lower}}.gz
:* For '''PA-Risc''' systems the file is called: ASK_eloq_{{AskPlus_Current_Version_Lower}}.gz

These instructions assume that the name of the file is ASK64_eloq_{{AskPlus_Current_Version_Lower}}.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_{{AskPlus_Current_Version_Lower}}.gz
 tar -xvf ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz

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

'''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/eloquence/8.1/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

[https://wiki.vital-soft.com/index.php?title=AskPlus_FAQ#Upgrading_Eloquence_to_version_8 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 {{AskPlus_Current_Version_Upper}} (32 bits) ready !

 ITANIUM Example :
 Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
 ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (64 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

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