2 Obtaining and Running Repository Creation Utility

Use these instructions for obtaining and running the Repository Creation Utility (RCU) to create and drop schemas.

2.1 Obtaining RCU

In 12c, RCU is available with the Oracle Fusion Middleware Infrastructure distribution.

For information about how to install and obtain RCU, see Installing the Infrastructure Software in Oracle Fusion Middleware Installing and Configuring the Oracle Fusion Middleware Infrastructure.

2.2 Starting RCU

After you install Oracle Fusion Middleware Infrastructure and create your Oracle home, you can start RCU from the ORACLE_HOME/oracle_common/bin directory.

Note:

  • If you are running RCU using a non-English database, you will need to set the following language environment variables: LANG, LC_ALL, and NLS_LANG. Use the environment commands that are appropriate for your environment.

    For example, for UNIX operating systems running csh enter the following:

    setenv LANG en_US.UTF8
    setenv LC_ALL $LANG
    setenv NLS_LANG american_america
    
  • To start RCU, you don’t need to set the JAVA_HOME environment variable. But, in case you want to use a specific JDK, ensure that the JAVA_HOME environment variable is set to the location of a certified JDK on your system. The location should be up to but not including the bin directory.

    For example, on UNIX operating systems, if your JDK is located in /home/Oracle/Java/:
    setenv JAVA_HOME /home/Oracle/Java/jdk1.8.0_101
    

    Be sure to replace the JDK location in this example with the actual JDK location on your system.

On Linux operating systems:

cd ORACLE_HOME/oracle_common/bin
./rcu

On Windows operating systems:

cd ORACLE_HOME\oracle_common\bin
rcu.bat

RCU provides a command line interface in situations where Xserver is not available or you have access to telnet terminals without display capabilities. The command line interface also allows you to embed RCU from command line scripts or with some Oracle Fusion Middleware components (for example, Enterprise Manager).

For more information using the CLI, see Running Repository Creation Utility from the Command Line.

2.3 Creating Schemas

Follow these instructions to create schemas in the database and verify that they are installed properly.

2.3.1 Creating Schemas as a User with Full SYS or SYSDBA Privileges

If you’re a user with full SYS or SYSDBA privileges, and are able to provide valid authentication credentials for database access, follow these instructions to create schemas.

Click on the screen name to see more detailed information for that screen. Unless otherwise noted, click Next to continue to the next screen.

Table 2-1 Schema Creation Steps for Full-Privilege Users

Screen Description

Welcome

This screen introduces you to RCU.

Create Repository

Select Create Repository, then select System Load and Product Load.

If you don’t have full SYS or SYSDBA privileges on the database, select Prepare Scripts for System Load and follow the schema creation instructions in Creating Schemas as a User With Limited Database Privileges.

Database Connection Details

Specify your database connection credentials.

Remember that if you’re creating schemas on an IBM DB2 database, you must have already created one operating system user for each schema you want to create. See Additional Requirements for IBM DB2 Databases for more information.

Click Next when you have specified your credentials. A separate dialog window will appear while RCU checks connectivity and some database prerequisites. When the database checking has passed without errors, click OK to dismiss the dialog window and go to the next screen.

Select Components (for Create Operation)

Select the components for which you want to create schemas, and specify a prefix to group them together.

You must remember the prefix and schema names for the components you’re installing; you’ll need this information during the configuration phase of your product installation. Oracle recommends that you write these values down.

Schema Passwords

Specify the passwords for your schema owners.

You must remember the passwords you enter on this screen; you’ll need this information during the configuration phase of your product installation. Oracle recommends that you write these values down.

Custom Variables

The Custom Variables screen appears only if you selected one or more of the following components on the Select Components screen. You can select a component on the Select Components screen only if the Oracle home in which RCU was started contains that component.

Map Tablespaces

Use this screen to configure the desired tablespace mapping for the schemas you want to create.

When you click Next, a separate dialog window will appear asking you to confirm that you want to create these tablespaces. Click OK to proceed and dismiss the dialog window.

A second dialog window will appear showing the progress of tablespace creation. After this is complete, click OK to dismiss this window and go to the next screen.

Summary (for Create Operation)

Verify the information on this screen, then click Create to begin schema creation.

Completion Summary (for Create Operation)

Review the information on this screen to verify that the operation was completed successfully. Click Close to complete the schema creation and dismiss RCU.

2.3.2 Creating Schemas as a User With Limited Database Privileges

If you’re a user without SYS or SYSDBA privileges, or you’re unable to provide valid authentication credentials for database access, follow these instructions to create schemas.

Table 2-2 Schema Creation Steps for Limited-Privilege Users

Screen Description

Welcome

This screen introduces you to RCU.

Create Repository

Select Create Repository, then select Prepare Scripts for System Load.

See About System Load and Product Load for more information about these operations.

Database Connection Details

Specify your database connection credentials.

Click Next when you have specified your credentials. A separate dialog window will appear while RCU checks connectivity and some database prerequisites. When the database checking has passed without errors, click OK to dismiss the dialog window and go to the next screen.

NOTE: Performing system load and product load separately is only supported on Oracle or Oracle EBR databases.

Select Components (for Create Operation)

Select the components for which you want to create schemas, and specify a prefix to group them together.

You must remember the prefix and schema names for the components you’re installing; you will need this information during the configuration phase of your product installation. Oracle recommends that you write these values down.

Custom Variables

The Custom Variables screen appears only if you selected one or more of the following components on the Select Components screen. You can select a component on the Select Components screen only if the Oracle home in which RCU was started contains that component.

Map Tablespaces

Use this screen to configure the desired tablespace mapping for the schemas you want to create.

Summary (for Create Operation)

Verify the information on this screen, then click Generate to begin script generation.

By default, the scripts will be generated in the RCUdate_timestamp_random_number/logs directory inside the temporary directory on your system. For example, on UNIX operating systems, the scripts will be generated in the /tmp/RCUdate_timestamp_random_number/logs directory by default. If you want to specify a different location, click Browse and select a location on your system.

The names of the scripts generated are script_systemLoad.sql and script_postDataLoad.sql.

Completion Summary (for Create Operation)

Review the information on this screen to verify that the operation was completed successfully. Click Close to complete the script generation and dismiss RCU.

N/A

After the scripts are created, someone with SYS or SYSDBA privileges should execute the script_systemLoad.sql script:

  1. Login to SQL*Plus.

  2. Enter the following command to execute the script_systemLoad.sql script (replace the path to the script if you chose to save it in a custom location):

    @/tmp/RCUdate_timestamp_random_number/logs/script_systemLoad.sql
    
  3. While the script is running, the user will be prompted to set the schema password for each schema being created. Specify the passwords as prompted.

    You will be returned to your system prompt when the script has been executed.

N/A

After the script is executed, start RCU again and perform the product load phase to complete schema creation.

Welcome

This screen introduces you to RCU.

Create Repository

Select Create Repository, then select Perform Product Load.

See About System Load and Product Load for more information about these operations.

Database Connection Details

Specify your database connection credentials.

Click Next when you have specified your credentials. A separate dialog window will appear while RCU checks connectivity and some database prerequisites. When the database checking has passed without errors, click OK to dismiss the dialog window and go to the next screen.

Select Components (for Create Operation)

From the drop-down list, select the prefix you specified earlier in this procedure.

Then, select the components for which you want to perform the product load.

Schema Passwords

Specify the passwords for your schema owners. Make sure to specify the same passwords that were entered while running the script_systemLoad.sql script through SQL*Plus.

You must remember the passwords you enter on this screen; you will need this information during the configuration phase of your product installation. Oracle recommends that you write these values down.

Custom Variables

The Custom Variables screen appears only if you selected one or more of the following components on the Select Components screen. You can select a component on the Select Components screen only if the Oracle home in which RCU was started contains that component.

Summary (for Create Operation)

Verify the information on this screen, then click Data Load to begin schema creation.

Completion Summary (for Create Operation)

Review the information on this screen to verify that the operation was completed successfully. Click Close to complete the schema creation and dismiss RCU.

N/A

This optional step is needed for components that generate and must execute product load scripts requiring DBA privileges. After the product load phase is complete, someone with SYS or SYSDBA privileges should execute the script_postDataLoad.sql script.

This step is needed for the Audit Services (IAU) and Oracle Enterprise Scheduler (ESS) components.

  1. Login to SQL*Plus.

  2. Enter the following command to execute the script_postDataLoad.sql script (replace the path to the script if you chose to save it in a custom location):

    @/tmp/RCUdate_timestamp_random_number/logs/script_postDataLoad.sql
    

    You will be returned to your system prompt when the script has been executed.

2.3.3 Verifying Schema Version Numbers

When the schemas are created in your database, RCU creates and maintains a table called schema_version_registry. This table contains schema information such as version number, component name and ID, date of creation and modification, and custom prefix.

To verify that the schemas are installed properly, run the following query after logging in to SQL*Plus:

select comp_name, version from schema_version_registry;

The comp_name argument retrieves the name of the component, and version retrieves the version number. For example:

SQL> select comp_name, version from schema_version_registry;

COMP_NAME
--------------------------------------------------------------------------------
VERSION
------------------------------
Audit Service
12.2.1.2.0
 
Audit Service Append
12.2.1.2.0
 
Audit Service Viewer
12.2.1.2.0
 
 
COMP_NAME
--------------------------------------------------------------------------------
VERSION
------------------------------
Metadata Services
12.2.1.1.0
 
Oracle Platform Security Services
12.2.1.0.0
 
Service Table
12.1.3.0.0
 
 
COMP_NAME
--------------------------------------------------------------------------------
VERSION
------------------------------
User Messaging Service
12.2.1.0.0
 
WebLogic Services
12.2.1.0.0
 
 
8 rows selected.

2.4 Dropping Schemas

Follow these instructions to drop schemas from the database.

Click on the screen name to see more detailed information for that screen. Unless otherwise noted, click Next to continue to the next screen.

Table 2-3 RCU Screens and Description for Dropping Schemas

Screen Instructions and Action Required

Welcome

This screen introduces you to RCU.

Create Repository

Select Drop Repository.

Database Connection Details

Specify the connection details for your database, then click Next.

A separate dialog window will appear while RCU checks connectivity and some database prerequisites. When the database checking has passed without errors, click OK to dismiss the dialog window and go to the next screen.

Select Components (for Drop Operation)

Select the prefix and the schemas you want to drop, then click Next.

A separate dialog window will appear asking you to verify that you want to drop the selected schemas. Click OK to dismiss this window.

A second dialog window appears while RCU checks the prerequisites for the schemas you are dropping. After this is complete, click OK to dismiss this window and go to the next screen.

Custom Variables

The Custom Variables screen appears only if you selected one or more of the following components on the Select Components screen. You can select a component on the Select Components screen only if the Oracle home in which RCU was started contains that component.

Summary (for Drop Operation)

Review the information on this screen, then click Drop to drop the schemas.

Completion Summary (for Drop Operation)

Note the location of the log files, then click Close to dismiss the screen.

2.4.1 About Dropping Shared Tablespaces

Tablespaces that are shared among multiple schemas will not be dropped.

For example, if you created both the Audit Services (for example, DEV_IAU) and Metadata Services (for example, DEV_MDS) schemas, both schemas would use the temporary tablespace DEV_IAS_TEMP (see Default Tablespace Mappings).

If you then drop the DEV_IAU schema, the DEV_IAS_TEMP tablespace would not be dropped since it is also being used by the DEV_MDS schema.

2.4.2 Dropping Schemas and Deleting Datafiles (Windows Only)

If you used RCU to drop a schema from a Windows-based database, and you want to recreate the dropped schema, you will have to manually delete datafiles that were not automatically removed when the schema was dropped.

Navigate to the DB_HOME\oradata directory and manually delete any remaining datafiles before recreating the schema.

Oracle recommends that you check this directory for any remaining datafiles before you attempt to recreate any dropped schema.