How to install z2¶

prev :: home :: next

How to install z2-environment¶

Installation of the z2-environment is very easy. We tested the installation on Linux, Mac OS X and Windows Vista.

Prerequisites¶

You need a a properly setup JDK 6 - that's all.
A halfway modern system will do.

It is benefical to use the Eclipse IDE (the Ganymed or Helios versions are ok). 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.

Creating a home for z2¶

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.

Create a folder called z2_base inside your favorite/home/development/what-ever directory and enter it:

~/dev$ mkdir z2_base
    ~/dev$ cd z2_base

Cloning the sources¶

As described in [What_is_z2](What_is_z2) the z2_base project on gitorious.org contains several repositories.
You start always with the core.git repository:

~/dev/z2_base$ git clone https://git.gitorious.org/z2_base/core.git
    Cloning into core...
    ~/dev/z2_base$

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

~/dev/z2_base$ cd core
    ~/dev/z2_base/core$ ./gitsetup.sh
    Cloning/Updating the following repos: [base samples tools] from https://git.gitorious.org/z2_base
    Cloning https://git.gitorious.org/z2_base/base.git
    Cloning into base...
    Cloning https://git.gitorious.org/z2_base/samples.git
    Cloning into samples...
    Cloning https://git.gitorious.org/z2_base/tools.git
    Cloning into tools...
    done

On Windows you run `gitsetup.bat` instead of `./gitsetup.sh`; this takes a minute (depending on your internet access).

Start the z2-environment¶

If you have setup JDK 6 properly you can start the z2-environment right away:

~/dev/z2_base/core$ cd run/bin
    ~/dev/z2_base/core$ ./go.sh

Or on windows `cd \run\bin` and then `go.bat`. You will see something like this:

07/26 13:43:19 [1]...hers.HomeLauncher[800]: Z2 Home Launcher, (c) ZFabrik Software KG 2010, 2011
    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
    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)

...

07/26 13:43:27 [22]...nment/webWorker.2[800]: 2011-07-26 13:43:27.949:INFO::jetty-6.1.22
    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

...

07/26 13:43:33 [1]...hers.HomeLauncher[800]: Completed home process initialization

press (q)uit, (c)omponents, (f)oundation props, (s)ystem props, s(y)nc repo, (v)erify, (g)c:>

This means the z2-environment is up and running and excepting requests on localhost port 8080.

prev :: home :: next