The Plug-in requires Maven 2.0 or later. See the section called “System requirements” for the basic requirements to run Jalopy. Please note that a different Plug-in is available for older Maven releases (see Chapter 10, Maven 1 Plug-in).

The Plug-in comes as an executable Jar Archive (JAR) that contains a graphical setup wizard to let you easily install the software. Wizard installation is recommended and explained in detail in the section called “Wizard Installation”.

If you would rather install the Plug-in manually, you have to decompress and copy the appropriate files into the different application and/or settings folders. To decompress the contents of the installer JAR, you can often use the build-in support of your file manager (e.g. Nautilus) or any other software that can handle the ZIP compression format (e.g. 7Zip, WinZip or Stuffit Expander). If you don’t have access to one of the convenience tools, you might resort to the jar command-line application that ships with your Java distribution.

If you’re upgrading from a prior version and want to keep your settings, first copy or rename the current Jalopy settings directory to match the version number of the new release. For instance, if your current settings directory is C:\Documents and Settings\John Doo\.jalopy\1.9 and you’re about to install Jalopy 1.9.3, either copy the directory contents or rename it to C:\Documents and Settings\.jalopy\John Doo\1.9.3. Wizard installation can perform this step automatically.

First copy the Jalopy Maven Plug-in folder triemax from the temporary directory into the Maven 2 repository directory. This might either be the local repository (e.g. C:\Documents And Settings\John Doo\.m2\repository\ on a Windows XP system) or the repository directory of your internal repository in case you’re using a shared repository for your organization.

Copy the file jalopy-1.9.3.jar below the triemax/jalopy/1.9.3/ folder in your Maven repository, and jalopy-maven-1.9.3.jar from the temporary directory into the triemax/jalopy-maven/1.9.3/ folder of your Maven 2 repository. After all steps have been performed, you should have a folder structure like the following:

..
  repository
    [...]
    triemax
      jalopy
        1.9.3-156
          jalopy-1.9.3-156.jar
          jalopy-1.9.3-156.pom
      jalopy-maven
        1.9.3-156
          jalopy-maven-1.9.3-156.jar
          jalopy-maven-1.9.3-156.pom
          maven-metadata-local.xml
        maven-metadata-central.xml
    [...]