Upgrading Replication Agent to Version 15.7.1 SP120 or SP200

Special Instructions to upgrade the Replication Agent to version 15.7.1 SP120 or SP200.

As of 15.7.1 SP120 and later version, Replication Agent does not include the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files for maximum strength (256-bit) password encryption. By default, Replication Agent 15.7.1 SP120 and later version defaults to 128-bit password encryption.

Upgrade the Replication Agent instance using these options:

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>
```

To use the maximum strength (256-bit) password encryption, install the Java Cryptography extension (JCE) Unlimited Strengh Jurisdiction Policy Files:
1. Download the JCE Unlimited Strength Jurisdiction Policy Files 7 from the Oracle Website.
2. Extract the UnlimitedJCEPolicyJDK7.zip and copy the content of the Zip file in the Replication Agent installation directory.
  - On Windows – %SYBASE%\RAX-15_5\JRE7\lib\security
  - On UNIX – $SYBASE/RAX-15_5/JRE7/lib/security
To use the default strength (128-bit) password encryption, you must delete the existing passwords and reset the passwords.
1. Delete the existing password encryption string:
```
ra_admin –k <instance>
```
  where instance is the name of your Replication Agent instance.
  
  Note: Deleting the existing passwords will delete the Replication Agent system administrator, primary data server (PDS), SAP Replication Server and Replication Server System Database (RSS) user passwords and if you are replicating data definition language (DDL), the DDL user password is also deleted.
2. Reset the Replication Agent system administrator password by issuing:
```
ra_admin -reset <instance>
```
Restart the Replication Agent instance.
If you using the default strength password encryption, reset the password for PDS, SAP Replication Server, RSSD, and DDL user by issuing:
```
ra_config pds_password, <password>
```
```
ra_config rs_password, <password>
```
```
ra_config rssd_password, <password>
```
```
ra_config ddl_password, <password>
```
where password is the new password value.
Log in to Replication Agent instance and migrate the Replication Agent metadata by issuing:
```
ra_migrate
```
Note: You can use the ra_finalize_upgrade command 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 ra_finalize_upgrade in the Replication Agent Reference Manual.
Resume replication.
```
resume
```