A Repository Creation Utility Screens

This appendix contains screenshots and descriptions for all of the Repository Creation Utility screens:

A.1 Welcome

rcu welcome screen
Description of the illustration welcome.gif

This is the first screen that appears when RCU is started. Note the navigation pane on the left that summarizes the tasks that RCU will help you complete. Each item in the navigation pane represents a specific screen that will prompt you for information required to create or drop your schemas.

Click Skip This Page Next Time if you do not want to see the Welcome screen the next time you start RCU.

A.2 Create Repository

rcu operations screen
Description of the illustration create_repository.gif

Use this screen to select the action you want to perform:

  • Select Create to create component schemas in the database.

  • Select Drop to remove component schemas from the database.

A.3 Drop Repository

rcu operations screen
Description of the illustration drop_repository.gif

Use this screen to select the action you want to perform:

  • Select Create to create component schemas in the database.

  • Select Drop to remove component schemas from the database.

A.4 Database Connection Details

rcu database connection details screen
Description of the illustration database_details.gif

Use this screen to specify the connection credentials to the database in which you will be creating or dropping your schemas. Select one of the following depending on your database:

Click Next when you are finished entering the connection credentials for your database. The following screen appears, indicating the progress of the installer establishing the connection with the specified database:

checking prerequisites for database connection
Description of the illustration database_prereqs.gif

If an error occurs while the connection is being established, the error message(s) appear in the Messages field on the Database Connection Details screen.

Specific database requirements for the various schemas can be found in the Oracle Fusion Middleware System Requirements and Specifications document.

For certified database versions, see the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document, which is available on the Oracle Fusion Middleware Supported System Configurations page.

A.4.1 Specifying Connection Credentials for Oracle Databases and Oracle Databases with Edition-Based Redefinition

For Oracle databases and Oracle databases with edition-based redefinition, specify the following connection credentials:

Table A-1 Oracle Database Connection Credentials

Field Description

Host Name

Enter the name of the server where your database is running. Use the following format:

examplehost.exampledomain.com

For Oracle RAC databases, specify the VIP name or one of the node names in this field.

Port

Enter the port number for your database. The default port number for Oracle databases is 1521.

Service Name

Specify the service name for the database. Typically, the service name is the same as the global database name.

If you are unsure what the service name for your database is, you can obtain it from the SERVICE_NAMES parameter in the database's initialization parameter file. If the initialization parameter file does not contain the SERVICE_NAMES parameter, then the service name is the same as the global database name, which is specified in the DB_NAME and DB_DOMAIN parameters.

For Oracle RAC databases, specify the service name of one of the nodes in this field. For example:

examplehost.exampledomain.com

Username

Enter the user name for your database. The default user name is SYS.

Password

Enter the password for your database user.

Role

Select the database user's role from the drop-down list:

  • Normal

  • SYSDBA

All schemas installed on an Oracle database require the SYSDBA role. If you are creating schemas for Oracle Internet Directory (OID), you must use the user SYS and the SYSDBA role. See "Required Privileges for Oracle Databases" in the System Requirements and Specifications document for more information.


A.4.2 Specifying Connection Credentials for MySQL Databases

For MySQL databases, specify the following connection credentials:

Table A-2 Oracle MySQL Database Connection Credentials

Field Description

Host Name

Enter the host name, IP address, or complete server name in host\server format of the server where your database is running.

Port

Enter the port number for your database.

Database Name

Specify the name of your database.

Username

Specify the name of a user with DBA or SYSDBA privileges.

Password

Enter the password for your database user.


A.4.3 Specifying Connection Credentials for Microsoft SQL Server Databases

For Microsoft SQL Server databases, specify the following connection credentials:

Table A-3 Microsoft SQL Server Database Connection Credentials

Field Description

Unicode Support

Select Yes or No from the drop-down list.

NOTE: Oracle SOA Infrastructure schemas are created with Unicode support (database tables created with NVARCHAR) only, regardless of the option selected in this field.

Server Name

Enter the host name, IP address, or complete server name in host\server format of the server where your database is running.

Port

Enter the port number for your database.

Database Name

Specify the name of your database.

Username

Enter the user name for your database. The user must have SYSDBA or DBA privileges.

Password

Enter the password for your database user.


A.4.4 Specifying Connection Credentials for IBM DB2 Databases

For IBM DB2 databases, specify the following connection credentials:

Table A-4 IBM DB2 Database Connection Credentials

Field Description

Server Name

Enter the host name, IP address, or complete server name in host\server format of the server where your database is running.

Port

Enter the port number for your database.

Database Name

Specify the name of your database.

Username

Specify the name of a user with DB Owner privileges. The default user name for IBM DB2 databases is db2admin.

Password

Enter the password for your database user.


A.5 Select Components (for Create Operation)

Below is the Select Components screen if you selected Create on the Create Repository screen.

rcu select components screen
Description of the illustration select_component_create.gif

The following topics are covered in this section:

Note:

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

A.5.1 Creating Database Users for IBM DB2 Databases

IBM DB2 authenticates its database users using equivalent operating system users. Therefore, prior to running RCU, one operating system user must be created for each schema. The operating system user name must match the schema owner name and must contain only lowercase letters; no all-uppercase or mixed-case names are allowed. For example, if you create a schema named DEV_ODI using RCU, then the operating system user must be named dev_odi (all lowercase letters).

A.5.2 Creating Prefixes

Prefixes are used to create logical groupings of schemas in a database. For example, if you want to create two versions of the MDS schema in the database, you can use different prefixes to uniquely identify each one (for example, TEST_MDS and PROD_MDS). Note that the prefix name and schema name are separated by an underscore (_) character.

Note:

The Oracle Internet Directory (ODS) component cannot be prepended with a custom prefix; there can only be one repository for this component per database.

If you want to create a new prefix for your schemas, select Create a New Prefix and specify a new prefix name in the field. The prefix name must be a minimum of one character in length and cannot exceed 12 alphanumeric characters (0-9, a-z, or A-Z) in length (not including the underscore character). Prefixes should not start with a number. No whitespace or special characters are allowed.

Note:

For IBM DB2 databases, prefixes are limited to four characters in length (not including the underscore character).

The default new prefix is DEV. If DEV already exists as a prefix, then DEV1 is used; if DEV1 exists, then DEV2 is the default, and so on.

Use existing prefixes to add additional components to an existing repository in the database. To use an existing prefix, select Select an Existing Prefix and choose a prefix from the drop-down list.

A.5.3 Selecting Components and Dependencies

When you select a component, any other components that may be required by the component you select are also selected. For example, if you select SOA and BPM Infrastructure, then all schemas in this category are selected along with the Metadata Services schema. The Metadata Services schema is required by each component in SOA and BPM Infrastructure.

If a component has a plus sign (+) next to its name, then there are sub components available. Click on the plus sign (+) to expand the category to view all sub components. If you want to select a component with all its subcomponents, click on the top-most box with the plus sign (+).

A.5.4 Specifying Custom Schema Names

Click on the name of any schema in the "Schema Owner" column to change the name of the schema. Schema names can only contain alphanumeric characters (0-9, a-z, or A-Z) and are case-sensitive.

Note:

The Oracle Internet Directory (ODS) component cannot be prepended with a custom prefix; there can only be one repository for this component per database.

A.5.5 Checking Schema Prerequisites

Click Next when you are finished specifying your prefix, schema names, and selecting components. The following screen appears, indicating the progress of component prerequisite checking before the schemas are created.

checking prerequisites for component selection
Description of the illustration select_component_prereqs.gif

If an error occurs during the prerequisite checking, the error message(s) appear in the Messages field on the Select Components screen.

Click OK to dismiss this screen.

A.6 Select Components (for Drop Operation)

Below is the Select Components screen if you selected Drop on the Create Repository screen.

rcu select components screen
Description of the illustration select_component_drop.gif

First, select the prefix associated with the schema(s) you want to drop.

Then, select the component(s) whose schemas you want to drop.

Click Next when you are finished. The following screen appears:

checking prerequisites for component selection
Description of the illustration select_component_drop_conf.gif

Click OK to continue. The following screen appears:

checking prerequisites for component selection
Description of the illustration select_component_prereqs.gif

If an error occurs during the prerequisite checking, the error message(s) appear in the Messages field on the Select Components screen.

Click OK to dismiss this screen.

A.7 Schema Passwords

Below is the Schema Passwords screen.

rcu select components screen
Description of the illustration schema_password.gif

There are three ways to specify schema passwords on this screen; they are described in the following table:

Table A-5 Options for Specifying Schema Passwords

Option Description

Use same password for all schemas

Select this option if you want to use a single password for all schemas and their auxiliary schemas. In the Password field, enter your password. Enter your password again in the Confirm Password field.

Use main schema passwords for auxiliary schemas

Select this option if you want to specify different passwords for the main schemas, but still have the same password used for their respective auxiliary schemas. If you select this option, only the main schemas will be visible in the table. For each schema, you must enter each schema's password in the Password column in the table, and enter the same password in the Confirm Password column.

Specify different passwords for all schemas

Select this option if you want to specify unique passwords for the main schemas and auxiliary schemas. If you select this option, all main schemas and auxiliary schemas will be visible in the table. For each schema and auxiliary schema, you must enter the password in the Password column in the table, and enter the same password in the Confirm Password column.


Note:

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

A.8 Custom Variables

summary screen
Description of the illustration custom_variables.gif

This page allows one or more components to specify additional configuration information required by the components during runtime.

This screen only appears if you selected a component on the Select Components (for Create Operation) that supports custom variables:

A.8.1 Specifying Custom Variables for Master and Work Repository (ODI)

Specify the following for the Master and Work Repository Custom Variables:

Table A-6 Master and Work Repository Custom Variables

Variable Description

Master Repository ID

A specific ID for the new Master Repository. Master Repository ID values must be between 0 and 999. Default value is 001.

Supervisor PAssword

Password of the supervisor user. You must confirm this password on the following line.

Work Repository Type

Specify how the Work Repository will be used:

  • Use Development (D) for creating a development repository. This type of repository allows management of design-time objects such as data models and projects (including interfaces, procedures, etc.) A development repository also includes the run-time objects (scenarios and sessions). This type of repository is suitable for development environments.

  • Use Execution (E) for creating an execution repository: This type of repository only includes run-time objects (scenarios, schedules and sessions). It allows launching and monitoring of data integration jobs in Operator Navigator. Such a repository cannot contain any design-time artifacts. Designer Navigator cannot be used with it. An execution repository is suitable for production environments.

Work Repository ID

A specific ID for the new Work Repository. Default value is 001.

Work Repository Name

A unique name for the Work Repository (for example: DEVWORKREP1).

Work Repository Password

(Optional) - Provide a password for the Work Repository. If you provide a password, you must confirm the password on the following line.


A.8.2 Specifying Custom Variables for Oracle WebCenter Portal's Activity Graph and Analytics

Specify Y if you want to install Activity Graph and Analytics with database partitioning enabled, or N if you do not want to enable database partitioning.

A.9 Map Tablespaces

rcu map tablespaces screen
Description of the illustration map_tablespace.gif

This screen only appears if you selected the Create option on the Create Repository. The following topics are covered:

Click Next when you are finished with your tablespace information. The following screen appears, asking you to confirm the creation of tablespaces for any new schemas.

map tablespaces confirmation screen
Description of the illustration map_tablespace_confirm.gif

Note:

RCU only creates tablespaces for those components associated with RCU.

Click OK to continue. The following screen appears, indicating the progress of the tablespace creation.

validating and creating tablespaces
Description of the illustration map_tablespace_creating.gif

Click Stop to cancel tablespace creation. When the tablespaces are created, click OK to dismiss this window.

A.9.1 Default Tablespace Mappings

The default tablespace mapping for each component are shown in Appendix B, "Repository Creation Utility Schemas, IDs, and Tablespaces".

In the Default Tablespace and Temp tablespace columns, you can click on the tablespace cell to select from a list of available additional tablespace names.

Note:

OID tablespace names cannot be user specified.

A.9.2 Changing Default and Temporary Tablespaces

To change the default tablespace for a component, select the tablespace name in the "Default Tablespace" column, then select the tablespace name you want to use from the drop-down list. You can have your components use as many or as few tablespaces as desired to suit your configuration.

To change the temporary tablespace for a component, select the tablespace name in the "Temp Tablespace" column, then select the tablespace name you want to use from the drop-down list.

A.9.3 Viewing and Changing Additional Tablespaces

Some components have additional tablespaces associated with their schemas. If this is the case, the Additional Tablespaces button will appear on this screen. If none of the selected components have additional tablespaces, then this button will not appear.

To view additional tablespaces associated with the selected components, click the Additional Tablespaces button. You will see a screen similar to the following:

additional tablespaces screen
Description of the illustration map_tablespace_addtnl.gif

Only those components with additional tablespaces as defined in the configuration files will appear on this screen.

To change the tablespace you want to use for a component, click in the "Tablespace Name" column and select the tablespace you want to use from the drop-down list.

Click OK when you are finished.

A.9.4 Managing Tablespaces and Datafiles

To manage your tablespaces and datafiles, click the Manage Tablespaces button. You will see a screen similar to the following:

maange tablespaces screen
Description of the illustration map_tablespace_manage.gif

The following topics are covered in this section:

A.9.4.1 Adding, Modifying, and Removing Tablespaces

Only tablespaces that will be created by RCU can be modified or removed. Tablespaces that existed before RCU was launched are visible on this screen but are grayed out and cannot be modified or removed.

Only tablespaces that are used by a component are created. You can specify a new tablespace here, but unless it is actually used by a component it will not be created.

To modify a tablespace, select the tablespace name on the left-hand portion of the screen, and edit the fields as described in the following table:

Table A-7 Modifying a Tablespace

Field Description

Name

Edit the tablespace name this field to change the name of your tablespace.

Type

Specify whether you want this tablespace to be a temporary tablespace or permanent tablespace.

Block Size (KB)

Specify the block size (in Kilobytes) to be used for data retrieval.

Storage Type

Select Use Bigfile Tablespace if you want to create a bigfile tablespace; this is typically used if you have single large files instead of multiple small files. Select Use Automatic Segment Space Management if you want to use bitmaps to manage the free space within segments.


To add a tablespace, click Add and specify the same details as above (for modifying a tablespace) for your new tablespace.

To remove a tablespace, select the tablespace name from the navigation tree, then click Remove. This tablespace will not get created.

A.9.4.2 Adding, Modifying, and Removing Datafiles

In the Datafiles section, specify the datafiles that make up the selected tablespace. Select one of the following for more information:

A.9.4.2.1 Adding a Datafile

To add a datafile, click the icon with the plus sign (+):

Description of icon_add_datafile.gif follows
Description of the illustration icon_add_datafile.gif

The Add Datafile screen appears:

Description of map_tablespace_add_dfile.gif follows
Description of the illustration map_tablespace_add_dfile.gif

Provide the information described in the following table:

Table A-8 Adding a Datafile

Field Description

File Name

Specify the name of the datafile.

NOTE: Datafile names with a dash or hyphen (-) character are not permitted.

File Directory

Specify the location where this datafile will reside.

Size

Specify the initial size of the datafile. Use the drop-down list to specify the size in kilobytes (KB), megabytes (MB), or gigabytes (GB).

Automatically extend datafile when full (AUTOEXTEND)

Select Automatically extend datafile when full (AUTOEXTEND) if you want to automatically extend the size of your datafile when it becomes full. In the "Increment" field, specify the size by which your datafile should be increased each time it becomes full. Use the drop-down list to specify the size in kilobytes (KB), megabytes (MB), or gigabytes (GB).

If you want to limit maximum size of the datafile, specify this value in the "Maximum Size" field.


A.9.4.2.2 Modifying a Datafile

To modify or edit a datafile, select the icon next to the datafile name you want to edit, then click the icon with the pencil:

Description of icon_edit_datafile.gif follows
Description of the illustration icon_edit_datafile.gif

The Edit Datafile screen appears:

Description of map_tablespace_edit_dfile.gif follows
Description of the illustration map_tablespace_edit_dfile.gif

Provide the information described in the following table:

Table A-9 Modifying a Datafile

Field Description

File Name

Specify the name of the datafile.

NOTE: Datafile names with a dash or hyphen (-) character are not permitted.

File Directory

Specify the location where this datafile resides.

Size

Specify the initial size of the datafile. Use the drop-down list to specify the size in kilobytes (KB), megabytes (MB), or gigabytes (GB).

Automatically extend datafile when full (AUTOEXTEND)

Select Automatically extend datafile when full (AUTOEXTEND) if you want to automatically extend the size of your datafile when it becomes full. In the "Increment" field, specify the size by which your datafile should be increased each time it becomes full. Use the drop-down list to specify the size in kilobytes (KB), megabytes (MB), or gigabytes (GB).

If you want to limit maximum size of the datafile, specify this value in the "Maximum Size" field.


A.9.4.2.3 Deleting a Datafile

To delete a datafile, select the icon next to the datafile name you want to delete, then click the icon with the "X":

Description of icon_remove_datafile.gif follows
Description of the illustration icon_remove_datafile.gif

A.10 Summary (for Create Operation)

Below is the Summary screen if you selected Create on the Create Repository screen.

summary screen
Description of the illustration summary_create.gif

Review the information on this screen, and click Create to begin schema creation. The operations summarized on this page will be performed when you click Create.

While the schemas are being created, you will see the following progress screen:

repository creation summary screen
Description of the illustration summary_create_progress.gif

Click Stop if you want to stop creating the schemas.

A.11 Summary (for Drop Operation)

Below is the Summary screen if you selected Drop on the Create Repository screen.

summary screen
Description of the illustration summary_drop.gif

Review the information on this screen, and click Drop to begin the operations summarized on this page.

While the schema(s) are being dropped, you will see the following progress screen:

repository creation summary screen
Description of the illustration summary_drop_progress.gif

Click Stop if you want to cancel the operation.

A.12 Completion Summary (for Create Operation)

Below is the Completion Summary screen if you selected Create on the Create Repository screen.

rcu repository creation complete screen
Description of the illustration completion_summary_create.gif

Note the log file names for each component that are visible in the "Logfile" column.

The main RCU log and component log files are written to the following directory on UNIX operating systems:

RCU_HOME/rcu/log/logdir.date_timestamp

On Windows operating systems:

RCU_HOME\rcu\log\logdir.date_timestamp

If there were any problems encountered during schema creation, you can troubleshoot the issue using the log files. For more information, see Appendix C, "Troubleshooting Repository Creation Utility".

If errors are encountered during a Create operation, or if a Create operation fails for any component, the Cleanup for failed components checkbox appears on this page and is selected by default. If selected, RCU will perform cleanup operations for the component that failed during the Create operation. If you choose not to select this checkbox, you can cleanup the failed component at a later time by performing a Drop operation for the failed component(s).

Review the information on this screen, then click Close to dismiss this screen.

A.13 Completion Summary (for Drop Operation)

Below is the Completion Summary screen if you selected Drop on the Create Repository screen.

rcu repository creation complete screen
Description of the illustration completion_summary_drop.gif

Note the log file names for each component that are visible in the "Logfile" column.

The main RCU log and component log files are written to the following directory on UNIX operating systems:

RCU_HOME/rcu/log/logdir.date_timestamp

On Windows operating systems:

RCU_HOME\rcu\log\logdir.date_timestamp

If there were any problems encountered during schema creation, you can troubleshoot the issue using the log files. For more information, see Appendix C, "Troubleshooting Repository Creation Utility".

Review the information on this screen, then click Close to dismiss this screen.