directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1774854 - in /directory/site/trunk/content/apacheds/basic-ug: 1-how-to-begin.mdtext 1.5-sample-configuration.mdtext 1.6-backup-restore.mdtext 2-handling-data.mdtext
Date Sun, 18 Dec 2016 07:15:50 GMT
Author: elecharny
Date: Sun Dec 18 07:15:50 2016
New Revision: 1774854

URL: http://svn.apache.org/viewvc?rev=1774854&view=rev
Log:
Added documentation on backup/restore

Added:
    directory/site/trunk/content/apacheds/basic-ug/1.6-backup-restore.mdtext
Modified:
    directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
    directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext

Modified: directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext?rev=1774854&r1=1774853&r2=1774854&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext Sun Dec 18 07:15:50
2016
@@ -36,4 +36,5 @@ This user guide is **not** intended to b
 	* [1.4.3 - Adding your own partition resp. suffix](1.4.3-adding-partition.html)
 	* [1.4.4 - Configure logging](1.4.4-configure-logging.html)
 	* [1.4.5 - Enable and disable anonymous access](1.4.5-anonymous-access.html)
-* [1.5 - About the sample configurations and sample directory data](1.5-sample-configuration.html)
\ No newline at end of file
+* [1.5 - About the sample configurations and sample directory data](1.5-sample-configuration.html)
+* [1.6 - Backup/Restore](1.6-backup-restore.html)
\ No newline at end of file

Modified: directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext?rev=1774854&r1=1774853&r2=1774854&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext Sun Dec
18 07:15:50 2016
@@ -3,8 +3,8 @@ NavPrev: 1.4.5-anonymous-access.html
 NavprevText: 1.4.5 - Enable and disable anonymous access
 NavUp: 1-how-to-begin.html
 NavUpText: 1 - How to begin
-NavNext: 2-handling-data.html
-NavNextText: 2 - Handling data within your directory
+NavNext: 1.6-backup-restore.html
+NavNextText: 1.6. - Backup/Restore
 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

Added: directory/site/trunk/content/apacheds/basic-ug/1.6-backup-restore.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.6-backup-restore.mdtext?rev=1774854&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.6-backup-restore.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.6-backup-restore.mdtext Sun Dec 18 07:15:50
2016
@@ -0,0 +1,40 @@
+Title: 1.6. - Backup/Restore
+NavPrev: 1.5-sample-configuration.html
+NavprevText: 1.5 - About the sample configurations and sample directory data    
+NavUp: 1-how-to-begin.html
+NavUpText: 1 - How to begin
+NavNext: 2-handling-data.html
+NavNextText: 2 - Handling data within your directory
+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. - Backup/Restore
+
+You may want to save your data in a safe place, and be able to restore them.
+
+**ApacheDS** stores its data into a set of files, which are binary files. You can't simply
copy those files in a backup directory, because there is no guarantee that their state is
consistant when you do a copy (unless you have stopped the server while doing so) : one update
operation might be running when you do a copy, and unless this update has been completed,
the database is nt in a stable state.
+
+The current solution is to extract a LDIF from ApacheDS. You can do so either by using Apache
Directory Studio, or through a script using the slapsearch utility, on the partition you are
interested in. In any case, you must requests all the attributes, including the operational
attributes (use the '+' special attributes for that purpose). Here is a sample command line
that extract the data from the 'example' partition, on a default ApacheDS install :
+
+    $ ldapsearch -D "uid=admin,ou=system" -w secret -p 10389 -h localhost -b "dc=example,dc=com"
-s sub "(ObjectClass=*)" * + > backup.ldif
+
+(note that you will have to change the password, port, server name and partition name to
fits your setup)
+
+Restoring the database is a matter of starting frm a blank partition, and reimport the LDIF.
+
+Note : This is not really convenient. First, it requires that an external tool is present
to run the extract. Second, reimporting a huge database will take a lot of time...
+We are working on a new system that guarantees that the file containing the data can be copied
directly and restored as is.
\ No newline at end of file

Modified: directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext?rev=1774854&r1=1774853&r2=1774854&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext Sun Dec 18 07:15:50
2016
@@ -1,6 +1,6 @@
 Title: 2 - Handling of data within your directory
-NavPrev: 1.5-sample-configuration.html
-NavPrevText: 1.5. - About the sample configurations and sample directory data   
+NavPrev: 1.6-backup-restore.html
+NavPrevText: 1.6. - Backup/Restore
 NavUp: ../basic-user-guide.html
 NavUpText: Basic User Guide
 NavNext: 2.1-data-modification.html



Mime
View raw message