Step 1 - What is z2 » History » Version 11

Henning Blohm, 11.09.2012 21:56

1 1 Redmine Admin
h1. What is z2
3 9 Henning Blohm
h2. What is the z2-Environment?
4 1 Redmine Admin
5 9 Henning Blohm
The z2-Environment is a Java runtime environment (server or embedded) that allows to develop and operate Java applications (e.g. Web applications) in a new and particularly easy and consistent way.
6 1 Redmine Admin
7 9 Henning Blohm
What's the difference compared to Java servers like Tomcat?
8 1 Redmine Admin
9 9 Henning Blohm
The z2-Environment is not yet another Java EE container but rather a life-cycle container for other containers (it does uses Jetty as Servlet engine for example). It represents a radically new approach to development and operation Java application by greatly reducing required infrastructure from development operations and by greatly reducing the efforts required from developers to roundtrip and integrate. 
10 1 Redmine Admin
11 11 Henning Blohm
h2. The main point
12 1 Redmine Admin
13 9 Henning Blohm
The main point of the z2-Environment (which is also the main difference compared to other Java environments) is that it is directly attached to Version Control System (VCS) repositories. The repositories (currently Subversion and Git are supported) is used to retrieve source code files, Web application resources, and any other required configuration files. Z2 has an intimate understanding of the module and component structure contained in these repositories and uses available change tracking means to identify changes and can update its runtime state as required. The z2-Environment's runtime state - as a principle - reflects the stored module configuration in connected repositories. We also call the system centric approach a _pull_ deployment approach as changes and updates are retrieved as required. That strongly contrasts the traditional _push_ approach found in typical Java application servers that leave consistent application of changes across deployables to you!
14 1 Redmine Admin
15 11 Henning Blohm
h2. Why _pull_ is better than _push_
16 1 Redmine Admin
19 10 Henning Blohm
# Pushing a an update may require to copy numerous deployables to a Java server. The question is often: What deployables and do you have the right versions? Pulling solves this problem, because all it needs is the trigger to scan the VCS for *all* changes committed by you and your co-developers. The combination of manual trigger plus automatic VCS scan is called a _z2 synchronization_.
20 9 Henning Blohm
# Pushing deployables includes serveral preparation steps: One has to compile source files, package results into deployable units (typically some .war or .ear ZIP archives) and finally to deploy to each node of the system. Z2 does not need these intermediate packaging steps as it understands the very same module structure of the very same VCS the developer is working on. There is actually no difference between how the developer accesses the VCS using an IDE and how z2 accesses it. 
# The push approach easily leads to a divergence between the projects the developer is working on in his IDE and the programs and resources running on the runtime environment (as there is no 1:1 mapping anymore).  As described above, z2 uses the very same module structure as the developer (modules typically correspond to IDE projects), so that there is a 1:1 mapping between the projects in the IDE and the modules considered by the runtime environment. 
22 1 Redmine Admin
23 11 Henning Blohm
h2. But isn't there something missing?
24 1 Redmine Admin
25 9 Henning Blohm
You might wonder where the Java sources are compiled into binaries. The VCS contains only sources (apart from pre-compiled 3rd party .jar archives) and there is no build/make/deploy, so how does the JVM get its byte code to run?
26 1 Redmine Admin
27 9 Henning Blohm
Z2 compiles the sources on the fly (and on demand). The approach is similar to how Java servers handle JSPs for more than a decade now. Compilation, in particular at runtime when dependency code is typically already available in memory, has become amazingly fast and not causing noticable delays. Z2 uses the proven Eclipse Java Compiler. As z2 does not need to package resources into .war files or .ear files, time spent on ZIPping and unZIPping can be saved. Sources will only be compiled if required by changes.
28 1 Redmine Admin
29 9 Henning Blohm
Compiling in the execution environment is not a problem, rather a solution to cut short the tool chain (as an additional benefit,  sources are always compiled with the same JVM version the runtime is using).
30 1 Redmine Admin
31 11 Henning Blohm
h2. Looking a level deeper
32 1 Redmine Admin
33 10 Henning Blohm
As said above, Z2 uses the same module structure as what developers see as projects. On a next deeper level, Z2 organizes modules into _components_. Components, from a Z2 perspective is anything that has a managed life cycle by Z2. It is the smallest granularity of preparation for or removal from the system.
34 1 Redmine Admin
35 10 Henning Blohm
Examples of components are Java modules as well as Web application modules, datasource definitions, component repository definitions. The name of a Z2 components is made up by concatenating a module name and a local component name by a slash.
36 1 Redmine Admin
37 10 Henning Blohm
For example the module "" may have the following components:
38 1 Redmine Admin
39 10 Henning Blohm
* (containing the business logic, the database access layer, the web access layer in terms of servlets etc)
*  (containing the Web artifacts like JSPs, HTML files, Stylesheets, images, JS files etc)
* (containing the database connection settings)
43 1 Redmine Admin
The "java" and the "web" components contain multiple files inside folders and sub-folders while the "database" component is just a single .properties file.
45 10 Henning Blohm
Java components typically depend on other Java components which are declared in the java component's configuration file: *java/*.
46 1 Redmine Admin
47 10 Henning Blohm
Components have a runtime life cycle: They can be loaded and released. A component is loaded when it is first requested, possibly as early as part of the bootstrap process. A component is released during a z2-synchronization according to changes of its resources in the VCS or due to changes of dependency components. This way Java sources which have become invalid are unloaded, new versions are fetch from the VCS and compiled again. As a final step the released components can be loaded again (either on demand or as part of a partial bootstep process which is executed after a synchronization step).
48 5 Udo Offermann
49 10 Henning Blohm
The Z2 component model is extensible: By declaring and implementing component factories new component types may be made available to the platform. 
50 1 Redmine Admin
51 11 Henning Blohm
h2. The source is the system
52 5 Udo Offermann
53 10 Henning Blohm
The motto of the system-centric approach in the z2-Environment is: _"The source is the system!"_. Traditional systems with a push-deploy approach tend to become a heterogeneous conglomerate after a while, containing a mixture of original versions, patches, hotfixes and manual adjustments on config files. It is hard (or even impossible) to tell who installed that patch last month or who changed the memory settings yesterday. Often it is even difficult to tell what patch versions are actually deployed. And once this question is answered the next one pops up: Where do I get the corresponding sources for debugging and maintainance?
54 1 Redmine Admin
55 10 Henning Blohm
When the "source is the system", these questions are answered immediately. Changes to the z2-Environment are always changes in the repositories. And changes in the repositories are logged in the commit logs with author name and date, regardless if it's a fetch from another system (which is the equivalent to a patch) or a manual fix on configuration files. Also exactly the same sources are available, because there is only one source for (Java) sources which is the repository. When the Java sources are changed, z2 has to recompile them in order to get them executed. Thus it is always possible to debug a system with the most up-to-date sources.
56 5 Udo Offermann
57 11 Henning Blohm
h2. What's next
58 10 Henning Blohm
* Continue at [[Step_2_-_How_to_install_z2|» Step 2 - How to install z2]]
60 11 Henning Blohm
* Browse the reference documentation at (TDC!)