Binary Install

Dipforge provides a simple binary install package. This comes in the form of a self install JAR file available at Sourceforge.

Installation:

1. Download installer
2. Execute installer either by double clicking on the file or running the following command
   #java -jar dipforge-installer-<version>.jar
   The installer will launch a GUI if possible otherwise it will run in headless mode and prompt via the command line.
3. Answer the questions
4. Run dipforge from the command line
   # cd <install directory>/bin
   windows
   # ./run.bat
   unix or linux
   # ./run.sh
5. Running dipforge as an Ubuntu service.
   Copy the Dipforge service configuration script to the init directory
   # sudo cp <dipforge install dir>/bin/dipforge.conf /etc/init/
   Start the Dipforge service.
   # sudo service dipforge start

Once Dipforge is running it can be access through a web browser and runs on a default port of 8080. The url looks like the following:

http://<hostname>:8080/

Source Install

The current version is available from GitHub as source. It is a large project and takes some time to compile as it downloads the dependencies during the process.

Requirements

• 4gigs of ram or more recommended.
• Git client
• JDK 1.5 and above
• Gradle 1 and above
• Internet connection. I recommend an ADSL or better connection.

Once the Git client, the JDK and Gradle are setup the build process is as follows.

Build Process

1. git clone https://github.com/brettchaldecott/dipforge.git dipforge.git
2. cd dipforge.git
3. gradle -x test release

The command to build a full release of Dipforge is “gradle -x test release”. The “-x test” means that the unit tests will not be executed. This slows down the build process substantially.

Running Dipforge

Once the build has completed Dipforge can be started. An executable version of the server configured for the environment is built in a sub directory of project called release. To run the server follow these steps.

1. cd release/dipforge/bin
2. On Linux or Unix sudo ./run.sh.  On Windows run.bat

Access Dipforge

When Dipforge has started it exposes itself on port 8080. Accessing the frontend is thus as simple as open a connection from your browser to that port on the box running the instance. The URL will thus look like the following “http://{hostname}:8080/”.

Your browser will present you with a simple page providing links to the Dipforge desktop, an example site, git hub and the dipforge site.

Dipforge desktop

The desktop provides authenticated and authorized access to the Web IDE, and other functionality. The default username and password for it are the following

username: admin
password: 112233