----------------------------------------------------------
- INSTALLATION INSTRUCTIONS FOR EXTROPIA.COM JAVA WEBCAL -
----------------------------------------------------------


Unzip webcal.zip into any temporary directory.



1. Application

   Copy the unzipped "webcal" folder into your servlet 
   directory. eg. for Tomcat users, "webcal" should be 
   saved as such:

   $TOMCAT_HOME/webapps/webcal/



2. Images and StyleSheet

   Copy the unzipped "Images" folder into your root 
   directory. eg. for Tomcat users, "Images" should be 
   saved as such:

   $TOMCAT_HOME/webapps/ROOT/Images/

   Copy extropia.css into $TOMCAT_HOME/webapps/ROOT
   
   
   
3. Set-up the database.

   We currently support the Java WebCal only with MySQL
   and Oracle databases. 
   
   For MySQL users, use "cal_mysql.sql" to create the 
   appropriate tables for WebCal to run properly. 
   
   Oracle users please use "cal_oracle.sql" 



4. Miscellaneous

-  Open $TOMCAT_HOME/webapps/webcal/WEB-INF/config/webcal.xml
   using any text editor. 
   
   If you are using Oracle Database, uncomment the following section
   (Under WebCal->AuthManager->Authenticator->UserDataource->Datasource 
    and
    webCal->AuthManager->Authenticator->GroupDatasource->Datasource)
    
    <Driver type="oracle.jdbc.driver.OracleDriver"/>
      <Connection>
	jdbc:oracle:thin:@${database ip addr}:${port}:${instance}
	<user>${id}</user>
	<password>${passwd}</password>
     </Connection>
   
   Note : 
   1. The default port for Oracle is usually 1521.  
   2. if you are unsure of your instance name, execute the following query
      "select instance_name from v$instance"       
   
   If you are using mysql database, ensure that you specify the correct url.  
   The format is as follows 
   
   jdbc:mysql://[hostname][:port]/dbname[?user=value1][&password=value2]


-  Depending on your server, you may have to restart
   the server for changes to take effect.

-  The application may be accessed via a similar url
   as shown below:
   
   http://localhost:8080/webcal/servlet/WebCal

   you'll be asked for a username and password. You can 
   use 'name1' as the username and 'password1' for the 
   password for a start.

-  The "source" folder contains the source codes to 
   all the class files used in this application.

-  Due to changes in Tomcat 4.1.x, WebCal doesn't run as it is
   when you install it. You need to go to this file: webcal/WEB-INF/web.xml,
   and uncomment the part for Tomcat 4.1.x (it's there, you just need
   to uncomment it and it will work). WebCal runs fine as it is on 
   top of Tomcat 4.0.x. 

You may obtain support for the Java WebCal, as well
as any other application from eXtropia by joining
the open forum accessible from our website at 
www.eXtropia.com . 

Alternatively, you may email support@eXtropia.com
should you havce any further enquiries.

You are also invited to submit any hacks to 
hacks@eXtropia.com, and stand to win fabulous prizes,
as well as be recognized as the winner of the 
"Cool Hack of The Month" award on our website.


Regards,

The eXtropia Team