Difference between revisions of "Installing AskPlus on HPUX"

From Vital Soft Wiki
Jump to: navigation, search
>Johno
(Installation)
 
(35 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Installing AskPlus on HPUX Systems==
 
==Installing AskPlus on HPUX Systems==
  
===Downloading AskPlus{{AskPlus_Current_Version_Upper}}===
+
===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.
 
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/ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz Download] the install file for '''ITANIUM'''.
+
* [https://vital-soft.com/?page_id=544&product=askplus Download] the install file.
  
$ md5sum ASK64_eloq_e847.gz
+
* '''Itanium'''
0b58dffe0c51fc693637997edf7afc8d ASK64_eloq_e849.gz
 
$ cksum ASK64_eloq_e847.gz
 
96912135 3398996 ASK64_eloq_e849.gz
 
  
* [https://www.vital-soft.com/download/secure/software/ASK_eloq_{{AskPlus_Current_Version_Lower}}.gz Download] the install file for '''PA-Risc'''.
+
$ md5sum ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
 +
1531462bab0088a44048db2d9e79e67d ASK64_eloq_e854.gz
 +
$ cksum ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
 +
3724625910 3419089 ASK64_eloq_e854.gz
  
  $ md5sum ASK_eloq_e847.gz
+
* '''RedHat RHEL'''
  52d2bad9f187fed37deacdcf0637bf00 ASK_eloq_e849.gz
+
 
  $ cksum ASK_eloq_e847.gz
+
$ md5sum ASK64_eloq_{{AskPlus_RHEL_Version_Lower}}.gz
  132268176 1760395 ASK_eloq_e849.gz
+
fe1e4c716569c886ade40d67536cdf72  ASKRH_eloq_e856.gz
 +
$ cksum ASK64_eloq_{{AskPlus_RHEL_Version_Lower}}.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_{{AskPlus_PARISC_Version_Lower}}.gz
 +
  777a6719b6104122146c4a440bb61ff5 ASK_eloq_e850.gz
 +
  $ cksum ASK_eloq_{{AskPlus_PARISC_Version_Lower}}.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.
 
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.
Line 27: Line 36:
 
:If you have any questions, please call our technical support staff.
 
:If you have any questions, please call our technical support staff.
  
===Upgrading AskPlus===
+
===<span style="background:yellow">Upgrading AskPlus</span>===
  
:Existing clients should use [[Updating AskPlus|these instructions]] to update AskPlus.
+
Existing clients should use [[Updating AskPlus|these instructions]] to update AskPlus.
  
 
===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.'''
+
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.
 
1. Login as root.
  
 
2. Create a new user called askplus.
 
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:  
+
Create a directory where you want to install the AskPlus software. Create a new directory, for example:  
  /usr/askplus
+
  /opt/askplus
  
 
3. Create a symbolic link that will provide direct access to the directory just created. Type:
 
3. Create a symbolic link that will provide direct access to the directory just created. Type:
  ln -fs /usr/askplus /ASKPLUS
+
  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.
 
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):
 
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
 
  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
 
5. Switch to the /ASKPLUS directory
Line 53: Line 68:
 
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.
 
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 '''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
+
:* 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_{{AskPlus_Current_Version_Lower}}.gz.
 
These instructions assume that the name of the file is ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz.
Line 59: Line 75:
 
7. The file that was transferred in the previous step is a compressed tar file. To uncompress and expand this file, enter these commands:
 
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
 
  gunzip ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
  tar -xvf ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
+
  tar -xvf ASK64_eloq_{{AskPlus_Current_Version_Lower}}
  
 
8. Modify the properties of the vsrvtcp program file. Type:
 
8. Modify the properties of the vsrvtcp program file. Type:
Line 71: Line 87:
 
  ./vinstall
 
  ./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
 
<!--
 
<!--
'''NOTE: If you are installing AskPlus to use with an Oracle database, type:'''
+
===Special Note for Oracle Users===
  ./vinstall oracle
+
 
 +
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]
  
===Special Note for Eloquence Users===
+
== Validaing AskPlus ==
  
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:
+
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:
find / -name libeqdb.sl -print
+
  /ASKPLUS/askplus -ig
  
===Special Note for Oracle Users===
+
If you get an Eloquence library error, make sure you check the section above to verify the LD_LIBRARY_PATH.
  
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:
+
When you receive the validation code from Vital Soft, enter it using:
find / -name libcintsh.sl.* -print
+
  /ASKPLUS/askplus -is
  
[https://wiki.vital-soft.com/index.php?title=AskPlus_FAQ#Upgrading_Eloquence_to_version_8 Examples for Eloquence 8]
+
To check that the validation is correct, re-enter:
 +
  /ASKPLUS/askplus -ig
  
 
==Verifying AskPlus==
 
==Verifying AskPlus==
Line 95: Line 119:
 
If everything has been properly installed you will see something like this:
 
If everything has been properly installed you will see something like this:
 
  ITANIUM Example :
 
  ITANIUM Example :
  Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
+
  Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
 
  ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (64 bits) ready !
 
  ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (64 bits) ready !
 +
 +
RedHat Example :
 +
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
 +
ASKPLUS/Linux {{AskPlus_RHEL_Version_Upper}} (64 bits) ready !
  
 
  PA-Risc Example :
 
  PA-Risc Example :
  Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
+
  Copyright LSWE (c) 1978-2020. Distributed by Vital Soft, Inc.
  ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (32 bits) ready !
+
  ASKPLUS/Unix {{AskPlus_PARISC_Version_Upper}} (32 bits) ready !
  
 
Type EXIT, to exit the AskPlus program.
 
Type EXIT, to exit the AskPlus program.
Line 112: Line 140:
 
  exit
 
  exit
  
==Accessing Oracle Data==
+
==Creating the Macro File==
  
AskPlus should now be ready to use. Type the following commands to see if you can access your Oracle data:
+
The final step is to create the macro file using the sample files provided.
/ASKPLUS/askplus
+
  cd /ASKPLUS/visimage
open oracle username, password;
+
  ../load_macros
form sets
 
exit
 
  
 
For immediate technical support contact support@vital-soft.com or call 1-800-848-2576 ext 21.
 
For immediate technical support contact support@vital-soft.com or call 1-800-848-2576 ext 21.

Latest revision as of 16:31, 16 November 2023

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.