Step 2 - Install and run in 5 minutes » History » Revision 3
Revision 2 (Udo Offermann, 07.09.2012 11:48) → Revision 3/48 (Udo Offermann, 07.09.2012 15:17)
h1. How to install z2 v2.1 v21 [[What_is_z2|prev]] :: [[Wiki|home]] :: [[First_steps_with_z2_v21|next]] [[First_steps_with_z2|next]] h2. 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. h2. Prerequisites You need a properly setup JDK 6 - that's all. A halfway modern system will do. 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. h2. 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: <pre> :dev$ ~/dev$ mkdir z2-base :dev$ ~/dev$ cd z2-base </pre> h2. Cloning the sources As described in [[What_is_z2]] the z2-base project contains several repositories. You start always start with the _core_ repository. Create a clone from git.z2-environment.net which will checkout the "v2.1" branch automatically: repository: <pre> :z2-base$ ~/dev/z2-base$ git clone http://git.z2-environment.net/z2-base.core Cloning into core... :z2-base$ ~/dev/z2-base$ cd z2-base.core :z2-base.core$ git branch * v2.1 ~/dev/z2-base/z2-base.core$ </pre> That's all you need to do in order to install This will checkout the z2-environment and branch "v2.1" as you can run verify via @git branch@. *-------- TBC ------* ~/dev/z2_base$ cd z2-base.core ~/dev/z2_base/core$ ./gitsetup.sh Cloning/Updating the server right away if following repos: [core base samples tools] from http://git.z2-environment.net/z2-base Cloning http://git.z2-environment.net/z2-base.core (branch=v2.0) Cloning into base... Cloning http://git.z2-environment.net/z2-base.base (branch=v2.0) Cloning into samples... Cloning http://git.z2-environment.net/z2-base.samples (branch=v2.0) Cloning into tools... done On Windows you have setup JDK 6 properly. run `gitsetup.bat` instead of `./gitsetup.sh`; this takes a minute (depending on your internet access). h2. Start the z2-environment The start scripts are located inside @run/bin@. On a desktop If you can use the gui version called @gui.sh@ (resp. @gui.bat@ on Windows). Otherwise have setup JDK 6 properly you can use start the terminal based version @go.sh@ (resp. @go.bat@ on Windows). <pre> :z2-base.core$ z2-environment right away: ~/dev/z2_base/core$ cd run/bin :z2-base.core$ ./gui.sh ~/dev/z2_base/core$ ./go.sh Or on windows `cd \run\bin` and then `go.bat`. You will see something like this: Listening for transport dt_socket at address: 5000 09/07 15:10:24 07/26 13:43:19 [1]...hers.HomeLauncher[800]: Z2 Home Launcher, (c) ZFabrik Software KG 2010, 2011, 2012 09/07 15:10:24 2011 07/26 13:43:19 [1]...ProcessRunnerImpl[800]: Running core build 201208241554 201107181235 as udoo in z2 home /Users/udoo/dev/temp/z2-base-v2.1/z2-base.core/run/bin/../.., /Users/udoo/dev/git/z2_b/core/run/bin/../.., timezone Europe/Berlin, language de, region null 09/07 15:10:24 07/26 13:43:19 [1]...ProcessRunnerImpl[800]: Using VM v1.6.0_33 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) 09/07 15:10:24 [1]...ProcessRunnerImpl[800]: ************************************ 09/07 15:10:24 [1]...ProcessRunnerImpl[800]: *** Running in DEVELOPMENT mode! *** 09/07 15:10:24 [1]...ProcessRunnerImpl[800]: ************************************ 09/07 15:10:24 [1]...entRepositoryImpl[800]: Using GitCR com.zfabrik.boot.config/systemRepository (origin=http://git.z2-environment.net/z2-base.base, branch=master) com.zfabrik.impl.gitcr.GitComponentRepositoryImpl@75787005,repo:246d0e3e, component:com.zfabrik.boot.config/systemRepository, prio:500, checkDepth:1073741823, fileSystem:com.zfabrik.components.provider.fs.FileSystemImpl@36029483, root:/Users/udoo/dev/temp/z2-base-v2.1/z2-base.core/run/bin/../../work/repos/246d0e3e/git 09/07 15:10:24 [1]...entRepositoryImpl[800]: Cloning GitCR com.zfabrik.boot.config/systemRepository (origin=http://git.z2-environment.net/z2-base.base, branch=master) . This will take some seconds... ... 07/26 13:43:27 [22]...nment/webWorker.2[800]: 2011-07-26 13:43:27.949:INFO::jetty-6.1.22 09/07 15:10:58 [30]...ent/webWorker@0.1[800]: Listening for transport dt_socket at address: 5100 ... 09/07 15:11:02 [30]...ent/webWorker@0.1[800]: INFO org.eclipse.jetty.server.AbstractConnector - Started 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 ... 09/07 15:11:09 [1]...stemStateResource[800]: System state attained: com.zfabrik.boot.main/home_up 09/07 15:11:09 07/26 13:43:33 [1]...hers.HomeLauncher[800]: Completed home process initialization </pre> 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. [[What_is_z2|prev]] :: [[Wiki|home]] :: [[First_steps_with_z2_v21|next]] [[First_steps_with_z2|next]]