You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2016/12/18 07:15:50 UTC
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
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