4 Creating a TMS Database

4.1.1 Gather Required Information

Make sure you have the information below, which is arranged in the order it is prompted for by the Installer during a fresh installation. The order for upgrades is somewhat different.

1. OPA Home: the directory where Oracle Thesaurus Management System will be installed; by default:

   C:\opapps53

4.1.2 Start the TMS Database Server Installer

To install the TMS Database Server:

1. Log in as a user with system administrator privileges.

2. In the staging area, locate the directory where you downloaded and extracted Oracle Thesaurus Management System (see Section 1.6, "Download the Software").

3. Run the following file as an administrator:

   Disk1\install\setup.exe

   The Installer opens to the Welcome screen.

   Note:

   See Section 1.7, "Use the Silent Installer (Optional)" for instructions for running the Installer as a file with pre-entered parameter values.

   Note:

   Although the Welcome screen also shows a button for deinstalling products, Oracle does not support using the Installer to deinstall Oracle Thesaurus Management System.

4. In the Select a Product to Install page, select Oracle Thesaurus Management System Server 5.3.0.0.x.

4.1.3 Attend to the TMS Database Server Code Installation Screens

The Installer guides you through the installation and configuration of the TMS database server. Provide the information you assembled in "Gather Required Information."

4.2.1 Start with a New Database Instance

Oracle recommends that you set up a new database instance so that neither TMS nor its installation process interferes with other applications. However, you can install TMS on an existing database instance.

4.2.2 Accept Connections as a Service

Choose to configure the database to accept connections as a service instead of a SID. Service name requirements for Oracle Thesaurus Management System include:

• The service name must be less than 15 characters long.

• It must not include the domain.

• It must be all lowercase.

4.2.3 Check Required Tablespaces

Table 4-1 lists the tablespaces, along with their minimum size, required for TMS. 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.

4.2.4 Use the Database Configuration Assistant

To create a new database, use the Oracle Database Configuration Assistant. For instructions about the Database Configuration Assistant, see the Oracle Database 12c Release 1 (12.1.0.2) documentation, including online help and the Oracle Database 12.1.0.2 Installation Guide for the appropriate operating system.

Notes:

• Use the Custom Database installation option.

• The following parameters are not listed under All Initialization Parameters. Click Show Advanced Parameters to set the following parameters as described in Section 4.2.7, "Set Initialization Parameters":

  • Db_cache_size

  • Db_files

  • Java_pool_size

  • Job_queue_process

  • Large_pool_size

• The Custom installation option allows access to the Database Storage screen, where you can expand the Tablespaces folder in the tree on the left side of the screen and edit the following tablespaces as required; see Section 4.2.3, "Check Required Tablespaces"

4.2.5 Select Required Components

When you create a TMS database, select the following mandatory components:

• Oracle Text

• Oracle JVM

• Oracle XML DB

4.2.6 Use Automatic Memory Management

Oracle recommends that you use Oracle Database 12c Release 1 (12.1.0.2)'s Automatic Memory Management feature for a new or an upgraded TMS database.

4.2.7 Set Initialization Parameters

For information, see details under Initialization Parameters option in Section 2.4.1, "Install and Configure Oracle Database".

4.3.1 Unlock Accounts Before Installing the TMS Database

The Installer prompts you for passwords to several system accounts. In Oracle Database, some accounts are locked. Before you run the Installer, check these accounts. Unlock them if necessary. You will need to set their passwords when you run the Installer.

Make sure the following accounts are unlocked: SYSTEM, CTXSYS, and SYS.

When you have finished installing the database, relock any accounts that were locked except for SYSTEM and SYS, which should not be locked.

4.3.2 Gather Required Information

Before you start the installer, be sure you have the following information:

1. Home Details: The full path to the OPA_HOME or similar application home name on your application server; by default:

   C:\opapps53

   Note:

   If TMS is integrated with Oracle Clinical 5.2.1 and Oracle Clinical has already been installed, OPA_HOME may already exist and set to something other than C:\opapps53. You must continue using the already created OPA_HOME with the value set by the previous installation.

2. Oracle Database Client Home: Full path to ORACLE_HOME. For example, C:\Oracle\Middleware\Oracle_Home.

3. TMS Database Server Code Home Directory: The system detects the location and enters the value for you. By default, it is C:\opapps53\tms.

4. Database Service name to connect: Enter the database name. It must be a valid TNS entry in your tnsnames.ora file.

5. Database Details: Enter the database server name and database port number.

6. NLS Settings: Enter the NLS settings for the database; see Section 1.8, "Choose a Character Set". Oracle strongly recommends that you use UTF8. The default values are:

   • American_America.UTF8

   • DD-MON_RRRR

7. Directory for data tablespace data files: Enter the path to the directory on the database server where the data tablespace datafiles for the application should be created during the installation. The Installer does not validate the value and you must use the following syntax, including a trailing slash, depending on your operating system; for example:

   • UNIX: /u01/oradata/dbname/

   • Windows: drive:\oradata\dbname\

8. Directory for index tablespace data files: Enter the path to the directory on the database server where the index tablespace datafiles for the application should be created during the installation. The Installer does not validate the value and you must use the following syntax, including a trailing slash, depending on your operating system; for example:

   • UNIX: /u01/oradata/dbname/

   • Windows: drive:\oradata\dbname\

9. Enter and confirm passwords for the following accounts:

   • SYS

   • SYSTEM

   • CTXSYS

   • OPA

   • RXC

   • TMS

   • TMSPROXY

10. Ignore tablespace creation errors:

    • Select Yes if the database already has the TMS tablespaces created.

    • Select No if the TMS tablespaces do not exist.

11. The Installer gives you information that you should make a note of.

4.3.3 Stop the PSUB Process (If Integrated with Oracle Clinical)

If your TMS installation is integrated with Oracle Clinical, you must stop the PSUB process before upgrading the database. See the Oracle Clinical Administrator's Guide for instructions.

4.3.4 Start the Installer

To install a TMS database:

1. Log in as a user with system administrator privileges in the application tier.

2. In the staging area, locate the directory where you downloaded and extracted Oracle Thesaurus Management System (see Section 1.6, "Download the Software").

3. Run the file as an administrator:

   Disk1\install\setup.exe

   The Installer opens to the Welcome screen.

   Note:

   See Section 1.7, "Use the Silent Installer (Optional)" for instructions for running the Installer as a file with pre-entered parameter values.

   Note:

   Although there is a button for deinstalling products on the Welcome screen, Oracle does not support using the Installer to deinstall Oracle Thesaurus Management System.

4. In the Select a Product to Install page, select TMS Database Install 5.3.0.0.x.

4.3.5 Attend to the TMS Database Installer Screens

The Installer guides you through the installation and configuration of the TMS database.

4.3.6 Check the Database Log File

For each database installation you perform, the Installer creates the following log file in the INSTALL directory:

tmsinst_database_name.log

Always check the log file for status, messages, or errors.

4.5.1 Gather Required Information

Before you start the installer, be sure you have the following information:

1. Home Details: The full path to the OPA Home location on your application server; by default:

   C:\opapps53\

2. Oracle Database Client Home: Full path to ORACLE_HOME; for example:

   C:\Oracle\Middleware\Oracle_Home

3. TMS Server Code Home Directory: The system detects the location and enters the value for you. By default, it is C:\opapps53\tms\.

4. Enter and confirm passwords for the following accounts:

   • SYS

   • RXC

   • TMS

5. Global name: Enter the global name of the TMS database; for example:

   service_name

   To find out the global name, log in to SQL*Plus and enter:

   select * from global_name

6. Global name: Enter the global name of the OC database.

4.5.2 Start the Installer

To register your TMS database for use with Oracle Clinical:

1. Log in to the application tier server as a user with system administrator privileges.

2. In the staging area, locate the directory where you downloaded and extracted Oracle Thesaurus Management System (see Section 1.6, "Download the Software").

3. Run the following file as an administrator:

   Disk1\install\setup.exe

   The Installer opens to the Welcome screen.

   Note:

   See Section 1.7, "Use the Silent Installer (Optional)" for instructions for running the Installer as a file with pre-entered parameter values.

   Note:

   Although there is a button for deinstalling products on the Welcome screen, Oracle does not support using the Installer to deinstall Oracle Thesaurus Management System.

4.5.3 Attend to the TMS Database Registration Screens

The Installer guides you through registering a TMS database.

1. Product to install: TMS Database Registration 5.3.0.0.x.

2. Follow the instructions on the installation screens, providing the information you gathered in Section 4.5.1, "Gather Required Information".

3. The Installer gives you information that you should make a note of.

4. When you are ready, install.