OWXv3 v1.0.1 beta - README
--------------------------

This release comes as a Sun Servlet Specification v2.3 compilant "webapp" or 
webapplication. Until we've completed the installation & configuration manual
you can get OWXv3 to run like this:

- install a Apache webserver (i use v1.3.26)              http://www.apache.org
- install a ServletContainer like Tomcat (i use v4.0.4)   http://jakarta.apache.org/tomcat
- install a PostgreSQL Database server (i use v7.2.1)     http://www.postgresql.org

Now you have the basic software running. Please refer to the manuals of the above
software for installation and configuration. 

Now follow these steps:

--------------------------------------------------------------------------------
1) setup a new virtualhost (dns, mail, apache config). The directory structure and
   example configuration of the tar file should give you a clue about this. 
   The shipped configuration is tested and works on my system.

   Test       Try to request the index.html in the wwwroot directory. The url would
              be like: http://owxv3.ravix.raptus.com/. If you see the link for
              calling the public site, you're done with this step.

--------------------------------------------------------------------------------
2) setup a new database user and database in postgres. The shipped example assumes
   a user named "owxv3" with database "dev_owxv3". You need to replace these settings
   with your new created database user, its password and database name. In order to
   do this, the file struts-config.xml must be edited.
   
   ...
    <data-sources>
      <data-source key="owxdbpool"
                  autoCommit="true"
                  description="OWX Data Source Configuration"
                  driverClass="org.postgresql.Driver"
                  maxCount="10"
                  minCount="5"
                  password="owxv3"
                  user="owxv3"
                  url="jdbc:postgresql://localhost:5432/dev_owxv3"/>
    </data-sources>
   ...

   The "key" parameter connects this datasource with the corresponding vmodule. The
   other parameters should be quite clear. The things you need to change are:
   
   user=""
   password=""
   url="jdbc:postgresql://HOSTNAMEHERE:5432/DATABASENAMEHERE"

   Please refer to the struts configuration instructions for further details about
   the datasource configuration. http://jakarta.apache.org/struts

   Test       You can only test this step, when booting OWXv3 together with tomcat. 
              Then you need to look into tc_system.log and owxv3.log in order to 
              resolve connection problems.

--------------------------------------------------------------------------------
3) assuming you use tomcat4, install it and look at the shipped example start/stop
   script. You need to adopt this to your needs. Note that there are 2 different
   ways to do virtualhosting with tomcat:
   
   variant 1) setup one tomcat instance/process that serves multiple virtualhosts

   variant 2) setup one tomcat instance/process for EVERY virtualhost. Therfore you
              will need some helper scripts to not get ports confused.

   The shipped installation is a webapplication, so you can set this up either way. But
   the configuration examples assume the 2nd variant (1 tomcat per virtualhost).
   
   There is an example of a proxy connection between apache and tomcat and there is one
   of the webapp connection between them. Have a look at the conf directory.
  
   Test       When you request a tomcat url. If you use proxy connection you could try
              something like this: http://owxv3.ravix.raptus.com:8003/ and tomcat should
              display an error or some default content. Then you leave away the port and
              try to request that same result trough apache.

--------------------------------------------------------------------------------
4) Webapplication specific installation can be found in webapps/owxv3/WEB-INF/. You need
   to edit "struts-config.xml" for step 2 and for step 4 you need to adopt
   "web.xml" in order to tell OWX where to put its logfile. And last but not least
   you need to adopt owx-config.xml. Inside that file you need to change:

   <virtualhost hostname="owxv3.ravix.raptus.com" 
                identification="owxv3" 
                mailhost="localhost" 
                multiuser="true" 
                webmaster="webmaster">
   ...

   Set the hostname="" and "mailhost="" parameter. And inside the filemanager the
   upload directory:
   
   ...
    <vmodule name="filemgr" type="standard">
    ...
       <property name="repository" value="/workbench/virtualhosts/owxv3.ravix.raptus.com/cstData/owxv3"/>
       ...
       
   Note that the user that tomcat run as need to have write permission in that
   "repository".

   Test       When you started tomcat4 and configured everything correctly, both
              logfiles should not containy any exceptions (of course) and in owxv3.log
              you should find: 
              
              "com.raptus.owxv3.OmniaWebActionServlet:NORMAL:Virtualhost is now ready for requests"

--------------------------------------------------------------------------------
5) Now you're done and can access the site, log into eAdmin/OWX and start to
   enter content of the website. Good luck.
   
   

################################################################################
Copyright (C) 2002 OWX opensource project team
################################################################################