Copyright (c) 1999-2001 The dbXML Group, L.L.C.
All rights reserved.

See docs/LICENSE for The dbXML License

Before you can run or build dbXML on windows you need to obtain the following
programs and install them.

   - A copy of Sun's Java SDK version 1.3 or higher.

Running the server - dbXML Core Version 1.0 Windows

1. Unzip/Checkout the dbXML source to c:\dbXML-Core , c:\work\dbXML-Core, or an
   alternative location.

2. Make sure the jdk bin directory is in your PATH

3. Add the dbXML bin directory to your path. If you checked out to
   c:\dbXML-Core this will be c:\dbXML-Core\bin

4. Set the JAVA_HOME environment variable to point to the location where the jdk 
   was installed.

5. Set the DBXML_HOME environment variable to point to the location where dbXML 
   is installed.

6. Add the dbXML.jar file to your CLASSPATH 
   (Either c:\dbXML-Core\java\lib\dbXML.jar or 
   c:\work\dbXML-Core\java\lib\dbXML.jar)
   and make sure you have . in your CLASSPATH.

7. To start the server, cd to the base of the dbXML tree c:\dbXML-Core if that 
   is where you installed it and run.

   Type:
      startup

8. If all went well you should now have a running copy of dbXML Core. If you 
    encountered any problems double check all the steps especially the setting 
    of the environment variables.

9. Build the examples. (optional)

   Type      
      cd %DBXML_HOME%
      ant examples

   The examples are located under dbXML-Core/java/examples and each example 
   directory has a README file that explains how to run it.

10.  Run the API example (optional)

   Type
     cd %DBXML_HOME\java\examples\api
     run org.dbxml.examples.APIExample

10. The server and documentation can be accessed using a web browser pointed to 
    http://localhost:4080/


Compiling the server - dbXML Core Version 1.0 Windows   

1. Unzip/Checkout the dbXML source to c:\dbXML-Core , c:\work\dbXML-Core, or an
s   alternative location.

2. Make sure the jdk bin directory is in your PATH

3. Add the dbXML bin directory to your path. If you checked out to
   c:\dbXML-Core this will be c:\dbXML-Core\bin

4. Set the JAVA_HOME environment variable to point to the location where
   the jdk was installed.

5. Set the DBXML_HOME environment variable to pont to the location where dbXML 
   is installed.

6. If you're planning to build the examples you should go ahead and add the
   dbXML.jar file to your CLASSPATH. This file doesn't exist yet but it will
   once you build the server. If you checked out to c:\dbXML-Core the file
   will be placed in c:\dbXML-Core\java\lib\dbXML.jar. You should also make
   sure you have . in your CLASSPATH.

7. From a command prompt change directory to the base of the dbXML source tree
   then to the java directory.

   Type:
      cd %DBXML_HOME%

8. Type "ant" without the quotes. If all is correct the server should build
   without error.  If you wish to have the API documentation available from
   the server then type "ant javadoc"

9. You should now have a compiled server. To start the server you should cd to
   the base of the dbXML tree c:\dbXML-Core if that is where you checked it
   out and run.

   Type:
      startup

10. If all went well you should now have a running copy of dbXML Core. If you
   encountered any problems double check all the steps especially the setting
   of the environment variables. The server can be accessed using a web browser
   pointed to http://localhost:4080/

11. Build the examples. (optional)

   Type
      cd %DBXML_HOME%
      ant examples

   Each example directory has a README file that explains how to run it.

12.  Run the API example (optional)

   Type
     cd %DBXML_HOME%\java\examples\api
     run org.dbxml.examples.APIExample

13. The server and documentation can be accessed using a web browser pointed to 
    http://localhost:4080/

Note to developers: This process is a little too complicated and not very
flexible. Most of our development work is done on Linux so we would really
love for someone a little more savy with batch scripting to simplify this
process and remove things like the checkout path restriction.

