Skip to end of metadata
Go to start of metadata

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

  • Download the latest Griffon release
  • Extract the archive into an appropriate location; typically C:\griffon on Windows or ~/griffon on Unix
  • 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)
  • 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
  • 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')
  • Type "griffon" at the command line, if a help message is displayed you are ready to start using Griffon!
  • If you get an error message, try to chmod +x the griffon script inside the bin directory.

Installation from Git

Prerequisites

In order to start using Griffon from Git 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.7 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 Git

Steps

the following steps assume $checkout points to the directory where the Griffon source has been check out by git

  • Set the GRIFFON_HOME environment variable to some location that is not below the checkout location
  • Add the $checkout/bin directory to your PATH environment variable
  • Add the $checkout/ant/bin directory to your PATH environment variable.
  • (You may need to give the scripts in $checkout/ant/bin execute permissions.)
  • Go to the $checkout directory and type "ant install" to build Griffon and install it in your $GRIFFON_HOME directory
  • That's it! Start developing with Griffon!
  • No labels

3 Comments

  1. Looks like the SVN repository has moved. Try this checkout command: svn co http://svn.codehaus.org/groovy/trunk/groovy/modules/griffon/

  2. Just a typo:

    "eg. PATH under 'System variables' and GRAILS_HOME under 'User variables"

    should read:

    "eg. PATH under 'System variables' and GRIFFON_HOME under 'User variables"

  3. I know this might sound stupid: but I installed griffon on Win7, where I didn't have JAVA_HOME env variable defined.

    I did define it to the \bin folder and struggled more than a couple of hours to find what's wrong (I checked much more tricky cases)

    Since this can happen - I strongly suggest to give a better error message than "The system cannot find the path specified".

    I've seen that if the JAVA_HOME is a nonsense folder there is a clear error message.

    I tried to open an issue directly on codehaus - but I could not. A pity.

    Thanks for this interesting and promising project!

    Lior