Raible's Wiki: AppFuseQuickStart

At line 1 added 2 lines.

<div style="border: 1px solid #F0C000; background-color: #FFFFCE; padding: 10px">__NOTE:__ This wiki and its contents are for AppFuse 1.x. If you'd like to use AppFuse 2.x, please see the [new wiki|http://appfuse.org] or the [AppFuse 2.x QuickStart Guide|http://appfuse.org/display/APF/AppFuse+QuickStart].</div>

At line 4 changed 3 lines.

# [Download|https://appfuse.dev.java.net/servlets/ProjectDocumentList] the source version or checkout the ''appfuse'' module from CVS (cvs -d :pserver:[email protected]:/cvs co appfuse). <div class="note" style="margin: 10px"> __NOTE:__ You can download AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 and MySQL 4.1.11 (for Windows) using [the all-in-one installer|https://appfuse.dev.java.net/files/documents/1397/13863/appfuse-installer-1.8.zip]. View this package's [README.txt|https://appfuse.dev.java.net/source/browse/*checkout*/appfuse/extras/myjavapack/README-dist.txt] for more information.</div>

# Install Ant 1.6.2+ and set an ANT_HOME environment variable. Install Tomcat 4.1.x+ (recommend 5.0.28) and set a CATALINA_HOME environment variable to point to your Tomcat installation. Checkout my [development environment setup|DevelopmentEnvironment] to get links for these packages and to see where I usually install them.

# Install MySQL 3.23.x+ (recommend 4.1.7). <div class="note" style="margin: 10px"> __NOTE:__ If you're using MySQL 4.1.7, make sure to use a UTF-8 character set and an InnoDB table type. [Here's how|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].

# [Download|https://appfuse.dev.java.net/servlets/ProjectDocumentList] the source version or checkout the 1.9.x branch from Subversion (svn co https://appfuse.dev.java.net/svn/appfuse/branches/BRANCH_1-9-x appfuse).

# Install Ant 1.6.5+ and set an ANT_HOME environment variable. Install Tomcat 4.1.x+ (recommend 5.5.20) and set a CATALINA_HOME environment variable to point to your Tomcat installation. Checkout my [development environment setup|DevelopmentEnvironment] to get links for these packages and to see where I usually install them.

# Install MySQL 3.23.x+ (recommend 5.0+). <div class="note" style="margin: 10px"> __NOTE:__ If you're using MySQL 4.1.7, make sure to use a UTF-8 character set and an InnoDB table type. [Here's how|http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseSupport#ref-AppFuseSupport-5].</div>

At line 9 changed 3 lines.

# If you're planning on using iBATIS (instead of Hibernate) or a web framework other than Struts, install that now (instructions below).

# After the install completes, navigate to the new directory and run __ant new__. You will be prompted for an application name, database name and package name. After entering these, a directory containing your new application will be created in the same directory as appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __WARNING:__ Some application values will not work - don't use "test", anything with "appfuse" in it or anything that starts with numbers. Also, two dashes (-) in a name will mess things up.</div>

# Run __ant setup__ (or __ant setup-db setup-tomcat deploy__) to create the database, configure Tomcat and deploy your application. The database setup will only work if your root user has no password. You can change this in build.properties if necessary. Need [assistance with mysql setup|assistance with ant setup]?

# If you're planning on using iBATIS (instead of Hibernate) or a web framework other than Struts, install that now using the instructions below.

# Run __ant new__ from the appfuse directory. You will be prompted for an application name, database name and package name. After entering these, a directory containing your new application will be created in the same directory as appfuse. <div class="note" style="margin: 10px; background-color: #fcc"> __WARNING:__ Some application values will not work - don't use "test", anything with "appfuse" in it or anything that starts with numbers. Also, two dashes (-) in a name will mess things up.</div>

# Navigate to your new project's directory and run __ant setup__ (or __ant setup-db setup-tomcat deploy__) to create the database, configure Tomcat and deploy your application. The database setup will only work if your root user has no password. You can change this in build.properties if necessary. Need [assistance with mysql setup|assistance with ant setup]?

At line 17 removed 5 lines.

* If you'd like to use [iBATIS|http://ibatis.com] as a persistence framework option, view the README.txt in {{extras/ibatis}} or run __ant install-ibatis__.

* If you'd like to use [Spring|http://www.springframework.org/docs/reference/mvc.html] as the web framework, view the README.txt in {{extras/spring}} or run __ant install-springmvc__.

* If you'd like to use [WebWork|http://www.opensymphony.com/webwork] as the web framework, view the README.txt in {{extras/webwork}} or run __ant install-webwork__.

* If you'd like to use [JSF|http://myfaces.apache.org/] as the web framework, view the README.txt in {{extras/jsf}} or run __ant install-jsf__.

* If you'd like to use [Tapestry|http://jakarta.apache.org/tapestry] as the web framework, view the README.txt in {{extras/tapestry}} or run __ant install-tapestry__.

At line 20 added 8 lines.

<div class="note" style="margin-left: 40px"> __NOTE:__ If you're developing with AppFuse on Unix, run "ant fixcrlf" before running the installers. You can also download a pre-built version that already has the web framework option you're looking for.</div>

* If you'd like to use [iBATIS|http://ibatis.com] as a persistence framework option, view the README.txt in {{extras/ibatis}}.

* If you'd like to use [Spring|http://www.springframework.org/docs/reference/mvc.html] as the web framework, view the README.txt in {{extras/spring}}.

* If you'd like to use [WebWork|http://www.opensymphony.com/webwork] as the web framework, view the README.txt in {{extras/webwork}}.

* If you'd like to use [JSF|http://myfaces.apache.org/] as the web framework, view the README.txt in {{extras/jsf}}.

* If you'd like to use [Tapestry|http://jakarta.apache.org/tapestry] as the web framework, view the README.txt in {{extras/tapestry}}.

Raible's Wiki

AppFuse

Other Applications

AppFuseQuickStart