3.1 Installing the JDBC Connector

You can use the Advanced Server graphical installer or an RPM package to add the JDBC Connector to your installation.

The following sections describe these installation methods.

3.1.1 Installing the Connector with an RPM Package

Before using an RPM installer to install the JDBC connector, you must first create and configure the EnterpriseDB repository file, providing a user name and password that allows access to the files in the repository. Contact a representative at EnterpriseDB for your download credentials.

The name of the package that creates the repository file for Advanced Server 9.6 is edb-repo. You can download the package at:

http://yum.enterprisedb.com/

After downloading the repository configuration file, assume superuser privileges, and use the following command to create the repository configuration file:

rpm -Uvh edb-repo-x.x-x.noarch.rpm

The installer creates a repository configuration file named edb.repo; the file resides in /etc/yum.repos.d. The file contains entries for each of the EnterpriseDB repositories; to install the connector, you must enable the entry for the enterprisedb-tools repository:

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

Use your choice of editor to modify the repository configuration file:

1.	Replace the user_name and password placeholders in the baseurl specification with your user name and the repository password.

2.	Replace the 0 next to enabled with a 1.

Save the configuration file and exit the editor.

After modifying the content of the repository configuration file, you can use the yum install command to install the connector; use the command:

yum install edb-jdbc

During the installation, yum may encounter a dependency that it cannot resolve. If it does, it will provide a list of the required dependencies that you must manually resolve.

3.1.2 Using the Graphical Installer to Install the Connector

You can use the EnterpriseDB Connectors Installation wizard to add the JDBC connector to your system; the wizard is available at:

www.enterprisedb.com

This section demonstrates using the Installation Wizard to install the Connectors on a Linux system. (You can follow the same procedure to install the Connectors on a Windows system. Download the installer, and then, right-click on the installer icon, and select Run As Administrator from the context menu.) The installation wizard opens as shown in Figure 3.1.

Figure 3.1 - The Connectors Installation wizard.

Click Next to continue.

Figure 3.2- The Installation dialog.

Use the Installation Directory dialog (see Figure 3.2) to specify the directory in which the connector will be installed, and click Next to continue.

Figure 3.3- The Ready to Install dialog.

Click Next on the Ready to Install dialog (see Figure 3.3) to start the installation; popup dialogs confirm the progress of the installation wizard.

Figure 3.4 - The installation is complete.

When the wizard informs you that it has completed the setup, click the Finish button to exit the dialog (see Figure 3.4).

By default, the Advanced Server graphical installer installs the JDBC connector when you install Advanced Server. To ensure that the JDBC connector is installed during an Advanced Server installation, confirm that the check box next to Connectors is checked on the Select Components window of the installation wizard (see Figure 3.5).

Figure 3.5 - The Select Components dialog.

You can also use StackBuilder Plus to add or update the connector on an existing Advanced Server installation; to open StackBuilder Plus, select StackBuilder Plus from the Windows Apps menu or through Linux Start menu (see Figure 3.6).

Figure 3.6 - Starting StackBuilder Plus.

When StackBuilder Plus opens, follow the onscreen instructions, selecting the EntepriseDB Connectors option from the Database Drivers node of the tree control (see Figure 3.7).

Figure 3.7 - Selecting the Connectors installer.

Follow the directions of the onscreen wizard to add or update an installation of the EnterpriseDB Connectors.