Installing PSQL Using TAR
The tape archive (TAR) format allows you to install PSQL on Linux and OS X. The following topics explain how to install PSQL products using TAR:
•
Installing PSQL Server or Vx Server for Linux - TAR
•
Installing PSQL Server or Vx Server for OS X - TAR
•
Installing PSQL Client for Linux - TAR
•
Installing PSQL Client for OS X - TAR
If you have any trouble with installation, see the chapter Troubleshooting After Installation.
Installing PSQL Server or Vx Server for Linux - TAR
The name of the PSQL Server installation package follows these conventions.
Table 12
Server Package Names - TAR
Installation Type
Package Name
Server 64-bit
PSQL-linux-yy.yy-zzz.zzz.x86_64.tar.gz
Vx Server 64-bit
PSQL-Vx-linux-yy.yy-zzz.zzz.x86_64.tar.gz
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
•
First Time Server Installation on Linux
•
Upgrade Server Installation on Linux
First Time Server Installation on Linux
The 64-bit installation scripts perform the following tasks:
•
Verify necessary permissions to complete install
•
Create user psql and group pvsw if they do not exist
•
Sets user:group ownership to psql:pvsw for the installed files if not already set
►
To install PSQL Server or Vx Server on Linux using TAR
1
Log in as the root user.
2
Change to the /usr/local directory.
cd /usr/local
3
Enter the following command to copy the .tar file to /usr/local.
For example, if you downloaded the installation package to /home/bholly:
cp /home/bholly/<server_package_name> .
4
Unpack the .tar file using the following command.
tar -zxf <server_package_name>
5
Change directories to the /usr/local/psql/etc folder where the installation scripts reside.
cd psql/etc
6
Run the preinstallation script:
./preinstall.sh
7
Run the postinstallation script:
./postinstall.sh
Your installation is complete. For additional information, see Installing PSQL Using TAR.
Upgrade Server Installation on Linux
If you have a previous version of PSQL already installed, you must uninstall that version and then install the new PSQL product. See Uninstalling PSQL on Linux or OS X for more information.
Installing PSQL Server or Vx Server for OS X - TAR
The name of the PSQL Server installation package follows these conventions.
Table 13
Server Package Names - TAR
Installation Type
Package Name
Server 64-bit
PSQL-macosx-yy.yy-zzz.zzz.x86_64.tar.gz
Vx Server 64-bit
PSQL-Vx-macosx-yy.yy-zzz.zzz.x86_64.tar.gz
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
•
First Time Server Installation on OS X
•
Upgrade Server Installation on OS X
First Time Server Installation on OS X
The 64-bit installation scripts perform the following tasks:
•
Verify necessary permissions to complete install
•
Create user psql and group pvsw if they do not exist
•
Sets user:group ownership to psql:pvsw for the installed files if not already set
►
To install PSQL Server or Vx Server on OS X using TAR
You must be logged in as a user with administrator rights to use the sudo command.
1
Open a terminal window by entering terminal in a Spotlight search.
2
At the prompt, enter a sudo command like the following to gain administrative rights to install applications:
sudo -i bash -l
3
PSQL installation requires a /usr/local directory. Use the following command to create it:
mkdir /usr/local
4
Change directories to the newly created location.
cd /usr/local
5
Unpack the .tar file using the tar command.
For example, if you downloaded the installation package to your Desktop:
tar -zxf /Users/<name>/Desktop/<server_package_name>
6
Change directories to /usr/local/psql/etc where the installation scripts reside.
cd psql/etc
7
Run the preinstallation script:
./preinstall.sh
8
Run the postinstallation script:
./postinstall.sh
Your installation is complete. For additional information, see After Installing PSQL on Linux or OS X.
Upgrade Server Installation on OS X
If you have a previous version of PSQL already installed, you must uninstall that version and then install the new PSQL product. See Uninstalling PSQL on Linux or OS X for more information.
Installing PSQL Client for Linux - TAR
The name of the PSQL Client installation package follows these conventions.
Table 14
Client Package Names - TAR
Installation Type
Package Name
Client 64-bit
PSQL-Client-linux-yy.yy-zzz.zzz.x86_64.tar.gz
Client Access 32-bit
(Linux only)
PSQL-Client-Access-linux-yy.yy-zzz.zzz.x86_64.tar.gz
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First Time Client Installation on Linux
If you need to provide 32-bit client access for an application, you must install the PSQL Client 64-bit first, and then add PSQL Client Access 32-bit. The installation steps are the same except for the pre- and post-install scripts, as described below.
►
To install PSQL Client for Linux Using TAR
1
Log in as the root user.
2
Change to the /usr/local directory.
cd /usr/local
3
Enter the following command to copy the .tar file to /usr/local.
For example, if you downloaded the installation package to /home/bholly:
cp /home/bholly/<client_package_name> .
4
Unpack the .tar file using the following command.
tar -zxf <client_package_name>
The unpacking action creates a directory named psqlclient.
5
Change directories to the /usr/local/psql/etc folder where the PSQL installation scripts reside.
cd psql/etc
6
Run the preinstallation script needed by the client package that you are installing:
•
Client 64-bit: ./clientpreinstall.sh
or
•
Client Access 32-bit: ./clientaccesspreinstall.sh
7
Run the postinstallation script needed by the client package that you are installing:
•
Client 64-bit: ./clientpostinstall.sh
or
•
Client Access 32-bit: ./clientaccesspostinstall.sh
Your TAR installation is complete. For additional information, see After Installing PSQL on Linux or OS X and Configuring Network Communications for Clients.
Upgrade Client Installation on Linux
If you have a previous version of PSQL already installed, you must uninstall that version and then install the new PSQL product. See Uninstalling PSQL on Linux or OS X for more information.
Installing PSQL Client for OS X - TAR
The name of the PSQL Client installation package follows these conventions.
Table 15
Client Package Names - TAR
Installation Type
Package Name
Client 64-bit
PSQL-Client-macosx-yy.yy-zzz.zzz.x86_64.tar.gz
In the file name, yy.yy is a release number and zzz.zzz is a build number. See the file for its actual name.
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First Time Client Installation on OS X
►
To install PSQL Client for OS X using TAR
You must be logged in as a user with administrator rights to use the sudo command.
1
Open a terminal window by entering terminal in a Spotlight search.
2
At the prompt, enter a sudo command like the following to gain administrative rights to install applications:
sudo -i bash -l
3
PSQL installation requires a /usr/local directory. Use the following command to create it:
mkdir /usr/local
4
Change directories to the newly created location.
cd /usr/local
5
Unpack the .tar file using the tar command.
For example, if you downloaded the installation package to your Desktop:
tar -zxf /Users/<name>/Desktop/<client_package_name>
The unpacking action creates a directory named psqlclient.
6
Change directories to the /usr/local/psql/etc folder where the PSQL installation scripts reside.
cd psql/etc
7
Run the preinstallation script needed by the client package that you are installing:
./clientpreinstall.sh
8
Run the postinstallation script needed by the client package that you are installing:
./clientpostinstall.sh
Your TAR installation is complete. For additional information, see After Installing PSQL on Linux or OS X and Configuring Network Communications for Clients.
Upgrade Client Installation on OS X
If you have a previous version of PSQL already installed, you must uninstall that version and then install the new PSQL product. See Uninstalling PSQL on Linux or OS X for more information.