Changes for page Quick Start

Summary

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

Details

Page properties

Author

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

Content

...	...	@@ -1,38 +1,82 @@
1		-== Outline ==
	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"]])
2	2
3		-== Step 0: Install latest Java ==
	4	+**Steps 0-2** (as elaborated below)
4	4
5		-If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
	6	+0. Install Java 8
	7	+~1. Install Maven 3
	8	+2. Update ~~/.m2/settings.xml to include the wocommunity repo
6	6
	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 via Help > Install New Software.... (See [[http:~~/~~/www.eclipse.org/m2e/>>url:http://www.eclipse.org/m2e/||shape="rect"]])
	14	+5. Install [[doc: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	+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	+
7	7	== Step 1: Installing Maven ==
8	8
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:
	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.
10	10
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
	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
20	20	{{/code}}
21	21
22		-Then in your bash profile, make your path look something like:
	39	+(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
23	23
24		-export PATH=/usr/local/apache-maven/bin:$PATH
	41	+{{code title="Homebrew usage" theme="Emacs" language="bash"}}
	42	+$ brew install maven
	43	+{{/code}}
25	25
26		-And tell maven where your non-mac Java home is located
	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:
27	27
	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
28	28	export JAVA_HOME=$(/usr/libexec/java_home)
	64	+...
	65	+{{/code}}
29	29
30		-You should now be able to do
	67	+
31	31
32		-mvn -version
	69	+Whichever installation approach you've taken, you should now be able to do
33	33
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.
	71	+$ mvn -version
35	35
	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	+
36	36	== Step 2: Configuring your Maven Settings ==
37	37
38	38	Advanced users can skip this step, but it's highly recommended.
...	...	@@ -41,6 +41,8 @@
41	41
42	42	**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.
43	43
	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	+
44	44	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.
45	45
46	46	== Step 3: Installing WebObjects Libraries ==