Project

General

Profile

Step 2 - How to install z2 old » History » Version 3

Redmine Admin, 25.07.2012 14:43

1 1 Redmine Admin
h1. How to install z2
2
3
[[What_is_z2|prev]] :: [[Wiki|home]] :: [[First_steps_with_z2|next]]
4
5
h2. How to install z2-environment
6
7
Installation of the z2-environment is very easy. We tested the installation on Linux, Mac OS X and Windows Vista.
8
9
h2. Prerequisites
10
11 2 Redmine Admin
You need a properly setup JDK 6 - that's all. 
12 1 Redmine Admin
A halfway modern system will do. 
13
14 3 Redmine Admin
It is benefical to use the Eclipse IDE (Ganymed, Helios or Indigo work all fine). There's a small Eclipse plugin called "Eclipsoid" which makes it easier to develop z2 applications within Eclipse (see [[First steps with z2]] for more details). However you can use any IDE (including vi and notepad) together with z2.
15 1 Redmine Admin
16
h2. Creating a _home_ for z2
17
18
This is a best practice approach (and other approaches are possible). We recommend to keep the repositories and the IDE workspace close together. This way we don't need to adjust the path settings in the z2 configuration files and they can remain relative paths.
19
20
Create a folder called z2_base inside your favorite/home/development/what-ever directory and enter it:
21
22
    ~/dev$ mkdir z2_base
23
    ~/dev$ cd z2_base
24
25
h2. Cloning the sources
26
27 3 Redmine Admin
As described in [[What_is_z2]] the z2_base project contains several repositories. 
28
You start always with the _core_ repository:
29 1 Redmine Admin
30 3 Redmine Admin
    ~/dev/z2_base$ git clone http://git.z2-environment.net/z2-base.core
31 1 Redmine Admin
    Cloning into core...
32
    ~/dev/z2_base$
33
34
The newly created core folder contains a _gitsetup_ script file for unix like OSes and Windows. This script clones the remaining repositories beside the core and creates a folder called "workspace" that you can use as the Eclipse-workspace folder. So on Linux and MacOS X you run
35
36 3 Redmine Admin
    ~/dev/z2_base$ cd z2-base.core
37 1 Redmine Admin
    ~/dev/z2_base/core$ ./gitsetup.sh
38 3 Redmine Admin
    Cloning/Updating the following repos: [core base samples tools] from http://git.z2-environment.net/z2-base
39
    Cloning http://git.z2-environment.net/z2-base.core (branch=v2.0)
40 1 Redmine Admin
    Cloning into base...
41 3 Redmine Admin
    Cloning http://git.z2-environment.net/z2-base.base (branch=v2.0)
42 1 Redmine Admin
    Cloning into samples...
43 3 Redmine Admin
    Cloning http://git.z2-environment.net/z2-base.samples (branch=v2.0)
44 1 Redmine Admin
    Cloning into tools...
45
    done
46
    
47
On Windows you run `gitsetup.bat` instead of `./gitsetup.sh`; this takes a minute (depending on your internet access).
48
49
h2. Start the z2-environment
50
51
If you have setup JDK 6 properly you can start the z2-environment right away:
52
53
    ~/dev/z2_base/core$ cd run/bin
54
    ~/dev/z2_base/core$ ./go.sh
55
56
Or on windows `cd \run\bin` and then `go.bat`. You will see something like this:
57
58
    07/26 13:43:19 [1]...hers.HomeLauncher[800]: Z2 Home Launcher, (c) ZFabrik Software KG 2010, 2011
59
    07/26 13:43:19 [1]...ProcessRunnerImpl[800]: Running core build 201107181235 as udoo in z2 home /Users/udoo/dev/git/z2_b/core/run/bin/../.., timezone Europe/Berlin, language de, region null
60
    07/26 13:43:19 [1]...ProcessRunnerImpl[800]: Using VM v1.6.0_26 by Apple Inc. at /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home on Mac OS X (arch: 10.6.8)
61
62
    ...
63
64
    07/26 13:43:27 [22]...nment/webWorker.2[800]: 2011-07-26 13:43:27.949:INFO::jetty-6.1.22
65
    07/26 13:43:27 [22]...nment/webWorker.2[800]: 2011-07-26 13:43:27.977:INFO::Started SelectChannelConnector@0.0.0.0:8080
66
    
67
    ...
68
69
    07/26 13:43:33 [1]...hers.HomeLauncher[800]: Completed home process initialization
70
71
    press (q)uit, (c)omponents, (f)oundation props, (s)ystem props, s(y)nc repo, (v)erify, (g)c:>
72
73
This means the z2-environment is up and running and excepting requests on localhost port 8080.  
74
75
[[What_is_z2|prev]] :: [[Wiki|home]] :: [[First_steps_with_z2|next]]