Installing Mirror Replication Agent

This section describes how to install Mirror Replication Agent. It also has a procedure to verify the installation.

The Mirror Replication Agent installation process creates a directory structure containing the Mirror Replication Agent binaries, scripts, Java Runtime Environment (JRE), and associated files. There are no configuration steps during installation.

Before you install Mirror Replication Agent, see the Mirror Replication Agent Installation Guide and complete the installation worksheet.

Installation guidelines

While installing Mirror Replication Agent, use the following guidelines:

Install Mirror Replication Agent on a server where it can directly access the Microsoft SQL Server mirror transaction logs.
Create a Mirror Replication Agent instance and configure it for the Microsoft SQL Server database from which you want to replicate.

To install Mirror Replication Agent software

Use one of the following methods to install the software.

After following the download instructions from the SPDC Web site in the section “Accessing products from the SPDC Web site”, go to the location where you extracted the Mirror Replication Agent 15.1 for Windows installation image, or

Insert the Mirror Replication Agent CD into your CD-ROM drive.
Launch the installation program by executing the setup routine for Windows:
```
setup
```
If you see an error message saying that there is not enough temporary disk space, add the following to your setup command:
```
setup –is:tempdir someDirectory
```
Here, someDirectory is a directory with at least 100MB of disk space that the installation program can use.
On the Welcome window, click Next.
Select a geographic location that displays the license agreement. Select I Agree and click Next.
Enter the directory where you want to install Mirror Replication Agent:
- If the directory does not exist, the installation program prompts you to create it. Click Yes.
- If the destination directory exists, you receive a warning message that you are installing into an existing directory. Click Yes.
Select Typical for the installation setup type and click Next.
The installation program displays a summary of what is to be installed. Click Next.
The installation program starts to install Mirror Replication Agent, displaying the progress status. If you see the following message;
```
There are newer files already installed and do you want to replace them?
```
Click No to All.
When you receive a message that the installation was successful, click Next.
The SySAM License Server window opens and displays this prompt:
```
Will licenses be obtained from the License Server?
```
- If you answer Yes, you can leave the license-mrx.lic license file where it was installed (%SYBASE%\SYSAM-2_0\licenses), or you can move the file to the SYSAM-2_0/licenses directory of your SYSAM license server. In either case, the Mirror Replication Agent will verify the necessary license.
- If you answer No, no further action is needed. The Mirror Replication Agent will use the installed license (license-mrx.lic) as it was installed in %SYBASE%\SYSAM-2_0\licenses.
Click Next.
The SySAM notification window prompts you to configure your server for e-mail notification. When configuration is enabled, you receive information about license management events that require attention. Select Yes and either accept the default values that are supplied, or enter these values from the installation worksheet you completed in the Mirror Replication Agent Installation Guide:
- SMTP server host name
- SMTP server port number
- E-mail return address
- Recipients of the notification
- Message severity level of an event that will trigger e-mail. Your choices are:
  - Informational
  - Warning
  - Error
If you choose not to have e-mail alerts or severity messages logged, select No.

Click Next.
When you receive a message indicating that Mirror Replication Agent was successfully installed, click Finish.

Mirror Replication Agent should usually not be installed on the same host as the primary database for Mirror Activator.

For more information for the replication installation process, see the Mirror Replication Agent Installation Guide.

To verify the installation

In a command window, change to the directory where you installed Mirror Replication Agent.
Change the directory to %SYBASE%\MA-15_1\bin.
Obtain the Mirror Replication Agent version string:
```
ma -v
```
If the Mirror Replication Agent installation completed successfully, you can see the Mirror Replication Agent version string and the Sybase copyright.