Rev 1310 | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
225 | jmachado | 1 | ######################################################################### |
2 | # |
||
3 | # BACO is a LGPL project developed at ESTG / IPP Portalegre |
||
4 | # The main objective is to support school site and |
||
5 | # daily work and comunications between Teachers and Students |
||
6 | # |
||
7 | # |
||
8 | # http://www.estgp.pt |
||
9 | # |
||
10 | # Preject Team Leader |
||
11 | # |
||
12 | # Jorge Machado - jmachado AT estgp DOT pt |
||
13 | # |
||
14 | ######################################################################### |
||
15 | |||
16 | # Release 1.0 # |
||
17 | |||
18 | SOFTWARE REQUIREMENTS |
||
19 | |||
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 |
||
22 | MySql 4.1 or superior |
||
23 | Tomcat 5.0 or Superior |
||
24 | |||
25 | DOWNLOAD |
||
26 | |||
27 | Download the last version from Site Project or from SVN http://deptal.estgp.pt:9090/svn/estgweb |
||
28 | |||
29 | ANT CONFIGURATION |
||
30 | |||
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 |
||
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: |
||
35 | ============================================================================= |
||
36 | Buildfile: build.xml does not exist! |
||
37 | Build failed |
||
38 | ============================================================================= |
||
39 | |||
40 | This happens because you are not in a folder with a build.xml file |
||
41 | |||
42 | TOMCAT CONFIGURATION |
||
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 |
||
45 | For example: |
||
46 | ============================================================================= |
||
47 | <?xml version='1.0' encoding='utf-8'?> |
||
48 | <tomcat-users> |
||
49 | <role rolename="manager"/> |
||
50 | <role rolename="tomcat"/> |
||
51 | <role rolename="role1"/> |
||
52 | <user username="tomcat" password="tomcat" roles="tomcat"/> |
||
53 | <user username="both" password="tomcat" roles="tomcat,role1"/> |
||
54 | <user username="admin" password="admin" roles="manager"/> |
||
55 | </tomcat-users> |
||
56 | ============================================================================= |
||
57 | |||
58 | If you are using not self install tomcat create a startup file like this: |
||
59 | go to tomcat/bin |
||
60 | ============================================================================= |
||
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 |
||
63 | set JAVA_OPTS=%JAVA_OPTS% |
||
64 | startup.bat |
||
65 | ============================================================================= |
||
66 | |||
67 | |||
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 |
||
70 | at JAVA_OPTS screen write: |
||
71 | -Dfile.encoding=UTF-8 |
||
72 | |||
73 | and set min memory size to 128 and max memory size to 512 |
||
74 | |||
75 | INSTALL |
||
76 | |||
77 | Place yourself in project dir / impl |
||
78 | Copy and paste build.properties to local.properties, and change |
||
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) |
||
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 |
||
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 |
||
85 | |||
86 | At project/impl run |
||
87 | >ant all |
||
88 | |||
89 | If an error of log4j (No loggers found at routine generateHibernateDomain) appears to you stop and run it again |
||
90 | |||
91 | IF build is a success run |
||
92 | |||
93 | >ant build.war |
||
94 | |||
95 | And than |
||
96 | |||
97 | >ant tomcat.deployContext |
||
98 | |||
99 | If every thing goes well your system is running |
||
100 | |||
101 | |||
102 | SYSTEM CONFIGURATION |
||
103 | |||
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 |
||
106 | |||
107 | SCRIPTS |
||
108 | |||
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 |
||
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. |
||
112 |