Defining JNDI Properties

How to:

This section describes how to define JNDI properties in Apache Tomcat for Windows platforms.

Procedure: How to Define JNDI Properties

  1. Edit the context.xml file, which is located in the <TOMCAT_HOME>/conf directory, and add the following XML:
    <Environment override="true" type="java.lang.String" value="C:/OPMC_HOME/" name="Omni.Home"/>

    In the value= section, specify the location of the OPMC_HOME folder, including drive name. It is strongly recommended that you use C:/OPMC_HOME.

  2. If this is a new installation of Omni-Patient Management Central (OPMC), then extract the opmc_home_mm_dd.zip file into the root of your OPMC drive (for example, into C:\).

    This will create a folder named OPMC_HOME with a tree of sub-folders and files.

    Skip to Step 5.

  3. If this is an update of an existing OPMC instance, then create the following folder:
    C:\opmc_home_mm_dd

    where:

    mm_dd

    Is the month and date of the OPMC release.

  4. Use WinZip or WinRar to extract the opmc_home_mm_dd.zip file into the folder created in step 3 (C:\opmc_home_mm_dd).
  5. Edit the remediation.properties file.
    1. If this is a new installation, then navigate to the drive:\OPMC_HOME\Workflow\omni_home\properties folder and open the remediation.properties with a text editor.
    2. If this is an update to an existing OPMC/OPMC_HOME instance, then compare the new remediation.properties file in the C:\omni_home_ mm_dd\OPMC_HOME\Workflow\omni_home\properties folder with the existing remediation.properties file in the C: \OPMC_HOME\Workflow\omni_home\properties folder.

      Note: New OPMC releases will contain a list of any changes (additions) that you must make to your existing remediation.properties file, and/or any new files or folders that must be copied from omni_home_mm_dd.

    3. Edit the proper values for your system.

      Normally, you will leave most properties as they are set in the released file. However, closely examine and provide your site-specific values for certain properties, especially:

      • Line 4, the port value.

        This is the port number on your system where the Remediation Server listens for input data and instructions from the Omni-Patient system.

      • Line 23, the SMTP URL.

        This is the URL for the SMTP system that the Remediation Server will use to send notification e-mails as specified.

      • Line 38+, WSO2 Identity Server information.

        This is the URL user name and password for the WSO2 Identity Server (WSO2 IS), which interfaces with your Active Directory through LDAP, and provides user authentication and role-based user authorizations for OPMC.

      • Line 54+, TFS Access information.

        The URL and other values that must be defined to provide (optional) connection to your Team Foundation Server.

      Notice that there are two general .scxml files in the OPMC_HOME tree. The general_tsf.scxml is for HFHS.