Converting Databases to Oracle RAC Using rconfig

You can use the command-line utility rconfig to convert a single-instance database to an Oracle RAC database, or to convert it to an Oracle RAC One Node database, depending on the values you provide in the ConvertToRAC.xml file. To use this feature, complete the following steps:

See Also:

Oracle Database Upgrade Guide for information about upgrading existing Oracle Database installations

  1. As the oracle user, navigate to the directory $ORACLE_HOME/assistants/rconfig/sampleXMLs, and open the file ConvertToRAC.xml using a text editor, such as vi.

  2. Review the ConvertToRAC.xml file, and modify the parameters as required for your system. The XML sample file contains comments that provide instructions for how to configure the file.

    Caution:

    Set the convert option Convert verify="ONLY" to perform a test conversion to ensure that a conversion can be completed successfully.

    When you have finished modifying parameters, save the file with a name of the format filename.xml. Make a note of the name you select.

  3. Navigate to the directory $ORACLE_HOME/bin, and use the following command to run the command rconfig, where input.xml is the name of the XML input file you configured in Step 2:

    rconfig input.xml

    For example, if you create an input XML file called convert.xml, then you would use the following command

    $ ./rconfig convert.xml

Note:

The Convert verify option in the ConvertToRAC.xml file has three options:

  • Convert verify="YES": rconfig performs checks to ensure that the prerequisites for single-instance to Oracle RAC conversion have been met before it starts conversion

  • Convert verify="NO": rconfig does not perform prerequisite checks, and starts conversion

  • Convert verify="ONLY" rconfig only performs prerequisite checks; it does not start conversion after completing prerequisite checks

If performing the conversion fails, then use the following procedure to recover and reattempt the conversion.:

  1. Attempt to delete the database using the DBCA delete database option.

  2. Restore the source database.

  3. Review the conversion log, and fix any problems reported by rconfig that may have caused the conversion failure. The rconfig log files are under the rconfig directory in $ORACLE_BASE/cfgtoollogs.

  4. Reattempt the conversion.