3.3 Installing the xDB RPM Package
3 Installation and Uninstallation : 3.3 Installing the xDB RPM Package
xDB Replication Server is also 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.To request credentials to the EDB Yum Repository, visit the EnterpriseDB Advanced Downloads web page at:For information about using the EDB Yum Repository see Chapter 3 of the EDB Postgres Advanced Server Installation Guide available from the EnterpriseDB website located at: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 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 9.6 or later. The ppasxx-server-libs package is a component of the Advanced Server repository package for version 9.5 or earlier. Step 3 shows how to enable access to the Advanced Server repository so Yum can access its server libs package.yum install package_namepackage_name is any of the packages listed under the Package Name column of the preceding table.To install only the xDB Replication Console and xDB Replication Server Command Line Interface, invoke the following: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.7 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.Note: For Advanced Server versions prior to 9.3, a Java runtime is supplied and installed as part of the Advanced Server installation process, however, you must still have pre-installed a separate Java runtime system on your host. The xDB Replication Server installation process does not utilize the Java runtime supplied with Advanced Server.Step 2: From the EDB Yum Repository, click on the edb-repo link to download the repository RPM for all EnterpriseDB RPMs.As the root account, issue the following command to install this repository configuration package: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].Access to the packages in any of these repositories is accomplished by enabling the repository by editing the following in the repository entry:
• Substitute your user name and password obtained from your EnterpriseDB Account Manager 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 9.6, enable the following entry: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).Step 4: Install the xDB Replication Server RPM package.The following syntax installs the xDB RPM package files that have been previously downloaded to the current working directory. The local package files are installed by referencing the package name appended with an asterisk suffix (*):To install the xDB RPM package directly from the EDB Yum Repository website, omit the asterisk suffix:==========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================-----------------------------------------------------------------------------------------------------------------------------------------------------------------edb-as10-server-libs.x86_64 0:10.2.7-2.rhel6 ppas-xdb-console.x86_64 0:6.2.0-1.rhel6 ppas-xdb-libs.x86_64 0:6.2.0-1.rhel6The 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:Successful installation of xDB Replication Server results in the creation of directory structures and files in your host environment as described in Section 3.5.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 Section 5.2.1. For starting the subscription server see Section 5.3.1.Step 5 (For xDB Replication Server 6.2 or 6.1): 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 Section 10.4.2 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 Section 126.96.36.199 for information on the xDB Replication Configuration file.Step 5 (For xDB Replication Server 5.1): In the xDB Replication Configuration file /etc/edb-repl.conf, verify that parameters host, port, database, user, and password are set to allow access to a Postgres database that you wish to use as the xDB Control database. If you wish to use a database other than the one identified by the current default settings, create the desired database and change the parameters to permit connection and authentication to this database to be used as the xDB Control database.Step 6: 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 Section 188.8.131.52 for information on the xDB Startup Configuration file. See Section 3.5 for the location of this file.
3 Installation and Uninstallation : 3.3 Installing the xDB RPM Package