You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by sm...@apache.org on 2015/02/04 23:01:19 UTC
directory-fortress-core git commit: FC-56 - Fix Documentation - Add
the quickstart guide to javadoc.
Repository: directory-fortress-core
Updated Branches:
refs/heads/master fc9a4cc23 -> ea721e82e
FC-56 - Fix Documentation - Add the quickstart guide to javadoc.
Project: http://git-wip-us.apache.org/repos/asf/directory-fortress-core/repo
Commit: http://git-wip-us.apache.org/repos/asf/directory-fortress-core/commit/ea721e82
Tree: http://git-wip-us.apache.org/repos/asf/directory-fortress-core/tree/ea721e82
Diff: http://git-wip-us.apache.org/repos/asf/directory-fortress-core/diff/ea721e82
Branch: refs/heads/master
Commit: ea721e82e9c1279e3395fb3d1fc0df722789be3c
Parents: fc9a4cc
Author: Shawn McKinney <sm...@apache.org>
Authored: Wed Feb 4 16:00:47 2015 -0600
Committer: Shawn McKinney <sm...@apache.org>
Committed: Wed Feb 4 16:00:47 2015 -0600
----------------------------------------------------------------------
build.properties | 12 +-
pom.xml | 2 +-
.../core/doc-files/apache-directory.html | 140 +++++++++++++
.../core/doc-files/apache-fortress-core.html | 194 +++++++++++++++++
.../doc-files/apache-fortress-quickstart.html | 81 ++++++++
.../core/doc-files/apache-fortress-realm.html | 98 +++++++++
.../core/doc-files/apache-fortress-rest.html | 138 +++++++++++++
.../core/doc-files/apache-fortress-web.html | 182 ++++++++++++++++
.../fortress/core/doc-files/apache-tomcat.html | 207 +++++++++++++++++++
.../fortress/core/doc-files/apacheds-logo.jpeg | Bin 0 -> 4654 bytes
.../doc-files/connection-create-screenshot1.png | Bin 0 -> 57966 bytes
.../doc-files/connection-create-screenshot2.png | Bin 0 -> 46414 bytes
.../doc-files/connection-create-screenshot3.png | Bin 0 -> 78980 bytes
.../fortress/core/doc-files/fortress100.gif | Bin 0 -> 4807 bytes
.../doc-files/schema-import-screenshot1.png | Bin 0 -> 216104 bytes
.../doc-files/schema-import-screenshot2.png | Bin 0 -> 143583 bytes
.../doc-files/schema-import-screenshot3.png | Bin 0 -> 58231 bytes
.../doc-files/schema-import-screenshot4.png | Bin 0 -> 225836 bytes
.../fortress/core/doc-files/tomcat.png | Bin 0 -> 8410 bytes
19 files changed, 1047 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/build.properties
----------------------------------------------------------------------
diff --git a/build.properties b/build.properties
index ba4cb7a..04ad364 100644
--- a/build.properties
+++ b/build.properties
@@ -63,16 +63,16 @@ http.protocol=http
########################################################################
# This param tells fortress what type of ldap server in use:
-ldap.server.type=openldap
-#ldap.server.type=apacheds
+#ldap.server.type=openldap
+ldap.server.type=apacheds
# This is the default:
ldap.client.type=apache
# These parameters point fortress to LDAP host:
ldap.host=localhost
-ldap.port=389
+#ldap.port=389
#ldap.host=fortressdemo2.com
-#ldap.port=10636
+ldap.port=10389
#ldap.uris=ldap://${ldap.host}:${ldap.port}
# These are needed for client SSL connections with LDAP Server:
@@ -114,8 +114,8 @@ audits.dn=cn=log
groups.dn=ou=Groups,${suffix}
# These are the connection parameters used for LDAP service account:
-root.dn=cn=Manager,${suffix}
-#root.dn=uid=admin,ou=system
+#root.dn=cn=Manager,${suffix}
+root.dn=uid=admin,ou=system
# Used to load OpenLDAP admin root password in slapd.conf and was encrypted using 'slappasswd' command:
root.pw={SSHA}pSOV2TpCxj2NMACijkcMko4fGrFopctU
# This OpenLDAP admin root pass is bound for fortress.properties used by 'admin' pooled connections:
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index ddeca48..3353f88 100644
--- a/pom.xml
+++ b/pom.xml
@@ -605,7 +605,7 @@
<version>${javadoc.version}</version>
<configuration>
<stylesheet>java</stylesheet>
- <bottom>"<small>Copyright &copy; 2003-2015, The Apache Software Foundation. All Rights Reserved. Generated ${maven.build.timestamp}</small>"</bottom>
+ <bottom><small>Copyright &copy; 2003-2015, The Apache Software Foundation. All Rights Reserved. Generated ${maven.build.timestamp}</small></bottom>
<overview>src/main/java/org/apache/directory/fortress/core/overview.html</overview>
<docfilessubdirs>true</docfilessubdirs>
<includes></includes>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-directory.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-directory.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-directory.html
new file mode 100755
index 0000000..28c5da6
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-directory.html
@@ -0,0 +1,140 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+ <head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+ </head>
+ <body>
+ <p>
+ <h3>Setup Apache Directory Server</h3>
+ <img src="apacheds-logo.jpeg">
+ <br><br>
+ Download and install the package for your platform <a href="http://directory.apache.org/apacheds/downloads.html">Apache Directory Downloads Page</a>.
+
+ This section provides instructions to install Directory Server and Studio. The Apache Directory is an LDAPv3 compliant directory server. Apache Studio
+ is an ldap browser that can be used to maintain the ldap server directory and data.
+ <h4>Steps to install</h4>
+ <ol>
+
+ <li>
+ Download and install the package for your platform <a href="http://directory.apache.org/apacheds/downloads.html">Apache Directory Server Downloads Page</a>.
+
+ <br><br>
+
+ <ol type="A">
+ <li>
+ After installation start the directory server process.
+
+ For Debian from system command prompt:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# sudo /etc/init.d/apacheds-[VERSION]-default start
+ </p>
+ </pre>
+ Where [VERSION] matches what was installed earlier. At the time of this writing the latest version is 2.0.0-M19.
+ For Redhat (as root):
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+TODO: add instructions here
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Check the status of server process.
+
+ For Debian from system command prompt:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# sudo /etc/init.d/apacheds-[VERSION]-default status
+ApacheDS - default is running (70041).
+ </p>
+ </pre>
+ For Redhat (as root):
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+TODO: add instructions here
+ </p>
+ </pre>
+ </li>
+
+ </ol>
+
+ </li>
+
+ <br>
+
+ <li>
+ Download and install Apache Directory Studio <a href="http://directory.apache.org/studio/downloads.html">Apache Directory Studio Downloads Page</a>.
+
+ <br><br>
+
+ <ol type="A">
+ <li>
+ After installation start the directory studio process.
+
+ </li>
+
+ <br>
+
+ <li>
+ From the LDAP Browser perspective create a new connection. Enter an arbitrary name for connection, e.g. 'apacheds'. If apache directory server is running locally you may use 'localhost' and default port is '10389'.
+ </li>
+ <br><img src="./connection-create-screenshot1.png" /><br><br>
+
+ <br>
+
+ <li>
+ The default creds for apache directory server are 'uid=admin,ou=system' and 'secret' for the password. It's a good idea to verify this info by clicking on the 'Check Authentication' button.
+ </li>
+ <br><img src="./connection-create-screenshot2.png" /><br><br>
+
+ <br>
+ <li>
+ After all the info has been entered, you should be able to browse the directory.
+ </li>
+ <br><img src="./connection-create-screenshot3.png" /><br><br>
+
+ <br>
+
+ </ol>
+
+ </li>
+
+ <br>
+ </ol>
+ </body>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-core.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-core.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-core.html
new file mode 100755
index 0000000..1d76ff4
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-core.html
@@ -0,0 +1,194 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+ <head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+ </head>
+ <body>
+ <p>
+ <h3>Build Apache Fortress Core</h3>
+ <img src="fortress100.gif">
+ <br><br>This section provides instructions to install Fortress and optiohally test with Directory Server.
+ <h4>Steps to install the Fortress security system</h4>
+ <ol>
+ <li>
+ Clone the Apache Fortress Core Git repo:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# git clone https://git-wip-us.apache.org/repos/asf/directory-fortress-core.git
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Set JAVA_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export JAVA_HOME=/opt/jdk1.7.0_10/
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Change directory:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cd directory-fortress-core/
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Set M2_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export M2_HOME=/usr/local/maven-version
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Edit the build.properties in root folder of package.
+ These parameters are bound for files like <b>config/fortress.properties</b> and <b>ldap/setup/refreshLDAPData.xml</b> and used on subsequent steps.
+ <br>
+ Change the settings to:
+
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# This points fortress to LDAP host.
+ldap.host=localhost
+ldap.port=10389
+ldap.server.type=apacheds
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Build fortress core with maven and install to local repo. The fortress realm [<a href="apache-fortress-realm.html">Install Apache Fortress Realm</a>]
+ is dependent on fortress core.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn clean install -DskipTests=true
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Verify the following files were created by build as they are required later:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# ls -l config/fortress.properties
+# ls -l ldap/setup/refreshLDAPData.xml
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Load the fortress schema contained in <b>ldap/schema/apacheds-fortress.ldif</b> to ApacheDS instance using Apache Directory Studio.
+
+ <br><br>
+
+ <ol type="A">
+ <li>
+ In Apache Directory Studio LDAP Browser perspective, select Root DSE, right-click, and choose Import->LDIF Import
+ </li>
+ <br><img src="./schema-import-screenshot1.png" /><br><br>
+
+ <br>
+
+ <li>
+ Next a dialog box will appear where you can enter the fully qualified file name of the fortress schema.
+ </li>
+ <br><img src="./schema-import-screenshot2.png" /><br><br>
+
+ <br>
+
+ <li>
+ The schema file is located under the fortress core base package/ldap/schema/apacheds-fortress.ldif
+ </li>
+ <br><img src="./schema-import-screenshot3.png" /><br><br>
+
+ <br>
+
+ <li>
+ Verify success by viewing the cn=fortress schema node.
+ </li>
+ <br><img src="./schema-import-screenshot4.png" /><br><br>
+
+ </ol>
+
+ </li>
+
+ <br>
+
+ <li>
+ Setup partition in ApacheDS server matching ldap server params in <b>config/fortress.properties</b> file.
+ </li>
+
+ <br>
+
+ <li>
+ Build the fortress LDAP DIT and create the configuration node:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn install -Dload.file=./ldap/setup/refreshLDAPData.xml -DskipTests=true
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Load the fortress ARBAC policies:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn install -Dload.file=./ldap/setup/DelegatedAdminManagerLoad.xml -DskipTests=true
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Run the Fortress Core Regression Tess:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn -Dtest=FortressJUnitTest test
+ </p>
+ </pre>
+ Tests should run with no errors.
+ </li>
+ </ol>
+ </body>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-quickstart.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-quickstart.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-quickstart.html
new file mode 100644
index 0000000..2c55268
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-quickstart.html
@@ -0,0 +1,81 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<HTML>
+<HEAD>
+ <title>Apache Fortress Quickstart</title>
+</HEAD>
+<BODY>
+<p>
+ <h3>Overview</h3>
+ The documents linked by this guide provides a how-to guide for installing Apache Fortress software.
+ <br><br>
+<hr>
+<h4>Quickstart Guides</h4>
+The following topics are covered:
+<ol type="I">
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+</ol>
+</p>
+<hr>
+<h4>Prerequisites</h4>
+<ol type="1">
+ <li>Java 7 (or greater) SDK</li>
+ <li><a href="http://ant.apache.org/">Apache Ant 1.8 (or greater)</a></li>
+ <li><a href="http://maven.apache.org/">Apache Maven 3</a></li>
+ <li><a href="https://www.mozilla.org/en-GB/firefox/new/">Firefox Web Browser</a></li>
+</ol>
+<hr>
+<h4>Getting Started - Generating the tutorial's how-to guide</h4>
+This tutorial uses javadoc that is contained within the apache-fortress-core source archive. To generate, follow these instructions:
+<ol type="1">
+ <li>Download the <a href="https://git-wip-us.apache.org/repos/asf?p=directory-fortress-core.git">apache-fortress-core source bundle</a> from Apache Git repo.</li>
+ <li>Extract bundle</li>
+ <li>Set JAVA_HOME</li>
+ <li>Set M2_HOME</li>
+ <li>Run this command from the root package:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+$ $M2_HOME/bin/mvn javadoc:javadoc
+ </p>
+ </pre>
+ </li>
+ <li>Open the help document: /*package home*/target/site/apidocs/org/apache/directory/fortress/core/doc-files/apache-fortress-quickstart.html</li>
+ <li>Complete the desired sections under <b>Quickstart Guides</b> section</li>
+</ol>
+<hr>
+<h4>Infrastructure Installed</h4>
+<ol type="1">
+ <li><a href="http://directory.apache.org/apacheds/">Apache Directory Server</a></li>
+ <li><a href="http://directory.apache.org/studio/">Apache Directory Studio</a></li>
+ <li><a href="http://directory.apache.org/fortress/">Apache Fortress</a></li>
+ <li><a href="http://tomcat.apache.org/">Apache Tomcat Servlet Container</a></li>
+</ol>
+</p>
+<hr>
+If you find security flaws, or have questions about Apache Fortress, submit to <a href="http://mail-archives.apache.org/mod_mbox/directory-fortress/">Apache Fortress Discussion list</a>.
+</BODY>
+<p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</HTML>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-realm.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-realm.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-realm.html
new file mode 100644
index 0000000..ded8adf
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-realm.html
@@ -0,0 +1,98 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+<head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+</head>
+<body>
+<h3>Build Apache Fortress Realm</h3>
+
+<h4>This section describes how to install The Fortress Realm Java EE Policy Enforcement Component </h4>
+
+<ol>
+
+ <li>
+ Clone the Apache Fortress Realm Git repo:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# git clone https://git-wip-us.apache.org/repos/asf/directory-fortress-realm.git
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Set JAVA_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export JAVA_HOME=/opt/jdk1.7.0_10/
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Change directory:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cd directory-fortress-realm/
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Set M2_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export M2_HOME=/usr/local/maven-version
+ </p>
+ </pre>
+ </li>
+
+ <br>
+
+ <li>
+ Build fortress realm with maven and install to local repo. The fortress rest [<a href="apache-fortress-rest.html">Build Apache Fortress Rest</a>]
+ and fortress web [<a href="apache-fortress-web.html">Build Apache Fortress Web</a>]
+ are both dependent on the fortress realm.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn clean install
+ </p>
+ </pre>
+ </li>
+</ol>
+
+</body>
+<p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-rest.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-rest.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-rest.html
new file mode 100755
index 0000000..56a90ed
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-rest.html
@@ -0,0 +1,138 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+ <head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+ </head>
+ <body>
+ <h3>Build Apache Fortress Rest</h3>
+
+ <h4>This section describes how to install and use the Fortress Rest Application. It provides a RESTful wrapper around the Fortress Core apis.</h4>
+
+ <ol>
+
+ <li>
+ Clone the Apache Fortress Rest Git repo:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# git clone https://git-wip-us.apache.org/repos/asf/directory-fortress-rest.git
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Set JAVA_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export JAVA_HOME=/opt/jdk1.7.0_10/
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Change directory:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cd directory-fortress-enmasse/
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Set M2_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export M2_HOME=/usr/local/maven-version
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Generate the javadoc
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn javadoc:javadoc
+ </p>
+ </pre>
+ The javadoc will be located under target/site/apidocs.
+ </li>
+
+ <br>
+
+ <li>
+ Copy the fortress.properties, created on step <a href="./apache-fortress-core.html">Build Apache Fortress Core</a>, to this package's resource folder.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cp [directory-fortress-core]/config/fortress.properties [directory-fortress-rest]/src/main/resources
+ </p>
+ </pre>
+ Where [directory-fortress-core] is base folder of the fortress core source package and [directory-fortress-rest] is the current package's home folder.
+ </li>
+
+ <br>
+
+ <li>
+ To deploy fortress rest, run this command:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn tomcat:deploy
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ To redeploy:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn tomcat:redeploy
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Run the tests:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn test
+ </p>
+ </pre>
+ </li>
+
+ </ol>
+
+ </body>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-web.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-web.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-web.html
new file mode 100755
index 0000000..6f9107b
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-fortress-web.html
@@ -0,0 +1,182 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+ <head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+ </head>
+ <body>
+ <h3>Build Apache Fortress Web</h3>
+
+ <h4>This section describes how to install and use the Fortress Web Application for RBAC Administration </h4>
+
+ <ol>
+
+ <li>
+ Clone the Apache Fortress Web Git repo:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# git clone https://git-wip-us.apache.org/repos/asf/directory-fortress-web.git
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Set JAVA_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export JAVA_HOME=/opt/jdk1.7.0_10/
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Change directory:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cd directory-fortress-commander/
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Set M2_HOME:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# export M2_HOME=/usr/local/maven-version
+ </p>
+ </pre>
+ </li>
+
+ <br>
+
+ <li>
+ Copy the fortress.properties, created on step <a href="./apache-fortress-core.html">Build Apache Fortress Core</a>, to this package's resource folder.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cp [directory-fortress-core]/config/fortress.properties [directory-fortress-web]/src/main/resources
+ </p>
+ </pre>
+ Where [directory-fortress-core] is base folder of the fortress core source package and [directory-fortress-web] is the current package's home folder.
+ </li>
+
+ <br>
+
+ <li>
+ To deploy fortress web, run this command:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn tomcat:deploy
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ To redeploy:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# $M2_HOME/bin/mvn tomcat:redeploy
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Connect to web app:
+ <br><br>
+ <ol type="a">
+ <li>
+ non-SSL -
+ local: <a href="http://localhost:8080/fortress-web">http://localhost:8080/fortress-web</a>,
+ remote: <a href="http://fortressdemo2.com:8080/fortress-web">http://fortressdemo2.com:8080/fortress-web</a>
+ <br>
+ </li>
+ <br>
+ <li>
+ SSL -
+ local: <a href="https://localhost:8443/fortress-web">https://localhost:8443/fortress-web</a>,
+ remote: <a href="https://fortressdemo2.com:8443/fortress-web">https://fortressdemo2.com:8443/fortress-web</a>
+ </li>
+ <br>
+ Accept the self-signed certificate when the warning dialog appears.
+ </ol>
+
+ </li>
+
+ <br>
+
+ <li>
+ Try the various user accounts:
+ <br><br>
+ <ol type="a">
+ <li>
+ <b>userId</b>: <i>test</i>, <b>password</b>: <i>test</i>
+ </li>
+ <br>
+ <li>
+ <b>userId</b>: <i>test1</i>, <b>password</b>: <i>test</i>
+ </li>
+ <br>
+ <li>
+ <b>userId</b>: <i>test2</i>, <b>password</b>: <i>test</i>
+ </li>
+ <br>
+ <li>
+ <b>userId</b>: <i>test3</i>, <b>password</b>: <i>test</i>
+ </li>
+ </ol>
+ </li>
+ <br>
+ <li>
+ View the audit trail. The <i>test</i> user has access to view the following audit trail reports:
+ <ul>
+ <br>
+ <li>
+ <b>BINDS</b> shows authentication events
+ </li>
+ <br>
+ <li>
+ <b>AUTHZ</b> shows authorization events
+ </li>
+ <br>
+ <li>
+ <b>MODS</b> shows historical changes to the data elements.
+ </li>
+ </ul>
+ </li>
+ </ol>
+
+ </body>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apache-tomcat.html
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apache-tomcat.html b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-tomcat.html
new file mode 100755
index 0000000..2c5cbd8
--- /dev/null
+++ b/src/main/java/org/apache/directory/fortress/core/doc-files/apache-tomcat.html
@@ -0,0 +1,207 @@
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+-->
+<html>
+ <head>
+ <title>Apache Fortress Quickstart</title>
+ <hr>
+ <fieldset>
+ <legend><b>Navigation Links</b></legend>
+ <ul>
+ <li><a href="./apache-directory.html">Setup Apache Directory Server</a></li>
+ <li><a href="./apache-fortress-core.html">Build Apache Fortress Core</a></li>
+ <li><a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a></li>
+ <li><a href="./apache-tomcat.html">Setup Apache Tomcat Web Server</a></li>
+ <li><a href="./apache-fortress-rest.html">Build Apache Fortress Rest</a></li>
+ <li><a href="./apache-fortress-web.html">Build Apache Fortress Web</a></li>
+ </ul>
+ <li><a href="./apache-fortress-quickstart.html">Apache Fortress Quickstart</a></li>
+ </fieldset>
+ <hr>
+ </head>
+ <body>
+ <h3>Setup Apache Tomcat Web Server</h3>
+ <img src="tomcat.png">
+ <br><br>
+ This document contains instructions to install Tomcat 7 to common Linux distros. Any Tomcat (version 7 and beyond) instance
+ may be used but server commands and file locations must be translated to match target environment.
+ <hr>
+ <h4>This section describes how to install Apache Tomcat to Debian and Redhat distros and enable HTTPS communication</h4>
+ <ol>
+ <li>
+ If Tomcat is already installed skip this step.
+ <br><br>
+ For Debian from system command prompt:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# sudo apt-get install tomcat7 tomcat7-admin tomcat7-docs
+ </p>
+ </pre>
+ For Redhat (as root):
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# mkdir tmp
+# cd tmp
+# wget http://www.us.apache.org/dist/tomcat/tomcat-7/v7.0.55/bin/apache-tomcat-7.0.55.tar.gz
+# tar xzf apache-tomcat-7.0.55.tar.gz
+# mv apache-tomcat-7.0.55 /usr/share/tomcat7
+# cd /usr/share/tomcat7
+# ./bin/startup.sh
+ </p>
+ </pre>
+
+ </li>
+
+ <li>
+ Verify process is running:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# ps -ef | grep tomcat
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Place the fortress-realm proxy jar from <a href="./apache-fortress-realm.html">Build Apache Fortress Realm</a> into Tomcat server's /lib folder. The proxy
+ jar name is fortress-realm-proxy-[version].jar and located here: directory-fortress-realm/proxy/target
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# cp fortress-realm-proxy-[VERSION]-proxy.jar /usr/share/tomcat7/lib
+ </p>
+ </pre>
+ Where [VERSION] matches the value in this packages pom.xml file. At the time of this writing the current version was 1.0-RC40.
+ </li>
+
+ <br>
+
+ <li>
+ Edit tomcat-users.xml:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# vi /usr/share/tomcat7/conf/tomcat-users.xml
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Add privilege for <b>tcmanager</b> user to connect with Tomcat Manager. This account can access GUI and deploy via maven.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+<role rolename="manager-script"/>
+<role rolename="manager-gui"/>
+<user username="tcmanager" password="m@nager123" roles="manager-script,manager-gui"/>
+ </p>
+ </pre>
+ Using the config file realm to store credentials for an important application like the Tomcat Manager is a security <b>antipattern</b>. For production, a realm like
+ fortress realm should used globally by Tomcat.
+ </li>
+
+ <br>
+
+ <li>
+ Save and exit.
+ </li>
+
+ <br>
+
+ <li>
+ Enable Tomcat SSL
+ <ol type="a">
+ <br>
+ <li>
+ Copy keystore created during <a href="II-keys.html">Section II - Managing PKI Keys</a> to <b>/usr/local/tomcat/conf</b> folder.
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# sudo cp src/test/resources/certs/mykeystore /usr/share/tomcat7/conf
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Edit <b>/usr/share/tomcat7/conf/server.xml</b> file:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# vi /usr/share/tomcat7/conf/server.xml
+ </p>
+ </pre>
+ </li>
+ <li>
+ Add the following to <b>server.xml</b>:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+<!-- Define a SSL Coyote HTTP/1.1 Connector on port 8443 -->
+<Connector
+ port="8443" maxThreads="200"
+ scheme="https" secure="true" SSLEnabled="true"
+ keystoreFile="conf/mykeystore" keystorePass="changeit"
+ clientAuth="false" sslProtocol="TLS"/>
+ </p>
+ </pre>
+ </li>
+
+ <li>
+ Save and exit the file.
+ </li>
+
+ <br>
+
+ <li>
+ Restart Tomcat (Debian):
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+sudo /etc/init.d/tomcat7 restart
+ </p>
+ </pre>
+
+ Redhat users:
+ <pre>
+ <p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
+# ./bin/shutdown.sh
+# ./bin/startup.sh
+ </p>
+ </pre>
+
+ </li>
+ </ol>
+ </li>
+ <li>
+ Verify setup by signing onto the Tomcat Manager app with credentials <b>userId</b>: <i>tcmanager</i>, <b>password</b>: <i>m@nager123</i>
+ <br><br>
+ <ol type="a">
+ <li>
+ non-SSL -
+ local: <a href="http://localhost:8080/manager">http://localhost:8080/manager</a>,
+ remote: <a href="http://fortressdemo2.com:8080/manager">http://fortressdemo2.com:8080/manager</a>
+ <br>
+ </li>
+ <br>
+ <li>
+ SSL -
+ local: <a href="https://localhost:8443/manager">https://localhost:8443/manager</a>,
+ remote: <a href="https://fortressdemo2.com:8443/manager">https://fortressdemo2.com:8443/manager</a>
+ </li>
+ </ol>
+ <br>
+ Accept the self-signed certificate when the warning dialog appears.
+ </li>
+
+ </ol>
+ </body>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</html>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/apacheds-logo.jpeg
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/apacheds-logo.jpeg b/src/main/java/org/apache/directory/fortress/core/doc-files/apacheds-logo.jpeg
new file mode 100644
index 0000000..da14441
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/apacheds-logo.jpeg differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot1.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot1.png b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot1.png
new file mode 100644
index 0000000..0c238a0
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot1.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot2.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot2.png b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot2.png
new file mode 100644
index 0000000..c67dcc3
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot2.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot3.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot3.png b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot3.png
new file mode 100644
index 0000000..923a037
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/connection-create-screenshot3.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/fortress100.gif
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/fortress100.gif b/src/main/java/org/apache/directory/fortress/core/doc-files/fortress100.gif
new file mode 100644
index 0000000..3f8f3f9
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/fortress100.gif differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot1.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot1.png b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot1.png
new file mode 100644
index 0000000..732dab7
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot1.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot2.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot2.png b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot2.png
new file mode 100644
index 0000000..8b3d876
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot2.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot3.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot3.png b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot3.png
new file mode 100644
index 0000000..bf1ffd6
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot3.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot4.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot4.png b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot4.png
new file mode 100644
index 0000000..8f98c7e
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/schema-import-screenshot4.png differ
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/ea721e82/src/main/java/org/apache/directory/fortress/core/doc-files/tomcat.png
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/directory/fortress/core/doc-files/tomcat.png b/src/main/java/org/apache/directory/fortress/core/doc-files/tomcat.png
new file mode 100644
index 0000000..f40a9de
Binary files /dev/null and b/src/main/java/org/apache/directory/fortress/core/doc-files/tomcat.png differ