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 2014/11/11 21:41:11 UTC
directory-fortress-enmasse git commit: change site readme
Repository: directory-fortress-enmasse
Updated Branches:
refs/heads/master 99852b55d -> f4d61023f
change site readme
Project: http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse/repo
Commit: http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse/commit/f4d61023
Tree: http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse/tree/f4d61023
Diff: http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse/diff/f4d61023
Branch: refs/heads/master
Commit: f4d61023f96e36cbd3c9139e957ccf98c043e653
Parents: 99852b5
Author: Shawn McKinney <sm...@apache.org>
Authored: Tue Nov 11 14:41:00 2014 -0600
Committer: Shawn McKinney <sm...@apache.org>
Committed: Tue Nov 11 14:41:00 2014 -0600
----------------------------------------------------------------------
src/site/apt/README.apt | 103 ++++++++++++++++++++++++-------------------
1 file changed, 58 insertions(+), 45 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse/blob/f4d61023/src/site/apt/README.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/README.apt b/src/site/apt/README.apt
index 3aba5e6..6bab8d0 100755
--- a/src/site/apt/README.apt
+++ b/src/site/apt/README.apt
@@ -1,35 +1,42 @@
#
-# This work is part of OpenLDAP Software <http://www.openldap.org/>.
+# 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
#
-# Copyright 1998-2014 The OpenLDAP Foundation.
-# All rights reserved.
+# 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.
#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted only as authorized by the OpenLDAP
-# Public License.
#
-# A copy of this license is available in the file LICENSE in the
-# top-level directory of the distribution or, alternatively, at
-# <http://www.OpenLDAP.org/license.html>.
#
# Fortress slapd.conf default settings.
# Note: Directives that begin with '@' are substitution parms for Fortress' build.xml 'init-slapd' target.
___________________________________________________________________________________
###################################################################################
README for Fortress EnMasse Web Application Installation
-RC36 (BETA RELEASE CANDIDATE)
-Last updated: April 27, 2014
+RC29 (BETA RELEASE CANDIDATE)
+Last updated: August 29, 2013
___________________________________________________________________________________
###################################################################################
-# Guidelines & Tips for first-time users of EnMasse Web Application
+# Prerequisites
###################################################################################
+1. Internet access to retrieve dependencies from online Maven repo.
-1. In the document that follows, when you read "[version]" substitute with current info.
- For example - if the downloaded package version is 1.0 change enmasse-dist-[version] to enmasse-dist-1.0
-
-2. The source code for this project is located under enmasse-dist-[version]/src folder.
+NOTE: The EnMasse maven may run without connection to Internet iff:
+- The binary dependencies are already present in M2_HOME
-3. For EnMasse Services-level documentation, jump to SECTION 6.
+2. Java SDK Version 7 or beyond installed to target environment
+3. Maven 3 installed to target environment
+4. Fortress/OpenLDAP are installed to target system.
___________________________________________________________________________________
###################################################################################
# Important Notes about EnMasse Web Application
@@ -74,42 +81,45 @@ Before you can successfully complete the steps to install and run EnMasse, the f
http://maven.apache.org/download.html
http://www.sonatype.com/books/mvnref-book/reference/installation-sect-maven-install.html
-3. Java SDK Version 6 or beyond installed:
+3. Java SDK Version 7 or beyond installed:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
4. Fortress/OpenLDAP QUICKSTART installed:
-instructions: http://jts.us/iamfortress/guides/README-QUICKSTART.html
-binaries: http://iamfortress.org/projects
+instructions: http://www.joshuatreesoftware.us/iamfortress/guides/README-QUICKSTART.html
+binaries: https://iamfortress.org/projects
5. Tomcat 7 installed:
-http://tomcat.apache.org/download-70.cgi
+http://tomcat.apache.org
6. Fortress Sentry package (a.k.a Realm) installed:
-instructions: http://jts.us/iamfortress/javadocs/api-sentry/org.apache.directory.fortress.core/sentry/tomcat/package-summary.html
-binaries: http://iamfortress.org/projects
+instructions: http://www.jts.us/iamfortress/javadocs/api-sentry/org/openldap/sentry/tomcat/package-summary.html
+binaries: http://iamfortress.org/download
+
+Note: There is a complete EnMasse demo that handles these prereqs for you located here:
+http://iamfortress.org/EnMasse
+
_________________________________________________________________________________
###################################################################################
# SECTION 2: Instructions for EnMasse installation using distribution package
###################################################################################
-1. Retrieve Fortress EnMasse source code bundle which is referred to below as 'enmasse-dist':
-http://iamfortress.org/projects
+1. Retrieve Fortress EnMasse source code bundle either from iamfortress.org or OpenLDAP.org.
-2. Extract contents of enmasse-dist-[version].zip to target env.
+2. Extract contents of openldap-fortress-enmasse.tar.gz to target env.
___________________________________________________________________________________
###################################################################################
# SECTION 3: Instructions to build EnMasse Web archive file
###################################################################################
-1. open a command prompt on target machine in the root folder of the enmasse-dist package
+1. Open a command prompt on target machine in the root folder of the enmasse-dist package
-2. set java home:
->export JAVA_HOME=/opt/jdk1.7.0_27/
+2. Set java home:
+>export JAVA_HOME=/opt/jdk1.7.0_10
-3. set maven home:
->export M2_HOME=/usr/share/maven2
+3. Set maven home:
+>export M2_HOME=/usr/share/maven
-4. run maven install:
+4. Run maven install:
>mvn install
###################################################################################
@@ -130,14 +140,17 @@ Add to file:
note: If you followed the installation steps of Fortress QUICKSTART your Tomcat Manager creds would be as above.
-2. enter maven command to deploy to Tomcat:
+2. Enter maven command to deploy to Tomcat:
>mvn tomcat:deploy
+
+3. To redeploy:
+>mvn tomcat:redeploy
___________________________________________________________________________________
###################################################################################
# SECTION 5: Instructions to test EnMasse Web application
###################################################################################
-1. run maven test
+1. Run maven test
>mvn test
note1: the EnMasse application must be deployed and running within your servlet container before the unit tests will complete successfully. If your EnMasse server
@@ -166,15 +179,15 @@ http.host=localhost
http.port=80
# These will override default and enable client to call REST implementations:
-reviewmgr.implementation=com.jts.fortress.rest.ReviewMgrRestImpl
-adminmgr.implementation=com.jts.fortress.rest.AdminMgrRestImpl
-accessmgr.implementation=com.jts.fortress.rest.AccessMgrRestImpl
-delegated.adminmgr.implementation=com.jts.fortress.rest.DelegatedAdminMgrRestImpl
-delegated.reviewmgr.implementation=com.jts.fortress.rest.DelegatedReviewMgrRestImpl
-policymgr.implementation=com.jts.fortress.rest.PswdPolicyMgrRestImpl
-delegated.accessmgr.implementation=com.jts.fortress.rest.DelegatedAccessMgrRestImpl
-auditmgr.implementation=com.jts.fortress.rest.AuditMgrRestImpl
-configmgr.implementation=com.jts.fortress.rest.ConfigMgrRestImpl
+reviewmgr.implementation=org.apache.directory.fortress.core.rest.ReviewMgrRestImpl
+adminmgr.implementation=org.apache.directory.fortress.core.rest.AdminMgrRestImpl
+accessmgr.implementation=org.apache.directory.fortress.core.rest.AccessMgrRestImpl
+delegated.adminmgr.implementation=org.apache.directory.fortress.core.rest.DelegatedAdminMgrRestImpl
+delegated.reviewmgr.implementation=org.apache.directory.fortress.core.rest.DelegatedReviewMgrRestImpl
+policymgr.implementation=org.apache.directory.fortress.core.rest.PswdPolicyMgrRestImpl
+delegated.accessmgr.implementation=org.apache.directory.fortress.core.rest.DelegatedAccessMgrRestImpl
+auditmgr.implementation=org.apache.directory.fortress.core.rest.AuditMgrRestImpl
+configmgr.implementation=org.apache.directory.fortress.core.rest.ConfigMgrRestImpl
___________________________________________________________________________________
###################################################################################
@@ -189,8 +202,8 @@ $ mvn javadoc:javadoc
2. View the document output here:
-enmasse-dist-[version]/target/site/apidocs
+openldap-fortress-enmasse/target/site/apidocs
3. To view Service-level documentation, go here:
-enmasse-dist-[version]/target/site/apidocs/org/openldap/enmasse/FortressServiceImpl.html
\ No newline at end of file
+openldap-fortress-enmasse/target/site/apidocs/org/openldap/enmasse/FortressServiceImpl.html
\ No newline at end of file