Commit 78abde84 authored by toaster's avatar toaster
Browse files

added license & readme

git-svn-id: https://subversion.umiacs.umd.edu/ace/trunk@70 f1b3a171-7291-4a19-a512-95ad0ad9394a
parent fd335aa1
......@@ -6,6 +6,7 @@ The ACE AM requires the following software:
- Mysql 4.0+ (http://www.mysql.org)
- MySQL Connector 5.0.7+ (http://www.mysql.com/products/connector/j/)
------------------------------------------
In this file you should find the following:
- ace-am.sql - SQL installation files
- ace-am.war - webapp ACE Audit Manager
......@@ -13,6 +14,9 @@ In this file you should find the following:
- updates/ - directory containing SQL scripts which may be needed for updates
you can ignore these for new installations
------------------------------------------
Quick Installation:
1. Create the ACE database and user
- Create a new database called aceam and grant permissions to the aceam user.
- As a mysql administrator run the following commands:
......@@ -21,7 +25,27 @@ In this file you should find the following:
use aceam;
source ace-am.sql;
----- Example -----
2. Install the Tomcat webapp and Mysql JDBC Driver
- drop the ace-am.war into $TOMCAT/webapps
- copy the mysql connector to $TOMCAT/lib
3. Configure ACE database connection.
- drop ace-am.xml into $TOMCAT/conf/Catalina/localhost/ace-am.xml
- Edit $TOMCAT/conf/Catalina/localhost/ace-am.xml
- Change the following entries in the Resource Section:
- username - username you set in step 1 (aceam)
- password - password you set in step 1 (YOUR_PASSWORD)
- url - url of your database (jdbc:mysql://localhost/aceam)
4. Start up tomcat (startup.sh or startup.bat)
- Connect to http://localhost:8080/ace-am
- Look at /tmp/aceam.log for error messages
------------------------------------------
Detailed Installation
1. Create ACE database and user
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 2 to server version: 4.1.20
......@@ -45,6 +69,45 @@ Records: 0 Duplicates: 0 Warnings: 0
mysql> exit
Bye
-----
-----
2. Install the Tomcat webapp and Mysql JDBC Driver
- drop the ace-am.war into $TOMCAT/webapps
- copy the mysql connector to $TOMCAT/lib
$ cp ace-am.war apache-tomcat-6.0.14/webapps
$ cp mysql-connector-java-5.0.7-bin.jar apache-tomcat-6.0.14/lib
-----
3. Configure ACE database connection.
- drop ace-am.xml into $TOMCAT/conf/Catalina/localhost/ace-am.xml
- Edit $TOMCAT/conf/Catalina/localhost/ace-am.xml
- Change the following entries in the Resource Section:
- username - username you set in step 1 (aceam)
- password - password you set in step 1 (YOUR_PASSWORD)
- url - url of your database (jdbc:mysql://localhost/aceam)
$ mkdir -p apache-tomcat-6.0.14/conf/Catalina/localhost
$ cp ace-am.xml apache-tomcat-6.0.14/conf/Catalina/localhost
Edit apache-tomcat-6.0.14/conf/Catalina/localhost/ace-am.xml and set:
<Resource auth="Container" driverClassName="com.mysql.jdbc.Driver"
maxActive="20" maxIdle="10" maxWait="-1" name="jdbc/aceamdb"
password="YOUR_PASSWORD" testOnBorrow="true" type="javax.sql.DataSource"
url="jdbc:mysql://localhost/aceam" username="aceam"
validationQuery="SELECT 1"/>
4. Start up tomcat (startup.sh or startup.bat)
- Connect to http://localhost:8080/ace-am
- Look at /tmp/aceam.log for error messages
$ setenv JAVA_HOME /opt/jdk1.6.0
$ cd apache-tomcat-6.0.14
$ bin/startup.sh
$ bin/startup.sh
Using CATALINA_BASE: /home/user/apache-tomcat-6.0.14
Using CATALINA_HOME: /home/user/apache-tomcat-6.0.14
Using CATALINA_TMPDIR: /home/user/apache-tomcat-6.0.14/temp
Using JRE_HOME: /opt/jdk1.6.0
Please see Licenses/* for a complete list of all licenses affecting this code.
All components and source code, unless otherwise noted, are licensed under the
BSD license listed at Licenses/license-ace.txt
......@@ -22,6 +22,10 @@
</includes>
<outputDirectory>ace-am-${project.version}/updates</outputDirectory>
</fileSet>
<fileSet>
<directory>../Licenses</directory>
<outputDirectory>ace-am-${project.version}/Licenses</outputDirectory>
</fileSet>
</fileSets>
<files>
<file>
......@@ -37,5 +41,9 @@
<source>../INSTALL</source>
<outputDirectory>ace-am-${project.version}</outputDirectory>
</file>
<file>
<source>../LICENSE</source>
<outputDirectory>ace-am-${project.version}</outputDirectory>
</file>
</files>
</assembly>
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment