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.
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/siteadmin/dcdt ~/dcdt
Typically, the latest stable release tag should be used for deployments. To checkout this tag, run the following:
cd ~/dcdt
git checkout 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
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/siteadmin/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.