Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 62.1
edited by Ramsey Gurley
on 2015/04/30 21:14
Change comment: There is no comment for this version
To version 64.1
edited by Lachlan Deck
on 2016/01/13 14:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ramsey
1 +XWiki.ldeck
Content
... ... @@ -1,34 +1,60 @@
1 1  == Outline ==
2 2  
3 +== Step 0: Install latest Java ==
4 +
5 +If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
6 +
3 3  == Step 1: Installing Maven ==
4 4  
5 -Downloading and installing the latest version of [[Maven>>url:http://maven.apache.org/download||shape="rect"]] is the first step to start using this tool.
9 +Downloading and installing the latest version of [[Maven>>url:https://maven.apache.org/download.cgi||shape="rect"]] is the first step to start using this tool via one of the following approaches.
6 6  
7 -{{tip title="Mac Tip"}}
8 -install macports [[http:~~/~~/www.macports.org/install.php>>url:http://www.macports.org/install.php||shape="rect"]], then on the terminal:
11 +(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install:
9 9  
10 -{{noformat}}
11 -sudo port install maven3
13 +{{code title="MacPorts usage" theme="Emacs" language="bash"}}
14 +$ sudo port install maven3
15 +{{/code}}
12 12  
13 -{{/noformat}}
17 +(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
14 14  
15 -In future, to keep this up to date:
19 +{{code title="Homebrew usage" theme="Emacs" language="bash"}}
20 +$ brew install maven
21 +{{/code}}
16 16  
17 -{{noformat}}
18 -sudo port upgrade maven3
23 +(c) Or manually by downloading the binary tarball, copying it to /usr/local/, unpacking it, soft linking it and adding the path to your bash_profile:
19 19  
20 -{{/noformat}}
25 +{{code title="Manual install" theme="Emacs" language="bash"}}
26 +$ sudo su
27 +$ cd /usr/local/
28 +$ curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
29 +$ tar -xzf apache-maven-3.3.3-bin.tar.gz
30 +$ ln -s apache-maven-3.3.3 apache-maven
31 +$ exit
32 +$ cd ~/
33 +$ vi .bash_profile
34 +{{/code}}
21 21  
22 -Don't forget to install maven_select:
36 +Then in your bash profile, ensure your path and java home are updated:
23 23  
24 -{{noformat}}
25 -sudo port install maven_select
38 +{{code title="~~/.bash_profile" theme="Emacs" linenumbers="true" language="text"}}
39 +...
40 +export PATH=/usr/local/apache-maven/bin:$PATH
41 +export JAVA_HOME=$(/usr/libexec/java_home)
42 +...
43 +{{/code}}
26 26  
27 -{{/noformat}}
28 -{{/tip}}
45 +
29 29  
30 -**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
47 +Whichever installation approach you've taken, you should now be able to do
31 31  
49 +$ mvn -version
50 +
51 +**NOTE 1**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
52 +
53 +**NOTE 2**: You might also like to install bash completion utilities:
54 +
55 +* See this superuser answer for bash-completion installation: ([[http:~~/~~/superuser.com/questions/288438/bash-completion-for-commands-in-mac-os-x>>url:http://superuser.com/questions/288438/bash-completion-for-commands-in-mac-os-x||shape="rect"]]).
56 +* See also the following github repo for maven-bash-completion: ([[https:~~/~~/github.com/juven/maven-bash-completion>>url:https://github.com/juven/maven-bash-completion||shape="rect"]]).
57 +
32 32  == Step 2: Configuring your Maven Settings ==
33 33  
34 34  Advanced users can skip this step, but it's highly recommended.
... ... @@ -37,6 +37,8 @@
37 37  
38 38  **NOTE for those who know what to do**: You can download the complete and most recent settings.xml [[here>>attach:settings.xml]] and install it to ~~/.m2/settings.xml.
39 39  
66 +Download the [[archetype-catalog.xml>>url:http://maven.wocommunity.org/content/groups/public/archetype-catalog.xml||shape="rect"]] and copy it to ~~/.m2/archetype-catalog.xml
67 +
40 40  See [[Maven Settings Reference>>url:http://maven.apache.org/settings.html||shape="rect"]] if you want more information about additional options for the settings.xml file.
41 41  
42 42  == Step 3: Installing WebObjects Libraries ==