Skip to content

GuideGettingStarted

Jump to bottom Edit New page
Len DiMaggio edited this page Sep 20, 2013 · 22 revisions

Getting Started

Prerequisites

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.

Download, Installation and Configuration

First, we recommend you download the following:

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

  1. Unpack S-RAMP distribution

  2. Copy the EAP download into the unpacked S-RAMP distro

  3. Copy the ModeShape distribution into the unpacked S-RAMP distro

  4. Run the S-RAMP installer

  5. Unpack the DTGov distribution

  6. Move the "target" folder from the S-RAMP distro to the unpacked DTGov distro

  7. Copy the EAP download into the unpacked DTGov distro

  8. Run the DTGov installer

  9. Start JBoss

  10. 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 data
mvn install

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.

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.

You should see something like this:

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

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:

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.

Add a custom footer
Clone this wiki locally