### Overview

The documents linked by this guide provide the instructions to download, build and install Apache Fortress software from source. It takes about ten minutes after completing the steps on this page.

#### Steps

Navigation Links These steps should be completed in order. Fortress Rest and Web are optional.

- Setup Apache Directory Server
- Setup Apache Directory Studio
- Build Apache Fortress Core
- Build Apache Fortress Realm
- Setup Apache Tomcat Web Server
- Build Apache Fortress Web
- Build Apache Fortress Rest

- Back to Fortress Core Overview

#### Prerequisites

These items are required and must be installed to target machine before any of these tutorial steps. Instructions cover Debian and Fedora system syntax. Fortress is written in Java, runs on various platforms, but the others are not be covered here.

1. Java 7 (or greater) sdk installed.
2. Git Download for Linux and Unix
3. Apache Maven 3
4. Firefox Web Browser

#### Getting Started - Generating the tutorial's how-to guide

This tutorial is contained within the javadoc of directory-fortress-core source archive. To generate, follow these instructions:

1. Clone the directory-fortress repos from apache git:

       git clone  https://gitbox.apache.org/repos/asf/directory-fortress-core.git
       git clone  https://gitbox.apache.org/repos/asf/directory-fortress-realm.git
       git clone  https://gitbox.apache.org/repos/asf/directory-fortress-commander.git
       git clone  https://gitbox.apache.org/repos/asf/directory-fortress-enmasse.git

2. Change to the [directory-fortress-core] folder

       cd directory-fortress-core/

   Where [directory-fortress-core] is base folder of the fortress core source package.
3. Set java and maven home env variables.
4. Build the core source:

       mvn clean install

5. Build the javadoc which contains the tutorial:

       mvn javadoc:javadoc

   javadoc note: If using JDK 8, you must turn off doclint to get past errors. Add the following to project's pom:

       <plugin>
       <artifactId>maven-javadoc-plugin</artifactId>
       <configuration>
       <additionalparam>-Xdoclint:none</additionalparam>
       </configuration>
       </plugin>

6. Point your web browser to the javadoc:
   file:///[directory-fortress-core]/target/site/apidocs/org/apache/directory/fortress/core/doc-files/ten-minute-guide.html.
   Where [directory-fortress-core] is base folder of the fortress core source package.
7. Complete the sections under 'Navigation Links'

#### Infrastructure Installed

1. Apache Directory Server
2. Apache Directory Studio
3. Apache Fortress
4. Apache Tomcat Servlet Container

If you find security flaws, or have questions about Apache Fortress, submit to Apache Fortress Discussion list.

Copyright 2003-2018, The Apache Software Foundation. All Rights Reserved.