Replica Export Problems


If the mkreplica –export command finds that a replica with the specified name exists in the family (Replica replica-name already exists), select another name for the new replica, and reenter the mkreplica –export command.

If mkreplica –export –fship fails while it is transporting the packet, it does not remove the new replica’s replica object at the creating replica. To complete the replica creation, use shipping_server to transfer the replica-creation packet.

Recovering from a mkreplica –export Failure

If mkreplica –export fails, your database may be left in a locked state. To resolve this problem, use the procedures in this section or contact Rational Customer Support.

Unlock the Schema Repository and User Database

  1. Unlock the schema repository with the installutil unlockschemarepo command. This command has the following syntax:
  2. installutil unlockschemarepo db-vendor server database dbo-login dbo-password 
    connection-options 

    Connection options:

    Oracle database
    HOST=host;SID=sid
    All others
    ""

    For example, to unlock the SQL_SERVER schema repository database test_master_sitea on server QE_TEST1:

    installutil unlockschemarepo SQL_SERVER QE_TEST1 test_master_sitea 
    multisite multisite "" 

    where multisite is the dbo-login and dbo-password for the test_master_sitea database.

  3. Unlock the user database with the installutil unlockuserdb command. This command has the following syntax:
  4. installutil unlockuserdb db-vendor server database dbo-login dbo-password 
    connection-options 

    Connection options:

    Oracle database
    HOST=host;SID=sid
    All others
    ""

    For example, to unlock the SQL_SERVER user database test_user_sitea on server QE_TEST1:

    installutil unlockuserdb SQL_SERVER QE_TEST1 test_user_sitea multisite 
    multisite "" 

    where multisite is the dbo-login and dbo-password for test_user_sitea.

Subsequent multiutil Commands Fail

If subsequent attempts with mkreplica –export result in messages that indicate that the replica already exists or that another multiutil operation is in progress, contact Rational Customer Support.