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/05 15:25:34 UTC
[2/3] directory-fortress-core git commit: FC-56 - Fix Documentation -
Deprecate old README's
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/deprecate/README-QUICKSTART-APACHEDS.html
----------------------------------------------------------------------
diff --git a/deprecate/README-QUICKSTART-APACHEDS.html b/deprecate/README-QUICKSTART-APACHEDS.html
new file mode 100644
index 0000000..5a0229e
--- /dev/null
+++ b/deprecate/README-QUICKSTART-APACHEDS.html
@@ -0,0 +1,468 @@
+<!--
+ 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.
+-->
+<body>
+<img src="../images/fortresscommunitylogov3.jpg"/>
+<hr>
+<p>
+ <font color="red">NOTICE: This document has been deprecated. It is here for historical purposes. Eventually the
+ contents will be moved to a new location.</font>
+<hr>
+</p>
+<p>
+ These instructions are intended for new users who want to quickly learn how to install and test JoshuaTree Fortress
+ and ApacheDS IAM software using QUICKSTART package:
+ http://iamfortress.org/download
+ <br><br>Follow the steps and
+<ul>
+ <li>ApacheDS will be installed, configured, loaded, and ready to use by <em>Section IV</em>.</li>
+ <li>EnMasse Policy Server demo starts in <em>Section IX</em></li>
+ <li>Commander Web Admin demo starts in <em>Section X</em></li>
+</ul>
+</p>
+<hr>
+<h2>System Prerequisites</h2>
+
+<p>
+<ul>
+ <li>Internet access to retrieve binary dependencies from online Maven repo.</li>
+ <li>Java SDK Version 7 or beyond installed to target environment</li>
+ <li>Redhat or Ubuntu server machine (for window environments use <em>README-QUICKSTART-WINDOWS.html</em>)</li>
+ <li>1GB RAM</li>
+ <li>20GB HD</li>
+ <li>ApacheDS Pre-installed</li>
+</ul>
+</p>
+
+<b>NOTE:</b> The Fortress build.xml may run without connection to Internet iff:
+<ul>
+ <li>The binary dependencies have previously been downloaded to FORTRESS_HOME/lib folder</li>
+ <li>Local mode has been enabled on target machine. Local mode can be enabled by adding this property to
+ build.properties: local.mode=true
+ </li>
+</ul>
+<hr>
+<h2>Guidelines and Tips for first-time users</h2>
+<ul>
+ <li>In the document that follows, when you read <em>[version]</em> or <em>[platform]</em> substitute with current
+ package info. For example - if the downloaded package version is 1.0.0 and platform is 'Debian Silver i386', the
+ instructions show fortressBuilder-<em>[platform]</em>-<em>[version]</em>.jar your file name would be
+ fortressBuilder-Debian-Silver-i386-1.0.0.zip
+ </li>
+ <br>
+ <li>Is your target machine windows? Go to <em>README-QUICKSTART-WINDOWS</em></li>
+ <br>
+ <li>The source code for this project is located in <em>FORTRESS_HOME/src</em> folder.</li>
+</ul>
+
+<ol type="I">
+ <hr>
+ <li>
+ <h3>Instructions to extract and configure Fortress Builder Package to Target System</h3>
+ <ol type="A">
+ <li>Copy fortressBuilder-[platform]-[version].zip to hard drive on target server env.</li>
+ <br>
+ <li>Extract the zip. The location for archive can vary according to requirements. The location of package
+ will be referred to as <em>FORTRESS_HOME</em> later on.
+ </li>
+ <br>
+ <li>Enable permission for the binaries to execute. From FORTRESS_HOME root folder, enter the following
+ command from a system prompt:
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">chmod a+x -Rf *
+ </p></pre>
+ <img src="../images/Screenshot1-chmod.png"/>
+ </li>
+
+ <li>Edit file named 'build.properties' and insert LDAP configuration parameters:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">
+ ldap.server.type=apacheds
+
+ # These parameters point fortress to LDAP host:
+ ldap.host=localhost
+ ldap.port=10389
+
+ # These are used to construct suffix for DIT, i.e. dc=example,dc=com.
+ suffix.name=example
+ suffix.dc=com
+
+ # These are the connection parameters used for LDAP service account:
+ root.dn=uid=admin,ou=system
+
+ # Used to load OpenLDAP admin root password in slapd.conf and was encrypted using 'slappasswd'
+ command:
+ # This ApacheDS admin root password's value is 'secret', is bound for fortress.properties and was
+ encrypted using 'encrypt' target in build.xml:
+ cfg.root.pw=W7T0G9hylKZQ4K+DF8gfgA==
+
+ # If encryption of LDAP &/or HTTP service account passwords (e.g. cfg.root.pw, cfg.log.root.pw and
+ http.pw params) is required, this field must be set.
+ # If encryption of service accounts not needed, leave this value blank, and set the password values
+ for cfg.root.pw, cfg.log.root.pw and http.pw to be their clear text value.
+ # Use any arbitrary value here but must be same as key used to encrypt.
+ crypto.prop=abcd12345
+
+ </p></pre>
+ </li>
+
+ </ol>
+ </li>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Ant Build</h3>
+ <ol type="A">
+ <li>
+ From FORTRESS_HOME root folder, edit the b.sh script to point to java home:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">export JAVA_HOME=/opt/jdk1.7.0_10
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot3-edit-javahome.png"/><br><br>
+ <li>
+ Run the distribution target:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh dist
+ </p></pre>
+ <img src="../images/Screenshot4-ant-dist.png"/><br>
+ <br>Note: The b.sh batch file referred to here uses Ant package that is local to Fortress quickstart
+ package.
+ </li>
+ <br>
+ <li>
+ Verify it ran correctly according to Ant:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ <img src="../images/Screenshot4-ant-success-dist.png"/><br><br>
+ </li>
+ </ol>
+ You may now view the project binaries and documentation located under FORTRESS_HOME/dist.
+ <br><br><img src="../images/Screenshot5-dist-listing.png"/><br><br>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to configure ApacheDS and load with seed data</h3>
+ <strong><p style="color:blue;font-size:14px;">Important: This target reloads the ApacheDS configuration and
+ data.
+ </p>
+
+ </strong>
+ <ol type="A">
+ <br>
+ <li>
+ Import Fortress ApacheDS schema into ApacheDS server using preferred ldif import tool. Fortress ApacheDS
+ schema located here: FORTRESS_HOME/ldap/schema/apacheds-fortress.ldif
+
+ <br><br>Screenshot of Apache Directory Studio import of Fortress schema file into ApacheDS:
+ </li>
+ <img src="../images/Screenshot-Studio-Schema-Import.png"/><br><br>
+
+ <li>
+ The fortress 'init-apacheds' uses LDAPv3 to perform initial operations.
+ <br>edit build.properties, ensure the following line has been commented out:
+ <br><br><img src="../images/Screenshot43-edit-disable-rest.png"/><br><br>
+ Note: The default for this setting is 'false' or disabled.<br><br>
+ </li>
+
+ <li>
+ From FORTRESS_HOME root folder, enter the following command from a system prompt:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh init-apacheds
+</p></pre>
+ </li>
+ <li>
+ Verify it ran correctly according to Ant.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot7-init-slapd-success.png"/><br><br>
+ <li>
+ After above step completes, Symas ApacheDS will be installed, configured and loaded with fortress
+ bootstrap config. This
+ step also runs provisioning scripts which may be tailored according to requirements. Check out the xml
+ load scripts
+ in FORTRESS_HOME/ldap/setup folder.
+ <br><br>
+ </li>
+
+ <li>
+ Point your preferred LDAP browser, ours is <a href="http://directory.apache.org/studio/">Apache
+ Directory Studio</a>, to the installed directory.
+
+ The configuration parameters you'll need to browse can be found in the generated 'slapd.conf' file.
+ <br><br>
+ To view data stored in default database:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">suffix "dc=example,dc=com"
+ rootdn "uid=admin,ou=system"
+ rootpw "secret"</p></pre>
+ The root pw will be encrypted before stored in slapd.conf
+
+ <br><br><img src="../images/Screenshot8-ldap-browser.png"/><br><br>
+
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to regression test Fortress and ApacheDS on target machine (optional)</h3>
+ <ol type="A">
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot10-ant-test-init.png"/><br><br>
+ Note: The Fortress regression tests will run for around 3 minutes.<br><br>
+ <li>Verify these tests ran with no ERRORS.
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot11-ant-test-success.png"/><br><br>
+ <li>
+ To re-run these tests:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ </ol>
+ Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png"/>
+ <br><br>Note 2: If you made it this far without junit or ant ERRORS, the Fortress and ApacheDS IAM system are
+ certified to run on your machine.
+ <br><br>Note 3: These tests load tens of thousands of records into your newly installed directory.
+ The 'init-apacheds' and 'test-full' targets may be re-run as often as necessary. After regressions testing has
+ completed, you may run the 'init-apacheds' target to remove all test data from the directory.
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Command Line Interpreter (CLI) utility (optional)</h3>
+ This command line tool provides an interactive session with the user based on a simple command line
+ syntax.<br><br>
+ <ol type="A">
+ <li>
+ To start the CLI, enter:<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh cli
+ </p></pre>
+ <img src="../images/Screenshot13-ant-cli.png"/><br><br>
+ Which will bring up the command interpreter:
+ <br><img src="../images/Screenshot14-cli.png"/><br><br>
+ </li>
+ <li>
+ enter the command:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">review fuser -u demo
+</p></pre>
+ <img src="../images/Screenshot15-cli-review.png"/><br><br>
+
+ This example will return all users with userId that begins with 'demo':<br><br>
+ <img src="../images/Screenshot16-cli-fuser.png"/><br><br>
+ </li>
+ <li>
+ To learn more about the CLI and what it can do, follow instructions in the command line interpreter
+ reference
+ manual in the javadoc located here:
+ <br><br>
+ <a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line Interpreter</a>
+ <br><br>
+ Note: if javadocs are not found, go to Section VII
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run Fortress Console (optional)</h3>
+ For tasks like one-time setup of new users, password resets, searches
+ the Fortress Console application can be used.<br><br>
+ <ol type="A">
+ <li>
+ From FORTRESS_HOME root folder, enter the following command
+ from a system prompt:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh console
+</p></pre>
+ <img src="../images/Screenshot17-ant-console.png"/><br><br>
+ </li>
+
+ <li>
+ Console Screenshots...
+ <ol type="1">
+ <br>
+ <li>
+ Main Menu:
+ <br><img src="../images/Screenshot18-console-main.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to edit RBAC data:
+ <br><img src="../images/Screenshot19-console-admin.png"/><br>
+ </li>
+ <br>
+
+ <li>
+ Enter choice and follow the screen prompts to search RBAC data:
+ <br><img src="../images/Screenshot20-console-review.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to test RBAC policies:
+ <br><img src="../images/Screenshot21-console-access.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to setup ARBAC delegated policies:
+ <br><img src="../images/Screenshot22-console-deladmin.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to search through the AUDIT log:
+ <br><img src="../images/Screenshot23-console-audit.png"/>
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to generate and view Javadoc (optional)</h3>
+ <ol type="A">
+ <li>
+ Run the javadoc target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">/b.sh javadoc
+</p></pre>
+ <img src="../images/Screenshot24-ant-javadoc.png"/><br><br>
+ </li>
+ <li>Navigate to where docs are genned:</li>
+ <br>
+ <img src="../images/Screenshot25-javadoc-listing.png"/><br><br>
+ <li>Open 'index.html' using your preferred HTML Browser:</li>
+ <img src="../images/Screenshot26-javadoc.png"/><br><br>
+
+ <li>The javadoc provides coverage of the Fortress APIs and also provides explanations on how RBAC, ARBAC, PW
+ Policies and Audit work.
+ </li>
+ <br> <a href=""></a>
+ <li>
+ Good places to start learning about Fortress:
+ <ul><br>
+ <li><a href="./dist/docs/api/org/openldap/fortress/package-summary.html">Fortress Manager
+ Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/rbac/package-summary.html">RBAC Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/AuditMgr.html">Audit Manager</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line
+ Interpreter</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">FortressAntTask</a>
+ </li>
+ </ul>
+ </li>
+ </ol>
+ <hr>
+ <li>
+ <h3>Instructions to install EnMasse Policy Server Demo (optional)</h3>
+ <ol type="A">
+ <li>
+ Run the install-enmasse-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">/b.sh install-enmasse-demo
+</p></pre>
+
+ </li>
+ <li>
+ Verify it ran correctly according to Ant.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot42-install-enmasse-demo-success.png"/><br><br>
+ <li>
+ After above step completes, Fortress EnMasse will be installed
+ <br><br>
+ </li>
+ </ol>
+ <hr>
+ <li>
+ <h3>Instructions to regression test EnMasse Policy server on target machine (optional)</h3>
+ <ol type="A">
+
+ <li>Edit file named 'build.properties' and enable REST protocol here:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">enable.mgr.impl.rest=true
+ </p></pre>
+ Accept the defaults for other HTTP parameters in build.properties:
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">http.user=demouser4
+ http.pw=gX9JbCTxJW5RiH+otQEX0Ja0RIAoPBQf
+ http.host=localhost
+ http.port=8080
+ </p></pre>
+ </li>
+ Should look like the following:
+ <br><br><img src="../images/Screenshot41-enmasse-http-settings.png"/><br><br>
+
+ <li>Save and exit the text file editor
+ </li>
+ <br>
+
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot10-ant-test-init.png"/><br><br>
+ Note: The EnMasse regression tests will run for around 20 minutes.<br><br>
+ <li>Verify these tests ran with no ERRORS.
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot43-ant-enmasse-test-success.png"/><br><br>
+ <li>
+ This regression test may be rerun as often as necessary:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png"/>
+ <br><br>Note 2: If you made it this far without junit or ant ERRORS, EnMasse is installed and certified to
+ run on your machine.
+ <br><br>Note 3: These tests load tens of thousands of records into your directory.
+ The 'test-full' target may be re-run as often as necessary. After regressions testing have completed, you
+ may run the 'init-apacheds' target to remove all test data from the directory.
+ </li>
+ </li>
+</ol>
+<hr>
+<li>
+ <h3>Instructions to install Commander Web UI Demo (optional)</h3>
+ Run the install-commander-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">/b.sh install-commander-demo
+</p></pre>
+
+</li>
+<li>
+ <h3>More Utilities</h3>
+ Other execution targets:
+ <ol type="A">
+ <br>
+ <li>
+ 'test-samples' - contains examples of how the Fortress API's work
+ check out the following javadoc for more info on the samples package:
+ <a href="./dist/docs/samples/index.html">Samples Javadoc</a>
+ </li>
+ <br>
+ <li>
+ 'admin' - provides an XML-centric way to provision RBAC data policies and user accounts.
+ check out the following javadoc for more info on this utility:
+ <a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">Fortress Ant admin script utility
+ document</a>
+ </li>
+ <br>
+ <li>'encrypt' - interface to jacypt encryption utility</li>
+ <br>
+ <li>display all ant targets available:
+ <br><img src="../images/Screenshot27-ant-p.png"/><br><br>
+ </li>
+ </ol>
+</li>
+</ol>
+</ol>
+<hr>
+<p style="font: monospace; color: black; font-size: 6pt">Copyright (c) 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</body>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/deprecate/README-QUICKSTART-WINDOWS.html
----------------------------------------------------------------------
diff --git a/deprecate/README-QUICKSTART-WINDOWS.html b/deprecate/README-QUICKSTART-WINDOWS.html
new file mode 100644
index 0000000..4e34fa0
--- /dev/null
+++ b/deprecate/README-QUICKSTART-WINDOWS.html
@@ -0,0 +1,441 @@
+<!--
+ 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.
+-->
+<body>
+ <img src="../images/fortresscommunitylogov3.jpg" />
+<hr>
+<p>
+ <font color="red">NOTICE: This document has been deprecated. It is here for historical purposes. Eventually the contents will be moved to a new location.</font>
+<hr>
+</p>
+<p>
+These instructions are intended for new users who want to quickly learn how to use JoshuaTree Fortress and Symas OpenLDAP IAM software on Windows platform using QUICKSTART package:
+ http://iamfortress.org/download
+<br><br>Follow the steps and
+ <ul>
+ <li>OpenLDAP will be installed, configured, loaded, and ready to use by <em>Section IV</em>.</li>
+ <li>Commander Web Admin demo starts in <em>Section V</em></li>
+ <li>EnMasse Policy Server demo starts in <em>Section XI</em></li>
+ </ul>
+</p>
+ <hr>
+ <h2>System Prerequisites</h2>
+ The following steps are required...
+ <p>
+ <ul>
+ <li>Internet access to retrieve binary dependencies from online Maven repo.</li>
+ <li>Java SDK Version 7 or beyond installed to target environment</li>
+ </ul>
+ </p>
+
+<b>NOTE:</b> The Fortress build.xml may run without connection to Internet iff:
+ <ul>
+ <li>The binary dependencies are already present in FORTRESS_HOME/lib folder</li>
+ <li>Local mode has been enabled on target machine. Local mode can be enabled by adding this property to build.properties: local.mode=true</li>
+ </ul>
+ <hr>
+ <h2>Guidelines and Tips for first-time users</h2>
+ <ul>
+ <li>In the document that follows, when you read <em>[version]</em> or <em>[platform]</em> substitute with current package info. For example - if the downloaded package version is 1.0.0 and platform is 'Debian Silver i386', the instructions show fortressBuilder-<em>[platform]</em>-<em>[version]</em>.jar your file name would be fortressBuilder-Debian-Silver-i386-1.0.0.zip</li>
+<br>
+ <li>Does your target machine OS end with an X? Go to <em>README-QUICKSTART.html</em></li>
+<br>
+ <li>The source code for this project is located in <em>FORTRESS_HOME\src</em> folder.</li>
+
+ <br><img src="../images/Screenshot28-src-listing-win.png" /><br><br>
+ </ul>
+
+<ol type="I">
+ <hr>
+ <li>
+ <h3>Instructions to extract and configure Fortress Builder Package to Target System</h3>
+ <ol type="A">
+ <li>Copy fortressBuilder-[platform]-[version].zip to hard drive on target server env.</li>
+<br>
+ <li>Extract the zip. The location for archive can vary according to requirements. The location of package will be referred to as <em>FORTRESS_HOME</em> later on.</li>
+<br>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Ant Build</h3>
+ <ol type="A">
+ <li>
+From FORTRESS_HOME root folder, edit the b.bat script to point to java home:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">set JAVA_HOME=\Progra~1\Java\jdk1.7.0
+</p></pre>
+ </li>
+ <img src="../images/Screenshot28-edit-javahome-win.png" /><br><br>
+ <li>
+Run the distribution target:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">b.bat dist
+</p></pre>
+ <img src="../images/Screenshot29-ant-dist-win.png" />
+<br>Note: The b.bat file referred to here uses Ant package that is local to Fortress quickstart package.
+ </li>
+<br>
+ <li>
+Verify it ran correctly according to Ant:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot30-ant-dist-success-win.png" /><br><br>
+ </li>
+ </ol>
+You may now view the project binaries and documentation located under FORTRESS_HOME/dist.
+ <br><br><img src="../images/Screenshot5-dist-listing.png" /><br><br>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Builder to Install Symas OpenLDAP, configure and load with seed data</h3>
+ <strong><p style="color:blue;font-size:14px;">Important: This target reinstalls and reloads the OpenLDAP server program, configuration and data.
+</p>
+
+ <ol type="A">
+<br>
+
+ <li>
+From FORTRESS_HOME root folder, edit the build.properties file, setting the 3 properties below to match your environment:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">
+slapd.exe.drive=C <-- contains the drive letter for openldap server
+slapd.exe.dir=OpenLDAP <-- contains the folder to load openldap server binaries
+fortress.home.drive=C <-- contains the drive letter that you extracted fortress' builder package to.
+</p></pre>
+If you are not sure, what to use, the defaults usually work. Here's a screen shot of the build.properties.<br><br>
+ <img src="../images/Screenshot39-build-properties-win.png" /><br><br>
+ </li>
+</strong>
+
+ <li>
+From FORTRESS_HOME root folder, enter the following command from a system prompt:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b init-slapd
+</p></pre>
+ <br>Note: You will need to reply 'Yes' to the pop-up message:<br>
+ <img src="../images/Screenshot33-window-warning.png" /><br><br>
+
+ <br>Note: You will need to reply 'Allow' to the pop-up security warning message if you intend to allow other machines to communicate with ldap server:<br>
+ <img src="../images/Screenshot40-firewall-warning-win.png " /><br><br>
+
+ <img src="../images/Screenshot31-init-slapd-win.png" /><br><br>
+ </li>
+ <li>
+Verify it ran correctly according to Ant.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot32-init-slapd-success-win.png" /><br><br>
+ <li>
+After above step completes, Symas OpenLDAP will be installed, configured and loaded with fortress bootstrap config. This
+step also runs provisioning scripts which may be tailored according to requirements. Check out the xml load scripts
+in FORTRESS_HOME/ldap/setup folder.
+<br><br>
+ </li>
+
+ <li>
+Point your preferred LDAP browser, ours is <a href="http://directory.apache.org/studio/">Apache Directory Studio</a>, to the installed directory.
+
+The configuration parameters you'll need to browse can be found in the generated 'slapd.conf' file.
+<br><br>
+ To view data stored in default database:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">suffix "dc=openldap,dc=org"
+rootdn "cn=Manager,dc=openldap,dc=org"
+rootpw "secret"</p></pre>
+The root pw will be encrypted before stored in slapd.conf
+
+ <br><br><img src="../images/Screenshot8-ldap-browser.png" /><br><br>
+
+To view data stored in audit log database:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">suffix "cn=log"
+rootdn "cn=Manager,cn=log"
+rootpw "secret"</p></pre>
+The log root pw will be encrypted before stored in slapd.conf
+
+ <br><br><img src="../images/Screenshot9-ldap-browser-log.png" /><br><br>
+
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to regression test Fortress and Symas OpenLDAP on target machine</h3>
+ <ol type="A">
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">b test-full
+</p></pre>
+ </li>
+ <img src="../images/Screenshot34-ant-test-init-win.png" /><br><br>
+
+ <li>Verify these tests ran with no ERRORS.
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ </li>
+ <img src="../images/Screenshot35-ant-test-init-success-win.png" /><br><br>
+ <li>
+To re-run these tests:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">b test-full
+</p></pre>
+ </li>
+ </ol>
+Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png" />
+<br><br>Note 2: If you made it this far without junit or ant ERRORS, the Fortress and Symas OpenLDAP IAM system are certified to run on your machine.
+<br><br>Note 3: These tests load tens of thousands of records into your newly installed directory.
+The 'init-slapd' target may be re-run after the 'test-full-init' and 'test-full' targets have completed. This will delete the test data from the directory
+and restart directory with a clean slate.
+ </li>
+ <li>
+ <h3>Instructions to install Commander Web UI Demo (optional)</h3>
+Run the install-commander-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b install-commander-demo
+</p></pre>
+
+ </li>
+
+ <li>
+ <h3>Instructions to automatically test Commander Web UI Demo (optional)</h3>
+Run the commander-maven-test target to perform headless test of Commander Web:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b commander-maven-test
+</p></pre>
+
+note: Firefox must be preinstalled to target system.
+ </li>
+
+
+ <li>
+ <h3>Instructions to connect to Commander Web Admin</h3>
+Open up browser and enter the following URL:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">http://localhost:8080/commander
+</p></pre>
+
+userId: test
+password: test
+<br><br>
+Click on links on top or bottons on side of page to navigate between pages
+ </li>
+
+
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Command Line Interpreter (CLI) utility (optional)</h3>
+This command line tool provides an interactive session with the user based on a simple command line syntax.<br><br>
+ <ol type="A">
+ <li>
+To start the CLI, enter:<pre><p style="font-family:monospace;color:blue;font-size:14px;">b cli
+</p></pre>
+ <img src="../images/Screenshot36-ant-cli-win.png" /><br><br>
+Which will bring up the command interpreter:
+ <br><img src="../images/Screenshot14-cli.png" /><br><br>
+ </li>
+ <li>
+enter the command:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">review fuser -u demo
+</p></pre>
+ <img src="../images/Screenshot15-cli-review.png" /><br><br>
+
+This example will return all users with userId that begins with 'demo':<br><br>
+<img src="../images/Screenshot16-cli-fuser.png" /><br><br>
+ </li>
+ <li>
+To learn more about the CLI and what it can do, follow instructions in the command line interpreter reference
+manual in the javadoc located here:
+<br><br>
+<a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line Interpreter</a>
+<br><br>
+Note: if javadocs are not found, go to Section X
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run Fortress Console (optional)</h3>
+For tasks like one-time setup of new users, password resets, searches
+the Fortress Console application can be used.<br><br>
+ <ol type="A">
+ <li>
+From FORTRESS_HOME root folder, enter the following command
+from a system prompt:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b console
+</p></pre>
+<img src="../images/Screenshot37-ant-console-win.png" /><br><br>
+ </li>
+
+ <li>
+Console Screenshots...
+ <ol type="1">
+ <br>
+ <li>
+Main Menu:
+<br><img src="../images/Screenshot18-console-main.png" /><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to edit RBAC data:
+ <br><img src="../images/Screenshot19-console-admin.png" /><br>
+ </li>
+ <br>
+
+ <li>
+Enter choice and follow the screen prompts to search RBAC data:
+<br><img src="../images/Screenshot20-console-review.png" /><br>
+ </li>
+ <br>
+ <li>
+Enter choice and follow the screen prompts to test RBAC policies:
+<br><img src="../images/Screenshot21-console-access.png" /><br>
+ </li>
+ <br>
+ <li>
+Enter choice and follow the screen prompts to setup ARBAC delegated policies:
+<br><img src="../images/Screenshot22-console-deladmin.png" /><br>
+ </li>
+ <br>
+ <li>
+Enter choice and follow the screen prompts to search through the AUDIT log:
+<br><img src="../images/Screenshot23-console-audit.png" />
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to generate and view Javadoc (optional)</h3>
+ <ol type="A">
+ <li>
+Run the javadoc target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b javadoc
+</p></pre>
+<img src="../images/Screenshot38-javadoc-win.png" /><br><br>
+ </li>
+ <li>Navigate to where docs are genned:</li>
+ <br>
+<img src="../images/Screenshot25-javadoc-listing.png" /><br><br>
+ <li>Open 'index.html' using your preferred HTML Browser:</li>
+<img src="../images/Screenshot26-javadoc.png" /><br><br>
+
+ <li>The javadoc provides coverage of the Fortress APIs and also provides explanations on how RBAC, ARBAC, PW Policies and Audit work.</li>
+ <br> <a href=""></a>
+ <li>
+Good places to start learning about Fortress:
+ <ul><br>
+ <li><a href="./dist/docs/api/org/openldap/fortress/package-summary.html">Fortress Manager Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/rbac/package-summary.html">RBAC Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/AuditMgr.html">Audit Manager</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line Interpreter</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">FortressAntTask</a></li>
+ </ul>
+ </li>
+ </ol>
+
+ <hr>
+ <li>
+ <h3>Instructions to install EnMasse Policy Server Demo (optional)</h3>
+ <ol type="A">
+ <li>
+Run the install-enmasse-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">b install-enmasse-demo
+</p></pre>
+
+ </li>
+ <li>
+Verify it ran correctly according to Ant.
+ <li>
+After above step completes, Fortress EnMasse will be installed
+<br><br>
+ </li>
+ </ol>
+ <hr>
+ <li>
+ <h3>Instructions to regression test EnMasse Policy server on target machine (optional)</h3>
+ <ol type="A">
+
+ <li>Edit file named 'build.properties' and enable REST protocol here:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">enable.mgr.impl.rest=true
+ </p></pre>
+ Accept the defaults for other HTTP parameters in build.properties:
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">http.user=demouser4
+http.pw=gX9JbCTxJW5RiH+otQEX0Ja0RIAoPBQf
+http.host=localhost
+http.port=8080
+ </p></pre>
+ </li>
+ Should look like the following:
+ <br><br><img src="../images/Screenshot41-enmasse-http-settings.png" /><br><br>
+
+ <li>Save and exit the text file editor
+ </li><br>
+
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">b test-full
+</p></pre>
+ </li>
+ <img src="../images/Screenshot10-ant-test-init.png" /><br><br>
+Note: The EnMasse regression tests will run for around 10 minutes.<br><br>
+ <li>Verify these tests ran with no ERRORS.
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ </li>
+ <img src="../images/Screenshot43-ant-enmasse-test-success.png" /><br><br>
+ <li>
+This regression test may be rerun as often as necessary:
+<br><pre><p style="font-family:monospace;color:blue;font-size:14px;">b test-full
+</p></pre>
+ </li>
+Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png" />
+<br><br>Note 2: If you made it this far without junit or ant ERRORS, EnMasse is installed and certified to run on your machine.
+<br><br>Note 3: These tests load tens of thousands of records into your directory.
+The 'test-full' target may be re-run as often as necessary. After regressions testing have completed, you may run the 'init-slapd' target to remove all test data from the directory.
+ </li>
+ </li>
+ </ol>
+ <hr>
+
+ <hr>
+ <li>
+ <h3>More Utilities</h3>
+Other execution targets:
+ <ol type="A">
+ <br>
+ <li>
+'test-samples' - contains examples of how the Fortress API's work
+check out the following javadoc for more info on the samples package:
+<a href="./dist/docs/samples/index.html">Samples Javadoc</a>
+ </li>
+ <br>
+ <li>
+'admin' - provides an XML-centric way to provision RBAC data policies and user accounts.
+check out the following javadoc for more info on this utility:
+<a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">Fortress Ant admin script utility document</a>
+ </li>
+ <br>
+ <li>'encrypt' - interface to jacypt encryption utility</li>
+ <br>
+ <li>'start-slapd' - Starts OpenLDAP on target machine.</li>
+ <br>
+ <li>'stop-slapd' - Stops OpenLDAP on target machine.</li>
+Note: for slapd commands sudo or elevated privileges may be required.
+ <br><br>
+ <li>display all ant targets available:
+<br><img src="../images/Screenshot27-ant-p.png" /><br><br>
+ </li>
+ </ol>
+ </li>
+ </ol>
+</ol>
+ <hr>
+ <p style="font: monospace; color: black; font-size: 6pt">Copyright (c) 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</body>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/deprecate/README-QUICKSTART.html
----------------------------------------------------------------------
diff --git a/deprecate/README-QUICKSTART.html b/deprecate/README-QUICKSTART.html
new file mode 100755
index 0000000..a19e4bb
--- /dev/null
+++ b/deprecate/README-QUICKSTART.html
@@ -0,0 +1,552 @@
+<!--
+ 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.
+-->
+<body>
+<img src="../images/fortresscommunitylogov3.jpg"/>
+<hr>
+<p>
+ <font color="red">NOTICE: This document has been deprecated. It is here for historical purposes. Eventually the
+ contents will be moved to a new location.</font>
+<hr>
+</p>
+<p>
+ The intent of this document is to help new users with OpenLDAP Fortress IAM software using one of the the linux
+ QUICKSTART packages located here:
+ <a href="http://iamfortress.org/download">iamfortress.org/download</a>
+ <br>For instructions on how to get Fortress connected to an existing OpenLDAP instance, follow the instructions
+ inside <b>SECTION 6</b> of this document: <a href="./README.txt">README.txt</a>
+
+<h2>Table of Contents</h2>
+<ul>
+ <li>System Prerequisites</li>
+ <li>Guidelines and Tips for first-time users</li>
+ <li><b><em>Section I</em></b> - download Fortress QUICKSTART and prepare the package</li>
+ <li><b><em>Section II</em></b> - compile Fortress source and build distribution packages</li>
+ <li><b><em>Section III</em></b> - install, configure and load OpenLDAP with seed data</li>
+ <li><b><em>Section IV</em></b> - integration test Fortress and OpenLDAP</li>
+ <li><b><em>Section V</em></b> - Commander Web Administration demo</li>
+ <li><b><em>Section VI</em></b> - integration test Commander with Solenium</li>
+ <li><b><em>Section VII</em></b> - connecting to Commander via Web browser</li>
+ <li><b><em>Section VIII</em></b> - Instructions to use Fortress Command Line Interpreter (CLI)</li>
+ <li><b><em>Section IX</em></b> - Instructions to use Fortress Console utility (CLI)</li>
+ <li><b><em>Section X</em></b> - How to generate and view javadoc</li>
+ <li><b><em>Section XI</em></b> - EnMasse REST Policy Server demo</li>
+ <li><b><em>Section XII</em></b> - integration test Fortress, EnMasse and OpenLDAP</li>
+ <li><b><em>Section XIII</em></b> - enable and test the OpenLDAP RBAC Accelerator Overlay</li>
+ <li><b><em>Section XIV</em></b> - misc info about other utilities</li>
+</ul>
+</p>
+<hr>
+<h2>System Prerequisites</h2>
+
+<p>
+<ul>
+ <li>Internet access to retrieve binary dependencies from online Maven repo.</li>
+ <li>Java SDK Version 7 or beyond installed to target environment</li>
+ <li>Redhat or Ubuntu server machine (for window environments use <a href="./README-QUICKSTART-WINDOWS.html">README-QUICKSTART-WINDOWS.html</a>)
+ </li>
+ <li>1GB RAM</li>
+ <li>20GB HD</li>
+</ul>
+</p>
+
+<b>NOTE:</b> The Fortress build.xml may run without connection to Internet iff:
+<ul>
+ <li>The binary dependencies have previously been downloaded to FORTRESS_HOME/lib folder</li>
+ <li>Local mode has been enabled on target machine. Local mode can be enabled by adding this property to
+ build.properties: local.mode=true
+ </li>
+</ul>
+<hr>
+<h2>Guidelines and Tips for first-time users</h2>
+<ul>
+ <li>In the document that follows, when you read <em>[version]</em> or <em>[platform]</em> substitute with current
+ package info. For example - if the downloaded package version is 1.0.0 and platform is 'Debian Silver i386', the
+ instructions show fortressBuilder-<em>[platform]</em>-<em>[version]</em>.jar your file name would be
+ fortressBuilder-Debian-Silver-i386-1.0.0.zip
+ </li>
+ <br>
+ <li>Is your target machine windows? Go to <a
+ href="./README-QUICKSTART-WINDOWS.html">README-QUICKSTART-WINDOWS.html</a></li>
+ <br>
+ <li>The source code for this project is located here <a href="./src">./src</a>.</li>
+</ul>
+
+<ol type="I">
+ <hr>
+ <li>
+ <h3>Instructions to download, extract and configure Fortress Builder Package to Target System</h3>
+ <ol type="A">
+ <li>Download one of the linux packages from here: <a href="http://iamfortress.org/download">iamfortress.org/download</a>
+ </li>
+ <br>
+ <li>Copy fortressBuilder-[platform]-[version].zip to hard drive on target server env.</li>
+ <br>
+ <li>Extract the zip. The location for archive can vary according to requirements. The location of package
+ will be referred to as <em>FORTRESS_HOME</em> later on.
+ </li>
+ <br>
+ <li>Enable permission for the binaries to execute. From FORTRESS_HOME root folder, enter the following
+ command from a system prompt:
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">chmod a+x -Rf *
+ </p></pre>
+ <img src="../images/Screenshot1-chmod.png"/>
+ </li>
+
+ <li>if debian platform and using sudo, edit file named 'build.properties' and insert sudo password here:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">sudo.pw=your pw here
+ </p></pre>
+ note: For Redhat deployments leave this param's value empty, like below, otherwise the 'stop-slapd'
+ target may not work.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">sudo.pw=
+</p></pre>
+ </li>
+ <img src="../images/Screenshot2-edit-sudo.png"/><br>
+ </ol>
+ </li>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Ant Build</h3>
+ <ol type="A">
+ <li>
+ From FORTRESS_HOME root folder, edit the b.sh script to point to java home:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">export JAVA_HOME=/opt/jdk1.7.0_10
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot3-edit-javahome.png"/><br><br>
+ <li>
+ Run the distribution target:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh dist
+ </p></pre>
+ <img src="../images/Screenshot4-ant-dist.png"/><br>
+ <br>Note: The b.sh batch file referred to here uses Ant package that is local to Fortress quickstart
+ package.
+ </li>
+ <br>
+ <li>
+ Verify it ran correctly according to Ant:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ <img src="../images/Screenshot4-ant-success-dist.png"/><br><br>
+ </li>
+ </ol>
+ You may now view the project binaries and documentation located under FORTRESS_HOME/dist.
+ <br><br><img src="../images/Screenshot5-dist-listing.png"/><br><br>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run the Builder to Install Symas OpenLDAP, configure and load with seed data</h3>
+ <strong><p style="color:blue;font-size:14px;">Important: This target reinstalls and reloads the OpenLDAP server
+ program, configuration and data.
+ </p>
+
+ </strong>
+ <ol type="A">
+ <br>
+ <li>
+ The fortress 'init-slapd' uses LDAPv3 to perform initial operations.
+ <br>edit build.properties, ensure the following line has been commented out:
+ <br><br><img src="../images/Screenshot43-edit-disable-rest.png"/><br><br>
+ Note: The default for this setting is 'false' or disabled.<br><br>
+ </li>
+
+ <li>
+ From FORTRESS_HOME root folder, enter the following command from a system prompt:
+ <br>if sudo:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">sudo ./b.sh init-slapd
+</p></pre>
+ <img src="../images/Screenshot6-init-slapd.png"/><br><br>
+ if not sudo you must run as user that has priv to modify folders in /var and /opt folders:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">su
+</p></pre>
+ [enter your pw]
+ <br><br>before running the command to kick off the install
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh init-slapd
+</p></pre>
+ </li>
+ <li>
+ Verify it ran correctly according to Ant.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot7-init-slapd-success.png"/><br><br>
+ <li>
+ After above step completes, Symas OpenLDAP will be installed, configured and loaded with fortress
+ bootstrap config. This
+ step also runs provisioning scripts which may be tailored according to requirements. Check out the xml
+ load scripts
+ in FORTRESS_HOME/ldap/setup folder.
+ <br><br>
+ </li>
+
+ <li>
+ Point your preferred LDAP browser, ours is <a href="http://directory.apache.org/studio/">Apache
+ Directory Studio</a>, to the installed directory.
+
+ The configuration parameters you'll need to browse can be found in the generated 'slapd.conf' file.
+ <br><br>
+ To view data stored in default database:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">suffix "dc=openldap,dc=org"
+ rootdn "cn=Manager,dc=openldap,dc=org"
+ rootpw "secret"</p></pre>
+ The root pw will be encrypted before stored in slapd.conf
+
+ <br><br><img src="../images/Screenshot8-ldap-browser.png"/><br><br>
+
+ To view data stored in audit log database:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">suffix "cn=log"
+ rootdn "cn=Manager,cn=log"
+ rootpw "secret"</p></pre>
+ The log root pw will be encrypted before stored in slapd.conf
+
+ <br><br><img src="../images/Screenshot9-ldap-browser-log.png"/><br><br>
+
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to regression test Fortress and Symas OpenLDAP on target machine (optional)</h3>
+ <ol type="A">
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot10-ant-test-init.png"/><br><br>
+ Note: The Fortress regression tests will run for around 3 minutes.<br><br>
+ <li>Verify these tests ran with no ERRORS.
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot11-ant-test-success.png"/><br><br>
+ <li>
+ To re-run these tests:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ </ol>
+ Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png"/>
+ <br><br>Note 2: If you made it this far without junit or ant ERRORS, the Fortress and Symas OpenLDAP IAM system
+ are certified to run on your machine.
+ <br><br>Note 3: These tests load tens of thousands of records into your newly installed directory.
+ The 'init-slapd' and 'test-full' targets may be re-run as often as necessary. After regressions testing has
+ completed, you may run the 'init-slapd' target to remove all test data from the directory.
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to install Commander Web UI Demo (optional)</h3>
+ Run the install-commander-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh install-commander-demo
+</p></pre>
+
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to automatically test Commander Web UI Demo (optional)</h3>
+ Run the commander-maven-test target to perform headless test of Commander Web:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh commander-maven-test
+</p></pre>
+
+ note: Firefox must be preinstalled to target system.
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to connect to Commander Web Admin</h3>
+ Open up browser and enter the following URL:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">http://localhost:8080/commander
+</p></pre>
+
+ userId: test
+ password: test
+ <br><br>
+ Click on links on top or buttons on side of page to navigate between pages
+ </li>
+
+ <hr>
+ <li>
+ <h3>Instructions to run the Fortress Command Line Interpreter (CLI) utility (optional)</h3>
+ This command line tool provides an interactive session with the user based on a simple command line
+ syntax.<br><br>
+ <ol type="A">
+ <li>
+ To start the CLI, enter:<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh cli
+ </p></pre>
+ <img src="../images/Screenshot13-ant-cli.png"/><br><br>
+ Which will bring up the command interpreter:
+ <br><img src="../images/Screenshot14-cli.png"/><br><br>
+ </li>
+ <li>
+ enter the command:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">review fuser -u demo
+</p></pre>
+ <img src="../images/Screenshot15-cli-review.png"/><br><br>
+
+ This example will return all users with userId that begins with 'demo':<br><br>
+ <img src="../images/Screenshot16-cli-fuser.png"/><br><br>
+ </li>
+ <li>
+ To learn more about the CLI and what it can do, follow instructions in the command line interpreter
+ reference
+ manual in the javadoc located here:
+ <br><br>
+ <a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line Interpreter</a>
+ <br><br>
+ Note: if javadocs are not found, go to Section X
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to run Fortress Console (optional)</h3>
+ For tasks like one-time setup of new users, password resets, searches
+ the Fortress Console application can be used.<br><br>
+ <ol type="A">
+ <li>
+ From FORTRESS_HOME root folder, enter the following command
+ from a system prompt:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh console
+</p></pre>
+ <img src="../images/Screenshot17-ant-console.png"/><br><br>
+ </li>
+
+ <li>
+ Console Screenshots...
+ <ol type="1">
+ <br>
+ <li>
+ Main Menu:
+ <br><img src="../images/Screenshot18-console-main.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to edit RBAC data:
+ <br><img src="../images/Screenshot19-console-admin.png"/><br>
+ </li>
+ <br>
+
+ <li>
+ Enter choice and follow the screen prompts to search RBAC data:
+ <br><img src="../images/Screenshot20-console-review.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to test RBAC policies:
+ <br><img src="../images/Screenshot21-console-access.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to setup ARBAC delegated policies:
+ <br><img src="../images/Screenshot22-console-deladmin.png"/><br>
+ </li>
+ <br>
+ <li>
+ Enter choice and follow the screen prompts to search through the AUDIT log:
+ <br><img src="../images/Screenshot23-console-audit.png"/>
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ <hr>
+ <li>
+ <h3>Instructions to generate and view Javadoc (optional)</h3>
+ <ol type="A">
+ <li>
+ Run the javadoc target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh javadoc
+</p></pre>
+ <img src="../images/Screenshot24-ant-javadoc.png"/><br><br>
+ </li>
+ <li>Navigate to where docs are genned:</li>
+ <br>
+ <img src="../images/Screenshot25-javadoc-listing.png"/><br><br>
+ <li>Open 'index.html' using your preferred HTML Browser:</li>
+ <img src="../images/Screenshot26-javadoc.png"/><br><br>
+
+ <li>The javadoc provides coverage of the Fortress APIs and also provides explanations on how RBAC, ARBAC, PW
+ Policies and Audit work.
+ </li>
+ <br> <a href=""></a>
+ <li>
+ Good places to start learning about Fortress:
+ <ul><br>
+ <li><a href="./dist/docs/api/org/openldap/fortress/package-summary.html">Fortress Manager
+ Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/rbac/package-summary.html">RBAC Summary</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/AuditMgr.html">Audit Manager</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/cli/package-summary.html">Command Line
+ Interpreter</a></li>
+ <li><a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">FortressAntTask</a>
+ </li>
+ </ul>
+ </li>
+ </ol>
+
+ <hr>
+ <li>
+ <h3>Instructions to install EnMasse Policy Server Demo (optional)</h3>
+ <ol type="A">
+ <li>
+ Run the install-enmasse-demo target:
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh install-enmasse-demo
+</p></pre>
+
+ </li>
+ <li>
+ Verify it ran correctly according to Ant.
+<pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+</p></pre>
+ <img src="../images/Screenshot42-install-enmasse-demo-success.png"/><br><br>
+ <li>
+ After above step completes, Fortress EnMasse will be installed
+ <br><br>
+ </li>
+ </ol>
+ <hr>
+ <li>
+ <h3>Instructions to regression test EnMasse Policy server on target machine (optional)</h3>
+ <ol type="A">
+
+ <li>Edit file named 'build.properties' and enable REST protocol here:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">enable.mgr.impl.rest=true
+ </p></pre>
+ Accept the defaults for other HTTP parameters in build.properties:
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">http.user=demouser4
+ http.pw=gX9JbCTxJW5RiH+otQEX0Ja0RIAoPBQf
+ http.host=localhost
+ http.port=8080
+ </p></pre>
+ </li>
+ Should look like the following:
+ <br><br><img src="../images/Screenshot41-enmasse-http-settings.png"/><br><br>
+
+ <li>Save and exit the text file editor
+ </li>
+ <br>
+
+ <li>From FORTRESS_HOME root folder, enter the following command from a system prompt:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot10-ant-test-init.png"/><br><br>
+ Note: The EnMasse regression tests will run for around 20 minutes.<br><br>
+ <li>Verify these tests ran with no ERRORS.
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">BUILD SUCCESSFUL
+ </p></pre>
+ </li>
+ <img src="../images/Screenshot43-ant-enmasse-test-success.png"/><br><br>
+ <li>
+ This regression test may be rerun as often as necessary:
+ <br><pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-full
+ </p></pre>
+ </li>
+ Note 1: WARNING messages in test output are good as these are negative tests in action:
+ <br><img src="../images/Screenshot12-junit-warn.png"/>
+ <br><br>Note 2: If you made it this far without junit or ant ERRORS, EnMasse is installed and certified to
+ run on your machine.
+ <br><br>Note 3: These tests load tens of thousands of records into your directory.
+ The 'test-full' target may be re-run as often as necessary. After regressions testing have completed, you
+ may run the 'init-slapd' target to remove all test data from the directory.
+ </li>
+ </li>
+</ol>
+<hr>
+<li>
+ <h3>Instructions to enable RBAC Accelerator Overlay in OpenLDAP and test Java-side bindings (optional)</h3>
+ <ol type="A">
+
+ <li>Edit file named 'build.properties' and enable RBAC accelerator by adding:
+ <br>
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">rbac.accelerator=true</p></pre>
+ </li>
+ <li>Save and exit the text file editor</li>
+ <br>
+ <li>Reinstall Symas OpenLDAP by running the <b>init-slapd</b> target described in <b>Section III: Instructions
+ to run the Builder to Install Symas OpenLDAP, configure and load with seed data</b>
+ </li>
+ <br>
+
+ <li>Load necessary test data for unit tests:
+ <br>
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh admin
+ -Dparam1=ldap/setup/RbacAcceleratorTestUsers.xml</p></pre>
+ </li>
+ <li>Now you can run the rbac accelerator unit tests:
+ <br>
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-accel</p></pre>
+ </li>
+ <li>Verify the <b>test-accel</b> target completed with no ant or junit errors</li>
+ <br>
+ <li>Reload necessary regression test data by running the <b>test-full</b> target described in <b>Section IV:
+ Instructions to regression test Fortress and Symas OpenLDAP on target machine</b>
+ </li>
+ <br>
+ <li>Now you can run the rbac accelerator regression tests:
+ <br>
+ <pre><p style="font-family:monospace;color:blue;font-size:14px;">./b.sh test-accel-full</p></pre>
+ </li>
+ <li>Verify the <b>test-full-accel</b> target completed with no ant or junit errors</li>
+ <br>
+ <li>Check out the javadoc for learning about APIs supported within the RBAC accelerator:
+ <a href="./dist/docs/api/org/openldap/fortress/AccelMgr.html">Fortress Accelerator Client</a>
+ </li>
+ </ol>
+ <br>Note 1: The RBAC accelerator turns OpenLDAP into an RBAC Policy Decision Point (PDP) server. All state is
+ maintained in OpenLDAP LMDB databases including session and audit trail.
+ <br><br>Note 2: The <b>slapd.conf</b> file contains the mappings for the new database backends. You can view this
+ data using any LDAP browser.
+ <br><br>Note 3: Bindings for C and Python are being worked on and will be released soon.
+ <br><br>Note 4: <b>SessionPermissions</b> will be in future release as required by ANSI RBAC (INCITS 359) Core
+ functionality.
+ <hr>
+<li>
+ <h3>More Utilities</h3>
+ Other execution targets you may find useful:
+ <ol type="A">
+ <br>
+ <li>
+ 'test-samples' - contains examples of how the Fortress API's work
+ check out the following javadoc for more info on the samples package:
+ <a href="./dist/docs/samples/index.html">Samples Javadoc</a>
+ </li>
+ <br>
+ <li>
+ 'admin' - provides an XML-centric way to provision RBAC data policies and user accounts.
+ check out the following javadoc for more info on this utility:
+ <a href="./dist/docs/api/org/openldap/fortress/ant/FortressAntTask.html">Fortress Ant admin script utility
+ document</a>
+ </li>
+ <br>
+ <li>'encrypt' - interface to jacypt encryption utility</li>
+ <br>
+ <li>'start-slapd' - Starts OpenLDAP on target machine.</li>
+ <br>
+ <li>'stop-slapd' - Stops OpenLDAP on target machine.</li>
+ Note: for slapd commands sudo or elevated privileges may be required.
+ <br><br>
+ <li>display all ant targets available:
+ <br><img src="../images/Screenshot27-ant-p.png"/><br><br>
+ </li>
+ </ol>
+</li>
+</ol>
+</ol>
+<hr>
+<p style="font: monospace; color: black; font-size: 6pt">Copyright (c) 2003-2015, The Apache Software Foundation. All Rights Reserved.</p>
+</body>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/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
index c14fb75..4b0008a 100755
--- 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
@@ -19,25 +19,27 @@
-->
<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="./ten-minute-guide.html">Ten Minute Guide</a></li>
- </fieldset>
- <hr>
+ <title>Apache Fortress Ten Minute Guide</title>
+ <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
</head>
<body>
- <p>
- <h3>Setup Apache Directory Server</h3>
+ <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="./ten-minute-guide.html">Ten Minute Guide</a></li>
+ </fieldset>
+ <hr>
+ <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>.
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/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
index 3fb966c..85f8d48 100755
--- 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
@@ -18,177 +18,186 @@
*
-->
<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="./ten-minute-guide.html">Ten Minute Guide</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 run the junit tests.
- <h4>Steps to build the Fortress Core</h4>
- <ol>
- <li>
- Clone the <a href="https://git-wip-us.apache.org/repos/asf?p=directory-fortress-core.git">Directory Fortress Core Git repo</a>:
+<head>
+ <title>Apache Fortress Ten Minute Guide</title>
+ <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
+</head>
+<body>
+<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="./ten-minute-guide.html">Ten Minute Guide</a></li>
+</fieldset>
+<hr>
+<p>
+
+<h3>Build Apache Fortress Core</h3>
+<img src="fortress100.gif">
+<br><br>This section provides instructions to install Fortress and run the junit tests.
+<h4>Steps to build the Fortress Core</h4>
+<ol>
+ <li>
+ Clone the <a href="https://git-wip-us.apache.org/repos/asf?p=directory-fortress-core.git">Directory Fortress
+ Core Git repo</a>:
<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
+ # git clone https://git-wip-us.apache.org/repos/asf/directory-fortress-core.git
</p>
</pre>
- </li>
+ </li>
- <li>
- Set JAVA_HOME:
+ <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/
+ # export JAVA_HOME=/opt/jdk1.7.0_10/
</p>
</pre>
- </li>
+ </li>
- <li>
- Change directory:
+ <li>
+ Change directory:
<pre>
<p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
-# cd directory-fortress-core/
+ # cd directory-fortress-core/
</p>
</pre>
- </li>
+ </li>
- <li>
- Set M2_HOME:
+ <li>
+ Set M2_HOME:
<pre>
<p style="font: monospace; color: black; background-color: lightgrey; font-size: 10pt">
-# export M2_HOME=/usr/local/maven-version
+ # export M2_HOME=/usr/local/maven-version
</p>
</pre>
- </li>
+ </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:
+ <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
+ # This points fortress to LDAP host.
+ ldap.host=localhost
+ ldap.port=10389
+ ldap.server.type=apacheds
</p>
</pre>
- </li>
+ </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.
+ <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
+ # $M2_HOME/bin/mvn clean install -DskipTests=true
</p>
</pre>
- </li>
+ </li>
- <li>
- Verify the following files were created by build as they are required later:
+ <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
+ # ls -l config/fortress.properties
+ # ls -l ldap/setup/refreshLDAPData.xml
</p>
</pre>
- </li>
+ </li>
- <li>
- Load the fortress schema contained in <b>ldap/schema/apacheds-fortress.ldif</b> to ApacheDS instance using Apache Directory Studio.
+ <li>
+ Load the fortress schema contained in <b>ldap/schema/apacheds-fortress.ldif</b> to ApacheDS instance using
+ Apache Directory Studio.
- <br><br>
+ <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>
+ <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>
+ <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>
+ <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>
+ <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>
+ <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>
+ <br>
- <li>
- Verify success by viewing the cn=fortress schema node.
- </li>
- <br><img src="./schema-import-screenshot4.png" /><br><br>
+ <li>
+ Verify success by viewing the cn=fortress schema node.
+ </li>
+ <br><img src="./schema-import-screenshot4.png"/><br><br>
- </ol>
+ </ol>
- </li>
+ </li>
- <br>
+ <br>
- <li>
- Setup partition in ApacheDS server matching ldap server params in <b>config/fortress.properties</b> file.
- </li>
+ <li>
+ Setup partition in ApacheDS server matching ldap server params in <b>config/fortress.properties</b> file.
+ </li>
- <br>
+ <br>
- <li>
- Build the fortress LDAP DIT and create the configuration node:
+ <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
+ # $M2_HOME/bin/mvn install -Dload.file=./ldap/setup/refreshLDAPData.xml -DskipTests=true
</p>
</pre>
- </li>
+ </li>
- <li>
- Load the fortress ARBAC policies:
+ <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
+ # $M2_HOME/bin/mvn install -Dload.file=./ldap/setup/DelegatedAdminManagerLoad.xml
+ -DskipTests=true
</p>
</pre>
- </li>
+ </li>
- <li>
- Run the Fortress Core Regression Tess:
+ <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
+ # $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>
+ 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/01e76791/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
index 9fbd0e0..40dd66f 100644
--- 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
@@ -19,23 +19,26 @@
-->
<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="./ten-minute-guide.html">Ten Minute Guide</a></li>
- </fieldset>
- <hr>
+ <title>Apache Fortress Ten Minute Guide</title>
+ <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
</head>
<body>
+<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="./ten-minute-guide.html">Ten Minute Guide</a></li>
+</fieldset>
+<hr>
+<p>
+
<h3>Build Apache Fortress Realm</h3>
<h4>This section describes how to install The Fortress Realm Java EE Policy Enforcement Component </h4>
http://git-wip-us.apache.org/repos/asf/directory-fortress-core/blob/01e76791/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
index ae75dfa..25212db 100755
--- 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
@@ -19,24 +19,27 @@
-->
<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="./ten-minute-guide.html">Ten Minute Guide</a></li>
- </fieldset>
- <hr>
+ <title>Apache Fortress Ten Minute Guide</title>
+ <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
</head>
<body>
- <h3>Build Apache Fortress Rest</h3>
+ <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="./ten-minute-guide.html">Ten Minute Guide</a></li>
+ </fieldset>
+ <hr>
+ <p>
+
+ <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>