Installing the xDB RPM Package on x86-64 v6.2

Suggest edits

xDB Replication Server is supplied as an RPM package available in the EDB Yum Repository. Use the Yum package manager to install xDB Replication Server from the RPM package.

For information about using Yum, see the Yum project website located at:

http://yum.baseurl.org/

To request credentials to the EDB Yum Repository, visit the following website:

https://www.enterprisedb.com/repository-access-request

For information about using the EDB Yum Repository see Installing EDB Postgres Advanced Server.

Note

Although the following primarily describes the installation of xDB Replication Server version 6.2, access to the RPM packages for prior xDB Replication Server versions are also described in order to differentiate the installation of these different versions.

Each xDB Replication Server component is available as an individual RPM package. Thus, you can install all xDB Replication Server components with a single yum install command, or you may choose to install selected, individual components by installing only those particular RPM packages.

The following table lists the RPM packages and the xDB Replication Server component it contains.

Table 3 1: xDB Replication Server Component RPM Packages

Package NamexDB Replication Server Component
ppas-xdbAll components
ppas-xdb-consolexDB Replication Console and the xDB Replication Server Command Line Interface
ppas-xdb-publisherPublication server
ppas-xdb-subscriberSubscription server
ppas-xdb-libsLibrary files required by all components

The Advanced Server server libs package must be available for access by Yum when installing any xDB RPM package component. The edb-asxx-server-libs package is a component of the Advanced Server repository package for version 10 or later. Step 3 shows how to enable access to the Advanced Server repository so Yum can access its server libs package.

Note

You might have to enable the [extras] repository definition in the CentOS-Base.repo file (located in /etc/yum.repos.d).

To install any of the packages, invoke the following command as the root account:

yum install package_name

package_name is any of the packages listed under the Package Name column of the preceding table.

For example to install all xDB components, invoke the following:

yum install ppas-xdb --exclude edb-xdb

To install only the xDB Replication Console and xDB Replication Server Command Line Interface, invoke the following:

yum install ppas-xdb-console

To install only the publication server, invoke the following:

yum install ppas-xdb-publisher

Note

Though all xDB components are dependent upon and thus require installation of the server libs package, by using Yum, the dependency on the server libs is recognized when any xDB component is installed. Yum automatically installs the server libs package from the enabled Advanced Server repository along with your selected xDB RPM package.

The following are the steps to perform a complete xDB Replication Server installation with all xDB components.

Step 1: You must have Java Runtime Environment (JRE) version 1.8 or later installed on the hosts where you intend to install any xDB Replication Server component (xDB Replication Console, publication server, or subscription server). Any Java product such as Oracle Java or OpenJDK may be used.

Follow the directions for your host operating system to install Java runtime.

Note

When Replication Server is installed on a machine where Java is not present, the JDK is installed as part of the installation process. Since in this case the JDK was installed via Replication Server as its dependency, if you subsequently remove the JDK, Replication Server is also removed.

If Java 1.8 or greater exists before installing Replication Server, the installed Replication Server is not removed on removal of the JDK.

Step 2: From the EDB Yum Repository, click on the following link to download the repository RPM for all the EnterpriseDB RPMs.:

https://yum.enterprisedb.com/

As the root account, run the following command to install this repository configuration package:

On RHEL or CentOS 7:

yum -y install https://yum.enterprisedb.com/edb-repo-rpms/edb-repo-latest.noarch.rpm

On RHEL or Rocky Linux or AlmaLinux 8:

dnf -y install https://yum.enterprisedb.com/edb-repo-rpms/edb-repo-latest.noarch.rpm

Step 3: In the directory /etc/yum.repos.d, the repository configuration file edb.repo is created, which a text file is containing a list of EnterpriseDB repositories, each denoted by an entry starting with the text [repository_name].

Access to the packages in any of these repositories is accomplished by enabling the repository by editing the following in the repository entry:

  • Using your requested credentials for the EDB Yum Repository, substitute the user name and password for the <username>:<password> placeholders of the baseurl parameter.
  • Change the setting of the enabled parameter to enabled=1.

For example, to access the server libs package from the repository for Advanced Server version 14, enable the following entry:

[edbas96]
name=EnterpriseDB Advanced Server 14 $releasever - $basearch
baseurl=http://<username>:<password>@yum.enterprisedb.com/14/redhat/rhel-$releasever-$basearch
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY

To enable the appropriate repository for installing the desired version of xDB Replication Server, enable one of the following entries:

  • To install version 6.2, enable the entry for [enterprisedb-xdb60].
  • To install a prior version, enable the entry for [enterprisedb-tools].

Whichever version is chosen, be sure the other entries are disabled (that is, the parameter setting is enabled=0 for the non-selected entries).

For example, to access xDB Replication Server version 6.2, enable the following entry:

[enterprisedb-xdb60]
name=EnterpriseDB XDB 6.2 $releasever - $basearch
baseurl=http://<username>:<password>@yum.enterprisedb.com/xdb60/redhat/rhel-$releasever-$basearch
enabled=0
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY

Step 4: Install the xDB Replication Server RPM package.

The following syntax installs the xDB RPM package:

yum install ppas-xdb --exclude edb-xdb

The following is an example:

yum install ppas-xdb --exclude edb-xdb
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
* base: centos.excellmedia.net
* extras: centos.excellmedia.net
* updates: centos.excellmedia.net
base                                                                                  | 3.6 kB  00:00:00
edb                                                                                                                                                               | 2.5 kB  00:00:00
extras                                                                                                                                                            | 2.9 kB  00:00:00
updates                                                                                                                                                           | 2.9 kB  00:00:00
edb/7/x86_64/primary_db                                                                                                                                           | 452 kB  00:00:03
Resolving Dependencies
--> Running transaction check
---> Package ppas-xdb.x86_64 0:6.2.12-1.rhel7 will be installed
--> Processing Dependency: ppas-xdb-subscriber for package: ppas-xdb-6.2.12-1.rhel7.x86_64
--> Processing Dependency: ppas-xdb-publisher for package: ppas-xdb-6.2.12-1.rhel7.x86_64
--> Processing Dependency: ppas-xdb-console for package: ppas-xdb-6.2.12-1.rhel7.x86_64
--> Running transaction check
---> Package ppas-xdb-console.x86_64 0:6.2.12-1.rhel7 will be installed
--> Processing Dependency: ppas-xdb-libs for package: ppas-xdb-console-6.2.12-1.rhel7.x86_64
---> Package ppas-xdb-publisher.x86_64 0:6.2.12-1.rhel7 will be installed
--> Processing Dependency: ppas-libs for package: ppas-xdb-publisher-6.2.12-1.rhel7.x86_64
--> Processing Dependency: libpq.so.5()(64bit) for package: ppas-xdb-publisher-6.2.12-1.rhel7.x86_64
---> Package ppas-xdb-subscriber.x86_64 0:6.2.12-1.rhel7 will be installed
--> Running transaction check
---> Package ppas-xdb-libs.x86_64 0:6.2.12-1.rhel7 will be installed
---> Package ppas95-server-libs.x86_64 0:9.5.24.30-1.rhel7 will be installed
--> Processing Dependency: libmemcached.so.11()(64bit) for package: ppas95-server-libs-9.5.24.30-1.rhel7.x86_64
--> Running transaction check
---> Package libmemcached.x86_64 0:1.0.16-5.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved
============================================================================
Package                                             Arch                                   Version                                           Repository                            Size
============================================================================
Installing:
ppas-xdb                                            x86_64                                 6.2.12-1.rhel7                                    edb                                  7.2 k
Installing for dependencies:
libmemcached                                        x86_64                                 1.0.16-5.el7                                      base                                 237 k
ppas-xdb-console                                    x86_64                                 6.2.12-1.rhel7                                    edb                                     1.6 M
ppas-xdb-libs                                       x86_64                                 6.2.12-1.rhel7                                    edb                                   14 M
ppas-xdb-publisher                                  x86_64                                 6.2.12-1.rhel7                                    edb                                   40 k
ppas-xdb-subscriber                                 x86_64                                 6.2.12-1.rhel7                                    edb                                   11 k
ppas95-server-libs                                  x86_64                                 9.5.24.30-1.rhel7                                 edb                                  499 k

Transaction Summary
============================================================================
Install  1 Package (+6 Dependent packages)

Total download size: 16 M
Installed size: 21 M
Is this ok [y/d/N]: y
Downloading packages:
warning: /var/cache/yum/x86_64/7/base/packages/libmemcached-1.0.16-5.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID f4a80eb5: NOKEY            ] 230 kB/s | 212 kB  00:01:11 ETA
Public key for libmemcached-1.0.16-5.el7.x86_64.rpm is not installed
(1/7): libmemcached-1.0.16-5.el7.x86_64.rpm                                                                                                                       | 237 kB  00:00:02
warning: /var/cache/yum/x86_64/7/edb/packages/ppas-xdb-6.2.12-1.rhel7.x86_64.rpm: Header V4 RSA/SHA1 Signature, key ID 7e30651c: NOKEY                 ] 215 kB/s | 237 kB  00:01:16 ETA
Public key for ppas-xdb-6.2.12-1.rhel7.x86_64.rpm is not installed
(2/7): ppas-xdb-6.2.12-1.rhel7.x86_64.rpm                                                                                                                         | 7.2 kB  00:00:02
(3/7): ppas-xdb-console-6.2.12-1.rhel7.x86_64.rpm                                                                                                                 | 1.6 MB  00:00:08
(4/7): ppas-xdb-publisher-6.2.12-1.rhel7.x86_64.rpm                                                                                                               |  40 kB  00:00:00
(5/7): ppas-xdb-subscriber-6.2.12-1.rhel7.x86_64.rpm                                                                                                              |  11 kB  00:00:00
(6/7): ppas95-server-libs-9.5.24.30-1.rhel7.x86_64.rpm                                                                                                            | 499 kB  00:00:01
(7/7): ppas-xdb-libs-6.2.12-1.rhel7.x86_64.rpm                                                                                                                    |  14 MB  00:00:22
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                                                    663 kB/s |  16 MB  00:00:25
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
Importing GPG key 0xF4A80EB5:
Userid     : "CentOS-7 Key (CentOS 7 Official Signing Key) <security@centos.org>"
Fingerprint: 6341 ab27 53d7 8a78 a7c2 7bb1 24c6 a8a7 f4a8 0eb5
Package    : centos-release-7-5.1804.el7.centos.x86_64 (@anaconda)
From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
Is this ok [y/N]: y
Retrieving key from file:///etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY
Importing GPG key 0x7E30651C:
Userid     : "EnterpriseDB Inc. (EnterpriseDB Yum Repositories) <packages@enterprisedb.com>"
Fingerprint: ca40 9f7c 635f 2ae5 6c9e 8b34 e5ed e919 7e30 651c
Package    : edb-repo-20-2.noarch (installed)
From       : /etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY
Is this ok [y/N]: y
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
Installing : ppas-xdb-libs-6.2.12-1.rhel7.x86_64                                                                                                                                   1/7
Installing : ppas-xdb-subscriber-6.2.12-1.rhel7.x86_64                                                                                                                             2/7
Installing : ppas-xdb-console-6.2.12-1.rhel7.x86_64                                                                                                                                3/7
Installing : libmemcached-1.0.16-5.el7.x86_64                                                                                                                                      4/7
Installing : ppas95-server-libs-9.5.24.30-1.rhel7.x86_64                                                                                                                           5/7
Installing : ppas-xdb-publisher-6.2.12-1.rhel7.x86_64                                                                                                                              6/7
Installing : ppas-xdb-6.2.12-1.rhel7.x86_64                                                                                                                                        7/7
Verifying  : libmemcached-1.0.16-5.el7.x86_64                                                                                                                                      1/7
Verifying  : ppas-xdb-libs-6.2.12-1.rhel7.x86_64                                                                                                                                   2/7
Verifying  : ppas95-server-libs-9.5.24.30-1.rhel7.x86_64                                                                                                                           3/7
Verifying  : ppas-xdb-publisher-6.2.12-1.rhel7.x86_64                                                                                                                              4/7
Verifying  : ppas-xdb-subscriber-6.2.12-1.rhel7.x86_64                                                                                                                             5/7
Verifying  : ppas-xdb-console-6.2.12-1.rhel7.x86_64                                                                                                                                6/7
Verifying  : ppas-xdb-6.2.12-1.rhel7.x86_64                                                                                                                                        7/7

Installed:
ppas-xdb.x86_64 0:6.2.12-1.rhel7

Dependency Installed:
libmemcached.x86_64 0:1.0.16-5.el7             ppas-xdb-console.x86_64 0:6.2.12-1.rhel7         ppas-xdb-libs.x86_64 0:6.2.12-1.rhel7    ppas-xdb-publisher.x86_64 0:6.2.12-1.rhel7
ppas-xdb-subscriber.x86_64 0:6.2.12-1.rhel7    ppas95-server-libs.x86_64 0:9.5.24.30-1.rhel7

Complete!

The xDB Replication Server is installed in directory location /usr/ppas-xdb-x.x where x.x is the xDB Replication Server version number as shown by the following:

[root@localhost ppas-xdb-6.2]# pwd
/usr/ppas-xdb-6.2
[root@localhost ppas-xdb-6.2]# ls -l
total 84
drwxr-xr-x 2 root         root          4096 Feb 23 16:05 bin
drwxr-xr-x 3 root         root          4096 Feb 23 16:05 etc
drwxr-xr-x 4 root         root          4096 Feb 23 16:05 lib
drwxr-xr-x 2 root         root          4096 Feb 23 16:05 share
drwx------ 2 enterprisedb enterprisedb  4096 Feb 20 22:17 xdata
-r--r--r-- 1 enterprisedb enterprisedb 64035 Feb 20 20:40 xdb_3rd_party_licenses.txt

Successful installation of xDB Replication Server results in the creation of directory structures and files in your host environment as described in Section Post-Installation Host Environment.

Note

Neither the publication server nor the subscription server are running immediately following installation. If after reviewing the remaining steps, you wish to start the publication server, see Registering a Publication Server. For starting the subscription server see Registering a Subscription Server.

Step 5: Install a JDBC driver. See Installing a JDBC driver for more information.

Step 6: In the xDB Replication Configuration file /etc/edb-repl.conf, you can either use the default password (edb) as the admin user password, or you can substitute a password of your choice. If you want to use your own password, see Encrypting the Password in the xDB Replication Configuration File on how to generate the encrypted form of the password. Place the encrypted password in the admin_password parameter of the xDB Replication Configuration file. The default admin user name is set to admin and can be changed as well. See xDB Replication Configuration File for information on the xDB Replication Configuration file.

Step 7: The JAVA_EXECUTABLE_PATH parameter in the xDB Startup Configuration file should be set so that the Java runtime program can be accessed upon startup of the publication server and subscription server. If the publication server or subscription server startup fails due to inaccessibility to the Java program, be sure to set the path to your Java runtime program in the xDB Startup Configuration file. See xDB Startup Configuration File for information on the xDB Startup Configuration file. See Post-Installation Host Environment for the location of this file.

Updating an RPM Installation

If you have an existing xDB RPM installation, you can use yum to upgrade your repository configuration file and update to a more recent product version. To update the edb.repo file, assume superuser privileges and enter:

yum upgrade edb-repo

yum will update the edb.repo file to enable access to the current EDB repository, configured to connect with the credentials specified in your edb.repo file. Then, you can use yum to upgrade any installed packages:

yum upgrade ppas-xdb* --exclude edb-xdb*

← Prev

Installing from the Command Line

Next →

Installing the RHEL 8 xDB RPM Package on IBM Power (ppc64le)