Build Apache Fortress Core

This section provides instructions to install Fortress Core, setup usage with ApacheDS, and run the junit tests

1. Set java and maven home env variables.


2. Change directory:

                   
   
   cd directory-fortress-core/
                   
               

3. Copy build.properties.example in root folder of package, to build.properties.

                   
   
   cp build.properties.example build.properties
                   
                 

4. Edit the build.properties in root folder of package. These parameters will be used to generate config artifacts: config/fortress.properties and ldap/setup/refreshLDAPData.xml, needed later on.
   Change the settings to:

                   
   
   # This points fortress to LDAP host.
   ldap.host=localhost
   ldap.port=10389
   ldap.server.type=apacheds
                   
                 

5. Build fortress core. This step will generate config artifacts using settings from build.properties.

                       
   
   mvn install
                       
                   

6. Verify the following config artifacts were created by build as they are required later:

                       
   
   ls -l config/fortress.properties
   ls -l ldap/setup/refreshLDAPData.xml
                       
                   

7. Load the Apache Fortress schema.
   
   
   Choose one option:
   
   
   1. Load the fortress schema contained in ldap/schema/apacheds-fortress.ldif to ApacheDS instance using command line.

                          
      
      ldapmodify -h localhost -p 10389 -D uid=admin,ou=system -w secret -a -f FORTRESS_HOME/ldap/schema/apacheds-fortress.ldif
                          
                      

   OR
   
   
   2. Load the fortress schema contained in ldap/schema/apacheds-fortress.ldif to ApacheDS instance using Apache Directory Studio.
      
      
      1. In Apache Directory Studio LDAP Browser perspective, select Root DSE, right-click, and choose Import->LDIF Import
      
      
      
      
      
      2. Next a dialog box will appear where you can enter the fully qualified file name of the fortress schema.
      
      
      
      
      
      3. The schema file is located under the fortress core base package/ldap/schema/apacheds-fortress.ldif
      
      
      
      
      
      4. Verify success by viewing the cn=fortress schema node.
      
      
      
      
8. Setup partition in ApacheDS server matching ldap server params in config/fortress.properties file.


9. Build the fortress LDAP DIT, create its config node and load the A/RBAC policies:

                       
   
   mvn install -Dload.file=./ldap/setup/refreshLDAPData.xml
   mvn install -Dload.file=./ldap/setup/DelegatedAdminManagerLoad.xml
                       
                   

10. Run the Fortress Core Regression Tess:

                        
    
    mvn test -Dtest=FortressJUnitTest
                        
                    

    Tests should run with no errors.


11. Run the Fortress Command Line Interface:

                        
    
    mvn test -Pcli
                        
                    

    This program provides a command line interface for driving the fortress APIs. It is useful for ad-hoc and automated updates to the data. It's instruction manual is here: Fortress CLI Instruction Manual


12. Run the Fortress Console:

                        
    
    mvn test -Pconsole
                        
                    

    This program provides an interfactive console for driving the fortress functions. It is useful for testing and ad-hoc updates to the data.
    
    
    • Start at the Main Menu:
      
      Enter option to perform a particular manager function.
    
    
    • Option '1' for RBAC Admin Manager Functions:
      
      Add, Update and Delete RBAC entities.
    
    
    • Option '2' for RBAC Review Manager Functions:
      
      Read and Search RBAC entities.
    
    
    • Option '3' for RBAC Access Manager Functions:
      
      Test RBAC runtime functions like createSession and checkAccess.
    
    
    • etc

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