WebSVN - bacoAlunos - Diff - Rev 225 and 1306


#########################################################################
#
# 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.

Rev 225	Rev 1306
1	#########################################################################	1	#########################################################################
2	#	2	#
3	# BACO is a LGPL project developed at ESTG / IPP Portalegre	3	# BACO is a LGPL project developed at ESTG / IPP Portalegre
4	# The main objective is to support school site and	4	# The main objective is to support school site and
5	# daily work and comunications between Teachers and Students	5	# daily work and comunications between Teachers and Students
6	#	6	#
7	#	7	#
8	# http://www.estgp.pt	8	# http://www.estgp.pt
9	#	9	#
10	# Preject Team Leader	10	# Preject Team Leader
11	#	11	#
12	# Jorge Machado - jmachado AT estgp DOT pt	12	# Jorge Machado - jmachado AT estgp DOT pt
13	#	13	#
14	#########################################################################	14	#########################################################################
15		15
16	# Release 1.0 #	16	# Release 1.0 #
17		17
18	SOFTWARE REQUIREMENTS	18	SOFTWARE REQUIREMENTS
19		19
20	JDK 5.0 or JDK 1.6.0_06 or superior (Middle versions between those two will bring problems in WEB SERVICES)	20	JDK 5.0 or JDK 1.6.0_06 or superior (Middle versions between those two will bring problems in WEB SERVICES)
21	Apache ANT to compile and build project	21	Apache ANT to compile and build project
22	MySql 4.1 or superior	22	MySql 4.1 or superior
23	Tomcat 5.0 or Superior	23	Tomcat 5.0 or Superior
24		24
25	DOWNLOAD	25	DOWNLOAD
26		26
27	Download the last version from Site Project or from SVN http://deptal.estgp.pt:9090/svn/estgweb	27	Download the last version from Site Project or from SVN http://deptal.estgp.pt:9090/svn/estgweb
28		28
29	ANT CONFIGURATION	29	ANT CONFIGURATION
30		30
31	Download and unzip ant for some local folder.	31	Download and unzip ant for some local folder.
32	Set Environement Variable ANT_HOME with that folder and add %ANT_HOME%/bin to PATH of your computer	32	Set Environement Variable ANT_HOME with that folder and add %ANT_HOME%/bin to PATH of your computer
33	Test this instalation opening a shell pront and writing >ant If the command is recognized ANT is ready to run.	33	Test this instalation opening a shell pront and writing >ant If the command is recognized ANT is ready to run.
34	It's natural system anwser you with:	34	It's natural system anwser you with:
35	=============================================================================	35	=============================================================================
36	Buildfile: build.xml does not exist!	36	Buildfile: build.xml does not exist!
37	Build failed	37	Build failed
38	=============================================================================	38	=============================================================================
39		39
40	This happens because you are not in a folder with a build.xml file	40	This happens because you are not in a folder with a build.xml file
41		41
42	TOMCAT CONFIGURATION	42	TOMCAT CONFIGURATION
43		43
44	Download and unzip tomcat in some folder. Go to conf/tomcat-users.xml and create role "manager" and a user with that role	44	Download and unzip tomcat in some folder. Go to conf/tomcat-users.xml and create role "manager" and a user with that role
45	For example:	45	For example:
46	=============================================================================	46	=============================================================================
47	<?xml version='1.0' encoding='utf-8'?>	47	<?xml version='1.0' encoding='utf-8'?>
48	<tomcat-users>	48	<tomcat-users>
49	<role rolename="manager"/>	49	<role rolename="manager"/>
50	<role rolename="tomcat"/>	50	<role rolename="tomcat"/>
51	<role rolename="role1"/>	51	<role rolename="role1"/>
52	<user username="tomcat" password="tomcat" roles="tomcat"/>	52	<user username="tomcat" password="tomcat" roles="tomcat"/>
53	<user username="both" password="tomcat" roles="tomcat,role1"/>	53	<user username="both" password="tomcat" roles="tomcat,role1"/>
54	<user username="admin" password="admin" roles="manager"/>	54	<user username="admin" password="admin" roles="manager"/>
55	</tomcat-users>	55	</tomcat-users>
56	=============================================================================	56	=============================================================================
57		57
58	If you are using not self install tomcat create a startup file like this:	58	If you are using not self install tomcat create a startup file like this:
59	go to tomcat/bin	59	go to tomcat/bin
60	=============================================================================	60	=============================================================================
61	set CATALINA_HOME=C:\Servidores\apache-tomcat-6.0.16	61	set CATALINA_HOME=C:\Servidores\apache-tomcat-6.0.16
62	set JAVA_OPTS=-Dfile.encoding=UTF-8 -Xmx512m -Xms128m -XX:NewRatio=1 -server	62	set JAVA_OPTS=-Dfile.encoding=UTF-8 -Xmx512m -Xms128m -XX:NewRatio=1 -server
63	set JAVA_OPTS=%JAVA_OPTS%	63	set JAVA_OPTS=%JAVA_OPTS%
64	startup.bat	64	startup.bat
65	=============================================================================	65	=============================================================================
66		66
67		67
68	if you are running a self install server version after install tomcat as Service	68	if you are running a self install server version after install tomcat as Service
69	go to tomcat folder / bin and run tomcatXw.exe to set environement variables	69	go to tomcat folder / bin and run tomcatXw.exe to set environement variables
70	at JAVA_OPTS screen write:	70	at JAVA_OPTS screen write:
71	-Dfile.encoding=UTF-8	71	-Dfile.encoding=UTF-8
72		72
73	and set min memory size to 128 and max memory size to 512	73	and set min memory size to 128 and max memory size to 512
74		74
75	INSTALL	75	INSTALL
76		76
77	Place yourself in project dir / impl	77	Place yourself in project dir / impl
78	Copy and paste build.properties to local.properties, and change	78	Copy and paste build.properties to local.properties, and change
79	- database configuration,	79	- database configuration,
80	- tomcat location (in case of tomcat 5 carefully with libraries folders (see in build.properties) because are not the same in tomcat 6.0)	80	- tomcat location (in case of tomcat 5 carefully with libraries folders (see in build.properties) because are not the same in tomcat 6.0)
81	See local-exampleNotInUse for example. Note that this is a minimal example. Some configurations will be takes by default.	81	See local-exampleNotInUse for example. Note that this is a minimal example. Some configurations will be takes by default.
82	Do not include local.properties in SVN project	82	Do not include local.properties in SVN project
83		83
84	Create a new Schema in MySql with the name used in local.properties and configure a user or let be root with no password	84	Create a new Schema in MySql with the name used in local.properties and configure a user or let be root with no password
85		85
86	At project/impl run	86	At project/impl run
87	>ant all	87	>ant all
88		88
89	If an error of log4j (No loggers found at routine generateHibernateDomain) appears to you stop and run it again	89	If an error of log4j (No loggers found at routine generateHibernateDomain) appears to you stop and run it again
90		90
91	IF build is a success run	91	IF build is a success run
92		92
93	>ant build.war	93	>ant build.war
94		94
95	And than	95	And than
96		96
97	>ant tomcat.deployContext	97	>ant tomcat.deployContext
98		98
99	If every thing goes well your system is running	99	If every thing goes well your system is running
100		100
101		101
102	SYSTEM CONFIGURATION	102	SYSTEM CONFIGURATION
103		103
104	System configurations can be found at project/impl/conf/app.properties	104	System configurations can be found at project/impl/conf/app.properties
105	Web services configuration can be found in build.properties and you can override in local.properties	105	Web services configuration can be found in build.properties and you can override in local.properties
106		106
107	SCRIPTS	107	SCRIPTS
108		108
109	A set of schedulable scripts are created in build and placed in impl/build/ant/scripts.	109	A set of schedulable scripts are created in build and placed in impl/build/ant/scripts.
110	Some scripts are used to import CourseUnits, Students, Teachers and Grades from SIGES WEB-SERVICE	110	Some scripts are used to import CourseUnits, Students, Teachers and Grades from SIGES WEB-SERVICE
111	There are a script to clean tmp. This script delete only old files with more than 24 hours, you can run it any time.	111	There are a script to clean tmp. This script delete only old files with more than 24 hours, you can run it any time.

Subversion Repositories bacoAlunos

(root)/branches/v3/impl/INSTALL @ 1623 - Rev 225 → 1306