Requirements

• A computer running Unix or Linux. Dapper has been tested on Fedora Core 4 and Red Hat Enterprise 3.
• The MySQL relational database (version 4.1.x or 5.x). MySQL is only needed if you want to serve in-situ data.
• The Java runtime enviroment or SDK (at least version 1.6.0).
• Any data installed with pre-0.9.0 versions of Dapper must be reinstalled because of changes to the database schema.
• If you installed a version of Dapper before 1.0, you will need to change the etc/dapper.properties configuration file. The etc/cdp.properties file is no longer used. Info on the new configuration file format is here.

Installation

• Get the latest version of Dapper
• Untar the dapper distribution:
  
  

  tar zxf latest.tar.gz

  
  You need to use GNU tar for this to work. Standard tar on Solaris will not work.
  
• Change to the directory created by untarring the distribution
• If you have an older version of Dapper, copy all of the files from <dapper.old>/resources to the resources directory.
• Load in-situ data into the database (see loading data for more details). If you want to load some sample data:

  cd examples/argo
  ../../dapperload.sh -u <dbuser> -p <dbpass> \
     create dapperexample argo_sample
  ../../dapperload.sh -l example.ptr -u <dbuser> -p <dbpass> \
     load dapperexample argo_sample
  cd ../..

  where <dbuser> is the database user name and <dbpass> is the database password. You need to have create, index, insert, select, and update privileges for this to work.
• Configure the Dapper servlet by creating the file etc/dapper.properties. A sample file illustrating which properties are configurable is available in etc/dapper.properties.sample. For the sample data add the following:

  dapper.cdp_databases=dapperexample
  dapper.user = <dbuser>
  dapper.password = <dbpass>
  

• Configure the DChart servlet by copying the file dchart/etc/config.xml.sample to dchart/etc/config.xml.
• Start the server:

  ./dapper.sh start

• Verify that the Dapper servlet is running by pointing your browser to:

  http://localhost:8080/dods

  You can access the DChart plotting and downloading interface by pointing your browser to:

  http://localhost:8080/dchart

  If you have the OPeNDAP geturl program installed, you can dump data from the server by typing:

  geturl -D http://localhost:8080/dods/dapperexample/argo_sample.cdp

If it doesn't work...

• Check the log files in jakarta/logs/ for error messages