Login
Forgot your password? Have your password hint e-mailed to you.
Version: 1.3
Quick-Start FAQ
===============
Use this file to specify features and important developer-related information
in your application.
To build this application - you must be using Ant 1.5.1 and have your
$J2EE_HOME set to your J2EE SDK install directory. You can also copy the
j2ee.jar file to lib/j2sdkee1.4/lib. J2EE 1.4 is not required yet, so
using a 1.3 lib is fine. You can also pass in the parameter such as
ant -Dj2ee.jar=/path/to/jar.
You will also need to copy junit.jar into your $ANT_HOME/lib directory.
** IMPORTANT NOTE FOR TOMCAT 5 USERS **
You will need to copy Java Mail JAR (mail.jar, activation.jar) files into
$CATALINA_HOME/common/lib to use Log4j's SMTPAppender to get e-mail
notification of errors. If you don't want to use this, remove the SMTPAppender
stuff from log4j.properties in web/WEB-INF/classes.
To run this application, you will need to perform the following tasks:
1. Copy build.properties.sample and database.properties.sample to
build.properties and database.properties. See properties.xml for other
options.
2. Adjust the database.properties file to fit your system - the username
and password for the database must have database/table create rights.
It currently creates a mysql "CIPService" database using the user: root/admin.
It also grants the user "test" (password: test) full rights to this
database.
3. Run "ant setup-db".
4. Test that the db access code works with:
ant test-ejb -Dtestcase=UserDAOTest
ant test-web -Dtestcase=UserManagerTest
5. Setup Tomcat running "ant setup-tomcat deploy". This puts a mysql jdbc
driver in $CATALINA_HOME/common/lib, puts a CIPService.xml file in
$CATALINA_HOME/webapps/ and deploys the application.
6. Start Tomcat and test the web login using:
ant test-canoo -Dtestcase=login
What is AppFuse?
- It's an application that is meant to demonstrate how to use XDoclet with
Struts to generate your Forms, web.xml, struts-config.xml, and validation.xml.
It's also designed to show how you can use the different security packages
(i.e. form-based authentication, SSLExt) and advanced
Struts techniques (i.e. Tiles, Validator) to build your webapps.
Where do I put my own code?
- The build file is setup so that you can place your own packages anywhere
under the /src directory. For database access code, it's recommended that
you put it under the src/ejb directory.
What targets does the build file accept?
- Run "ant -projecthelp" for a complete list of available tasks.
==+== This file created by AppFuse, an open source project by Matt Raible ==+==