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.

To install Mirror Replication Agent software

Verify that the operating system (OS) patch levels are at the current level required to support Java 5.0. This is needed to support the JRE that is installed with Mirror Replication Agent.

For more information about this requirement, see the Mirror Replication Agent Installation Guide.

Use one of the following methods to install the software:

From the Sybase Software Product Download Center (SPDC), download and extract the Mirror Activator 15.1 CD install image for Sun Solaris (see “Accessing products from the SPDC Web site” for details), or

Insert the Mirror Replication Agent CD into your CD-ROM drive.
Launch the installation program by executing the setup routine for Solaris:
```
./setup
```
If you see an error message saying that there is not enough temporary disk space, add this to your setup command:
```
./setup –is:tempdir someDirectory
```
where someDirectory is a directory with at least 100MB of disk space that the installation program can use.

If you are installing from a remote machine and do not have an X-windows client, execute ./setup –console to run in console mode.
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 to create it.
- 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. You might see this message:
```
There are newer files already installed and do you want to replace them?
```
Click No to All.
When you see a message that indicates 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.

For more information about the installation process and the installation program, see the Mirror Replication Agent Installation Guide.

To verify the installation

Change to the directory ($SYBASE) where you installed Mirror Replication Agent.
Set the environment variable by sourcing SYBASE.csh or SYBASE.sh, as appropriate for your shell.
Change the directory to $SYBASE/MA-15_1/bin.
Obtain the Mirror Replication Agent version string:
```
ma.sh -v
```
You should see the Sybase copyright and the Mirror Replication Agent version string.