Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added instructions for checking out the source code from GitHub.

Table of Contents

Introduction

This guide details the process for installing the Direct Certificate Discovery Tool (DCDT, or the Tool) from a version of the source code.

Requirements

See the System Requirements Install Guide for instructions on how to prepare your system prior to installation of the Tool.

Building the Tool

The following steps are to check out the release tag and build the source code.

Checkout the Sources

There are currently two ways to checkout the sources: using 1) Git from GitHub and 2) Mercurial from Google Code.

The Google Code project site is read-only for the Mercurial repository, but can be used if you need to build the projects.

The GitHub project site will have the latest changes and will be the official site, once the repository on Google Code has been retired.

 

1) Use the Git CLI to checkout the desired version.

To clone the repository and checkout the tip (newest revision of the default branch), run the following:

git clone https://github.com/esacinc/dcdt ~/dcdt

Typically, the latest stable release tag should be used for deployments. To checkout this tag, run the following:

cd ~/dcdt
git checkout tags/dcdt-3.0.4-RELEASE

 

OR

 

2) Use the Mercurial CLI to checkout the desired version.

To clone the repository and checkout the tip (newest revision of the default branch), run the following:

hg clone https://code.google.com/p/direct-certificate-discovery-tool/ ~/dcdt

Typically, the latest stable release tag should be used for deployments. To checkout this tag, run the following:

cd ~/dcdt
hg update dcdt-3.0.4-RELEASE

Build the Projects

To build all of the Maven projects that comprise the Tool, run the following:

cd ~/dcdt/
mvn -DskipChecks=true -DskipTests=true clean
install
Info

This will currently only work for the project checked out from Mercurial.

 

Developer Functionality

The following sections describe advanced functionality typically reserved for developers.

Checkout the Sources for Development

To checkout the trunk for development from GitHub, you should create a GitHub account and fork the DCDT project repository at https://github.com/esacinc/dcdt to your account.

Then, checkout your forked version of the repository, by running the following:

git clone https://github.com/<your username>/dcdt ~/dcdt

 

To checkout the trunk for development (project membership required) from Google Code, the tip needs to be checked out by running the following:

hg clone https://code.google.com/p/direct-certificate-discovery-tool/ ~/dcdt

Upon pushing, you will be prompted to enter your password. This is not your Google account password, but a string that Google Code has generated for you. It can be retrieved from your Google Code profile.