Metacat

   These installation instructions are meant for a systems administrator/DBA

   or someone who is an advanced computer user.  They are NOT meant for

   the average computer user.  Please realize that by executing these

   instructions, you may have to trouble shoot many advanced issues yourself.

         compliant RDBMS like Postgres)</li>

       <p class="emphasis">Note: For a more robust web serving environment, 

       Apache web server should

   should be installed on the system and the "ant" executable shell script 

    you install Tomcat itself will be referred to as the "$TOMCAT_HOME".

    This install assumes Tomcat version 3.1.  The Tomcat 

    configuration will be slightly different depending on what version of 

    Tomcat you are running.

    You must now set up your servlet context.  Change to the $TOMCAT_HOME/conf.

    Edit the tomcat.conf file.  Find a line that looks like:

   may pick whatever servlet name you wish. Also note that the path to the

   servlet context will depend on where you install the tomcat webapps 

   directory.</div>

   xmltodb directory and edit the file called "build.xml".  You will need 

   to change a number of configuration properties to match the setup on

   your system.  If you are using oracle, you'll need to customize the

   properties in the "oracle" target.  If you are using Postgres, you'll

   need to customize the properties inthe "postgres" target.  All users

   will need to customize the properties in the "config" target.

   The properties that you need to change will include jdbc-connect, 

   dbDriver, dbAdapter, oracle_home, jdbc, tomcat, webapps, context,

   user, password, server, web-base-url, and default-style.

   Each is described in detail below. You should also verify that the 

   jar file properties mentioned in the remainder of the config target are

   accessible at the paths listed -- the defaults will usually work.

  Properties you will likely need to change:<br />

   The dbAdapter parameter is the name of the Metacat adapter class to be used

   to communicate with a particular database.

   If you are not using Oracle, you will need to change this.  There are 

   currently adapters for Oracle, Postgres, and MS SQL Server.

   The oracle_home parameter is the location that oracle is installed on 

   your system.

  </li>

  <li>

   The jdbc parameter is the location of your jdbc driver jar file.

  </li>

  <li>

   The tomcat parameter is the location in which tomcat is installed.

  </li>

  <li>

   The webapps parameter is the location in which your tomcat servlet

   contexts are installed.  This is typically "$TOMCAT_HOME/webapps".

  </li>

  <li>

   The context parameter is the name of the servlet context in which

   you want metacat to be installed.  This will determine the installation

   directory for the servlet and many of the urls that are used to

   access the installed Metacat server.

  </li>

  <li>

   The server is the http address on which Metacat is running.

  </li>

  <li>

   The user and password parmaters are the database user name that you set up

   to use Metacat, for example an Oracle username and password.

  </li>

  <li>

   The default-style parameter defines the "style-set" that is to be used

   by default when the qformat parameter is missing or set to "html" during

   a query.  It is set to "knb", which is the only style that ships with the

   default metacat distribution.  If you create your own stylesheets for

   displaying metacat output, you may want to create a new config file in the

   config-dir (e.g., mystyle.xml) and then change the default-style to use

   your custom style (e.g., "mystyle").

  </li>

  </ul>

  Other properties that you can but generaly need not change:<br />

  <ul>

  <li>

   The installdir

   parameter is the directory that you want Ant to install the servlet to.

   It is your "servlet context path" that was defined above.

  </li>

  <li>

   At the SQLPlus prompt type the following: <pre>@src/xmltables.sql;</pre>

   that file to $TOMCAT_HOME/lib/protocol.jar.  In our case: 

   and installation.  When it is done you should see the message 

   BUILD SUCCESSFUL

   the message BUILD SUCCESSFUL then there was an error that you need to 

   resolve.

   file, or if any of the paths to files are not configured correctly in the

   "config" target.

   this, login as the user that runs your tomcat server (ofter "tomcat"),

   go to $TOMCAT_HOME/bin and type:

   <pre>http://yourserver.yourdomain.com/yourcontext/</pre>

   You should substitute your context name for "yourcontext" in the url above.

   <pre>http://yourserver.yourdomain.com:8080/yourcontext/</pre>