Chat now with support
Chat with Support

SharePlex 11.2 - Administration Guide

About this Guide Conventions used in this guide Revision History Overview of SharePlex Run SharePlex Run multiple instances of SharePlex Execute commands in sp_ctrl Set SharePlex parameters Configure data replication Configure replication to and from a container database Configure named queues Configure partitioned replication Configure replication to a change history target Configure a replication strategy Configure DDL replication Configure error handling Configure data transformation Configure security features Assign SharePlex users to security groups Start replication on your production systems Monitor SharePlex Prevent and solve replication problems Repair out-of-sync data Tune the Capture process Tune the Post process Recover replication after Oracle failover Make changes to an active replication environment Apply an Oracle application patch or upgrade Back up Oracle data on the source or target Troubleshooting Tips Appendix A: Peer-To-Peer Diagram Appendix B: SharePlex environment variables

Tune queue performance

You can tune the performance of Post by tuning the performance of the post queue.

Reduce queue contention

  • You can use the SharePlex queue contention reduction feature to ensure that shared memory is not swapped to disk when the post queue is becoming full. This feature is enabled by the SP_IMP_QUEUE_PAUSE parameter.
  • This parameter pauses the writing of data to the post queue when that queue contains the specified number of messages. Post stores queue messages in shared memory until it issues a checkpoint, after which it releases the data from memory.
  • If the post queue runs out of shared memory, the read and write functions will start incurring file IO to free up the memory buffers. By pausing the queue writing, this parameter helps Post maintain its performance by avoiding the need for disk storage and the resultant slowdown in IO.
  • Use the SP_IMP_QUEUE_RESUME parameter to set the number of messages at which Import resumes writing to the post queue. This parameter works in conjunction with SP_IMP_QUEUE_PAUSE. If the number of messages in the post queue is lower or equal to the value set with this parameter, Import resumes writing to the post queue.

    To use this feature, both SP_IMP_QUEUE_PAUSE and SP_IMP_QUEUE_RESUME must be greater than zero, and SP_IMP_QUEUE_PAUSE must be greater than SP_IMP_QUEUE_RESUME.

    Tune subqueue indexing

    You can improve Post queue performance by enabling subqueue indexing to access the subqueue structures that represent a transaction session. A message "Subqueue index enabled queuename" is written to the Event Log for every Post queue for which this parameter is enabled.

    To enable this feature, set the SP_QUE_USE_SUBQUE_INDEX parameter to 1. This parameter does not support VARRAYs. If you are replicating VARRAYs and this parameter is enabled, the parameter is ignored.

  • Tune hash-based horizontally partitioned replication

    Hash-based horizontally partitioned replication uses a hash algorithm that is based on the rowid by default. You may be able to improve the processing of tables that use hash-based horizontally partitioned replication by switching the hash algorithm to one that is based on the block where the row resides.

    Because changing the algorithm has the same effect as a routing change (the potential to switch partitions), you must reactivate the configuration file. The activation locks the tables that are affected by this change so that the hash change is applied when there are no open transactions. The locking eliminates the potential for out-of-sync conditions by preventing data that is processed under the new hashing algorithm from being posted before in-flight data that was processed under the old algorithm.

    To switch to a block-based hash:

    1. Set the SP_OCF_HASH_BY_BLOCK parameter to 1.
    2. Reactivate the configuration file.

    Recover replication after Oracle failover

    This chapter contains instructions for recovering Oracle replication along with the database and applications during a failover in a high-availability environment. To support these procedures, SharePlex must be properly configured to support high availability. See Configure Replication to Maintain High Availability.

    Contents

    Recover replication if the primary system fails

    In an unplanned failure of the primary (source) machine, replicated data remaining in the SharePlex queues on that system will be unrecoverable as a result of buffering and the likelihood that the queues are corrupted. In a high-availability environment, you can move replication to the secondary (target) machine along with the database users to maintain data availability. When the primary system is restored, you can move users and replication back to that system with minimal downtime using a hot backup of the secondary instance.

    For this procedure, you will activate a configuration file and then use the reconcile command to synchronize the results of the backup with ongoing replicated user changes after the copied instance is recovered.

    Supported databases

    Oracle database on Unix or Linux

    Requirements

    Procedure 1: Move replication to the secondary system

    To move replication to the secondary system after an unplanned failure of the primary system:

    1. Verify that Export is stopped on the secondary system.

      sp_ctrl> stop export

    2. Use the qstatus command to view the post queue, and keep issuing this command until the number of backlogged messages is 0. Note: Do not wait for the actual numberof messages to be 0. If the primary system failed before the commit for some transactions were received, messages for these partial transactions will remain in the queue until cleared later in this procedure.

      sp_ctrl> qstatus

    3. Run the script that grants INSERT, UPDATE and DELETE access to all users on the secondary system.
    4. Run the script that enables triggers and constraints on the secondary system when users begin using this system.
    5. Implement the failover procedure for relocating users to the secondary system, including starting the applications.
    6. Move users to the secondary system and let them resume working, but do not start Export. Their transactions will now be accumulating in the export queue awaiting restoration of the source database.

    Note: If started, Export will repeatedly try to connect to the primary system, wasting system resources.

    1. Go to Procedure 2: Move replication to the restored primary system.

    Procedure 2: Move replication to the restored primary system

    This procedure moves users back to the primary machine after it is recovered from an unplanned failure. Follow each segment in the order presented.

    Restore the replication environment on the primary system

    To restore the replication environment on the primary system:

    1. On the primary system, recover the SharePlex directories, system files and Oracle files from the backups and archives.
    2. On the primary system, start sp_cop using the -s option to prevent the SharePlex processes (Capture, Read, Export, Import, Post) from starting.

      $ /productdir/bin/sp_cop -s &

    3. On the primary system, start sp_ctrl.
    4. On the primary system, deactivate the configuration file. When you copied the archived SharePlex variable-data directory to the primary system, you copied the configuration that was active before the system failed. This causes the Capture process to set the transaction number to “1” when replication from the primary system resumes.

      sp_ctrl> deactivate config filename

    Purge the queues

    To purge the queues:

    1. Run sp_ctrl on the primary and secondary systems.
    2. On the primary system, delete the capture queue.

      sp_ctrl> delete capture queue for datasrc [on host]

      Example: sp_ctrl> delete capture queue for o.oraA

    3. On the primary system, delete the export queue.

      sp_ctrl> delete export queue quename [on host]

      Example: sp_ctrl> delete export queue sysA

    4. On the secondary system, delete the post queue.

      sp_ctrl> delete post queue quename for datasrc-datadst [cleartrans] [on host]

      Example: sp_ctrl> delete post queue sysA for o.oraA-o.oraB

      Note:

      • You are issuing the delete queue command on the primary system because you restored the old capture and export queues when you restored the archived SharePlex directories.
      • You are issuing the delete queue command on the secondary system because data remaining in the post queue cannot be posted. The primary system failed before Post received a COMMIT for remaining transactions. SharePlex will rebuild the queues when you reactivate the configuration and the two systems are reconciled.

    Start replication from secondary to primary system

    To start replication from secondary to primary system:

    1. On the primary system, verify that all SharePlex processes are stopped.

      sp_ctrl> status

    2. On the primary system, stop Post.

      sp_ctrl> stop post

    3. On the secondary system, start Export. This establishes communication between the primary and secondary systems.:

      sp_ctrl> start export

    Synchronize the source and target data

    To synchronize the source and target data:

    1. On the secondary system, run an Oracle hot backup.
    2. When the hot backup is finished, switch log files on the secondary system and make a note of the highest archive-log sequence number.

    3. On the primary system, recover the primary database from the backup by using the UNTIL CANCEL option in the RECOVER clause, and cancel the recovery after the log with the number you recorded has been fully applied.
    4. Open the database with the RESETLOGS option.

      Note: This resets the sequences on the primary system to the top of the cache upon startup.

    5. On the primary system, issue the reconcile command using the sequence number of the log that you noted previously. If you are using named post queues, issue the command for each one. If you do not know the queue names, issue the qstatus command first.

      sp_ctrl> qstatus

      sp_ctrl> reconcile queue queuename for datasource-datadest seq sequence_number

      Example: reconcile queue SysB for o.oraA-o.oraA seq 1234

    6. On the primary system, disable triggers on the tables, or run the sp_add_trigger.sql utility script so that the triggers ignore the SharePlex user.
    7. On the primary system, disable check constraints and scheduled jobs that perform DML.
    8. On the primary system, log onto SQL*Plus as the SharePlex Oracle user and run the cleanup.sql utility from the bin sub-directory of the SharePlex product directory. This truncates the SharePlex tables and updates the SHAREPLEX_ACTID table.
    9. On the secondary system, truncate the SHAREPLEX_TRANS table. This table contains transaction information that the Post process was using before the primary system failed, and therefore that information is obsolete. Truncating the table restores transaction consistency between the two systems.

    Activate replication on the primary system

    To activate replication on the primary system:

    1. On the primary system, activate the configuration file.

      sp_ctrl> activate config filename

    2. On the primary system, start Post.

      sp_ctrl> start post

    Restore the object cache

    To restore the object cache:

    1. On the primary system, view the status of the SharePlex processes.

      sp_ctrl> status

      Note: This command shows that Post stopped due to an error, which occurred because the object cache is missing.

    2. On the primary system, issue the show log command with the filter option, and filter on the keyword "objcache."

      sp_ctrl> show log filter=objcache

    3. Look for a Post error message that refers to a file with a name similar to the following example:

      0x0a0100c5+PP+sys4+sp_opst_mt+o.quest-o.ov-objcache_sp_opst_mt.18

      You are looking for a string that contains the string “objcache_sp_opst_mt,” followed by a number. This is the object-cache file that the Post process needs. If you are using named post queues, there will be more than one error message, each referring to a different object-cache file but ending with the same number, such as the number .18 in the example.

    4. Make a note of the full pathname of the Post object-cache file(s) named in the error message. The path will be the state directory in the SharePlex variable-data directory, for example:

      splex_vardir/state/0x0a0100c5+PP+sys4+sp_opst_mt+o.quest-o.ov-objcache_sp_opst_mt.18

    5. On the secondary system, shut down SharePlex.

      sp_ctrl> shutdown

    6. On the secondary system, change directories to the state sub-directory of the SharePlex variable-data directory and locate the Capture object-cache file. This file will have a name similar to the one in the following example.

      o.quest-objcache_sp_ocap.18

      Important! If there are more than one of these files, use the one with the most recent number at the end of it — this number should match the number at the end of the Post object-cache file, such as .18 in the example.

    7. Copy the Capture object-cache file to the primary system and rename it to the full pathname of the Post object-cache file that you noted previously.
    8. On the primary system, start Post.

      sp_ctrl> start post

    Switch users back to the primary system

    To switch users back to the primary system:

    1. On the secondary system, stop user access to the database.
    2. On the primary system, view the post queue and continue to issue the command until the number of messages is 0.

      sp_ctrl> qstatus

    3. On the secondary system, shut down the Oracle instance.

      svrmgr1> shutdown

    4. On the secondary system, start the Oracle instance.

      svrmgr1> startup

      Note: This resets the sequence on the secondary system to the top of the cache to synchronize with the primary system.

    5. On the primary system, enable database objects that were disabled.
    6. On the secondary system, start SharePlex.
    7. On the secondary system, stop Post.

      sp_ctrl> stop post

    8. On the secondary system, disable triggers on the tables, or run the sp_add_trigger.sql utility script so that the triggers ignore the SharePlex user.
    9. On the secondary system, disable check constraints and scheduled jobs that perform DML.
    10. On the secondary system, start Post.

      sp_ctrl> start post

    11. On the primary system, view the number of messages in the post queue, and keep checking until the number of messages is 0.

      sp_ctrl> qstatus

    12. When the number of messages is 0, switch users back to the primary system.
    13. On the secondary system, stop Export to prevent accidental changes made on that system from being replicated to the primary system.

      sp_ctrl> stop export

    Note: The secondary system is now in a failover-ready state again, with:
    • no users
    • an active configuration
    • disabled or modified triggers, constraints, and scheduled jobs
    • a stopped Export process
    Related Documents

    The document was helpful.

    Select Rating

    I easily found the information I needed.

    Select Rating