OSCAR: Configure Your Server

If your OSCAR OSP vendor has Ocean pre-configured, you can skip this step.

If your OSP vendor does not have Ocean pre-configured or you are using a locally-hosted instance OSCAR instance, you will need to ask your OSP vendor or your IT person to change your server-site configuration to enable Ocean.

If you use an OSP If you have a locally hosted OSCAR instance

Check with your OSCAR OSP vendor to find out if they have Ocean pre-configured. If they do, you can skip this step.

If you are a client of Trimara or OSCAR Service, you can skip this step since Ocean support is preconfigured.

Note that Indivica does NOT support Ocean.

If your OSP vendor does not have Ocean pre-configured, ask them to complete the following steps for you.

Changing the Server-Site Configuration to Enable Ocean

  1. Navigate to your OSCAR web app installation’s custom JavaScript directory (e.g. cd /var/lib/tomcat6/webapps/js/custom)
  2. Create a directory for your custom Ocean integration JavaScript (e.g. Ocean).
  3. Copy your default cme.js (or your existing customized cme.js file) file to this new directory. See your Oscar properties file cme_js property to determine if it has been customized. If there is no cme_js property in the file, then default is being used.

    e.g. cp /var/lib/tomcat6/webapps/js/custom/default/cme.js /var/lib/tomcat6/webapps/js/custom/Ocean

    If the properties file already contains a cme_js property, then the custom JavaScript files will need to be integrated. Please contact CognisantMD support for assistance.

  4. Edit the Ocean/cme.js and add the following to the jQuery(document).ready function callback:

    jQuery.ajax({ url: "../eform/displayImage.do?imagefile=oceanToolbar.js", cache: true, dataType: "script" });init();

    This code must replace the init(); call at the end of the callback function. The init() call will be made once the Ocean Ajax call has completed.

    Note: This custom JavaScript directory will need to be preserved during OSCAR upgrades, so it should be backed up.

  5. Edit your Oscar properties file (e.g. /usr/share/tomcat6/Oscar12_1.properties) and add a line for the cme_js property:


    The value “Ocean” MUST match the custom JavaScript directory created above

Have more questions? Submit a request