z2-Environment

h1. How to Run a Sample

Various z2-based sample system configurations have been prepared as Git repositories. 

You can run these samples with very few manual steps in a local environment. This How-To describes what you need to do.

h2. 0. Pre-Requisites

All you need is Java Runtime Environment (JRE) of at least version 6. Preferrably, as that is easier to understand a sample, have the Eclipse IDE installed.

h2. 1. Prepare a z2-base Installation

Create a folder to hold the installation. We will assume that folder is called *sample*

In *sample* execute

<pre>

git clone http://git.z2-environment.net/z2-base.core

</pre>

Go into *sample/z2-base.core/run/bin* and run 

<pre>

./gui.sh

</pre>

or 

<pre>

gui.bat

</pre>

depending on your operating system. A simple graphical console should open up that displays the console log output of the z2 <home> and worker processes.

At the first start, the environment will download required resources, which may take a few minutes - depending on your network bandwidth. Subsequent starts will be faster.

Eventually the server should be up and you can go to the basic admin view at http://localhost:8080/adm (use z* with password z) to verify everything is cool.

h2. 2. Clone the specific sample repository