Bug 1310925

Description of problem:

broken example of db2bak.pl in the RHDS 10 admin guide
in
https://access.redhat.com/documentation/en-US/Red_Hat_Directory_Server/10/html/Administration_Guide/Populating_Directory_Databases-Backing_Up_and_Restoring_Data.html
chapter
4.3.1.2. Backing up All Databases from the Command Line

it says
"
[root@server ~]# /usr/lib64/dirsrv/slapd-example/db2bak.pl /var/lib/dirsrv/slapd-instance/bak/instance-2015_04_30_16_27_56
"

which does not work and confuse customers

if the intent is to show a task use while the server is running, it should be like this example:

"
[root@server ~]# /usr/lib64/dirsrv/slapd-example/db2bak.pl -D "cn=Directory Manager" -w - -a /var/lib/dirsrv/slapd-instance/bak/instance-2015_04_30_16_27_5-custom-name
"


and add an extra note about the path when specifying the -A option (or should this note go into a kb article?):

Note: When using the -A option, do not provide a trailing slash to the destination directory if only indicating the nsslapd-bakdir directory, there will be an error otherwise.
this will fail
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -a /var/lib/dirsrv/slapd-m2/bak/
but this will work
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -a /var/lib/dirsrv/slapd-m2/bak
and this will work
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -a /var/lib/dirsrv/slapd-m2/bak/m2-test/
as well as this form:
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -a /var/lib/dirsrv/slapd-m2/bak/m2-test


I am providing 2 examples here, not sure if this should go into the admin guide:

broken db2bak.pl example with the -A option:
"
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -A /var/lib/dirsrv/slapd-m2/bak/
Back up directory: /var/lib/dirsrv/slapd-m2/bak//m2-2016_2_22_16_28_27
Successfully added task entry "cn=backup_2016_2_22_16_28_27, cn=backup, cn=tasks, cn=config"
[root@m2 ~]# 

and in the /var/log/dirsrv/slapd-m2/errors log file:
[22/Feb/2016:16:28:26 -0800] - Beginning backup of 'ldbm database'
[22/Feb/2016:16:28:26 -0800] - mkdir_p /var/lib/dirsrv/slapd-m2/bak/m2-2016_2_22_16_28_27: error -5943 (Cannot create or rename a filename that already exists.)
[22/Feb/2016:16:28:26 -0800] - Can't create new directory /var/lib/dirsrv/slapd-m2/bak/m2-2016_2_22_16_28_27/userRoot, Netscape Portable Runtime error -5943 (Cannot create or rename a filename that already exists.)
[22/Feb/2016:16:28:26 -0800] - Backup: error in copying directory (/var/lib/dirsrv/slapd-m2/db/userRoot -> /var/lib/dirsrv/slapd-m2/bak/m2-2016_2_22_16_28_27): err=-1
[22/Feb/2016:16:28:27 -0800] - Backup finished.

"

good db2bak.pl example with the -A option:
"
/usr/lib64/dirsrv/slapd-m2/db2bak.pl -D "cn=Directory Manager" -w password -A /var/lib/dirsrv/slapd-m2/bak
Back up directory: /var/lib/dirsrv/slapd-m2/bak/m2-2016_2_22_16_29_45
Successfully added task entry "cn=backup_2016_2_22_16_29_45, cn=backup, cn=tasks, cn=config"
"
and the task completes with a success.



Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info: