z2-Environment

h2. Running a Java DB Network Server

Previously to Java 9, the Java SE Development Kit (JDK) by Oracle provided the Java DB - essentially the same as the Apache Derby DB. That is not the case anymore. However, we use that Database implementation in our samples. In order to run those samples that illustrate use of a relational database, please follow the instructions below to install and run Apache Derby. Could hardly be simpler.

h3. Step 1: Download and Install

Unless you have done so already, download "Apache Derby DB":http://db.apache.org/derby and follow the "installation how-to":http://db.apache.org/derby/papers/DerbyTut/install_software.html.

Note: You do not need to unpack Apache Derby into some global folder on your system. Instead you may want to use some local folder under your user's home folder. There is no problem installing and runnning different instances and configurations at any time.

h3. Step 2: Run

Let's assume you installed (well - unpacked) into a folder $DERBY_INSTALL. Also, let's assume some Java Runtime Environment is installed and ready.

Simply run the following on Linux or Mac OS:

<pre><code class="ruby">

cd $DERBY_INSTALL

java -jar lib/derbyrun.jar server start

</code></pre>

On Windows run

<pre><code class="ruby">

cd %DERBY_INSTALL

java -jar lib\derbyrun.jar server start

</code></pre>

That's it. Apache Derby will be waiting for connections on port 1527.