Project

General

Profile

Step 2 - Install and run in 5 minutes » History » Version 47

Henning Blohm, 23.04.2019 00:16

1 22 Henning Blohm
h1. Install and run Z2 in 5 minutes
2 1 Udo Offermann
3 18 Udo Offermann
[[Step_1_-_What_is_z2|« Step 1 - What is z2]]
4 1 Udo Offermann
5
h2. Prerequisites
6
7 41 Henning Blohm
{{include(Java Version Requirements)}}
8 1 Udo Offermann
9 42 Henning Blohm
It is beneficial to use the Eclipse IDE (Ganymed, Helios, Indigo, Kepler work all fine). There's a small Eclipse plug-in called "Eclipsoid" which makes it easier to develop z2 applications within Eclipse (see [[Step 3 - First steps with Z2 on Git]] for more details). That plugin is also available for Intellij. However you can use any IDE (including vi and notepad) together with z2.
10 1 Udo Offermann
11 28 Udo Offermann
h2. Creating a _home_ for Z2
12 1 Udo Offermann
13 28 Udo Offermann
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.
14 1 Udo Offermann
15
Create a folder called z2-base inside your favorite/home/development/what-ever directory and enter it:
16
17 43 Henning Blohm
<pre><code class="bash">
18 42 Henning Blohm
mkdir z2-base
19
cd z2-base
20
</code></pre>
21 1 Udo Offermann
22 42 Henning Blohm
h2. Installing the z2-base Distribution
23 1 Udo Offermann
24 42 Henning Blohm
The fastest way to start with z2 is by installing the z2-base distribution that contains the z2-core and complete copy of the z2-base.base component repository in one installable archive and requires no access to remote repositories (see also [[How_to_create_your_own_system]] for more details).
25 34 Henning Blohm
26 42 Henning Blohm
In order to install, "download":https://redmine.z2-environment.net/projects/z2-environment/files from the web site and unpackage. 
27 38 Henning Blohm
28 47 Henning Blohm
{{include(Install z2-base-v27)}}
29 38 Henning Blohm
30 1 Udo Offermann
h2. Starting
31 38 Henning Blohm
32 46 Henning Blohm
Make sure to have a Java Development Kit (JDK) or a Java Runtime Environment of version 9 or later installed and executable. Test this by running
33 38 Henning Blohm
34 43 Henning Blohm
<pre><code class="bash">
35 1 Udo Offermann
java -version
36 42 Henning Blohm
</code></pre>
37 35 Henning Blohm
38 46 Henning Blohm
{{include(Install_sample_postfix)}}
39 1 Udo Offermann
40 42 Henning Blohm
That's it.
41 20 Henning Blohm
42 42 Henning Blohm
h2. What's Next
43
44
This tutorial will continue by showing you how to develop with Z2. If you ask yourself how to add remote repositories, please check out  [[How_to_create_your_own_system]].
45
46 27 Udo Offermann
47 39 Henning Blohm
* [[Step 3 - First steps with Z2 on Git|&raquo; Step 3 - First steps with Z2 on Git]]