Backup Agent on Linux and OS X
Installing and Using Backup Agent on Linux and OS X
•
Before You Begin
•
Backup Agent Installation Checklists
•
Installing Backup Agent Using TAR
•
Installing Backup Agent for Linux
•
Installing Backup Agent for OS X
•
Installing Backup Agent Using RPM
•
Installation Scripts
•
Common Questions After Installation on Linux and OS X
•
Using Backup Agent on Linux and OS X
•
Uninstalling Backup Agent on Linux or OS X
Before You Begin
This section contains information with which you need to be familiar to successfully install Backup Agent on Linux and OS X.
Before installing, begin by reviewing the following documents for important information:
•
This chapter provides important information such as system requirements and platform specific notes that are relevant to your operation.
•
Release notes. The release notes are in a readme file located on the distribution media and contain late-breaking product news that could not be included in the product documentation.
Backup Agent Installation Checklists
This section provides you with checklists and other information to prepare you for installation on Linux and OS X.
Precautions
The following lists important precautions to follow prior to installing Backup Agent.
*
Your system hardware and software meets the minimum requirements to install Backup Agent (which are the same the minimum requirements to install the database engine). The hardware and software requirements are listed on the Actian Corporation web site.
*
The PSQL database engine is stopped and restarted during the installation of Backup Agent. If your business requirements prohibit stopping the database engine during certain hours, install Backup Agent during an acceptable period.
*
As with any software application, you should always back up any important files on the hard drive before you begin the installation.
*
If you have enabled Archival Logging, you must disable it before you can use Backup Agent.
Database Engine Requirements
See PSQL Database Engine Requirements for Backup Agent.
Linux and OS X Platform Notes
This section provides information that is specific to the Linux and OS X versions of Backup Agent.
Linux and OS X do not support upgrading Backup Agent the same way as on Windows platforms. With these distributions, you first uninstall the previous version of Backup Agent and then install the version you want.
Installing Backup Agent Using TAR
The tape archive (TAR) format allows you to install on Linux and OS X. The name of the installation package follows the convention:
•
PSQL-Backup-Agent-linux-yy.yy-zzz.zzz.x86_64.tar.gz.
•
PSQL-Backup-Agent-macosx-yy.yy-zzz.zzz.x86_64.tar.gz.
The yy.yy designates a release number and zzz.zzz designates a build number. Verify the actual name for the file you install.
Installation of Backup Agent stops and then restarts PSQL services, so your database is briefly shut down.
Note If you use a Linux system that supports RedHat Package Manager (RPM), you may want to use RPM instead of TAR. See Installing Backup Agent Using RPM for more information.
The following topics explain how to install Backup Agent products using TAR:
•
Installing Backup Agent for Linux
•
Installing Backup Agent for OS X
Installing Backup Agent for Linux
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
•
First Time Installation on Linux
•
Upgrade Installation on Linux
First Time Installation on Linux
►
To install Backup Agent on Linux using TAR
1
Log in as the root user.
2
Change the current directory to /usr/local/psql.
cd /usr/local/psql
3
Enter the following command to copy the .tar file to here.
For example, if you downloaded the installation package to /home/bholly:
cp /home/bholly/<package_name> .
4
Unpack the .tar file using the following command.
tar -zxf <package_name>
5
Change directories to the /pba/etc folder where the installation scripts reside.
cd pba/etc
6
Run the preinstallation script:
./preinstall.sh
7
Run the postinstallation script:
./postinstall.sh
If successful, the prompt displays the following message:
Install has successfully completed.
8
To know what actions the scripts performed, see Installation Scripts.
9
After installation, you can verify that the database engine is running by using the following command:
/etc/init.d/psql –status
Your installation is complete. For additional information, see Common Questions After Installation on Linux and OS X.
Upgrade Installation on Linux
If you have a previous version of Backup Agent already installed, you must uninstall that version and then install the new Backup Agent product. See Uninstalling Backup Agent on Linux or OS X for more information.
Installing Backup Agent for OS X
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
•
First Time Installation on OS X
•
Upgrade Installation on OS X
First Time Installation on OS X
►
To install Backup Agent 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
Change the current directory to /usr/local/psql.
cd /usr/local/psql
4
Unpack the .tar file using the tar command.
For example, if you downloaded the installation package to your Desktop:
tar -zxf /Users/<name>/Desktop/<package_name>
5
Change directories to the /pba/etc folder where the installation scripts reside.
cd pba/etc
6
Run the preinstallation script:
./preinstall.sh
7
Run the postinstallation script:
./postinstall.sh
If successful, the prompt displays the following message:
Install has successfully completed.
8
To know what actions the scripts performed, see Installation Scripts.
9
After installation, you can verify that the database engine is running by using the following command:
/usr/local/psql/etc/init.d/psql –status
Your installation is complete. For additional information, see Common Questions After Installation on Linux and OS X.
Upgrade Installation on OS X
If you have a previous version of Backup Agent already installed, you must uninstall that version and then install the new Backup Agent product. See Uninstalling Backup Agent on Linux or OS X for more information.
Installing Backup Agent Using RPM
The name of the Backup Agent installation package on Linux follows the convention PSQL-Backup-Agent-yy.yy-zzz.zzz.x86_64.rpm
The yy.yy designates a release number and zzz.zzz designates a build number. Verify the actual name for the file you install.
Note To install this package, you must be logged in as root. If you are installing from the CD, you must be in the CD root directory.
Caution Installation of Backup Agent stops and then restarts PSQL services, so your database is briefly shut down.
►
To install Backup Agent using RPM
1
Log in as the root user.
2
Change directories to the location of the RPM package
3
Issue the following command, replacing the package name used here with the correct name:
rpm -ivh <PSQL_Backup_Agent_package_name>
Note If you are installing to a non-RPM based Linux installation such as Slackware, you need to add the --nodeps option so that the package manager does not check for RPM dependencies, which your system does not have. For example, rpm -ivh --nodeps <package_name>.
The package scripts install the product and perform other tasks as noted in Installation Scripts. If successful, the prompt displays the following message:
Install has successfully completed.
4
After installation, you can verify that the database engine is running by using the following command:
/etc/init.d/psql –status
Verifying RPM Installation
You can verify that RPM installed the Backup Agent package by issuing the following case-sensitive command at a prompt:
rpm -q 'PSQL-Backup-Agent'
When successful, a specific version should be returned:
PSQL-Backup-Agent-yy.yy-zzz.zzz
Installation Scripts
This section contains additional information about Backup Agent installation on Linux and OS X.
•
If you use the RPM installation system, installation scripts run automatically before and after the package manager copies all needed files to the location /usr/local/psql/pba.
•
If you use TAR, you will run the script postinstall.sh manually after installation.
In either case, the scripts perform the following tasks:
•
Verify necessary permissions to complete the installation.
•
Shut down PSQL services.
•
Set user:group ownership to psql:pvsw for the installed files.
•
Configure and register Backup Agent with PSQL Services.
•
Restart PSQL services.
Caution Installation of Backup Agent stops and then restarts PSQL services, so your database is briefly shut down.
Common Questions After Installation on Linux and OS X
This section contains information that you should read after installing Backup Agent on Linux and OS X. If you have problems with installation, see the troubleshooting chapter in Getting Started With PSQL or visit the PSQL website for online help resources.
Where Do I Find the Product Documentation?
The product includes a man page. To read it, use the following command:
man pvbackup
Backup Agent documentation in PDF format is available in the following file:
/usr/local/psql/pba/doc/pvbackup.pdf
A readme file for the product is also available. See Backup Agent Release Notes.
What Files Were Installed as Part of Backup Agent?
The installation of Backup Agent places the directories and files under the Backup Agent root directory. By default this directory is /usr/local/psql/pba.
I had to uninstall and then reinstall my PSQL Engine. Why doesn’t Backup Agent operate anymore?
You must remove and reinstall Backup Agent.
Using Backup Agent on Linux and OS X
On Linux and OS X, the pvbackup command is used at the command line exactly the same as it is under Windows systems. This section provides an overview of the command and its syntax. For more information, see Using the Backup Agent Command Line Interface.