Backup Agent on Linux and macOS
Installing and Using Backup Agent on Linux and macOS
Before You Begin
This topic contains information with which you need to be familiar to successfully install Backup Agent on Linux and macOS.
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 macOS.
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 Zen 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
Linux and macOS Platform Notes
This section provides information that is specific to the Linux and macOS versions of Backup Agent.
Linux and macOS 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 TAR format allows you to install on Linux and macOS. The name of the installation package follows the convention:
•Zen-BackupAgent-linux-x86_64-yy.yy-zzz.zzz.tar.gz.
•Zen-BackupAgent-macosx-x86_64-yy.yy-zzz.zzz.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 restarts the Zen engine service, so your database is briefly shut down.
Note If you use a Linux system that supports RPM Package Manager, 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
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
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.
cd /usr/local/actianzen
3 Enter the following command to copy the .tar file to here.
For example, if you download the 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 directory 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/actianzen status
Your installation is complete. For additional information, see Common Questions After Installation on Linux and macOS.
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 macOS for more information.
Installing Backup Agent for macOS
Your installation is either a first time, with no previous version, or an upgrade to an existing installed version.
First Time Installation on macOS
►To install Backup Agent on macOS 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.
cd /usr/local/actianzen
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 directory 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/actianzen/etc/init.d/actianzen status
Your installation is complete. For additional information, see Common Questions After Installation on Linux and macOS.
Upgrade Installation on macOS
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 macOS for more information.
Installing Backup Agent Using RPM
The name of the Backup Agent installation package on Linux follows the convention Zen-BackupAgent-linux-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 restarts the Zen service, 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 <BackupAgent_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/actianzen 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 'Zen-BackupAgent'
When successful, a specific version should be returned:
Zen-BackupAgent-yy.yy-zzz.zzz
Installation Scripts
This section contains additional information about Backup Agent installation on Linux and macOS.
•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/actianzen/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 the Zen service.
•Set user:group ownership to zen-svc:zen-data for the installed files.
•Configure and register Backup Agent with the Zen service.
•Restart the Zen service.
Caution Installation of Backup Agent stops and restarts the Zen service, so your database is briefly shut down.
Common Questions After Installation on Linux and macOS
This topic contains information that you should read after installing Backup Agent on Linux and macOS. If you have problems with installation, see the troubleshooting topic in Getting Started with Zen or visit the Actian website for online help resources.
Where do I find the product documentation?
The product includes a man page. To read it, run the following command at a prompt:
man pvbackup
Backup Agent documentation in PDF format is available in the following file:
/usr/local/actianzen/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?
Backup Agent installation places the directories and files under the Backup Agent root directory. By default this directory is /usr/local/actianzen/pba.
I had to remove and then reinstall my Zen Engine. Why doesn’t Backup Agent operate anymore?
You must remove and reinstall Backup Agent.
Using Backup Agent on Linux and macOS
On Linux and macOS, 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.