Subversion Repositories bacoAlunos

#########################################################################
#
# BACO is a LGPL project developed at ESTG / IPP Portalegre
#  The main objective is to support school site and
#  daily work and comunications between Teachers and Students
# 
#
# http://www.estgp.pt
#
# Preject Team Leader
#
#   Jorge Machado - jmachado AT estgp DOT pt
#
#########################################################################

# Release 1.0 #

SOFTWARE REQUIREMENTS

JDK 5.0 or JDK 1.6.0_06 or superior (Middle versions between those two will bring problems in WEB SERVICES)
Apache ANT to compile and build project
MySql 4.1 or superior
Tomcat 5.0 or Superior

DOWNLOAD

Download the last version from Site Project or from SVN http://deptal.estgp.pt:9090/svn/estgweb

ANT CONFIGURATION

Download and unzip ant for some local folder.
Set Environement Variable ANT_HOME with that folder and add %ANT_HOME%/bin to PATH of your computer
Test this instalation opening a shell pront and writing >ant If the command is recognized ANT is ready to run.
It's natural system anwser you with:
=============================================================================
Buildfile: build.xml does not exist!
Build failed
=============================================================================

This happens because you are not in a folder with a build.xml file

TOMCAT CONFIGURATION

Download and unzip tomcat in some folder. Go to conf/tomcat-users.xml and create role "manager" and a user with that role
For example:
=============================================================================
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager"/>
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="admin" password="admin" roles="manager"/>
</tomcat-users>
=============================================================================

If you are using not self install tomcat create a startup file like this:
go to tomcat/bin
=============================================================================
set CATALINA_HOME=C:\Servidores\apache-tomcat-6.0.16
set JAVA_OPTS=-Dfile.encoding=UTF-8 -Xmx512m -Xms128m -XX:NewRatio=1 -server
set JAVA_OPTS=%JAVA_OPTS%
startup.bat
=============================================================================


if you are running a self install server version after install tomcat as Service
go to tomcat folder / bin and run tomcatXw.exe to set environement variables
at JAVA_OPTS screen write:
-Dfile.encoding=UTF-8

and set min memory size to 128 and max memory size to 512

INSTALL

Place yourself in project dir / impl
Copy and paste build.properties to local.properties, and change
    - database configuration,
    - tomcat location (in case of tomcat 5 carefully with libraries folders (see in build.properties) because are not the same in tomcat 6.0)
See local-exampleNotInUse for example. Note that this is a minimal example. Some configurations will be takes by default.
Do not include local.properties in SVN project

Create a new Schema in MySql with the name used in local.properties and configure a user or let be root with no password

At project/impl run
>ant all

If an error of log4j (No loggers found at routine generateHibernateDomain) appears to you stop and run it again

IF build is a success run

>ant build.war

 And than

>ant tomcat.deployContext

If every thing goes well your system is running


SYSTEM CONFIGURATION

System configurations can be found at project/impl/conf/app.properties
Web services configuration can be found in build.properties and you can override in local.properties

SCRIPTS

A set of schedulable scripts are created in build and placed in impl/build/ant/scripts.
Some scripts are used to import CourseUnits, Students, Teachers and Grades from SIGES WEB-SERVICE
There are a script to clean tmp. This script delete only old files with more than 24 hours, you can run it any time.