Installing Griffon

Installation from Download

Prerequisites

In order to start using Griffon you need to have the following:

• An installation of Java SDK 1.5 or higher and have set your JAVA_HOME variable to the SDK install location. Java 1.6 is strongly recommended.

Steps

1. Download the latest Griffon release
2. Extract the archive into an appropriate location; typically C:\griffon on Windows or ~/griffon on Unix
3. Create a GRIFFON_HOME environment variable that points to the path where you extracted the archive (eg C:\griffon on Windows or ~/griffon on Unix)
4. If you have not set the JAVA_HOME environment variable yet, create JAVA_HOME environment variable that points to the path where you have installed Java
5. Append a reference to the "bin" directory within the Griffon directory to your PATH variable (eg %GRIFFON_HOME%\bin on Windows or $GRIFFON_HOME/bin on Unix). Note that, for Windows, both PATH and GRIFFON_HOME must be defined at the same environment variable level (eg. 'System variables') rather than across environment variable levels (eg. PATH under 'System variables' and GRIFFON_HOME under 'User variables')
6. Type "griffon" at the command line, if a help message is displayed you are ready to start using Griffon!
7. If you get an error message, try to chmod +x the griffon script inside the bin directory.

Installation from Subversion

Prerequisites

In order to start using Griffon from SVN you need to have the following:

• An installation of Java 1.5 or higher and have set your JAVA_HOME variable to the install location
• A working installation of Apache Ant 1.6.5 or higher and have set your ANT_HOME variable to the install location
• JUnit (to run the build tests - put junit.jar in your ANT_HOME\lib directory)
• An installation of Subversion

Steps

1. Checkout Griffon from the Griffon Module in the Griffon SVN repository
   1. Go into an empty directory where you will keep your griffon sources, create one if you want
   2. Run this command: svn co http://svn.codehaus.org/griffon/core/trunk griffon-src
2. A subdirectory named griffon-src will be created, let's call that location GRIFFON_SRC
3. Go into GRIFFON_SRC
4. Make sure you can run ant : ant -version
   1. If you have an error, try using the ant provided in the sources (you may need to give the ant script executable permission before): ./ant/bin/ant -version
5. Decide of a directory where you want griffon to be installed; typically C:\griffon on Windows or ~/griffon on Unix
6. Set the GRIFFON_HOME environment variable to that location (make sure it is not below the checkout location)
7. Install griffon by running "ant install"
8. Once the build runs with success, follow the instructions as if you've downloaded a binary distribution (see "Installation from Download" above).
9. That's it! Start developing with Griffon!