Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 from original document.  Document above has minor edits from the original version.)

 

o  
8/28/2011
§  Created
by Kensaku Kawamoto based on configuration instructions for OpenCDS alpha
release
§  Changes
include:
·     
Use of Drools and Guvnor 5.2 instead of 5.1.1
·     
More information on 64-bit OS configuration
·     
Use of newest releases of software components
o  
11/8/2011
§  Updated
by Kensaku Kawamoto, with verification on 32-bit and 64-bit Windows OSs 
§  Use
of Drools 5.3.0 instead of 5.2.0
o  
11/9/2011
§  Updated
by Kensaku Kawamoto to include use of SilkSVN for 32-bit OSs as well
o  
11/10/2011
§  Updated
by Kensaku Kawamoto to note need to use latest Tortoise SVN version 
o  
11/16/2011
§  Updated
by Kensaku Kawamoto to include preliminary Guvnor/Designer installation instructions
and to make additional note regarding Tortoise SVN
o  
11/29/2011
§  Updated
by David Shields to include solution to failed installation of JBoss
Application Server in a path including “Program Files (x86)”.
o  
12/16/2011
§  Updated
by David Shields to include alternate installation paths, 2.0  version of JBoss Designer, alternate ports
for JBoss, and availability of OpenCDS 1.0 binaries.
o  
12/17/2011
§  Updated
by David Shields to include information on extended default timeout for JBoss
AS 7.0.2
o  
11/14/2012
§  Major
update by David Shields to reflect latest versions of all components, including
Drools 5.4, JBPM Designer 5.3, and JBoss 7.1.x 
o  
1/11/2013
§  Updated
to reflect Drools 5.5, Designer 5.4
o  
5/21/2013
§  Removed
developer setup, and Guvnor setup instructions to create new RunTime
Installation Guide