Difference between revisions of "Installing AskPlus on HPUX"

From Vital Soft Wiki
Jump to: navigation, search
>Jeremyb
(→‎Installation)
 
(62 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
==Summary==
+
==Installing AskPlus on HPUX Systems==
−
Installing of 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.
  
−
==Installing AskPlus on HPUX Systems==
+
* [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'''
  
−
===Installing AskPlus for the first time===
+
$ 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
  
−
Installation on UNIX systems is done by creating the appropriate user and directory and loading a file called ASKPLUS.
+
* '''PA-Risc'''.  Note E.8.5.0 is the most recent version available for PA-Risc.
−
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.
 
  
 +
$ 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
  
−
===Upgrading AskPlus===
+
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.
  
−
Before starting the installation, you must ensure that AskPlus is not in use and that the TCP/IP Listener process (vsrvtcp) is not running. See section 2.4 for instructions on stopping the listener process.
+
===Installing AskPlus for the first time===
  
−
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.
+
: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.
  
−
''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.''
+
===<span style="background:yellow">Upgrading AskPlus</span>===
  
 +
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:
 +
/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.
  
−
3. Create a new user called askplus.
+
4. Add a new service to your host services file. Add the following line to your host services file (/etc/services):
−
The home directory for this user should be the directory where you want to install the AskPlus software. Create a new directory, for example:  
+
askplus 30501/tcp #AskPlus/Visimage server
−
<pre>
 
−
/usr/askplus
 
−
</pre>
 
  
−
4. Create a symbolic link that will provide direct access to the directory just created. Type:
+
To check if a port is in use, type these two commands:
−
<pre>
+
grep 30501 /etc/services
−
ln -fs /usr/askplus /ASKPLUS
+
netstat -a | grep 30501
−
</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.
+
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 '''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.
 +
 
 +
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}}
 +
 
 +
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
 +
<!--
 +
===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]
 +
 
 +
== 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
  
−
5. Add a new service to your host services file. Add the following line to your host services file (/etc/services):
+
==Verifying AskPlus==
−
askplus 30501/tcp #AskPlus/Visimage server
 
  
−
''Existing users, login as root and start here:''
+
To verify that the programs have been properly installed, type the following command:
 +
/ASKPLUS/askplus
  
−
6. Switch to the /ASKPLUS directory
+
If everything has been properly installed you will see something like this:
−
<pre>
+
ITANIUM Example :
−
cd /ASKPLUS
+
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
−
</pre>
+
ASKPLUS/Unix {{AskPlus_Current_Version_Upper}} (64 bits) ready !
  
−
7. Existing customers must stop the vsrvtcp listener process before continuing. This will disconnect any users that are currently running Visimage.
+
RedHat Example :
−
<pre>
+
Copyright LSWE (c) 1978-2021. Distributed by Vital Soft, Inc.
−
./kill_vsrvtcp -stop_all
+
ASKPLUS/Linux {{AskPlus_RHEL_Version_Upper}} (64 bits) ready !
−
</pre>
 
  
−
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.
+
PA-Risc Example :
−
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.
+
Copyright LSWE (c) 1978-2020. Distributed by Vital Soft, Inc.
 +
ASKPLUS/Unix {{AskPlus_PARISC_Version_Upper}} (32 bits) ready !
  
−
9. The file that was transferred in the previous step is a compressed tar file. To uncompress and expand this file, enter these commands:
+
Type EXIT, to exit the AskPlus program.
−
<pre>
 
−
gunzip ASKPLUS.gz
 
−
tar -xvf ASKPLUS
 
−
</pre>
 
  
−
10. Modify the properties of the vsrvtcp program file. Type:
+
==Accessing Eloquence Data==
−
<pre>
 
−
chmod +s vsrvtcp
 
−
</pre>
 
  
−
Finally,
+
AskPlus should now be ready to use. Type the following commands to see if you can access your Eloquence data:
−
11. Login as askplus and make sure you are in the /ASKPLUS directory. Type:
+
/ASKPLUS/askplus
−
<pre>
+
open localhost:eloq-LIVE/MEMBRS,LOOKUP;
−
login askplus
+
form sets
−
cd /ASKPLUS
+
exit
−
</pre>
 
  
−
12. Complete the installation by running the vinstall script. If you are installing AskPlus to use with Eloquence, type:
+
==Creating the Macro File==
−
<pre>
 
−
./vinstall
 
−
</pre>
 
  
−
'''NOTE: If you are installing AskPlus to use with an Oracle database, type:'''
+
The final step is to create the macro file using the sample files provided.
−
<pre>
+
  cd /ASKPLUS/visimage
−
./vinstall oracle
+
  ../load_macros
−
</pre>
 
  
−
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.

Retrieved from "https://wiki.vital-soft.com/index.php?title=Installing_AskPlus_on_HPUX&oldid=3648"