Migrating from version 12.5 to 12.6 for non-Oracle instances

Migration from Sybase Replication Agent version 12.5 to 12.6 is a simple, three-step process:

1. Install the Sybase Replication Agent version 12.6 software.

2. Copy the existing Replication Agent version 12.5 instance directories to the version 12.6 directory.

3. Set rs_charset.

Using this process, new Replication Agent version 12.6 instances will have the same configuration, including instance names and administrative user IDs and passwords, as existing version 12.5 instances. The following procedure describes the details of this process.

To migrate from Replication Agent version 12.5 to 12.6

1. Install the Sybase Replication Agent version 12.6 software, as described in “Installing the Sybase Replication Agent software” in the Sybase Replication Agent Installation Guide.

   If you are installing the Replication Agent for Oracle version 12.6 software on a machine with an installation of the previous version, it must be installed in a different SYBASE directory.

   After you complete the version 12.6 installation procedure, return to this section to continue the migration procedure.

2. Quiesce and shut down all Replication Agent version 12.5 instances.

3. For each existing Replication Agent version 12.5 instance, copy the instance directory and subdirectories to the Replication Agent version 12.6 directory structure.

   • On Windows NT or Windows 2000, use Explorer to cut and paste the version 12.5 instance directory and all its contents into the version 12.6 base directory (%SYBASE%\RAX-12_6).

   • On UNIX, use the following command at the operating system prompt:

     cp -R $SYBASE/rax-12_5/inst_name $SYBASE/RAX-12_6
     

   where inst_name is the name of the directory for an existing Replication Agent version 12.5 instance.

4. Edit the configuration file for each Replication Agent version 12.6 instance to change the log directory path reference to point to the new directory location.

   The configuration file named inst_name.cfg, is located in the instance directory, %SYBASE%\RAX-12_6\inst_name, where %SYBASE% is the installation directory and inst_name is the name of the Replication Agent instance. In the following examples, the installation directory is sybase and the instance name is repagent.

   Windows example:

   Before: log_directory=C:\\sybase\\rax-12_5\\repagent\\log

   After: log_directory=C:\\sybase\\RAX-12_6\\repagent\\log

   When editing the configuration file on Windows 2000, you must retain the double backslash characters.

   UNIX example:

   Before: log_directory=/sybase/rax-12_5/repagent/log

   After: log_directory=/sybase/RAX-12_6/repagent/log

   Save each configuration file after you edit it.

5. Start up each new Replication Agent version 12.6 instance.

   See “Starting the Replication Agent instance from the command line” in the Sybase Replication Agent Installation Guide for more information.

6. Set rs_charset to match the Replication Server character set.

7. Update the version of the Replication Agent objects in the database. Invoke the pdb_xlog command with no parameters.

   Replication Agent checks the version of the Replication Agent objects in the database for compatibility, and makes any updates necessary to complete the migration process.

8. Invoke the resume command to resume replication.

9. Uninstall the Sybase Replication Agent version 12.5 software.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF