3 Installation

3.1 Requirements

Before running the WANdisco Security Agent, 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.
A local SCM repository has been initialized
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 and Cygwin platforms, 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 or 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.
Please read the latest deployment checklist in our Knowledgebase on our support web site at [http://support.wandisco.com]

3.2 Installation

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

Security_Agent_root
  bin
  config
  docs
  lib
  logs

bin: Contains scripts such as cvssecurityagent and shutdown
config: Contains the Security_Agent_root/config/prefs.xml file used to configure the WANdisco Security Agent.
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 Security Agent's log file names have the extension -prefs.log.n, with the extension -prefs.log.0 representing the most recent log file.