Upgrade the TMS Front End

For TMS 5.4.1, the Front End upgrade is supported from releases 5.2.2, 5.2.3, 5.2.4, 5.3.0, 5.3.1, and 5.4.0.

When upgrading TMS Front End from release 5.2.2, 5.2.3, or 5.3, upgrade of the application tier technology stack from version 12.2.1.3 to 12.2.1.4. For information, see Upgrade and Configure the Application Tier Technology Stack.

When upgrading TMS Front End from release 5.2.2, 5.2.3, 5.2.4, 5.3, 5.3.1, or 5.4.0, the application tier technology stack version is already 12.2.1.4.

For TMS 5.4.1 Front End upgrade, OPADomain node manager, admin server, and managed server must be running. For FRDomain report server instance, ohs1, WLS_FORMS, and WLS_REPORTS must be stopped. The node manager and admin server can be in running state.

If Oracle Clinical Front End 5.4.1 is already installed on the application server, follow the instructions below to install TMS 5.4.1 Front End. In this case, the upgrade option for TMS Front End will be used.

For more information, see:

Gather Required Information to Upgrade TMS Front End

Have the following information ready to enter in the Installer screens:

  • Home Details: Enter the following:

    • Name: OPA_HOME

    • Path: c:\opa_home

    Note:

    If TMS 5.2.x, 5.3.x, or 5.4.0 or Oracle Clinical 5.2.x/5.4.1 has already been installed on this application server, OPA_HOME may already be set to C:\opapps52 or similar path and you must use this for TMS 5.4.1 too. Do not create a new OPA_HOME if this was already created. The TMS 5.4.1 components will be placed by the installer under this OPA_HOME at the specified location for the TMS 5.4.1 release.

  • Java Home is the location where JDK 1.8.0_391 or higher was installed

  • Oracle Fusion Middleware home directory:

    • If the technology stack has been upgraded from version 12.2.1.3 to 12.2.1.4, use the new 12.2.1.4 Oracle Home (post upgrade one). The upgrade to 12.2.1.4 is an out-of-place upgrade and a new oracle_home is created; for example, C:\Oracle12214\Middleware\Oracle_Home.

    • If the technology stack was fresh installed at version 12.2.1.4, for example if TMS 5.3.1/5.4.0 or OC 5.2.2/5.4.1 Front End is already installed, use the Oracle Home you had at the time of technology stack installation; for example, C:\Oracle\Middleware\Oracle_Home.

  • Oracle Fusion Middleware User Project directory:

    • If the technology stack has been upgraded from version 12.2.1.3 to 12.2.1.4, use the initial 12.2.1.3 Oracle Home (pre upgrade one) to select the user projects directory. The upgrade to 12.2.1.4 is an out-of-place upgrade and the domains reside in the 12.2.1.3 oracle home; for example, C:\Oracle\Middleware\Oracle_Home\user_projects.

    • If the technology stack was fresh installed at version 12.2.1.4, for example if TMS 5.3.1/5.4.0 or OC 5.2.2/5.4.1 Front End was already installed, use the Oracle Home you had at the time of technology stack installation; for example, C:\Oracle\Middleware\Oracle_Home\user_projects.

  • OPA home directory: By default, it is c:\opa_home.

  • OPADomain Administration Server configuration details:

    • Listen address

    • OPADomain Listen port number

    • OPADomain SSL listen port number

    • OPADomain WebLogic username

    • OPADomain WebLogic password

  • OPADomain Node Manager configuration details:

    • Listen address

    • OPA Domain NodeManager Listen port number

    • WebLogic username

    • WebLogic Server password

  • Database details (database used for data source created under OPADomain):

    • Server.Domain: for example, servername.your_company.com

    • Port number

    • Database service name

    • TMS Proxy Password (tmsproxy)—the password you created when installing Oracle Thesaurus Management System database objects.

  • Managed Server configuration details:

    • Number of Managed Servers

    • Listen port start index

  • Online help URL: If you have customized the online help, the URL where the customized online help is located.

Start the Installer

To install the TMS Front End:

  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 Download the Software).
  3. Run the following file as an administrator:

    Disk1\install\setup.exe

    The Installer opens to the Welcome screen.

    Note:

    See 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.

Attend to the TMS Front End Installer Screens

The Oracle Universal Installer guides you through the installation and configuration of the TMS Front End.

  1. Select a Product to install: Oracle Thesaurus Management System Front End 5.4.1.0.x.
  2. Home Details: From the Directory drop-down, select the OPA Home that corresponds to the Oracle Thesaurus Management System home (for example, c:\opa_home). When you select the directory, the value in the Home drop-down changes automatically.
  3. Available Product Components: Select Oracle Thesaurus Management System Front End 5.4.1.0.x– Install status – Upgrade.

    Note:

    Although the Installer gives you the option install the TMS Server (database server code) at the same time, do not select this option. You must install the TMS Server first, then the database objects, and then the Front End.

  4. Choose Install Type: Select No.
  5. Follow the instructions on the installation screens, providing the information you assembled in Gather Required Information to Upgrade TMS Front End.
  6. Summary: The Summary screen provides information about the global settings, languages, space requirements, and products for this installation.

    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.

  7. Install: The Installer copies the files onto the server, completes the setup and configuration tasks, and generates a log file of this installation.

    In addition, the Install screen displays the location of the log file that records the results of the installation activities for this session. Make a note of this information so you can view the log file after the installation.

  8. End of Installation: The End of Installation screen reports whether the installation was successful.

    The Installer saves the URL information in the following file:

    %OPA_HOME%\log\setup.txt

    When you have finished reviewing the installation information, click Exit.

Find the Installation Log Files

During the installation of an Oracle Health Sciences component, the Oracle Universal Installer generates the following log file:

installActionstimestamp.log

On a Windows installation, the log files are located at:

\Oracle\Inventory\logs

For example:

C:\Program Files\Oracle\Inventory\logs

All generated log files have a timestamp appended to the name. For example:

installActions2013-04-30_11-22-52AM.log

If you encounter any error, contact Health Sciences Support.

Set Remote Method Invocation (RMI) JDBC Security to Secure

  1. Log in to the OPADomain WebLogic Server.
  2. Go to Summary of Servers, select Managed Server of OPADomain, select General, and click Advanced.
  3. Change the RMI JDBC Security setting to Secure.
  4. Click Save.
  5. Click Activate Changes.