added INSTALL file, updated README, dbparams.properties, and web.xml files.

5 files changed, 71 insertions, 14 deletions

diff --git a/.gitignore b/.gitignore
index 4e33556..2f831d2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 *.class
 *.war
 doc/
+dbparams.properties
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..7b6d22a
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,18 @@
+BUILD AND INSTALL:
+
+- download the PetaScope package from www.petascope.org and uncompress
+  the source code.
+- edit the dbparams.properties configuration file (see documentation)
+- compile the servlet:
+  $ cd src; make
+- deploy the war file with Tomcat.
+
+Once installed, see doc/index.html for more information.
+
+
+VERSION COMPATIBILITY STATEMENT:
+
+Petascope compiles successfully with Java 1.6.
+
+
+
diff --git a/README b/README
index 1b588f7..f073c0c 100644
--- a/README
+++ b/README
@@ -1,7 +1,5 @@
 This file is part of PetaScope, a free implementation of the Open GeoSpatial Consortium (OGC, www.opengeospatial.org) Web Coverage Service (WCS) standards suite. As such, it implements the following interface standards:
-- Web Coverage Service (WCS) 1.1.2
 - WCS Processing Extension (WCPS) 1.0.0, which grounds on the Web Coverage Processing Service standard
-- WCS Transaction Extension (WCS-T)
 
 PetaScope is implemented as a Java servlet.
 As such, it relies on several following freely available components which are not part of the PetaScope distribution:
@@ -22,7 +20,7 @@ misc/                Additional scripts, e.g., for
                      initializing the metadata database
 src/                 PetaScope Java source code
 test/                test scripts
-xml/                 WCS schema files used by PetaScope
+xml/                 WC*S schema files used by PetaScope
                      (copies from schemas.opengis.net)
 dbparams.properties  Servlet initialization parameters,
                      such as database connections (*)
diff --git a/dbparams.properties b/dbparams.properties
index 5e92ff4..e28a021 100644
--- a/dbparams.properties
+++ b/dbparams.properties
@@ -1,9 +1,43 @@
-# mango/kahlua
+# ---------------------------------------------------------------------
+# dbparams.properties
+#
+# PetaScope configuration file
+#
+# Important note:
+# Parameters marked "yes" in item "need to adapt" MUST be configured
+# to meaningful values during installation, they CAN NOT be used as is!
+# ---------------------------------------------------------------------
+
+# parameter:     metadata_driver
+# purpose:       name of DBMS driver to be loaded
+# need to adapt: no
 metadata_driver=org.postgresql.Driver
-metadata_url=jdbc:postgresql://localhost:9000/wcpsdb
-metadata_user=rasservice
-metadata_pass=ifhtcc
-#rasdaman_url=http://10.70.11.111:9001
-#rasdaman_database=RASBASE
-rasdaman_url=http://kahlua.eecs.jacobs-university.de:9001
-rasdaman_database=RASSERVICE
+
+# parameter:     metadata_url
+# purpose:       JDBC URL of database serving PetaScope metadata
+# need to adapt: yes
+metadata_url=jdbc:postgresql://HOST:PORT/DBNAME
+
+# parameter:     metadata_user
+# purpose:       DBMS login under which servlet has r/w access
+#                to PetaScope metadata;
+#                recommendation: establish a dedicated user
+# need to adapt: yes
+metadata_user=petascope
+
+# parameter:     metadata_pass
+# purpose:       password for DBMS login, as above
+# need to adapt: yes
+metadata_pass=
+
+# parameter:     rasdaman_url
+# purpose:       URL of rasdaman database serving PetaScope raster data
+# need to adapt: yes
+rasdaman_url=http://HOST:PORT
+
+# parameter:     rasdaman_database
+# purpose:       name of rasdaman database serving PetaScope raster data
+#                recommendation: use rasdaman standard name, RASBASE
+# need to adapt: no
+rasdaman_database=RASBASE
+
diff --git a/web.xml b/web.xml
index 11b91fa..40f211b 100644
--- a/web.xml
+++ b/web.xml
@@ -1,5 +1,11 @@
+/*
+ * web.xml: PetaScope Web deployment file
+ * 
+ * Need to adapt: no.
+ */
+
 <web-app>
-    <display-name>PetaScope Implementation (WCPS, WCS)</display-name>
+    <display-name>PetaScope Implementation</display-name>
     <servlet>
         <servlet-name>wcpsServlet</servlet-name>
         <servlet-class>wcps.server.servlet.WCPSServlet</servlet-class>
@@ -13,7 +19,7 @@
         <url-pattern>/wcps/</url-pattern>
     </servlet-mapping>
     <servlet-mapping>
-    <servlet-name>wcsServlet</servlet-name>
-	<url-pattern>/wcs/</url-pattern>
+		<servlet-name>wcsServlet</servlet-name>
+		<url-pattern>/wcs/</url-pattern>
     </servlet-mapping>
 </web-app>