AppFuseQuickStart

This is version 53. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

1. Download the source version or CVS version.
2. Install J2SE 1.4+, set a JAVA_HOME environment variable, install Ant 1.6.1+, set an ANT_HOME environment variable.
3. Install MySQL 3.23.x+ and Tomcat 4.1.x+. Set a CATALINA_HOME environment variable to point to your Tomcat installation.
4. Setup a local SMTP server or change mail.properties (in the web/WEB-INF/classes directory) and build.properties (in the root -- for log4j messages) to point to an existing one - they default to localhost.
5. Copy lib/junit3.8.1/junit.jar to $ANT_HOME/lib.
6. Run ant new -Dapp.name=YOURAPPNAME -Ddb.name=YOURDBNAME. This will create a directory named YOURAPPNAME in the same directory as appfuse.
7. Navigate to the new directory and run ant setup to create the database and setup your app on Tomcat. The database setup will only work if your root user has no password. You can change the database.admin.username and database.admin.username values in build.properties if necessary (after uncommenting those lines). If you want to test and make sure everything works, run ant test-all - make sure Tomcat is stopped when you do this.
8. Run ant test-reports - there will be a message after it runs telling you how you can view the generated reports.

Optional Installs

• If you'd like to use iBATIS as a persistence framework option, view the README.txt in extras/ibatis.
• If you'd like to use Spring as the web framework, view the README.txt in extras/spring.

Usually, after you get all this to work - it's likely you'll want to change all your package names to "com.company" rather than "org.appfuse". I use Eclipse to rename packages. To do this, go to the package view, click on a package name and right click -> Refactor -> Rename. Type in "*.xml,*.properties,*.xdt" for File name patterns to search in.

NOTE: If you want to use iBATIS, I recommend you install it (instructions at extras/ibatis/README.txt) before renaming all the packages. If you don't install it first, you can add the ibatis/src as a source directory and rename packages there. Make sure to edit/change all the package names in the .xml files (including build.xml). You will also need to manually change the package names in the *DAOiBatis files.

By adding "*.xml,*.properties,*.xdt" to the File name patterns field in the Rename Package wizard, the following files should be changed as well. If you're not using Eclipse or something isn't working right - you might want to ensure the "org.appfuse" has been changed to "com.company" in the following files:

- metadata/web/global-exceptions.xml
- web/WEB-INF/tiles-config.xml
- web/WEB-INF/classes/log4j.properties
- web/WEB-INF/validator-rules-custom.xml
- src/service/com/company/service/applicationContext-service.xml
- src/dao/com/company/persistence/hibernate/applicationContext-hibernate.xml
- metadata/templates/struts_form.xdt

You'll need to manually change the location of the Hibernate mapping files in the applicationContext-hibernate.xml file (location listed above). Basically, "org/appfuse" needs to be changed to "com/company".

You'll also need to change a few targets in build.xml to refer to the new package names. These targets/changes are listed below:

- junitdoclet-module - change org.* to com.*
- javadoc - change org.* to com.*

If you want to keep your source in a separate package, but keep AppFuse's package naming intact - this also seems to be possible. Read More...