Table of Contents Previous Next


3 Installing and Uninstalling BART : 3.2 Installation of BART

BART requires a number of dependencies including the libpq library and the pg_basebackup utility program. All of these components are available in the EnterpriseDB RPM.
Step 1: Download the repository for all EnterpriseDB RPMs shown as edb-repo on the EDB Yum Repository website.
As the root user, issue the following command to install the repository configuration RPM as shown by the following example:
Step 2: Install the EPEL package (Extra Packages for Enterprise Linux), which contains certain libraries that may need to be installed depending upon your Linux operating system:
Step 3: In directory /etc/yum.repos.d, the repository configuration file edb.repo is created, which is a text file containing a list of EnterpriseDB repositories, each denoted by an entry starting with the text [repository_name].
Change the setting of the enabled parameter to enabled=1.
Repository edbasxx for Advanced Server 9.6 or later. The latest version is recommended.
Repository enterprisedb-tools.
Repository enterprisedb-dependencies.
Edit the edb.repo file by substituting your user name and password obtained from your EnterpriseDB Account Manager for the <username>:<password> placeholders of the baseurl parameter for the repositories to be enabled. Also change the enabled=0 parameter setting to enabled=1.
For example, to access the enterprisedb-tools repository, enable the following entry:
Step 4 (Optional): Install the pg_basebackup utility program using the server client package. If you do not already have the pg_basebackup program installed on the BART host, nor do you later plan to install the PostgreSQL database server or Advanced Server on the BART host, you can install a limited number of files that include the pg_basebackup program by installing the server client package with the following command:
yum install edb- asxx-server-client
Step 5: If BART 2.0 is currently installed on the host, save a copy of the BART 2.0 configuration file (default directory and file name is /usr/edb/bart2.0/etc/bart.cfg).
Step 6: Install the BART RPM package. Using Yum results in the installation of all dependencies required by BART. These packages are accessed from the repositories you enabled in the edb.repo repository configuration file.
The following syntax uses the yum command to install the BART RPM package file that has been downloaded to the current working directory. The local package file is installed by using the complete, RPM package file name:
yum install edb-bart-2.1.x-x.rhel7.x86_64.rpm
xlogreader_ident.so
Step 7: If BART 2.0 is also installed on the host, you must remove it. Use the following command to remove BART 2.0:
Step 8: In the newly created /usr/edb/bart/etc directory, place the configuration file bart.cfg that you saved in Step 5 from BART 2.0. (Note that this is the default location of the configuration file. The -c option can be used with BART subcommands to specify an alternative configuration file name or location. See Section 5.3 for information.)
Note that if you have a BART backup catalog created with BART 2.0 that you wish to use with BART 2.1, be sure the backup_path parameter of the BART 2.1 configuration file is set to this existing BART 2.0 backup catalog.
The bart_host parameter must also specify the same BART user account that was used for BART 2.0 to be able to access the BART backup catalog.
Note: The requirement of the BART configuration file for usage by BART 2.1 applies only when installing BART 2.1 on the host from which the BART subcommands are to be invoked (that is, the BART host). If you are installing BART 2.1 on a remote host on which incremental backups are to be restored, (in other words, this is not the BART host), then the content of the BART 2.1 etc subdirectory does not need the addition of the bart.cfg file.
Step 9: Adjust the setting of the PATH environment variable to include the directory location of the BART 2.1 bin subdirectory in the ~/.bashrc or ~/.bash_profile files of the following user accounts:
Step 10: Repeat the installation process described in this section to install BART 2.1 on all remote hosts where incremental backups are to be restored using BART 2.1. See Section 2.2.5.2 for additional information on restoration of incremental backups on remote hosts.
Step 11: You should now be able to use BART 2.1 to take additional backups and restore backups taken by BART 2.0.

3 Installing and Uninstalling BART : 3.2 Installation of BART

Table of Contents Previous Next