Mailing-List: contact commits-help@directory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@directory.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1405672 -
 /directory/site/trunk/content/apacheds/advanced-ug/
Date: Sun, 04 Nov 2012 23:29:17 -0000
To: commits@directory.apache.org
From: elecharny@apache.org
Message-Id: <20121104232918.295E42388A56@eris.apache.org>

Author: elecharny
Date: Sun Nov  4 23:29:17 2012
New Revision: 1405672

URL: http://svn.apache.org/viewvc?rev=1405672&view=rev
Log:
Added some placeholder pages in the AUG

Added:
    directory/site/trunk/content/apacheds/advanced-ug/1.1-architecture-overview.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1.2-frontend-protocols.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1.3-interceptors.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1.4-backend.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1.5-schemamanager.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1.6-admin-model.mdtext
Modified:
    directory/site/trunk/content/apacheds/advanced-ug/0.3-contributing.mdtext
    directory/site/trunk/content/apacheds/advanced-ug/1-architecture.mdtext

Modified: directory/site/trunk/content/apacheds/advanced-ug/0.3-contributing.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/0.3-contributing.mdtext?rev=1405672&r1=1405671&r2=1405672&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/0.3-contributing.mdtext (original)
+++ directory/site/trunk/content/apacheds/advanced-ug/0.3-contributing.mdtext Sun Nov  4 23:29:17 2012
@@ -1,6 +1,8 @@
 Title: 0.3 - Contributing
-NavUp: ../advanced-users-guide.html
-NavUpText: Advanced User Guide
+NavPrev: 0.2-building-trunks.html
+NavPrevText: 0.2 - Building Trunks
+NavUp: 0-community.html
+NavUpText: 0 - Community
 NavNext: 1-architecture.html
 NavNextText: 1 - Architecture
 Notice: Licensed to the Apache Software Foundation (ASF) under one
@@ -21,4 +23,3 @@ Notice: Licensed to the Apache Software 
     under the License.
 
 # 0.3 - Contributing
-TODO...
\ No newline at end of file

Modified: directory/site/trunk/content/apacheds/advanced-ug/1-architecture.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1-architecture.mdtext?rev=1405672&r1=1405671&r2=1405672&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1-architecture.mdtext (original)
+++ directory/site/trunk/content/apacheds/advanced-ug/1-architecture.mdtext Sun Nov  4 23:29:17 2012
@@ -1,10 +1,10 @@
 Title: 1 - Architecture
 NavPrev: 0-community.html
-NavNextText: 0 - Community
+NavPrevText: 0 - Community
 NavUp: 0-community.html
 NavUpText: 0 - Community
-NavNext: 0.2-
-NavNextText: 0.2 - 
+NavNext: 2-server-config.html
+NavNextText: 2 - Server Configuration
 Notice: 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
@@ -24,3 +24,13 @@ Notice: Licensed to the Apache Software 
 
 # 1 - Architecture
 
+We will now describe the server architecture, in order to give you a more deeper understanding of the way the server works.
+
+## Chapter content
+
+* [1.1 - Architectural Overview](1.1-architecture-overview.html)
+* [1.2 - Frontend, protocol provider](1.2-frontend-protocols.html)
+* [1.3 - Interceptors](1.3-interceptors.html)
+* [1.4 - Backend](1.4-backend.html)
+* [1.5 - SchemaManager](1.5-schema-manager.html)
+* [1.6 - Administrative Model](1.6-admin-model.html)

Added: directory/site/trunk/content/apacheds/advanced-ug/1.1-architecture-overview.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.1-architecture-overview.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.1-architecture-overview.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.1-architecture-overview.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,27 @@
+Title: 1.1 - Architecture Overview
+NavPrev: 1-architecture.html
+NavPrevText: 1 - Architecture
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 1.2-frontend-protocols.html
+NavNextText: 1.2 - Frontend, protocol provider
+Notice: 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.
+
+# 1.1 - Architecture Overview
+
+Blah...

Added: directory/site/trunk/content/apacheds/advanced-ug/1.2-frontend-protocols.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.2-frontend-protocols.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.2-frontend-protocols.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.2-frontend-protocols.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,27 @@
+Title: 1.2 - Frontend, protocol provider
+NavPrev: 1.1-architecture-overview.html
+NavPrevText: 1.1 - Architecture Overview
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 1.3-Interceptors.html
+NavNextText: 1.3 - Interceptors
+Notice: 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.
+
+# 1.2 - Frontend, protocol provider
+
+Blah...

Added: directory/site/trunk/content/apacheds/advanced-ug/1.3-interceptors.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.3-interceptors.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.3-interceptors.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.3-interceptors.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,27 @@
+Title: 1.3 - Interceptors
+NavPrev: 1.2-frontend-protocols.html
+NavPrevText: 1.2 - Frontend, protocol provider
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 1.4-backend.html
+NavNextText: 1.4 - Backend
+Notice: 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.
+
+# 1.3 - Interceptors
+
+Blah...

Added: directory/site/trunk/content/apacheds/advanced-ug/1.4-backend.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.4-backend.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.4-backend.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.4-backend.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,27 @@
+Title: 1.4 - Backend
+NavPrev: 1.3-interceptors.html
+NavPrevText: 1.3 - Interceptors
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 1.5-schemamanager.html
+NavNextText: 1.5 - SchemaManager
+Notice: 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.
+
+# 1.4 - Backend
+
+Blah...

Added: directory/site/trunk/content/apacheds/advanced-ug/1.5-schemamanager.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.5-schemamanager.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.5-schemamanager.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.5-schemamanager.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,27 @@
+Title: 1.5 - SchemaManager
+NavPrev: 1.4-backend.html
+NavPrevText: 1.4 - Backend
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 1.6-admin-model.html
+NavNextText: 1.6 - Administrative Model
+Notice: 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.
+
+# 1.5 - SchemaManager
+
+Blah...

Added: directory/site/trunk/content/apacheds/advanced-ug/1.6-admin-model.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/1.6-admin-model.mdtext?rev=1405672&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/1.6-admin-model.mdtext (added)
+++ directory/site/trunk/content/apacheds/advanced-ug/1.6-admin-model.mdtext Sun Nov  4 23:29:17 2012
@@ -0,0 +1,67 @@
+Title: 1.6 - Administrative Model
+NavPrev: 1.5-schemaManager.html
+NavPrevText: 1.5 - SchemaManager
+NavUp: 1-architecture.html
+NavUpText: 1 - Architecture
+NavNext: 2-server-config.html
+NavNextText: 2 - Server Configuration
+Notice: 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.
+
+# 1.6 - Administrative Model
+
+The **Administrative Model** is a really critical notion that need to be understood, because it drives many of ApacheDS roles, including :
+
+* Authorization
+* Schema
+* Triggers
+* Collective Attributes
+* Replication
+
+It's directly inherited by the **X.500** Administrative model (in fact, we do implement the full **X.500** sepcification related to **AAs**).
+
+## What is the Administrative Model ?
+
+The idea is to define the **DIT** as some areas which are administrated. Each area can be defined, and covers a set of entries, and each area can manage one ore more roles we want to manage. Those roles can be related to authorization, schema, etc... Each of this areas can overlap, but in any case, if two areas are overlaping, then one area totally include the other one. 
+
+The Admnistrative Model is everything we need to implement in order to be able to manage roles on some defined areas.
+
+## Areas
+
+An Area describe a part of the **DIT** which will start from a specific entry, and span across a part of the subtree starting at the base entry. An area is administrated by an **AP** (Administrative Point) which holds all the needed information about the area and the roles.
+
+We have three kind of areas :
+
+* AAA : Autonomous Administrative Areas
+* SAA : Specific Administrative Areas
+* IAA : Inner Administrative Areas
+
+**AAAs** cover all the roles as if we have declared one **SAA** for each existing role. They overload any area in which they can be encapsulated, hiding them.
+
+**SAAs** cover one specific role, and overload any encapsulating area with the same role.
+
+**IAAs** cover one specific role, but don't not overload any encapsulating area with the same role.
+
+## Administration Point
+
+Once we know which area we need to define, and the associated roles, it's mandatory to store those information in the **DIT**. This is done by adding **Administration Point**, which just are entries storing all the administrative configuration.
+
+An Administrative Point is stored as an entry (a sub-entry, to be more specific) just below the base of the defined area.
+
+<DIV class="info" markdown="1">
+	A **Subentry** is just a plain normal entry except that it contains administative model informations. They are stored below the entry they are managing, as a child entry.
+</DIV>
\ No newline at end of file