Rev 1306 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1306 | Rev 1310 | ||
---|---|---|---|
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. |