Difference between revisions of "Installing AskPlus on HPUX"

From Vital Soft Wiki
Jump to: navigation, search
>Johno
(Upgrading AskPlus)
 
(50 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}}===
 +
 +
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://vital-soft.com/?page_id=544&product=askplus Download] the install file.
 +
 +
* '''Itanium'''
 +
 +
$ 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
 +
 +
* '''RedHat RHEL'''
 +
 +
$ md5sum ASK64_eloq_{{AskPlus_RHEL_Version_Lower}}.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.
  
 
===Installing AskPlus for the first time===
 
===Installing AskPlus for the first time===
Line 7: 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>===
 
 
:Before starting the installation, you must ensure that AskPlus is not in use and that the TCP/IP Listener process (vsrvtcp) is not running. [https://wiki.vital-soft.com/index.php?title=Managing_Vsrvtcp_on_HPUX#Stopping_the_Listener 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.''
+
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.)  
  
'''NOTE: Existing users upgrading AskPlus, skip to step 6'''
+
'''Make sure that you login as askplus to complete the installation.'''
  
 
1. Login as root.
 
1. Login as root.
  
2. If AskPlus has been installed previously on your system, skip to step 6.
+
2. Create a new user called askplus.
 
+
Create a directory where you want to install the AskPlus software. Create a new directory, for example:  
3. Create a new user called askplus.
+
/opt/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:  
 
<pre>
 
/usr/askplus
 
</pre>
 
  
4. 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:
<pre>
+
ln -fs /opt/askplus /ASKPLUS
ln -fs /usr/askplus /ASKPLUS
 
</pre>
 
 
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.
  
5. 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
  
''Existing users, login as root and start here:''
+
To check if a port is in use, type these two commands:
 +
grep 30501 /etc/services
 +
netstat -a | grep 30501
  
6. Switch to the /ASKPLUS directory
+
5. Switch to the /ASKPLUS directory
<pre>
+
cd /ASKPLUS
cd /ASKPLUS
 
</pre>
 
  
7. Existing customers must stop the vsrvtcp listener process before continuing. This will disconnect any users that are currently running Visimage.
+
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.
<pre>
+
:* For '''Itanium''' systems the file is called: ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
./kill_vsrvtcp -stop_all
+
:* For '''RedHat RHEL''' systems the file is called: ASKRH_eloq_e856.gz
</pre>
+
:* For '''PA-Risc''' systems the file is called: ASK_eloq_e850.gz
  
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 ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz.
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:
+
7. The file that was transferred in the previous step is a compressed tar file. To uncompress and expand this file, enter these commands:
<pre>
+
gunzip ASK64_eloq_{{AskPlus_Current_Version_Lower}}.gz
gunzip ASKPLUS.gz
+
tar -xvf ASK64_eloq_{{AskPlus_Current_Version_Lower}}
tar -xvf ASKPLUS
 
</pre>
 
  
10. Modify the properties of the vsrvtcp program file. Type:
+
8. Modify the properties of the vsrvtcp program file. Type:
<pre>
+
chmod +s vsrvtcp
chmod +s vsrvtcp
 
</pre>
 
  
Finally,
+
9. '''Login as askplus''' and make sure you are in the /ASKPLUS directory. Type:
11. Login as askplus and make sure you are in the /ASKPLUS directory. Type:
+
login askplus
<pre>
+
cd /ASKPLUS
login askplus
 
cd /ASKPLUS
 
</pre>
 
  
12. Complete the installation by running the vinstall script. If you are installing AskPlus to use with Eloquence, type:
+
10. Complete the installation by running the vinstall script. If you are installing AskPlus to use with Eloquence, type:
<pre>
+
./vinstall
./vinstall
 
</pre>
 
  
'''NOTE: If you are installing AskPlus to use with an Oracle database, type:'''
+
===Special Note for Eloquence Users===
<pre>
 
./vinstall oracle
 
</pre>
 
  
 +
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
 +
<!--
 +
===Special Note for Oracle Users===
  
===Special Note for Eloquence 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]
  
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:
+
== Validaing AskPlus ==
<pre>
 
find / -name libeqdb.sl -print
 
</pre>
 
  
 +
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
  
===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:
<pre>
+
  /ASKPLUS/askplus -is
find / -name libcintsh.sl.* -print
 
</pre>
 
  
[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==
  
 
To verify that the programs have been properly installed, type the following command:
 
To verify that the programs have been properly installed, type the following command:
<pre>
+
/ASKPLUS/askplus
/ASKPLUS/askplus
 
</pre>
 
  
 
If everything has been properly installed you will see something like this:
 
If everything has been properly installed you will see something like this:
<pre>
+
ITANIUM Example :
PA-Risc Example :
+
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
+
ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (64 bits) ready !
ASKPLUS/Unix E.8.x.x (32 bits) ready ! Thu Jan 16 16:27:04 2014
+
 
</pre>
+
RedHat Example :
 +
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
 +
ASKPLUS/Linux {{AskPlus_RHEL_Version_Upper}} (64 bits) ready !
  
<pre>
+
PA-Risc Example :
ITANIUM Example :
+
Copyright LSWE (c) 1978-2020. Distributed by Vital Soft, Inc.
Copyright LSWE (c) 1978-2011. Distributed by Vital Soft, Inc.
+
ASKPLUS/Unix {{AskPlus_PARISC_Version_Upper}} (32 bits) ready !
ASKPLUS/Unix E.8.x.x (64 bits) ready ! Thu Jan 16 16:27:04 2014
 
</pre>
 
  
 
Type EXIT, to exit the AskPlus program.
 
Type EXIT, to exit the AskPlus program.
Line 126: Line 135:
  
 
AskPlus should now be ready to use. Type the following commands to see if you can access your Eloquence data:
 
AskPlus should now be ready to use. Type the following commands to see if you can access your Eloquence data:
<pre>
+
/ASKPLUS/askplus
/ASKPLUS/askplus
+
open localhost:eloq-LIVE/MEMBRS,LOOKUP;
open localhost:eloq-LIVE/MEMBRS,LOOKUP;
+
form sets
form sets
+
exit
exit
 
</pre>
 
 
 
 
 
==Accessing Oracle Data==
 
  
AskPlus should now be ready to use. Type the following commands to see if you can access your Oracle data:
+
==Creating the Macro File==
<pre>
 
/ASKPLUS/askplus
 
open oracle username, password;
 
form sets
 
exit
 
</pre>
 
  
 +
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
+
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.