Updating the Log Device Repository

Replication Agent stores information about primary log devices in its RASD when you initialize the Replication Agent instance. Log device information in the RASD is referred to as the log device repository.

Unlike other information in the RASD, you can update the log device repository at any time using the ra_updatedevices command.

Note: If any log device is added, dropped, extended, or moved at the primary database, the Replication Agent log device repository must be updated. If Oracle ASM is being used to manage redo logs and a disk is added to or dropped from an ASM disk group, the device repository should be updated. Sybase recommends that you coordinate all log device changes at the primary database with updating the Replication Agent log device repository.
When you update the log device repository, Replication Agent:
  • Queries the primary database for information about all of its log devices.

  • Compares the information returned by the primary database with the information recorded in the log device repository.

  • Updates the log device repository with the new information returned by the primary database, if it finds information:
    • For existing log devices in the log device repository that does not match the information returned by the primary database, or

    • About new log devices in the information returned by the primary database.

If the path for a log device at the primary site is different from the path for the corresponding log device at the standby site, you must use ra_devicepath to specify the path to the log device recorded in the RASD.

Note: The ra_devicepath command is available only for Replication Agent for Microsoft SQL Server. The primary database does not have to be quiesced when you update the Replication Agent log device repository.
  1. Log in to the Replication Agent instance with the administrator login.
  2. Get the current status of the Replication Agent instance:
    ra_status
  3. If the Replication Agent is in Admin state, skip this step and go to step 4.

    If the Replication Agent is in Replicating state:

    1. Suspend replication for the Replication Agent instance:
      suspend
    2. Verify that the Replication Agent instance is in Admin state:
      ra_status
  4. If you coordinate log device changes at the primary database with updating the Replication Agent log device repository, make the log device changes at the primary database after the Replication Agent is in Admin state.
  5. Update the log device repository in the RASD:
    ra_updatedevices
  6. To specify the path for a log device, use ra_devicepath:
    ra_devicepath device, dev_path
    where:
    • device is the device ID.

    • dev_path is the alternate path (optional) that Replication Agent should use to access the log device.

    Note: You must invoke ra_devicepath once for each log device whose path you need to specify.
  7. Start replication for the Replication Agent instance:
    resume

You can update the log device repository as often as necessary to accommodate log device changes at the primary database.