Installation and Setup of Infrastructure Components

Note:  If you have Windows User Access Control turned on, you may need to disable it in order to complete the installation properly.

...

NOTE: we have created a common, publicly accessible Apelon DTS instance for maintaining a central set of concepts for use by the OpenCDS community.  Software to access this is included in the OpenCDS source distribution.

Install Java SE SDK version 6

1. Download appropriate 32-bit or 64-bit Java SE SK from http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. Run executable, install using default options
   • You can use a non-default installation directory if desired
3. Control Panel → System → Advanced → Environment Variables → System Variables
   
   1. Set JAVA_HOME to Java SE SDK location
      
      1. e.g., C:\Program Files\Java\jdk1.6.0_26
   2. Add %JAVA_HOME%\bin to path
      1. In this example, was added to beginning of path

Install Tomcat

1. Download latest Tomcat using “32-bit/64-bit Windows Service Installer” from relevant download page at http://tomcat.apache.org

   1. OpenCDS has been tested using both Apache Tomcat versions 6 and 7, and it can be built to run on either, but the public download is built for Tomcat version 6.

      1. Note:  OpenCDS will not deploy on JBoss without making some changes to the included librari
   2. Accept defaults

   3. Installation directory may be changed if desired

   4. Set Tomcat Administrator Login to something secure

      1. You may even prefer to remove the administrator login if you have physical access to the server.

2. Control Panel → System → Advanced → Environment Variables → System Variables

   1. Set CATALINA_HOME to, e.g., “C:\Program Files\Apache Software Foundation\Tomcat 6.0”

   2. Add %CATALINA_HOME%\bin to Path

      1. In this example, was added to beginning of Path

Install OpenCDS Sample Knowledge Repository

1. Download opencds-knowledge-repository-data.zip from the OpenCDS website | Members | Binary Downloads | at http://develop.opencds.org/OpenCDSDemo/latest/opencds-knowledge-repository-data.zip
2. Unzip it to a location on the same machine where you will be running Tomcat.
   1. NOTE: you won't have to change any configuration settings if you unzip it into "C:/OpenCDS".
   2. NOTE: There is a configuration file named "opencds-decision-support-service-config.xml" that you will need to update if you have located the sample KR somewhere other than "C:/OpenCDS".
      1. This file is found inside the exploded war file at <servletContainerPath>/opencds-decision-support-service/WEB-INF/classes
      2. it specifies a default path of "C:/OpenCDS/opencds-knowledge-repository-data/resources_v1.1"

Install OpenCDS RunTime WAR file

1. Download latest OpenCDS RunTime war file from the OpenCDS website | Members | Binary Downloads | OpenCDS11
   1. http://www.opencds.org/Members/BinaryDownloads/OpenCDS11.aspx
2. Rename the file to “opencds-decision-support-service.war”
   1. (this step is not absolutely necessary, but will make your runtime match other instructions in our documentation, and so it is probably a good idea unless you know what you are doing).
3. Stop Tomcat
4. Copy the opencds-decision-support-service.war file into the %CATALINA_HOME%\webapps folder
5. Restart Tomcat

Test the Installation

1. Open a web browser on the same machine that you installed Tomcat on, and go to
   1. http://localhost:8080/opencds-decision-support-service/evaluate?wsdl
   2. The browser should display the WSDL.
   3. If it is installed on a different machine, or you changed the default port to something different than 8080, make the appropriate changes to the URL above.
2. To interact with the DSS, a convenient program to use for testing and demo is the oXygen XML editor (http://www.oxygenxml.com).  We use the Academic/Non-Commercial version, and a free trial license is available at http://www.oxygenxml.com/register.html.
3. Other tools are available, and some are open-source, such as SoapUI at http://www.soapui.org , or the Firefox addon at https://addons.mozilla.org/en-US/firefox/addon/soa-client, for those of you who want to experiment.
4. You can also use the open-source MirthConnect software to test rules, as well as in a production environment, because it includes support for web services.  The software can be found at http://www.mirthcorp.com/products/mirth-connect.  We have some sample channels available in the Demo folder.
5. If you are using oXygen, go to Tools → WSDL SOAP Analyzer → Saved SOAP request, and use the sample .wssc files available from the OpenCDS website | Members | Binary Downloads | OpenCDS11.  Hitting the "Send" button will interact with the DSS.  Note that a base64 converter for reading base64 payloads is available at http://ostermiller.org/calc/encode.html or http://www.opinionatedgeek.com/DotNet/Tools/Base64Encode/default.aspx

Document Version History

(Duplicated/reversed from original document.  Document above has minor edits from the original version.)

...