Migrating between 32-bit and 64-bit platforms

Replication Server 15.5 is available only on 64-bit platforms for all supported UNIX operating systems, and is available on 32-bit and 64-bit platforms for Linux and Windows. See the Replication Server Release Bulletin for supported 64-bit platforms.

The instructions in this section apply to migration between 32-bit and 64-bit platforms on Windows and Linux.

NoteIf you have upgraded to Replication Server 15.5 and later on UNIX systems available only on 64-bit platforms, you cannot migrate back to a 32-bit platform.

Before migrating

Back up your replication system. The upgrade process makes changes to the system databases that you cannot roll back if the upgrade fails. Restore the system databases if the upgrade fails.

If you plan to install the Replication Server software in a directory other than an existing Sybase version directory, verify that the interfaces (sql.ini) file is accessible.

StepsMigrating between 32-bit and 64-bit platforms

  1. Stop Replication Agent for all primary databases and system databases by executing this command on Replication Server:

    suspend log transfer from all
    
  2. If you are using Adaptive Server as your RSSD, stop RepAgent for the RSSD:

    sp_stop_rep_agent emb
    
  3. If you are going to migrate a replicate Replication Server, log in to the primary Replication Server and suspend all the routes to the replicate Replication Server:

    suspend route to replicate_Replication_Server
    
  4. Verify that the Replication Server queues have been drained and that Replication Server has been quiesced:

    admin quiesce_check
    

    Retry with admin quiesce_force_rsi if Replication Server is not quiesced yet.

    WARNING!  You may lose data if you proceed with the downgrade process and Replication Server is not quiesced.

  5. Stop Replication Server. To stop a Replication Server using isql:

    1. Log in to the Replication Server as the system administrator:

      isql -Usa -Psa_password -Sservername
      
    2. Enter:

      1> shutdown
      2> go
      
  6. If you are using an ERSSD, manually restart it:

    1. Set the LD_LIBRARY_PATH environment variable:

      $ export
      LD_LIBRARY_PATH=$SYBASE/REP-15_5/ASA11/
      lib:$SYBASE/REP-15_5/lib64:$SYBASE/REP-15_5/
      lib:$SYBASE/REP-15_5/lib3p64/log4cxx/lib:$SYBASE/
      OCS-15_0/lib:$SYBASE/OCS-15_0/lib3p64:$SYBASE/OCS-15_0/
      lib3p
      
    2. Start the ERSSD:

      -o $SYBASE/REP-15_5/samp_repserver/SAMPLE_RS.log
      $SYBASE/REP-15_5/samp_repserver/dbfile/SAMPLE_RS_ERSSD.db &
      

      See your Replication Server log file for the actual commands to set LD_LIBRARY_PATH and to start the ERSSD by searching for “LD_LIBARY_PATH” and “ERSSD start command” respectively.

  7. Load the migration script file into the ERSSD or RSSD. For example:

    • ERSSD – load $SYBASE/REP-15_5/scripts/rs_migration_asa.sql into the ERSSD

    • RSSD – load $SYBASE/REP-15_5/scripts/rs_migration_ase.sql into the RSSD

  8. Start Replication Server from the new Replication Server executable. See Chapter 6, “Starting or Stopping a Replication Server.”