Upgrading Replication Agent for Oracle to 15.7.1 SP100

Set the SYBASE environment variables by changing to the SYBASE directory in which Replication Agent 15.7.1 SP100 is installed and sourcing the SYBASE script:

For C Shell: source SYBASE.csh
For Bourne or Korn shell: . SYBASE.sh
For Windows, run: SYBASE.bat

Change to the Replication Agent bin directory:

On UNIX:
```
cd $SYBASE/RAX-15_5/bin
```
On Windows:
```
cd %SYBASE%\RAX-15_5\bin
```

Note: The Replication Agent directory name for release 15.5 and later is RAX-15_5.

Upgrade the Replication Agent instances.

Option	Description
Upgrading instances within the same product installation	To upgrade a specific Replication Agent instance in the Replication Agent installation directory, at the command prompt, run: ./ra_admin.sh -u instance=`<instance_name>` To upgrade all Replication Agent instances in the Replication Agent installation directory, at the command prompt, run: ./ra_admin.sh -u all
Upgrading instances in a separate product installation	To upgrade a specific Replication Agent instance in the specified source instance directory from the current product installation directory, run: ./ra_admin.sh -u `<source_instance_directory>` To upgrade all Replication Agent instances in the specified source installation directory from the current product installation directory, at the command prompt, run: ./ra_admin.sh -u `<source_installation_directory>`

Option

Description

Upgrading instances within the same product installation

To upgrade a specific Replication Agent instance in the Replication Agent installation directory, at the command prompt, run:
```
 ./ra_admin.sh -u instance=<instance_name> 
```
To upgrade all Replication Agent instances in the Replication Agent installation directory, at the command prompt, run:
```
./ra_admin.sh -u all
```

Upgrading instances in a separate product installation

To upgrade a specific Replication Agent instance in the specified source instance directory from the current product installation directory, run:
```
 ./ra_admin.sh -u <source_instance_directory> 
```
To upgrade all Replication Agent instances in the specified source installation directory from the current product installation directory, at the command prompt, run:
```
./ra_admin.sh -u <source_installation_directory>
```

The configuration files are backed up before the upgrade for use in error recovery, if required. If an error occurs, the upgrade is rolled back. The all option requires relatively less space because upgrades are performed directly on instances within the current product installation directory, not to copies. However, reversing an upgrade is more difficult for the same reason.

Start the Replication Agent instance:

$SYBASE/RAX-15_5/<instance>/RUN_<instance>

Log in to Replication Agent instance and migrate the Replication Agent metadata by running:

ra_migrate

Note: You can use the ra_finalize_upgrade to manually force upgrade finalization of an instance from a previous version and prevent downgrade to the previous version. You must finalize the upgrade to enable any new functionality. See the Replication Agent Reference Manual for details on using the ra_finalize_upgrade command.

Resume replication.

resume