Readme file for the (very) alpha version of T&P automation software
---------------------------------------------------------------------

This software aims to automate T&P processes in IITB. Please refer to
the SRS for full details on the scope and design of it. This file is
just to tell you how to make use of the software. (In fact, do read
the SRS _before_ reading this)
---------------------------------------------------------------------

Distribution: This is how the tar file will be prepared!

Directory Str ----> Student/<kaushy, expand>
	       |
	       |--> TandP/<garg, expand>
	       |
	       |--> General/(DatabaseConnection, Mailer,MainDaemon).java
			    (cr_tabs, drop_tabs, cr_cons).sql	 


The package is divided functionally into following parts: 

1) Student interface Server (stored in .../Student/*) - kaustubh,
smitao. This runs servlets at a given port to act as an interface to
students who wish to register, change resume, etc.

2) T&P staff interface Server (stored in .../TandP/*) - garg, smitao. This
runs servelets at a given port to act as interface for T&P staff to
deal with all transactions of companies, and important student-related
transactions like creating a student account, etc. All maintenance
(back-up, etc) and misc work is also handled here.

3) Independently running progs (stored in .../General/*) -
hrishi. This just consists of an 'Everyday Prog', like a Cron job,
which does daily updation and reminder-generation. This directory also
contains some table-creating and initialising SQL queries.

4) The backend - An Oracle 7 RDBMS with our tables created, with proper
'grant' premissions ('grant's not yet implemented) for students, T&P staff
and administrator.
---------------------------------------------------------------------
To install and run:
The software uses JDBC and servelets to make its ends meet.
We assume you have an Oracle 7 RDBMS, a Web Server and java installed.
We are assuming you have properly configured these.
For e.g. The owner of the table

(On our HP-UX system, we used the following settings:
 CLASSPATH=
 
      ORACLE_TERM=vt100
      ORACLE_HOME=/oracle
      ORACLE_SID=GEN
      PATH=$PATH:$ORACLE_HOME/bin:/usr/ccs/bin:.
      export PATH TERM ORACLE_TERM ORACLE_HOME ORACLE_SID
      MENU5PATH=$ORACLE_HOME/forms30/admin/resource
      export MENU5PATH
      ORATERMPATH=$ORACLE_HOME/forms30/admin/resource
      export ORATERMPATH

export
CLASSPATH=${CLASSPATH:-""}:/oracle/jdbc/lib/classes111.zip:.:<dir
containing jsdk.jar>:/opt/java/lib/classes.zip

)

0) Table Creation - Now, we have assumed fello called hrishi is owner
   of tables. Hence: 
   * either make a tablespace in the name of hrishi, and run, in order -
   cr_tabs and cr_cons
   * or choose a different name. 
   Idea is that this person will be the root user of the database.
   (ie. We have assumed T&P staff will use this name. So will the
    database administrator. But, this needs to be changed - we should
    really have a distinction between staff and administrator. This is
    a big change and will involve 'grant' permissions, etc. We have
    not dealt with these.)

1) Student Interface Server - compile ... and run the servletrunner
	servletrunner -p 5032 -d dir
	dir is a directory which contains the servlets required for
	updating the student info.

2) T&P Server - compile. This consists of a collection of servlets each
handling a small aspect of the T&P Staff interface. The servlet's
sessions feature is used to keep track of the activities across the
servlets. The props file and the rc file contain the configuration of
the server. Just use servlet runner / or java enabled web-server to run
the servlets on some port (all of them on the same port). 

3) Independant Prog - Compile the java files in the General dir to get
   the final executable MailerDaemon. Put a stmt like "java
   MailerDaemon" in the m/c's cron jobs lists to make it run once
   every day. Recommended time at which it should be run: 3:00 a.m!

VERY IMPORTANT NOTE:
Almost ALL the source files have some hard coding as regards
parameters. May lead to probs. Please go thru them if things don't
work out. And remember, this IS an alpha version.
----------------------------------------------------------------------------

Now, the system can be used by students and T&P staff by connecting to
whatever ports the reps servelets are running on. Best of luck.
---------------------------------------------------------------------------

