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.
Note:
Starting with Oracle AI Database 26ai, the RCONFIG utility is deprecated.
- As the
oracleuser, navigate to the directory$ORACLE_HOME/assistants/rconfig/sampleXMLs, and open the fileConvertToRAC.xmlusing a text editor, such asvi. - Review the
ConvertToRAC.xmlfile, and modify the parameters as required for your system. The XML sample file contains comments that provide instructions for how to configure the file. Do NOT put passwords in the XML file. Instead, let therconfigutility prompt you to enter the passwords.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
file_name .xml. Make a note of the name you select. - Navigate to the directory
$ORACLE_HOME/bin, and use the following command to run the commandrconfig, whereinput.xmlis the name of the XML input file you configured in Step 2:rconfig input.xmlFor example, if you create an input XML file called
convert.xml, then you would use the following command$ ./rconfig convert.xmlThe
rconfigutility will prompt you for the necessary passwords.
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:
- Attempt to delete the database using the DBCA delete database option.
- Restore the source database.
- Review the conversion log, and fix any problems reported by
rconfigthat may have caused the conversion failure. Therconfiglog files are under therconfigdirectory in$ORACLE_BASE/cfgtoollogs. - Reattempt the conversion.
Related Topics