Subsections

• 4.1 Requirements
• 4.2 Installing the bits

---

4 Installation

4.1 Requirements

Before running the WANdisco HADR, please ensure:

• On Windows, everything is installed on paths with no spaces in the names. For example, on the Windows platforms, the default installation path for java looks like C:/Program Files/java/jdk1.5.0_03. Choose an alternate installation directory, for example C:/java with no spaces in the path.
• You have copied a valid license.key file into [replicator]/config. Depending upon your license, certain features may be disabled. This document will highlight any features that require an Enterprise Edition license. In particular, security (access control) features require an Enterprise Edition license.
• At each replication site, a local SCM repository has been initialized and all SCM repositories have exact same data prior to replication.
• JDK/J2SE 1.5.0_03 or greater is installed, and the JAVA_HOME environment variable is defined.
  • Please ensure the full JDK is installed, not just the JRE. This can be confirmed by running java -server -version. If it generates a not found error, uninstall the JRE Java package and reinstall the JDK Java package.
• On UNIX/Cygwin platform, Perl version 5.6 or greater is installed and the perl executable is on the system PATH.
  • The optional logtimefix script requires Perl package Date::Manip. - To install a Perl package on UNIX/Cygwin, using CPAN (ensure you are logged into the root account first), for example:

    $ perl -MCPAN -eshell
    cpan> install  Term::ReadKey
    

• On Windows platform, ActivePerl version 5.8 or greater is installed and the perl executable is on the system PATH. Please download the MSI installer for ActivePerl from here: [http://activestate.com/Products/Download/Download.plex?id=ActivePerl]
  • The optional logtimefix script requires Perl package Date::Manip. - To install a Perl package on Windows, using ActivePerl package manager, for example:

    c:\>ppm
    ...
    ppm>install DateManip
    

• importauditdb script requires Perl package Perl::DBI.
  • XML::Parser package is required. It should be bundled as a standard module on a perl 5.8 installation.
• Please read the latest deployment checklist in our Knowledgebase on our support web site at [http://support.wandisco.com]

4.2 Installing the bits

Important: The WANdisco HADR is installed as part of a WANdisco Replicator install. You will want to consult the WANdisco Replicator install guide for further information on installing the WANdisco Replicator. This guide only highlights the steps relevant to installing and configuring the WANdisco Failover Agent.

Untar or unzip (using WinZip for example on Windows) the WANdisco Replicator package (tar.gz) into the intended subdirectory. You should see the following directory structure:

$ cd [replicator]
$ ls
config  lib  logs bin docs systemdb

bin

Contains scripts like failoveragent , shutdown

config

Contains the [replicator]/config/prefs.xml file used to configure the WANdisco HADR.

lib

Contains the jar files and DLLs that are required to run the product.

docs

Contains the administration guide in various formats: PDF, Html and UNIX man page.

logs

Contains the pid file, log files and other temporary files. WANdisco HADR's log file is named FailoverAgent-prefs.log.0.

systemdb

Contains the system database with its transaction journal. Warning: Deleting or modifying files from systemdb will likely corrupt your installation.