Oracle® Clinical Installation Guide Release 4.6 Part Number A83779-08 |
|
|
View PDF |
This chapter describes how to create a new Oracle database for use with Oracle Clinical.
Oracle Database 11g and the Oracle Clinical Database Server installations must be complete before you can install the Oracle Clinical database. (See the Oracle Database 11g documentation and Chapter 2 for UNIX instructions or Chapter 3 for Windows instructions.)
This chapter includes the following topics:
Section 4.2, "Reviewing Database Requirements and Recommendations"
Section 4.3, "Installing Oracle Clinical 4.6 Database Objects"
Section 4.5, "Completing File Viewing Tasks in the Database"
Section 4.6, "Adding the Reports Server to the Database Reference Codelist"
Before you begin a database installation:
Review Chapter 1, "Preparing to Install Oracle Clinical" to ensure that your system is up to date.
Check My Oracle Support for the latest changes to the installation instructions.
Review the Configuring Oracle Clinical Remote Data Capture Onsite 4.6 for Performance and Scalability white paper (Article ID 873743.1), which is available on My Oracle Support.
Before you install the Oracle Clinical database component, review the requirements and recommendations — such as SID names, tablespace sizes, memory management, and initialization parameters — listed in this section.
Oracle recommends that you set up a new database instance so that neither Oracle Clinical 4.6 nor its installation process interferes with other applications. However, you can install Oracle Clinical on an existing database instance.
On UNIX systems, when you define the Oracle Clinical SID name, consider these options:
If you define the Oracle Clinical SID name using lowercase letters only, there are no conflicts in the Oracle Clinical Data Extract module.
If you define the Oracle Clinical SID name using uppercase letters, you must create symbolic links. These links are required so that the path to the SAS_VIEW directory is recognized. For information on creating these links, see the Oracle Clinical Administrator's Guide.
Table 4-1 lists the tablespaces, along with their minimum size, required for Oracle Clinical. Make sure the database contains these tablespaces. The best practice is to create them with the Autoextend On option, to avoid running out of space.
In addition, you may need to increase the minimum sizes for your installation.
To create a new database, use the Database Configuration Assistant. For instructions about the Database Configuration Assistant, see the Oracle Database 11g documentation, including online help and the Oracle Database Installation Guide 11g Release 1 (11.1) for the appropriate operating system.
Note:
The Database Configuration Assistant prompts you to "Keep the enhanced 11g default security settings (recommended)." Information on security settings is included in the Oracle Database 2 Day + Security Guide 11g Release 1 (11.1).When you create an Oracle Clinical database, select the following mandatory components:
Oracle Text
Oracle JVM
Oracle XML DB
Oracle recommends that you use Oracle Database 11g's Automatic Memory Management feature for a new or an upgraded Oracle Clinical database.
In addition, download the following white paper from My Oracle Support for more information on memory management:
Title: | Configuring Oracle Clinical Remote Data Capture Onsite 4.6 for Performance and Scalability |
Article ID: | 873743.1 |
Review the entries in the opa_settings file. Ensure that the default settings are applicable to the installation or create specific settings applicable to the specific database. See Section 2.7, "Performing Post-installation Tasks" for more information.
Note:
The default settings for all databases or the specific settings for a particular database, such as NLS_LANG, must be correct in the opa_settings file.Table 4-2 lists the required and recommended init.ora parameter settings for Oracle Clinical. For those parameters that accept a value from within a range, the values in the table are minimum values.
Tip:
Table 4-2 arranges the parameters in alphabetical order. In the Database Configuration Assistant, you can select the Parameter column to sequence the parameters in the same order.Note:
If you make any changes to the initialization parameters, be sure to stop and restart the database in order to acquire the new parameter settings.Table 4-2 Required and Recommended init.ora Parameter Settings
Follow these instructions to add Oracle Clinical database objects to this database.
If you are installing on a UNIX computer and you have not yet transferred the Database Server software from the media pack to this computer, see Section 2.6.2, "Transfer the Oracle Clinical 4.6 Database Server Software" for installation instructions.
Before you install database objects, you may want to modify some of the default SQL scripts used by the Installer.
The Installer creates several new tablespaces with default sizes. To create larger databases, edit the following files:
UNIX: | OPA_HOME /oc/46/install/opadba2.sql OPA_HOME /oc/46/install/rxcdba2.sql |
Windows: | OPA_HOME \oc\46\install\opadba2.sql OPA_HOME \oc\46\install\rxcdba2.sql |
You can either increase the size of the data files or remove the autoextend clause from the data files. The default value is an autoextend of 1M and an unlimited maximum size.
The Installer prompts to create accounts in this database. If you select Yes, the Installer runs a script that creates default guest accounts. Prior to running the Installer, edit the rxcdba4.sql script to customize the accounts that get created and their default settings:
UNIX: | OPA_HOME /oc/46/install/rxcdba4.sql |
Windows: | OPA_HOME \oc\46\install\rxcdba4.sql |
See the Oracle Clinical Administrator's Guide for more information about enrolling users.
Follow these instructions to set the correct installation environment and start the Installer. Where the platforms have different instructions, there are separate sections.
The Installer acts in two phases. In the first phase, the Installer collects information about your system. During this phase, you can move back and forward through the screens, revising your entries. During the second phase, the Installer runs the scripts to set up the Oracle Clinical software according to the information you provided in the first phase.
To start the Installer on a UNIX server:
Log in to the server computer as the opapps
user.
Change the primary group of the opapps account to the group that owns the Oracle Inventory:
newgrp
inst_group
where inst_group
is the name of the group that owns the Oracle Inventory. You specified the name during the Oracle Database 11g installation. Typically, this user group is oinstall.
This temporary change is necessary so that the Installer can update the Oracle inventory.
Set the X Window display output to the IP address of your local computer. Use the standard format for IP addresses, and add ":0"
to the end of the address. For example:
setenv DISPLAY 123.45.67.89:0
Navigate to this location in the folder where you extracted the server code:
server_code_platform
\Disk1\install
Change protections on files to 755
.
chmod 755 *
Start the Universal Installer:
./runInstaller
Follow the instructions on the installation screens. For additional information on each screen, see Section 4.3.4, "Attend to the Oracle Clinical Database Installation Screens."
To start the Installer on a Windows server:
Log in to the server computer using an account with system administrator privileges.
Insert Disk V17174-01 of the Oracle Clinical 4.6 and Oracle Thesaurus Management System 4.6.1 Media Pack.
Locate and execute the setup.exe file:
oc\server_code\win\install\setup.exe
The Installer opens to the Welcome screen.
Follow the instructions on the installation screens. For additional information on each screen, see Section 4.3.4, "Attend to the Oracle Clinical Database Installation Screens."
This section describes the Installer's prompts for installing an initial Oracle Clinical database. The instructions are the same for all platforms.
The Installer opens to the Welcome screen. Click Next.
Select OC Database Install 4.6.0.0.XX (where XX is the build number). Click Next.
Select or enter the ORACLE_HOME location, which is where you installed Oracle Database 11g.
Check that the displayed value is the correct location of the Oracle Clinical Database Server installation. If not, click Browse and locate the Oracle Clinical server installation. Click Next.
Specify the directory to create for locating Data Extract files. (See Chapter 8, "Setting Up SAS" for more information.) Click Next.
Choose Database Enter connect string for database to be installed
Enter the Oracle SID. Click Next.
Choose Directory for data tablespace datafiles
Enter the path for the directory where the Installer creates the data tablespace datafiles. The installer validates that the specified directory exists on the server.
In addition, the Installer creates the tablespaces with the default sizes defined in the opadba2.sql and rxcdba2.sql scripts. To increase the size of the initial database, edit these scripts before running the installer. For more information, see Section 4.3.2, "Customize the Installer."
Click Next.
Choose Directory for index tablespace datafiles
Enter the path for the directory where the Installer creates files to hold tablespaces for Oracle Clinical indexes. The installer validates that the specified directory exists on the server.
In addition, the Installer creates the tablespaces with the default sizes defined in the opadba2.sql and rxcdba2.sql scripts. To increase the size of the initial database, edit these scripts before running the installer. For more information, see Section 4.3.2, "Customize the Installer."
Click Next.
Enter and confirm the password for the SYS user to perform database administration activities during the installation. The Installer validates the password against the database before performing the install. Click Next.
Enter and confirm the password for the SYSTEM user to perform database administration activities during the installation. The Installer validates the password against the database before performing the install. Click Next.
Note:
In the installation screens that follow, the Installer prompts for the passwords for many user accounts. Note that:The Installer encrypts and stores the passwords in the database.
Passwords cannot contain the following characters: { } | ; @
Passwords cannot contain spaces.
Enter and confirm the password for the account that creates and maintains data access accounts during data extract.
Click Next.
Enter and confirm the password for the account that creates stored procedures during validation procedure definition. Click Next.
Enter and confirm the password for the account that manages distributed study conduct. Click Next.
Choose Password for RXC_DISC_REP
Enter and confirm the password for the account that manages disconnected replication. Click Next.
Choose Password for RXCLIN_MOD
Enter and confirm the password for the database role that controls write access to the Oracle Clinical database. Click Next.
Choose Password for BC4J_INTERNAL
Enter and confirm the password for the account that stores product objects. Click Next.
Enter and confirm the password for the account that stores product objects. Click Next.
Enter and confirm the password for the account that stores product objects. Click Next.
Enter and confirm the password for the account that stores product objects. Click Next.
Enter and confirm the password for the account that stores product objects. Click Next.
Enter and confirm the password for the account that stores product objects. Click Next.
Enter Value Database Seed Number
Each database in an Oracle Clinical installation (or group of databases that are replicating with each other) must have a unique seed starting number. The seed number must be an integer between 1 and 99. Click Next.
Enter Database Configuration Parameters
Enter the full name of the host where the database is located, and enter the SQL*Net port used to connect to this database. The port number is specified in the tnsnames.ora file for this database. Click Next.
Enter Location a unique code for this location
Enter a unique code for the location of this database. The location code cannot exceed 15 characters, and is converted to all uppercase characters.
The default value is the value of ORACLE_SID. Click Next.
Enter Global Library Location a unique code for the Global Library location
Enter a unique code for the location that owns the Global Library. The location code cannot exceed 15 characters, and is converted to all uppercase characters.
The default value is the location code entered in the previous screen. Click Next.
Yes/No Do you want to create accounts in this database?
This setting controls whether the Installer runs the rxcdba4.sql script and creates the user accounts defined in the script. Prior to running the Installer, you can edit the script to customize the accounts that get created and their default settings. See Section 4.3.2, "Customize the Installer" for more information.
You can also create user accounts after the installation. Click Next.
Yes/No Ignore Tablespace Creation Errors
This setting controls whether the Installer ignores errors that occur when creating the tablespaces. Tablespace creation can fail for several reasons.
The default value is No. In general, you do not want the Installer to ignore tablespace creation errors. For example, you want the Installer to report an error if there is not enough space to create the tablespace.
On the other hand, if you are reinstalling into an existing Oracle Clinical database, the tablespace creation fails because the tablespace already exists. In this case, you do not need to know about the error.
Click Next.
This screen reports that the Installer will start an SQL*Plus session to complete the database installation. The screen confirms the name of the database installation, the location of the scripts used for the installation, and the location of the log file that you can view for the progress of the installation. Click Next.
Summary OC Database Install 4.6.0.0.XX (Note: XX is the build number.)
This screen provides information about the global settings, languages, space requirements, and products for this installation.
Click Install. The Installer starts an SQL*Plus session to complete the installation.
The Installer configures the installed database to work with the Oracle Clinical 4.6 Database Server code by adding an entry to the following file:
UNIX: | opapps /bin/opa_settings |
Windows: | opapps \bin\opa_settings.bat |
The Installer displays this screen when it finishes. This screen provides information about the installation, including whether the processes completed without errors, the name of the PSUB service created, and the location of the log file for your review.
Note:
You may need to modify or create some additional default entries in the opa_settings file for this database. See the Oracle Clinical Administrator's Guide for more information.Recall that before you started this installation on UNIX, you changed the primary group of the opapps account to the group that owns the Oracle Inventory (see Section 4.3.3.1). This temporary change was necessary so that the Installer could update the Oracle inventory.
To reset the privileges for the opapps account, enter the following command:
newgrp
group
where group
is the name of your original primary group for the opapps account.
Follow the instructions in this section to complete your database installation.
The Installer generates numerous log files and saves the files to the following location:
UNIX: | OPA_HOME /oc/46/install |
Windows: | OPA_HOME \oc\46\install |
Check the following log files for error messages and invalid objects. In each file name, database
is the database SID.
oclinst_
database
.log
reall_
database.
log
oclconfig_
database.
log
flt_seeddata_
database_timestamp
.log
html_dialg_templ_
database_timestamp
.log
html_blob_seeddata_
database_timestamp
.log
xmlp_clob_seeddata_
database_timestamp
.log
xml_clob_seeddata_
database_timestamp
.log
compile_all_invalid_
database
.log
load_olsardcstatemachine_jar_
database
.log
install_
database_timestamp
.log
opaconnectcheck_system_
database
.log
To improve security and to protect system access:
Change the default passwords of all schemas and roles
Use the set_pwd utility to encrypt the passwords in the database
See the Oracle Clinical Administrator's Guide for details about setting up user accounts and roles, changing passwords, and encrypting passwords.
To improve performance, some of Oracle Clinical's packages are pin-able packages. Pinning allocates a stable memory location so that a package cannot be subjected to being swapped out of memory. Oracle Clinical provides the rxcdbinit.sql script to pin the database packages.
Note:
Oracle Clinical 4.6 pins additional packages. The new packages are included in the updated rxcdbinit.sql script.To pin the database packages located on a UNIX server:
Log in to the UNIX server computer as opapps.
Set the UNIX environment:
opa_setup
database
46
where database
is the name of this database instance, and 46
is the alias for the version of Oracle Clinical.
Change to the RXC_INSTALL directory:
cd $RXC_INSTALL
Start an SQL*Plus session, and connect to the database in the RXC account:
sqlplus rxc/
password
start rxcdbinit.sql
The script pins the database packages and exits upon completion.
Note:
You must reexecute this script each time you restart the database. Consider creating an entry in the database startup script that runsrxcdbinit.sql
.To pin the database packages located on a Windows server:
Set the Windows environment:
set p1=
database
set p2=
46
opa_setup
where database
is the name of this database instance, and 46
is the alias for the version of Oracle Clinical.
Change to the drive where Oracle Clinical 4.6 is installed. For example:
X
:
Start an SQL*Plus session, and connect to the database in the RXC account:
sqlplus rxc/
password
Run the rxcdbinit.sql script to pin the database packages:
start %RXC_INSTALL%\rxcdbinit.sql
If you are continuing the installation, note that you perform the next task in this environment.
The Parameterized SUBmission (PSUB) process schedules reports and batch processing. Note that:
You start one PSUB process for each Oracle database instance supporting an Oracle Clinical installation.
Each database instance can have only one PSUB process.
You must locate PSUB on the same computer as the database installation.
To start PSUB as a UNIX process:
Log in to the server as rxcprod.
Enter the following command:
start_psub
database code_environment
For example:
start_psub prod 46
To change the startup of the PSUB service on Windows:
Log in as Administrator.
Set the PSUB service parameters:
Open the Administrative Tools control panel.
Double-click Services.
From the list of services in the Services dialog box, double-click the name of the database for this service. It is in this form:
PSUB Service database
For Startup type, select Manual.
Click the Log On tab.
For Log on as, select This account and then enter RXCPROD in the field.
(The task of creating the RXCPROD account occurs during the installation of the Database Server. See Section 3.2.1, "Create the RXCPROD Account" for more information).
In the Password and Confirm Password fields, enter the RXCPROD password.
Click OK to close the dialog box.
Exit from the Services dialog box.
Log off this Administrator session. You start PSUB from the RXCPROD account.
To be able to start PSUB on Windows, the OSAUTH_PREFIX_DOMAIN setting in the Windows System Registry must be set to FALSE. Otherwise, the operating system authentication prefix is OPS$hostname\ instead of OPS$.
The OSAUTH_PREFIX_DOMAIN registry setting is located at:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\HomeX\
where HomeX is the Home number of your Oracle Database 11g installation.
To start PSUB as a Windows process:
Log in to the computer as user RXCPROD.
(You set up the PSUB service to start as the RXCPROD user, but in Windows you can start the service when logged on as another user.)
Set the PSUB service parameters:
Open the Administrative Tools control panel.
Double-click Services.
From the list of services in the Services dialog box, double-click the name of the database for this service. It is in this form:
PSUB Service database
Enter values for the Log On parameters:
database code_environment
[verbose | noverbose]
value-of-RXC_ROOT
For example: prod 46 verbose c:\\opapps\\oc\\46
Note:
If your entry requires a backslash (\), you must enter two (\\). Alternatively, you can enter the path using single forward slashes, for example,c:/OPA_HOME/oc/46
.Click Start.
Exit from the Services dialog box.
By default, the PSUB service does not start automatically when you restart a server computer. However, you can configure the PSUB service to start automatically. For information about managing the PSUB process and defining automatic startup parameters, see the Oracle Clinical Administrator's Guide.
See the Oracle Clinical Administrator's Guide for more information about enrolling users.
If you implement disconnected replication, you might need to increase the size of the DISC_REP_DATA tablespace to fit the amount of replicated data. Installing Oracle Clinical 4.6 creates the RXC_DISC_REP user account to manage disconnected replication. DISC_REP_DATA is the default tablespace for RXC_DISC_REP. For more information about distributed study conduct and disconnected replication, see the Oracle Clinical Administrator's Guide.
Oracle Clinical provides scripts that analyze the storage characteristics of tables and indexes, and compute statistics. As you accumulate statistics for this database, run these scripts periodically. See the Oracle Clinical Administrator's Guide, Appendix E, "Collecting Statistics for Optimization" for more information.
Oracle Clinical supports partitioning of the responses data entry table. Before implementing partitioning to responses data for your Oracle Clinical 4.6 installation, consider your requirements and options in migrating from a non-partitioned, pre-Oracle Clinical 4.0 responses table to Oracle Clinical 4.6.
To migrate your data from a non-partitioned responses table into a partitioned one, first backup your existing responses table, indexes, and data.
You must install an Oracle Clinical Forms Server and Reports Server before you can continue. See "File Viewing" in the Oracle Clinical Administrator's Guide for more information.
Before performing this step, you should have installed, or at least determined where you intend to install one, many, or all of the Reports Servers that you access from this database. For each Reports Server that you add and that you want to access from this database, you must repeat the steps in this section.
To set the Reports Server values:
Start Oracle Clinical.
Navigate to Admin, Reference Codelist, and then Local Codelist to open the Maintain Reference Codelists form.
Query for REPORT_SERVER in the Name field.
Complete the Short Value and Long Value fields as follows:
For each Short Value listed in Table 4-3, enter in the Long Value field the connection string of the Reports Server that you want to use as the default for the specified function.
To add additional, non-default Reports Servers, add rows to the reference codelist and specify a unique name in the Short Value field and the connection string in the Long Value field.
Table 4-3 REPORT_SERVER Reference Codelist Values
Short Value | Enter in Long Value Field |
---|---|
REPORT_SERVER |
The connection string for the Reports Server you want to use as the default for Oracle Reports. |
JOB_SET_SERVER |
The connection string for the Reports Server you want to use as the default for job sets. |
PSUB_SCHEDULER |
The connection string for the Reports Server you want to use as the default for PSUB jobs. |
Click Save.