<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="https://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
How To Build JBoss Tools 4.1 FAQ
</h3>
<span style="margin-bottom: 10px;">
created by <a href="https://community.jboss.org/people/nickboldt">Nick Boldt</a> in <i>JBoss Tools Development</i> - <a href="https://community.jboss.org/docs/DOC-48358">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p><span style="font-size: 14pt; text-decoration: underline;"><strong>Frequently Asked Questions: How Do I Build JBoss Tools 4.1?</strong></span></p><p><span style="font-size: 14pt; text-decoration: underline;"><strong><br/></strong></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong style="font-size: 12pt;"><em>How do I configure my settings.xml?</em></strong></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;">Follow<a class="jive-link-wiki-small" href="https://community.jboss.org/docs/DOC-15170"> these instructions</a> to add reference to JBoss Repositories into your settings.xml. You'll also probably need access to the SNAPSHOT repository. So here is what you should see in your ~/.m2/settings.xml</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code jive-xml">
<span class="jive-xml-tag"><span><settings xmlns="</span><a class="jive-link-external-small" href="http://maven.apache.org/SETTINGS/1.0.0" rel="nofollow" target="_blank">http://maven.apache.org/SETTINGS/1.0.0</a><span>" xmlns:xsi="</span><a class="jive-link-external-small" href="http://www.w3.org/2001/XMLSchema-instance" rel="nofollow" target="_blank">http://www.w3.org/2001/XMLSchema-instance</a><span>" xsi:schemaLocation="</span><a class="jive-link-external-small" href="http://maven.apache.org/SETTINGS/1.0.0" rel="nofollow" target="_blank">http://maven.apache.org/SETTINGS/1.0.0</a><span> </span><a class="jive-link-external-small" href="http://maven.apache.org/xsd/settings-1.0.0.xsd" rel="nofollow" target="_blank">http://maven.apache.org/xsd/settings-1.0.0.xsd</a><span>"></span></span>
   ....
    <span class="jive-xml-tag"><profiles></span>
        ....
        <span class="jive-xml-tag"><profile></span>
            <span class="jive-xml-tag"><id></span>jboss-default<span class="jive-xml-tag"></id></span>
            <span class="jive-xml-tag"><repositories></span>
                <span class="jive-xml-comment"><!-- To resolve parent artifact -->
                <span class="jive-xml-tag"><repository></span>
                    <span class="jive-xml-tag"><id></span>jboss-public-repository-group<span class="jive-xml-tag"></id></span>
                    <span class="jive-xml-tag"><name></span>JBoss Public Repository Group<span class="jive-xml-tag"></name></span>
                    <span class="jive-xml-tag"><url></span><a class="jive-link-external-small" href="http://repository.jboss.org/nexus/content/groups/public/" rel="nofollow" target="_blank">http://repository.jboss.org/nexus/content/groups/public/</a><span class="jive-xml-tag"></url></span>
                <span class="jive-xml-tag"></repository></span>
                <span class="jive-xml-tag"><repository></span>
                    <span class="jive-xml-tag"><id></span>jboss-snapshots-repository<span class="jive-xml-tag"></id></span>
                    <span class="jive-xml-tag"><name></span>JBoss Snapshots Repository<span class="jive-xml-tag"></name></span>
                    <span class="jive-xml-tag"><url></span><a class="jive-link-external-small" href="https://repository.jboss.org/nexus/content/repositories/snapshots/" rel="nofollow" target="_blank">https://repository.jboss.org/nexus/content/repositories/snapshots/</a><span class="jive-xml-tag"></url></span>
                <span class="jive-xml-tag"></repository></span>
            <span class="jive-xml-tag"></repositories></span>
            <span class="jive-xml-tag"><pluginRepositories></span>
                        <!-- To resolve parent artifact --></span>
                        <span class="jive-xml-tag"><pluginRepository></span>
                                <span class="jive-xml-tag"><id></span>jboss-public-repository-group<span class="jive-xml-tag"></id></span>
                                <span class="jive-xml-tag"><name></span>JBoss Public Repository Group<span class="jive-xml-tag"></name></span>
                                <span class="jive-xml-tag"><url></span>http://repository.jboss.org/nexus/content/groups/public/<span class="jive-xml-tag"></url></span>
                        <span class="jive-xml-tag"></pluginRepository></span>
                        <span class="jive-xml-tag"><pluginRepository></span>
                                <span class="jive-xml-tag"><id></span>jboss-snapshots-repository<span class="jive-xml-tag"></id></span>
                                <span class="jive-xml-tag"><name></span>JBoss Snapshots Repository<span class="jive-xml-tag"></name></span>
                                <span class="jive-xml-tag"><url></span>https://repository.jboss.org/nexus/content/repositories/snapshots/<span class="jive-xml-tag"></url></span>
                        <span class="jive-xml-tag"></pluginRepository></span>
                <span class="jive-xml-tag"></pluginRepositories></span>
        <span class="jive-xml-tag"></profile></span>
    <span class="jive-xml-tag"></profiles></span>
    <span class="jive-xml-tag"><activeProfiles></span>
        <span class="jive-xml-tag"><activeProfile></span>jboss-default<span class="jive-xml-tag"></activeProfile></span>
        ...
    <span class="jive-xml-tag"></activeProfiles></span>
<span class="jive-xml-tag"></settings></span>
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><em><strong>My build is failing due to OutOfMemory or PermGen issues! How do I give Maven more memory?</strong></em></span></p><p style="text-align: start;"><span style="font-size: 12pt;"><em><strong><br/></strong></em></span></p><ul><li style="text-align: start;">To configure the amount of memory used by Maven, you can define MVN_OPTS as follows, either in the mvn / mvn.bat script you use to run Maven, or set as global environment variables. Here's how to do so for <a class="jive-link-external-small" href="http://forums.fedoraforum.org/showthread.php?t=262465" rel="nofollow">Fedora</a>, <a class="jive-link-external-small" href="https://help.ubuntu.com/community/EnvironmentVariables" rel="nofollow">Ubuntu</a>, <a class="jive-link-external-small" href="http://forums.techarena.in/windows-xp-support/1152405.htm" rel="nofollow">Windows</a>, <a class="jive-link-external-small" href="http://www.digitaledgesw.com/node/31" rel="nofollow">OSX</a>.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive_text_macro jive_macro_wiki"><p style="padding-left: 30px;"><span style="font-family: courier new,courier;">set MAVEN_OPTS=-Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m</span></p></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="text-align: start;"><span style="font-size: 12pt;"><em><strong>How do I build via commandline?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ol><li style="text-align: start;"><span style="font-size: 10pt;">Fetch code from github</span></li><li style="text-align: start;"><span style="font-size: 10pt;">Run maven</span></li><li style="text-align: start;"><span style="font-size: 10pt;">Repeat for other projects<br/></span></li></ol><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="text-align: start; padding-left: 30px;"><span style="font-size: 10pt; font-family: courier new,courier;">cd ~/jbosstools</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;"><span style="font-size: 10pt;">git clone </span><a class="jive-link-external-small" href="https://github.com/jbosstools/jbosstools-base" target="_blank">https://github.com/jbosstools/jbosstools-base</a></span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">cd ~/jbosstools/jbosstools-base</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">mvn verify</span></p><p style="text-align: start;"><span style="font-size: 12pt;"><br/></span><span style="font-size: 12pt;"><em><strong>How do I build in Eclipse (with m2e)?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span><span style="font-size: 10pt;">To be written</span><em><strong><br/></strong></em></span></li></ul><p><span style="font-size: 12pt;"></span><span style="font-size: 12pt;"><em><strong>How do I build a single project?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span style="font-size: 10pt;">Generally, you need only fetch the sources, and run `mvn verify`. See 'How do I build via commandline?' or 'How do I build in Eclipse (with m2e)?' above.</span></li></ul><p><span style="font-size: 12pt;"><em><strong><br/></strong></em></span></p><p><span style="font-size: 12pt;"><em><strong>How do I build a series of projects (eg., Base, Server, Webservices) ?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span style="font-size: 10pt;">Assuming your goal is to change sources in <strong>multiple</strong> projects, then build them all to verify everything still compiles, you will need to fetch sources, then build the projects in dependency order.</span></li><li style="text-align: start;"><span style="font-size: 10pt;">This workflow is useful when you're looking to change framework code in an upstream project like Base on which Webservices or Server depends, and verify that API changes don't break the downstream project's code.</span></li><li style="text-align: start;"><span style="font-size: 10pt;">Rather than using `<span style="font-family: courier new,courier;">mvn verify</span>`, you must use `<span style="font-family: courier new,courier;"><strong>mvn install</strong></span>` so that the downstream build will use YOUR locally-built content in your ~/.m2, rather than looking to the internet for the last published upstream dependencies.<br/></span><span style="font-size: 10pt;"><br/></span></li></ul><p style="text-align: start; padding-left: 30px;"><span style="font-size: 10pt; font-family: courier new,courier;">cd ~/jbosstools</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;"><span style="font-size: 10pt;">git clone </span><a class="jive-link-external-small" href="https://github.com/jbosstools/jbosstools-base" target="_blank">https://github.com/jbosstools/jbosstools-base</a></span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;"><span style="font-size: 10pt;">git clone </span><a class="jive-link-external-small" href="https://github.com/jbosstools/jbosstools-server" target="_blank">https://github.com/jbosstools/jbosstools-server</a></span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;"><span style="font-size: 10pt;">git clone </span><a class="jive-link-external-small" href="https://github.com/jbosstools/jbosstools-webservices" target="_blank">https://github.com/jbosstools/jbosstools-webservices</a></span></p><p style="padding-left: 30px;"><span style="font-family: courier new,courier;">cd ~/jbosstools/jbosstools-base; </span><span style="font-family: courier new,courier;">mvn install</span></p><p style="padding-left: 30px;"><span style="font-family: courier new,courier;">cd ~/jbosstools/jbosstools-server; </span><span style="font-family: courier new,courier;">mvn install</span></p><p style="padding-left: 30px;"><span style="font-family: courier new,courier;">cd ~/jbosstools/jbosstools-webservices; </span><span style="font-family: courier new,courier;">mvn verify</span></p><p><span style="font-family: courier new,courier;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>Which is better - `mvn clean install` or `mvn verify` ?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span style="font-size: 10pt;">Use `<strong style="font-family: courier new,courier;">install</strong>` to create artifacts in your ~/.m2 folder which will be checked when building anything which depends on those artifacts (in addition to checking the internet). Also useful for doing subsequent offline builds with the `<span style="font-family: courier new,courier;"><strong>-o</strong></span>` or `<strong style="font-family: courier new,courier;">--offline</strong>` flag.</span></li><li style="text-align: start;"><span style="font-size: 10pt;">Use `<strong style="font-family: courier new,courier;">verify</strong>` to build, but NOT install anything into your ~/.m2 folder.</span></li></ul><p style="text-align: start;"><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>How do I clean out artifacts I might have installed to my ~/.m2/repo ?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><em><strong>What if I've already built something locally, but I want to build against the server version instead of my local repo?</strong></em></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;">There are <a class="jive-link-external-small" href="http://wiki.eclipse.org/Tycho/Target_Platform#Locally_built_artifacts" rel="nofollow">two approaches</a> that work here:</li></ul><ol><ol><li style="text-align: start;">override temporarily when building, using <tt><strong style="font-family: courier new,courier;">-Dtycho.localArtifacts=ignore</strong><span style="font-family: arial,helvetica,sans-serif;">, or</span></tt></li><li style="text-align: start;">delete <strong style="font-family: courier new,courier;"><tt>~/.m2/repository/.meta/p2-local-metadata.properties</tt></strong></li></ol></ol><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><em><strong>How do I build a target platform?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span style="font-size: 10pt;">Currently, you should not need to build a target platform locally if you're building w/ maven via commandline. But if you'd like to materialize a target platform for use in Eclipse, you can do so like this:</span></li></ul><p style="text-align: start;"><span style="font-size: 10pt;"><br/></span></p><ol><li style="text-align: start;">Fetch target platforms project from github</li><li style="text-align: start;">Switch to the correct branch</li><li style="text-align: start;">Run maven</li><li style="text-align: start;">Results will be in jbosstools/multiple/target/jbosstools-multiple.target.repo/ or jbdevstudio/multiple/target/jbdevstudio-multiple.target.repo/</li></ol><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="text-align: start; padding-left: 30px;"><span style="font-size: 10pt; font-family: courier new,courier;">cd ~/jbosstools</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;"><span>git clone </span><a class="jive-link-external-small" href="https://github.com/jbosstools/jbosstools-target-platforms" target="_blank">https://github.com/jbosstools/jbosstools-target-platforms</a></span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">cd ~/jbosstools/jbosstools-target-platforms</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">git checkout 4.3.0</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">mvn install</span></p><p style="text-align: start; padding-left: 30px;"><span style="font-family: courier new,courier;">cd </span><span style="font-family: courier new,courier;">~/jbosstools/jbosstools-target-platforms/jbosstools/multiple/target/jbosstools-multiple.target.repo/</span></p><p><span style="font-size: 12pt;"><em><strong><br/></strong></em></span></p><p><span style="font-size: 12pt;"><em><strong>Why is there more than one target platform?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;">Every time we make changes to the target platform, either to add/remove something, or to change the included version, we release a new version. </li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;">In order to verify we can build against the oldest version of a target platform (eg., one based on Eclipse 4.2.0, or "minimum" target platform) but also run tests against the latest for that stream (eg., based on Eclipse 4.2.2, or "maximum" target platform), we need to maintain multiple versions.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;">By default, your build will use the default "minimum" target platform specified in the JBoss Tools parent pom. To easily build against the default "maximum", use <span style="font-family: courier new,courier;"><strong>-Pmaximum</strong></span>. See also <span style="font-size: 10pt;">'What profiles do I need to build? What Maven properties are useful when building?'</span></li></ul><p><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>How do I specify which target platform to use when building?</strong></em></span></p><ul><li style="text-align: start;">See <span style="font-size: 10pt;">'What profiles do I need to build? What Maven properties are useful when building?'</span></li></ul><p><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>How to I skip running  tests? How do I make tests not fail? Or only fail after ALL tests run?<br/></strong></em></span></p><p><span style="font-size: 12pt;"><em><strong><br/></strong></em></span></p><ul><li style="text-align: start;">To skip running tests, you can use these Maven flags:<ul><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-Dmaven.test.skip=true </strong></span></li><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-DskipTests</strong></span></li></ul></li><li style="text-align: start;">If your reason for skipping tests is to see if everything can run without being stuck on the first test failure, you might also like these flags:<ul><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-fae</strong></span>, <span style="font-family: courier new,courier;"><strong>--fail-at-end</strong></span> : Fail at end of build only</li><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-fn</strong></span>, <span style="font-family: courier new,courier;"><strong>--fail-never</strong></span> : Never fail the build regardless of result</li></ul></li><li style="text-align: start;">You can also cause test failures to result in JUnit output without failing the build using these flags:<ul><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-Dmaven.test.error.ignore=true</strong></span></li><li style="text-align: start;"><span style="font-family: courier new,courier;"><strong>-Dmaven.test.failure.ignore=true</strong></span></li></ul></li></ul><p><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>How can I debug tests in Eclipse when run from Tycho (with Surefire)?</strong></em></span></p><ul><li style="text-align: start;">See <a class="jive-link-external-small" href="http://www.jboss.org/tools/docs/testing.html">http://www.jboss.org/tools/docs/testing.html</a></li></ul><p><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>How do I build docs?</strong></em></span></p><ul><li>See <a class="jive-link-wiki-small" href="https://community.jboss.org/docs/DOC-13341">Building JBoss Tools Documentation</a>.</li></ul><p><span style="font-size: 10pt;"><br/></span></p><p><span style="font-size: 12pt;"><em><strong>What profiles do I need to build? What Maven properties are useful when building?<br/></strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li><span style="font-size: 10pt;">Most of the time, you don't need any profiles or -D properties. Here are some profiles and properties you might want to use in special cases.</span></li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><ul><li><span style="font-size: 10pt;"><span style="font-family: courier new,courier;"><strong>-Pmaximum</strong></span> : selects the default maximum target platform version instead of the default minimum one. Useful when running tests to verify that your code works against a newer target platform (eg., Eclipse 4.2.2 instead of 4.2.0)</span></li><li><span><span style="font-family: courier new,courier;"><strong>-DTARGET_PLATFORM_VERSION</strong></span> : allows you to pick a specific target platform version from those available in Nexus. </span></li></ul></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li><span style="font-size: 10pt;">See also 'How to I skip running  tests? How do I make tests not fail? Or only fail after ALL tests run?' above for test-related properties.</span></li></ul><p><span><em><strong><br/></strong></em></span><span style="font-size: 12pt;"><em><strong>Anything else?</strong></em></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li style="text-align: start;"><span style="font-size: 10pt;">See also this FAQ: </span><a class="" href="https://community.jboss.org/docs/DOC-10796">https://community.jboss.org/wiki/JBossToolsFAQ</a></li></ul><p><span style="font-size: 14pt;"><em><strong><br/></strong></em></span></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="https://community.jboss.org/docs/DOC-48358">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Tools Development at <a href="https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2129">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>