Topaz/Ambra Maven Setup

Maven Installation

• Download and install Maven (avoid using directories with spaces on Windows)
• Add the mvn binary to path to ensure it is visible in shells
  • On Windows, right Click on My computer, Properties, Advanced Tab, Environment Variables. System Variables
  • Edit the Path to put the bin folder of maven at the end (e.g., c:\tools\maven-2.0.8\bin)
• Open a shell window (bash, cygwin, etc.) and execute mvn to allow it to create local repository
• On Windows perform these additional steps:
  • Right Click on My computer, Properties, Advanced Tab, Environment Variables, System Variables
  • Select New and create variable name MAVEN_OPTS
  • Set Variable value to: -Xmx1024M -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8085,server=y,suspend=n
• For Mac OS X users, you need to set your file-encoding to 'UTF-8' (instead of the default 'MacRoman') running maven. E.g.

        env MAVEN_OPTS="-Dfile.encoding=UTF-8" mvn
  

Maven Configuration

• Copy the settings.xml to .m2 directory
  • On Windows this should be c:\Documents and Setting\[user name]\.m2
  • On Linux variants it should be ~/.m2
• Edit settings.xml to
  • Provide permanent directory name within the topazproject.install.dir element. Note: This should be an absolute directory name and avoid use of spaces for Windows directory. e.g. are '/home/user/topaz-install-dir', 'c::/cygwin/home/username/topazproject-install', etc.
• You can have multiple profiles, and can switch to the profile you want using <activeProfile>
• You can pass Javac environment variables via Maven through the environment variable MAVEN_OPTS. On some systems you might have to provide additional heap and stack space to build successfully.