Basic Software

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 an Apache webserver (we use v1.3.28) www.apache.org
- install a ServletContainer like Tomcat (i use v4.1.27) jakarta.apache.org/tomcat
- install a PostgreSQL Database server (i use v7.3.4) www.postgresql.org
Please refer to the manuals of the above software for installation and configuration.

The basic software is now running.

Step by Step

--------------------------------------------------------------------------------
1) Set up a new virtualhost (DNS, mail, Apache config).
The directory structure and example configuration of the tar file should give you a clue. The shipped configuration is tested and works on my system.
Test: Try to request index.html of the wwwroot directory. The URL should be like: http://owxv3.ravix.raptus.com/.
If you see the link for calling the public site, you're done with this step.

--------------------------------------------------------------------------------
2) Set up a new database and database user in postgres. The shipped example assumes a user named "owxv3" with the 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.

Content of the file struts-config.xml
...
<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. 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 adapt this to your needs. Note that there are 2 different ways to do virtualhosting with tomcat:

First: set up one tomcat instance/process that serves multiple virtualhosts
Second: set up one tomcat instance/process for EVERY single 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 second 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.

Now refer to the configuration section.

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