added license & readme

git-svn-id: https://subversion.umiacs.umd.edu/ace/trunk@70 f1b3a171-7291-4a19-a512-95ad0ad9394a

INSTALL

@@ -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
+

LICENSE

+
+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

ace-dist/src/main/assembly/dep.xml

@@ -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>