This document should help you get started configuring the DAP2 Test Server (DTS).
Here you will find:
The DTS is implemented as a Java Servlet and utilizes the Java Servlet API to allow it to act as a "plug-in" to Java Servlet "containers" such as the Tomcat server.
The DTS is primarily used to test the java implementation of the DAP2 protocol.
It can also be used to test DAP2 client libraries by having them read from the DTS.
This servlet will take any DDS it finds in it's DDScache (see below) and populate it with
invented data per client request. This allows the testing of unusual DDS structures.
The DTS was developed, compiled, and tested using the javac 1.4.1 compiler, the 1.4.1 Java Virtual Machine, and Jakarta Tomcat 5.5.20 (which also provided the Java Servlet API (javax.servlet) packages).
CATALINA_HOME
to the location of your Tomcat instance.CATALINA_HOME
to point to
the top level of your Tomcat installation.dts.war
file from the distribution bundle and place it in $CATALINA_HOME/webapps
directory.The DTS gets its configuration from the servlet's web.xml file. The default location of the web.xml file is (at least in Tomcat 4.1) in $CATALINA_HOME/webapps/opendap/WEB-INF/web.xml If the servlet context changes then things get renamed accordingly. The servlet context is represented by the basename of the directory $CATALINA_HOME/webapps/opendap, thus by default the servlet context is "opendap"
Servlet classname: opendap.servers.test.dtsInside the web.xml file, the DTS uses a number of <init-param> elements inside of it's <servlet> element to get specific configuration information.
<init-param>'s common to all OPeNDAP servlets are:
<init-param> <param-name>DebugOn</param-name> <param-value>showRequest showResponse</param-value> </init-param>Default: If this parameter is not set, or the value field is empty then debugging instrumentation is not turned on.
<init-param> <param-name>DDXcache</param-name> <param-value>/usr/OPeNDAP/sdds-testsuite/ddx/</param-value> </init-param>Default: If this parameter is not set (does not appear in as an <init-param>) then it is set to $TOMCATHOME/webapps/opendap/datasets/servlet-name/ddx (where servlet-nameis the same as the name specified in the <servlet-name> element of the servlet configuration) .
<init-param> <param-name>DDScache</param-name> <param-value>/usr/OPeNDAP/sdds-testsuite/dds/</param-value> </init-param>Default: If this parameter is not set (does not appear in as an <init-param>) then it is set to $TOMCATHOME/webapps/opendap/datasets/servlet-name/dds (where servlet-name is the same as the name specified in the <servlet-name> element of the servlet configuration)
<init-param> <param-name>DAScache</param-name> <param-value>/usr/OPeNDAP/sdds-testsuite/das/</param-value> </init-param>Default: If this parameter is not set (does not appear in as an <init-param>) then it is set to $TOMCATHOME/webapps/opendap/datasets/servlet-name/das (where servlet-name is the same as the name specified in the <servlet-name> element of the servlet configuration) .
<init-param> <param-name>INFOcache</param-name> <param-value>/usr/OPeNDAP/sdds-testsuite/info/</param-value> </init-param>Default: If this parameter is not set (does not appear in as an <init-param>) then it is set to $TOMCATHOME/webapps/opendap/datasets/servlet-name/info (where servlet-name is the same as the name specified in the <servlet-name> element of the servlet configuration)
<init-param> <param-name>SchemaLocation</param-name> <param-value> http://dods.coas.oregonstate.edu:8080/opendap/opendap.xsd</param-value> </init-param>Default: If this parameter is not set (does not appear in as an <init-param>) then the SchemaLocation is set to http://hostname/opendap/opendap.xsd where hostname is the hostname and socket of the servlet engine. For example, if my hostname is opendap.org and my servlet engine is running on port 8080 the my default SchemaLocation is:
<init-param> <param-name>SequenceLength</param-name> <param-value>100</param-value> </init-param>Default: Is set to 5 if this parameter is not set (As in does not appear as an <init-param> in the servlet section of the web.xml file).
In this example SequenceLength gets set to 100.
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd"> <web-app> <servlet> <servlet-name>dts</servlet-name> <servlet-class>opendap.servers.test.dts</servlet-class> <init-param> <param-name>DebugOn</param-name> <param-value>showRequest CE CEEvaluator</param-value> </init-param> <init-param> <param-name>SequenceLength</param-name> <param-value>100</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dts</servlet-name> <url-pattern>/dts</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>dts</servlet-name> <url-pattern>/dts/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>dts</servlet-name> <url-pattern>*</url-pattern> </servlet-mapping> </web-app>
$CATALINA_HOME/bin/startup.sh &
$CATALINA_HOME/bin/shutdown.sh &
We hope we hope you find this software useful, and we welcome your questions and comments.
To Contact Us:
Technical Support: support@opendap.org