Changes for page Quick Start

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.ldeck
	1	+XWiki.ramsey

Content

...	...	@@ -1,82 +1,38 @@
1		-{{tip title="2016 QuickStart"}}
2		-See ([[http:~~/~~/lists.apple.com/archives/webobjects-dev/2016/Jan/msg00045.html>>url:http://lists.apple.com/archives/webobjects-dev/2016/Jan/msg00045.html||shape="rect"]])
	1	+== Outline ==
3	3
4		-**Steps 0-2** (as elaborated below)
	3	+== Step 0: Install latest Java ==
5	5
6		-0. Install Java 8
7		-~1. Install Maven 3
8		-2. Update ~~/.m2/settings.xml to include the wocommunity repo
	5	+If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
9	9
10		-**Steps 3–6**
11		-
12		-3. Install Eclipse 4.5 for Committers ([[http:~~/~~/www.eclipse.org/downloads/>>url:http://www.eclipse.org/downloads/||shape="rect"]])
13		-4. Install m2e (Help > Install New Software...)
14		-5. Install WOLips
15		-6. Preferences > Maven > Archetypes, Add Remote Catalog
16		- [[http:~~/~~/maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml>>url:http://maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml||shape="rect"]]
17		-
18		-[[url:http://maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml||shape="rect"]]Done. The WebObjects jars are in the wocommunity repo, so no need to do woinstaller.jar hassle.
19		-{{/tip}}
20		-
21		-----
22		-
23		-(% style="color: rgb(0,0,0);font-size: 24.0px;" %)Detailed Instructions...
24		-
25		-(% style="color: rgb(0,0,0);font-size: 20.0px;" %)Step 0: Install latest Java
26		-
27		-If you're on a Mac, it's using old and busted Java 6. Update that to Java 8 ([[http:~~/~~/www.oracle.com/technetwork/java/javase/downloads/index.html>>url:http://www.oracle.com/technetwork/java/javase/downloads/index.html||shape="rect"]]).
28		-
29	29	== Step 1: Installing Maven ==
30	30
31		-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.
	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. Download the binary tarball, copy it to /usr/local/, unpack it, soft link it and add the path to your bash_profile:
32	32
33		-(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install:
34		-
35		-{{code title="MacPorts usage" theme="Emacs" language="bash"}}
36		-$ sudo port install maven3
	11	+{{code title="shell"}}
	12	+sudo su
	13	+cd /usr/local/
	14	+curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
	15	+tar -xzf apache-maven-3.3.3-bin.tar.gz
	16	+ln -s apache-maven-3.3.3 apache-maven
	17	+exit
	18	+cd ~/
	19	+vi .bash_profile
37	37	{{/code}}
38	38
39		-(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
	22	+Then in your bash profile, make your path look something like:
40	40
41		-{{code title="Homebrew usage" theme="Emacs" language="bash"}}
42		-$ brew install maven
43		-{{/code}}
	24	+export PATH=/usr/local/apache-maven/bin:$PATH
44	44
45		-(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:
	26	+And tell maven where your non-mac Java home is located
46	46
47		-{{code title="Manual install" theme="Emacs" language="bash"}}
48		-$ sudo su
49		-$ cd /usr/local/
50		-$ curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
51		-$ tar -xzf apache-maven-3.3.3-bin.tar.gz
52		-$ ln -s apache-maven-3.3.3 apache-maven
53		-$ exit
54		-$ cd ~/
55		-$ vi .bash_profile
56		-{{/code}}
57		-
58		-Then in your bash profile, ensure your path and java home are updated:
59		-
60		-{{code title="~~/.bash_profile" theme="Emacs" linenumbers="true" language="text"}}
61		-...
62		-export PATH=/usr/local/apache-maven/bin:$PATH
63	63	export JAVA_HOME=$(/usr/libexec/java_home)
64		-...
65		-{{/code}}
66	66
67		-
	30	+You should now be able to do
68	68
69		-Whichever installation approach you've taken, you should now be able to do
	32	+mvn -version
70	70
71		-$ mvn -version
	34	+**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
72	72
73		-**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.
74		-
75		-**NOTE 2**: You might also like to install bash completion utilities:
76		-
77		-* 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"]]).
78		-* 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"]]).
79		-
80	80	== Step 2: Configuring your Maven Settings ==
81	81
82	82	Advanced users can skip this step, but it's highly recommended.
...	...	@@ -85,8 +85,6 @@
85	85
86	86	**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.
87	87
88		-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
89		-
90	90	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.
91	91
92	92	== Step 3: Installing WebObjects Libraries ==