1USN-TOMBSTONE-CLEANUP.PL(8) System Manager's ManualUSN-TOMBSTONE-CLEANUP.PL(8)
2
3
4
6 usn-tombstone-cleanup.pl - Directory Server perl script for cleaning up
7 tombstone entries.
8
10 usn-tombstone-cleanup.pl [-Z serverID] [-D rootdn] { -w password | -w -
11 | -j filename } -s suffix -n backend [-m maxusn_to_delete] [-P proto‐
12 col] [-h]
13
15 Deletes the tombstone entries maintained by the instance if the USN
16 Plug-in is enabled.
17
19 A summary of options is included below:
20
21 -Z Server Identifier
22 The server ID of the Directory Server instance. If there is
23 only one instance on the system, this option can be skipped.
24
25 -D Root DN
26 The Directory Manager DN, or root DN. If not specified, the
27 script will search the server instance configuration for the
28 value.
29
30 -w password
31 The rootdn password.
32
33 -w -
34 Prompt for the rootdn password.
35
36 -j password filename
37 The name of the file that contains the root DN password.
38
39 -s suffix
40 Gives the name of the suffix containing the entries to
41 clean/delete.
42
43 -n backend
44 Gives the name of the database containing the entries to
45 clean/delete. Example, userRoot.
46
47 -m maxusn_to_delete
48 Sets the upper bound for entries to delete. All tombstone
49 entries with an entryUSN value up to the specified maximum
50 (inclusive) are deleted, but not past that USN value. If no max‐
51 imum USN value is set, then all backend tombstone entries are
52 deleted.
53
54 -P protocol
55 The connection protocol to connect to the Directory Server.
56 Protocols are STARTTLS, LDAPS, LDAPI, and LDAP. If this option
57 is skipped, the most secure protocol that is available is used.
58 For LDAPI, AUTOBIND is also available for the root user.
59
60 -h
61 Display usage
62
64 usn-tombstone-cleanup.pl -Z instance2 -D 'cn=directory manager' -w
65 password -n userRoot -s 'ou=people,dc=example,dc=com' -P STARTTLS
66
67 Note: security must be enabled to use protocol STARTTLS. If
68 STARTTLS is not available it will default to next strong‐
69 est/available protocol automatically.
70
72 Exit status is zero if no errors occur. Errors result in a non-zero
73 exit status and a diagnostic message being written to standard error.
74
76 usn-tombstone-cleanup.pl was written by the 389 Project.
77
79 Report bugs to https://pagure.io/389-ds-base/new_issue
80
82 Copyright © 2017 Red Hat, Inc.
83
84
85
86 March 31, 2017 USN-TOMBSTONE-CLEANUP.PL(8)