Chapter 2. Getting Started

The DTGov application is written in Java. To get started make sure your system has the following:

Java JDK 1.6 or newer
Apache Ant 1.7 or newer to use the installer
Maven 3.0.3 or newer
Overlord S-RAMP version 0.3.0.Final or newer

This Getting Started guide assumes you do not already have Overlord S-RAMP installed.

2.2. Download, Installation and Configuration

First, we recommend you download the following:

Next, you must follow these steps to install and configure the application:

Unpack S-RAMP distribution
Copy the EAP download into the unpacked S-RAMP distro
Copy the ModeShape distribution into the unpacked S-RAMP distro
Run the S-RAMP installer
Unpack the DTGov distribution
Move the "target" folder from the S-RAMP distro to the unpacked DTGov distro
Copy the EAP download into the unpacked DTGov distro
Run the DTGov installer
Start JBoss
Populate the S-RAMP repository with DTGov seed data (ontology + workflow jar)

Some psuedo-shell code that might help

mkdir ~/overlord
cd ~/overlord
# Download JBoss EAP 6.1 (jboss-eap-6.1.0.zip)
#    From - http://www.jboss.org/jbossas/downloads
# Download the ModeShape EAP distro (modeshape-3.2.0.Final-jbosseap-61-dist.zip)
#    From - http://www.jboss.org/modeshape/downloads/downloads3-2-0-final.html
# Download S-RAMP distribution (s-ramp-0.3.0.Final.zip)
#    From - http://www.jboss.org/overlord/downloads/sramp
unzip s-ramp-0.3.0.Final.zip
cp jboss-eap-6.1.0.zip s-ramp-0.3.0.Final
cp modeshape-3.2.0.Final-jbosseap-61-dist.zip s-ramp-0.3.0.Final
cd s-ramp-0.3.0.Final
ant install
cd ..
mv s-ramp-0.3.0.Final/target dtgov-1.0.0.Final
cp jboss-eap-6.1.0.zip dtgov-1.0.0.Final
cd dtgov-1.0.0.Final
ant install
# Start JBoss (target/jboss-eap-6.1/bin/standalone.sh) - wait for startup to complete
ant seed
cd dtgov-data
mvn deploy

The dtgov.war and dtgov-ui.war services are deployed to the during the installation. The DTGov web UI (http://localhost:8080/dtgov-ui) is provided by dtgov-ui.war. You will see references to these services in the server.log at startup and when the services are invoked.

2.3. Check your Installation

Now that everything is installed and running, you should be able to verify that everything is working by logging in to the S-RAMP Browser UI and verifying that you can see the DTGov seed data.

http://localhost:8080/s-ramp-ui (admin/overlord)

You should see something like this:

Figure 2.1. Screenshot of the DTGov data in S-RAMP

2.4. Get to Work

It’s all installed, running, and checked? Now it’s time to use the software! This guide will explain advanced configuration and usage, but you can get started by logging in to the DTGov User Interface:

http://localhost:8080/dtgov-ui (admin/overlord)

It’s likely that users will need to customize the system based on their organization’s specific work processes. The Configuring and Governance Workflows chapters should be helpful in describing how to customize the system.