Skip Headers
Oracle® Thesaurus Management System Installation Guide
Release 4.6.2

Part Number E18826-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

4 Installing and Configuring Oracle Application Server

For Oracle Thesaurus Management System (TMS) 4.6.2, the required Oracle Application Server technology stack includes Oracle Application Server 10g Release 3 and its Patch Set 5, and Oracle Application Server 10g Release 2 and its Patch Set 3.

This chapter describes how to install and configure these components. It includes the following topics:

4.1 Installing the Oracle Application Server Technology Stack

To install the Oracle Application Server technology stack, you complete the following tasks:

4.1.1 Set the Windows Compatibility Mode for the setup.exe File

Before installing the Oracle Application Server technology stack on Windows 2008 server, you must set the compatibility mode for the setup.exe file for each component in the technology stack.

To set the Windows compatibility mode:

  1. Right-click on a setup.exe file, and then select Properties.

  2. Select the Compatibility tab.

  3. Select Run this program in compatibility mode for check box, and then select Windows Server 2008 (Service Pack 1) from the list.

  4. Click OK to save your changes.

  5. Continue with the software installation.

4.1.2 Install Oracle Application Server 10g Release 2 (10.1.2.0.2)

Oracle Application Server 10g Release 2 provides forms and reports services.

To install Oracle Application Server 10g Release 2:

  1. Close all running applications on the computer.

  2. Log in to the application server using an account with system administrator privileges.

    Caution:

    You cannot run the setup.exe file for Oracle Application Server 10g Release 2 on Microsoft Windows 2008. Oracle Universal Installer fails on start up because of compatibility issues with the operating system. Note that setting the Compatibility mode for the AS10gR2 setup.exe file does not resolve this known issue.

    To work around this issue, you must start Oracle Universal Installer by running the setup.exe file for Patch Set 3 (10.1.2.3.0) for Oracle Application Server 10g Release 2. Once the Installer starts, you must change the source directory to the location of the Oracle Application Server 10g Release 2 installation files. The steps that follow provide detailed instructions.

  3. Insert the Oracle Clinical 4.6.2 and Oracle Thesaurus Management System 4.6.2 disk.

  4. Copy and extract the p5983622_10123_WINNT.zip file, which is Patch Set 3 (10.1.2.3.0) for Oracle Application Server 10g Release 2 Forms and Reports Services onto your application server.

  5. Insert the Oracle Application Server Forms and Reports Services (10.1.2.0.2) Microsoft Windows (32-bit) disk. (This disk is included in the Oracle Clinical and Oracle Thesaurus Management System 4.6.2 Media Pack.)

  6. Navigate to the setup.exe file for the Patch Set 3 software that you previously copied and extracted.

  7. Set the Windows Compatibility mode for this setup.exe file. (See Section 4.1.1, "Set the Windows Compatibility Mode for the setup.exe File" for details.)

  8. Use Windows Explorer or the command line to run the setup.exe file for the Patch Set 3 software.

    The system briefly displays a DOS window while it checks your computer's compatibility, and then opens the Welcome screen.

  9. Follow the instructions on the installation screens. For additional information about each screen, see Section 4.1.2.1, "Attend to the Oracle Application Server 10g Release 2 Installation Screens."

4.1.2.1 Attend to the Oracle Application Server 10g Release 2 Installation Screens

The Oracle Universal Installer guides you through the installation and configuration of Oracle Application Server.

Welcome

Click Next to continue the installation.

Specify File Locations

Define where to install Oracle Application Server 10g Release 2 (10.1.2.0.2). The directory into which you install this instance of Oracle Application Server is called the ORACLE_AS10gR2_HOME.

  • Source Path

    Caution:

    Do not accept the default value. Because you had to start Oracle Universal Installer by running the setup.exe file for Patch Set 3 (10.1.2.3.0) for Oracle Application Server 10g Release 2, the default value specifies the location of the source files for Patch Set 3.

    Instead, click Browse to specify the location of the source files for the Oracle Application Server 10g Release 2 installation. For example, D:\Disk xxxxxx-01\stage\products.xml.

  • Destination Name: Enter the home name of the application tier. For example, AS10gR2.

  • Destination Path: Enter the complete directory path where this instance of Oracle Application Server will be installed. You can change the path to another location, or you can keep the default path. For example, D:\oracle\AS10gR2.

Click Next.

Available Product Components Oracle Application Server Forms and Reports Services 10g

Select the Oracle Application Server Forms and Reports Services 10g 10.1.2.0.2 check box to install all components. Click Next.

Specify Port Configuration Options

Select Automatic, and then click Next.

Provide Outgoing Mail Server Information

The mail server is optional. It is not needed to run TMS.

Click Next.

Specify Instance Name and ias_admin Password

Complete this screen as follows:

  • Enter a name for the Oracle Application Server 10g Release 2 instance you are installing. The suggested name for this instance is AS10gR2.

    Oracle Application Server appends the host name and the domain name to the instance name you specify to form a complete instance name. For example, if you install an instance on a host computer named comp1, and you name the instance AS10gR2, then the full name of the instance is as follows:

    AS10gR2.comp1.domain_name.com

  • Enter and confirm a valid ias_admin password to use for the administration of this instance of Oracle Application Server.

Click Next.

Summary Oracle Application Server Forms and Reports Services 10g 10.1.2.0.2

Review the installation details to verify that they are correct. To revisit earlier installation screens and make changes, click Back.

When you are ready to continue, click Install.

Install

The Install screen displays the progress of the installation. Oracle Universal Installer configures this instance of Oracle Application Server 10g Release 2. The configuration process can take several minutes. Do not interrupt the automated configuration.

You can view a log of this installation session at:

\Program Files (x86)\Oracle\Inventory\logs\installActionstimestamp.log

End of Installation

Scroll through and review the information on the End of Installation screen. Oracle Application Server 10g Release 2 saves this information in the following file:

setupinfo.txt

Oracle Universal Installer displays the location of the setupinfo.txt file near the top of the End of Installation section. Make note of this location in case you want to reference the file in the future.

When you have finished reviewing the installation information, click Exit. At the confirmation prompt, click Yes to exit from Oracle Universal Installer.

4.1.2.2 Apply Oracle Application Server 10g Release 2 Patch Set 3 (10.1.2.3.0)

To apply Patch Set 3 (10.1.2.3.0) to Oracle Application Server 10g Release 2 Forms and Reports Services:

  1. Navigate to the location where you already copied and extracted the Patch Set 3 software.

    (Patch Set 3 is the p5983622_10123_WINNT.zip file on the Oracle Clinical 4.6.2 and Oracle Thesaurus Management System 4.6.2 disk.)

  2. Locate the setup.exe file for the Patch Set 3 software.

  3. Set the Windows Compatibility mode for this setup.exe file. (See Section 4.1.1, "Set the Windows Compatibility Mode for the setup.exe File" for details.)

  4. Execute setup.exe to start the Installer and follow the instructions on screen.

    Note:

    During the installation, the system may display the following error message:

    The procedure entry point GetProcessImageFileNameW could not be located in the dynamic link library PSAPI.DLL.

    You can safely ignore this error message, and click OK to continue.

    Note:

    Do not do any of the configuration steps described in the patch release notes.

4.1.2.3 Restart the Computer

To ensure that all configuration changes for Oracle Application Server 10g Release 2 and Patch Set 3 (10.1.2.3.0) are initialized, you must restart the computer before you continue with the next task in the installation process.

4.1.3 Install Oracle Application Server 10g Release 3 (10.1.3.1.0)

Oracle Application Server 10g Release 3 provides the latest Java environment for an TMS installation.

To install Oracle Application Server 10g Release 3:

  1. Close all running applications on the computer.

  2. Log in to the application server using an account with system administrator privileges.

    Caution:

    You cannot run the setup.exe file for Oracle Application Server 10g Release 3 on Microsoft Windows 2008. Oracle Universal Installer fails on start up because of compatibility issues with the operating system. Note that setting the Compatibility mode for the AS10gR3 setup.exe file does not resolve this known issue.

    To work around this issue, you must start Oracle Universal Installer by running the setup.exe file for Patch Set 5 (10.1.3.5.0) for Oracle Application Server 10g Release 3. Once the Installer starts, you must change the source directory to the location of the Oracle Application Server 10g Release 3 installation files. The steps that follow provide detailed instructions.

  3. Insert the Oracle Clinical 4.6.2 and Oracle Thesaurus Management System 4.6.2 disk.

  4. Copy the following two folders and extract the files, which are Patch Set 5 (10.1.3.5.0) for Oracle Application Server 10g Release 3:

    • V17522-01_1of2.zip

    • V17522-01_2of2.zip

  5. Insert the Oracle SOA Suite 10g (10.1.3.1.0) for Microsoft Windows (32-bit) disk. (This disk is included in the Oracle Clinical and Oracle Thesaurus Management System 4.6.2 Media Pack.)

  6. Navigate to the setup.exe file for the Patch Set 5 software that you previously copied and extracted.

  7. Set the Windows Compatibility mode for this setup.exe file. (See Section 4.1.1, "Set the Windows Compatibility Mode for the setup.exe File" for details.)

  8. Use Windows Explorer or the command line to run the setup.exe file for the Patch Set 5 software.

    The system briefly displays a DOS window while it checks your computer's compatibility, and then opens the Welcome screen.

  9. Follow the instructions on the installation screens. For additional information about each screen, see Section 4.1.3.1, "Attend to the Oracle Application Server 10g Release 3 Installation Screens."

4.1.3.1 Attend to the Oracle Application Server 10g Release 3 Installation Screens

The Oracle Universal Installer guides you through the installation of Oracle Application Server.

Welcome

Click Next to continue the installation.

Specify File Locations

Define where to install Oracle Application Server 10g Release 3. The directory into which you install this instance of Oracle Application Server is called the ORACLE_ AS10gR3_HOME. You specify the full path to this directory.

  • Source Path

    Caution:

    Do not accept the default value. Because you had to start Oracle Universal Installer by running the setup.exe file for Patch Set 5 (10.1.3.5.0) for Oracle Application Server 10g Release 3, the default value specifies the location of the source files for Patch Set 5.

    Instead, click Browse to specify the location of the source files for the Oracle Application Server 10g Release 3 installation. For example, D:\Disk xxxxxx-01\stage\products.xml.

  • Destination Name: Enter the home name of the application tier. For example, AS10gR3.

  • Destination Path: Enter the complete directory path where this instance of Oracle Application Server will be installed. You can change the path to another location, or you can keep the default path. For example: D:\oracle\AS10gR3.

Click Next.

Select a Product to Install

Select Oracle Application Server SOA Suite 10.1.3.1.0.

Click Next.

Select Installation Type Oracle Application Server SOA Suite 10.1.3.1.0

Select J2EE Server and Web Server (586MB), and then click Next.

Selecting this option installs and configures Oracle Container for J2EE (OC4J), including HTTP Server with SSL support, Oracle Enterprise Manager Application Server Control, and Oracle Process Manager and Notification Server (OPMN).

Specify Port Configuration Options

Select Automatic, and then click Next.

Administration Settings

You need to specify the following administration settings for this instance of Oracle Application Server 10g Release 3:

  • Enter a unique name for this instance of Oracle Application Server 10g Release 3 you are installing.

  • Enter and confirm an administrator password for this instance of Oracle Application Server 10g Release 3. Note that the administrator user name is oc4jadmin.

  • Select the Configure this as an Administration OC4J instance check box.

In addition, specify the name of the default OC4J instance that is created by the Oracle Universal Installer.

Click Next.

Cluster Topology Configuration

You can ignore all settings on this screen. TMS does not use cluster topology. Click Next.

Summary Oracle Application Server SOA Suite 10.1.3.1.0

Review the installation details to verify that they are correct. To revisit earlier installation screens and make changes, click Back.

When you are ready to continue, click Install.

Install

The Install screen displays the progress of the installation. Oracle Universal Installer configures this instance of Oracle Application Server 10g Release 3. The configuration process can take several minutes. Do not interrupt the automated configuration.

You can view a log of this installation session at:

\Program Files (x86)\Oracle\Inventory\logs\installActionstimestamp.log

End of Installation

The End of Installation screen reports whether the software installed successfully.

Scroll through and review the information, which includes the command for viewing the status of the server and the URL for accessing the Welcome page of the server.

In addition, you can view all this information in the readme.txt file located at:

\ORACLE_AS10gR3_HOME\install\readme.txt

When you have finished reviewing the installation information, click Exit. At the confirmation prompt, click Yes to exit from Oracle Universal Installer.

4.1.3.2 Apply Oracle Application Server 10g Release 3 Patch Set 5 (10.1.3.5.0)

To apply Patch Set 5 (10.1.3.5.0) to Oracle Application Server 10g Release 3:

  1. Navigate to the location where you already copied and extracted the Patch Set 5 software.

    (Patch Set 5 is the V17522-01_1of2.zip and V17522-01_2of2.zip folders on the Oracle Clinical 4.6.2 and Oracle Thesaurus Management System 4.6.2 disk.)

  2. Locate the setup.exe file for the Patch Set 5 software.

  3. Set the Windows Compatibility mode for this setup.exe file. (See Section 4.1.1, "Set the Windows Compatibility Mode for the setup.exe File" for details.)

  4. Execute setup.exe to start the Installer and follow the instructions on screen.

    Note:

    Do not do any of the configuration steps described in the patch release notes.

4.1.3.3 Configure the Oracle AS10gR3 Process Manager

Go to the Oracle Application Server 10g Release 3 Process Manager.

Change the startup type to Automatic.

4.1.3.4 Restart the Computer

To ensure that all configuration changes for Oracle Application Server 10g Release 3 and Patch Set 5 (10.1.3.5.0) are initialized, you must restart the computer before you continue with the next task in the installation process.

4.2 Setting Up Oracle Application Server 10g Release 3 for SSL

By default, TMS is set up to work with HTTPS, which combines the Hypertext Transfer Protocol with a Secure Sockets Layer (SSL) / Transport Layer Security (TLS) protocol. The SSL/TLS protocol provides encrypted communication, secure identification of a network Web server, and communications security over the Internet.

Therefore, you must ensure that the default URL for Oracle Application Server 10g Release 3 uses HTTPS. For example:

https://server1.company_name.com.

TMS will not run if the security certificate is not configured properly.

4.3 Modifying the Oracle Process Manager Service

To change the login properties of the Oracle AS10gR2 Process Manager Service to use the administrator account:

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

  2. Open the Windows Control Panel.

  3. Double-click Administrative Tools.

  4. Double-click Services.

  5. Select Oracle AS10gR2 Process Manager Service.

  6. Open the Action menu, and then click Properties.

  7. Click the Log On tab.

    1. Set the account to a user with system administrator privileges.

    2. Click OK to save your changes.

  8. Close the Services dialog box.

Repeat the procedure to change the login properties of the Oracle AS10gR3 Process Manager Service to use the administrator account. Be sure to select the Oracle AS10gR3 Process Manager Service.

4.4 Applying Critical Patch Updates

Every quarter, Oracle provides Critical Patch Updates (CPUs) to address security vulnerabilities, and Patch Set Updates (PSUs) to address proactive, critical fixes and security vulnerabilities.

Table 4-1 lists the CPUs that are included on the Oracle Clinical 4.6.2 and Oracle Thesaurus Management System 4.6.2 disk in the media pack. These CPUs are current as of this document release and current with the information in the Oracle Health Sciences Applications Critical Patch Update for January 2011 note on My Oracle Support. Be sure to check My Oracle Support for the latest version of CPUs and PSUs, and then apply the latest patch approved for the Oracle Health Sciences applications.

Before you run the OPatch utility to apply the October 2010 CPUs, set the OPatch compatibility as follows:

set OPATCH_PLATFORM_ID=215

Follow the instructions in the ReadMe file to apply these CPUs.

Table 4-1 Critical Patch Updates Included on the Media Pack

Patch Purpose Apply the Patch To… Zip File

6640838

Oracle Universal Installer CPU

Oracle Application Server 10g Release 2

p6640838_10106_WINNT.zip

10031950

CPU

Oracle Application Server 10g Release 2

p10031950_10123_WINNT.zip

10031963

CPU

Oracle Application Server 10g Release 3

p10031963_101350_WINNT.zip


4.5 Setting Up the SQL*Net Connections for Existing Databases

To establish that SQL*Net connections can be created to connect the application server to all databases:

4.5.1 Test the Connection from the Application Servers to the Database

For the TMS application to work properly, the database must be able to communicate with the application servers.

To ensure that you can connect to the database from each application server:

  1. Open a Microsoft DOS command window.

  2. Test the connection from Oracle Application Server 10g Release 2:

    1. Define the ORACLE_HOME environment variable:

      set ORACLE_HOME=ORACLE_AS10gR2_HOME

      For example:

      set ORACLE_HOME=D:\oracle\as10gr2

    2. Use SQL*Plus to verify that you can connect to the database:

      sqlplus system/password

  3. Test the connection from Oracle Application Server 10g Release 3:

    1. Define the ORACLE_HOME environment variable:

      set ORACLE_HOME=ORACLE_AS10gR3_HOME

      For example:

      set ORACLE_HOME=D:\oracle\as10gr3

    2. Use SQL*Plus to verify that you can connect to the database:

      sqlplus system/password

4.5.2 Troubleshoot Network Connection Issues

If the system returns a connection error, you must resolve this problem before continuing with the installation of TMS.

Possible causes of errors include:

  • The computer is not physically connected to the network.

  • One of the databases does not exist.

  • The network protocol software is not loaded on the computer. Try a remote login to check.

  • The database or SQL*Net listener process is not started on the server.

  • An incorrect connect string, user ID, or password was entered.

  • The tnsnames.ora file is not present in the correct directory or does not contain the correct entries.