Initializing the Replication Agent instance

StepsInitializing the Replication Agent instance

  1. NoteIf in your resource file you set initialize_instance to yes and no errors were received during the creation of the instance, skip this step.

    The pdb_xlog init command verifies that the primary Oracle database is correctly configured to provide archived logging and supplemental logging, and that the Oracle user ID used by the Replication Agent has the necessary permissions. In addition to creating objects in the database to support stored procedure replication, the pdb_xlog init command also initializes the Replication Agent System Database (RASD) by reading schema information, and redo log location information from the primary Oracle database.

    To initialize the Replication Agent instance, run:

    pdb_xlog init
    
    go
    

    A message appears, indicating that the procedure was successful.

  2. Enter:

    resume
    
    go
    

    If the Replication Agent successfully transfers to a replicating state, the following result is returned:

    State Action
    
    -------------------------------------
    
    REPLICATING Ready to replicate data.
    

    A returned state of ADMIN indicates that an error prevented the replicating state from being achieved. To determine the error, review the contents of the Replication Agent system log.

  3. The ra_status command returns the state of the Replication Agent. It is good practice to verify that the Replication Agent remains in replication state, even after the resume command executes successfully.

    To detect an error that occurred after replication start-up, execute:

    ra_status
    
    go
    

    If the Replication Agent is in replicating state, ra_status returns:

    State Action
    
    ------------ -------------------------
    
    REPLICATING Ready to replicate data.
    

    A returned state of ADMIN indicates that an error prevented the replicating state from being achieved. To determine the error, review the contents of the Replication Agent system log.

  4. Validate that both primary and replicate connections are active:

    isql -Usa -P -SSAMPLE_RS
    
    admin who
    
    go
    

    NoteBe aware that:

    • The DSI connection for the primary database connection is usually down because you are not replicating data back to the primary database.

    • The Replication Agent connection, if established for the replicate database connection, is usually down, because you are not replicating data from the replicate database.

    Do not proceed until admin who returns similar status for threads to the following:

    Spid Name       State            Info
    
    ---- ---------- ---------------- --------------------------------------
    
    13   DSI EXEC   Awaiting Command 101(1) SAMPLE_RS_ERSSD.SAMPLE_RS_ERSSD
    
     9   DSI        Awaiting Message 101 SAMPLE_RS_ERSSD.SAMPLE_RS_ERSSD
    
     8   SQM        Awaiting Message 101:0 SAMPLE_RS_ERSSD.SAMPLE_RS_ERSSD
    
    54   DSI EXEC   Awaiting Command 102(1) DCOServer.oratest2
    
    53   DSI        Awaiting Message 102 DCOServer.oratest2
    
    17   SQM        Awaiting Message 102:0 DCOServer.oratest2DSI
    
    20   DSI EXEC   Suspended        103(1) NY.NYora92
    
    21   DSI        Suspended        103 NY.NYora92
    
    24   DIST       Awaiting Wakeup  103 NY.NYora92
    
    25   SQT        Awaiting Wakeup  103:1 DIST NY.NYora92
    
    23   SQM        Awaiting Message 103:1 NY.NYora92
    
    22   SQM        Awaiting Message 103:0 NY.NYora92
    
    62   REP AGENT  Awaiting Command NY.NYora92