From: John H Terpstra Date: Wed, 28 May 2008 16:00:49 +0000 (-0500) Subject: Added TDB File documentation requested by some users. X-Git-Tag: samba-4.0.0alpha6~801^2~950 X-Git-Url: http://git.samba.org/samba.git/?p=kai%2Fsamba-autobuild%2F.git;a=commitdiff_plain;h=cfa41921adbdf478a5dd66243f77b5ce35d33881 Added TDB File documentation requested by some users. (cherry picked from commit 5035311af639336fdc51fa9829e984ff281216f9) (cherry picked from commit a7531f4964ac8f861a41e9fa446e5a3aa69eaaa2) (This used to be commit e5c2665ef8cb44f1ef1ec16d21358e5f37b81d6b) --- diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml b/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml new file mode 100644 index 00000000000..2c9cefcfda5 --- /dev/null +++ b/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml @@ -0,0 +1,152 @@ + + + + + + &author.jht; + + 21 May 2008 + + +Managing TDB Files + + +Features and Benefits + + +tdb +Trivial Database + Samba uses a lightweight database called Trivial Database (tdb) in which it stores persistent and transient data. + Some tdb files can be disposed of before restarting Samba, but others are used to store information that is vital + to Samba configuration and behavior. The following information is provided to help administrators who are seeking + to better manage their Samba installations. + + + +tdb +currupted +backup +restore + Those who package Samba for commercial distribution with operating systems and appliances would do well to take + note that tdb files can get corrupted, and for this reason ought to be backed up regularly. An appropriate time + is at system shutdown (backup) and startup (restore from backup). + + + + Samba's Trivial Database Files + + + File namePreserveDescription + + + + account_policy.tdbY + NT account policy settings such as pw expiration, etc... + brlock.tdbN + Byte range locks. + browse.datN + Browse lists - gets rebuilt automatically. + connections.tdbN + Share connections. Used to enforce max connections, etc. + gencache.tdbN + Generic caching database. + group_mapping.tdbY + Stores group mapping information. Not used when using LDAP backend. + lang_en.tdbY + Stores language encoding information. + locking.tdbN + Stores share mode and oplock information. + login_cache.tdbN + Keeps a log of bad pw attempts. + messages.tdbN + Used to keep track of Samba internal messaging. + netsamlogon_cache.tdbY + + Cache of user net_info_3 struct from net_samlogon() + requests from domain member machines. + + ntdrivers.tdbY + Stores installed printer driver information. + ntforms.tdbY + Stores installed printer forms information. + ntprinters.tdbY + Stores installed printers information. + printing directoryY + Directory containing tdb per print queue of cached lpq output. + registry.tdbY + Windows registry skeleton (connect via regedit.exe). + sessionid.tdbN + Session information to support utmp = yes capabilities. + share_info.tdbY + Stores share-level ACL configuration settings. + Default ACL is Everyone - Full Control. + + unexpected.tdbN + + Unexpected packet queue needed to support windows clients that respond on a + different port that the originating reques. + + winbindd_cache.tdbN + Winbind's cache of user lists. + winbindd_idmap.tdbY + Winbind's local IDMAP database. + wins.datN + + WINS database iused only when wins support = yes + has been set. This gets rebuilt or updated at every restart. + + wins.tdbY + + The working permanent storage for all WINS data. This database is used only + when wins support = yes has been set in the &smb.conf; file. + Note: This retains all manually configured WINS entries. Manual setting can be done use the net utility. + + secrets.tdbY + + This tdb file stores internal settings such as the machine and the domain SID, secret passwords + that are used with LDAP, the machine secret token, etc. This is an essential file that is stored + in a secure area. Vendors locate this in various folders. Check smbd -b to + find its location on your system. + + schannel_store.tdbY + + This stores secure channel access token information used with SMB signing. + + passdb.tdbY + + This stores the Samba SAM account information when using a tdbsam password backend. + + + +
+ + + + +Managing TDB Files + + + The tdbbackup utility is a tool that may be used to backup samba tdb files. + This tool may also be used to verify the integrity of the tdb files prior to Samba startup or + during normal operation. If it finds file damage it will search for a prior backup the backup + file from which the damaged tdb file will be restored. The tdbbackup + utility can safely be run at any time. It was designed so that it can be used at any time to + validate the integrity of tdb files, even during Samba operation. + + + + It is recommended to backup all tdb files as part of the Samba start-up scripts on a Samba + server. The following command syntax can be used: + + +myserver# > cd /var/lib/samba +myserver@ > tdbbackup *.tdb + + + The default extension is .bak. Any alternate extension can be specified + by executing tdbbackup -s 'new_extension' *.tdb as part of your startup script. + + + + + diff --git a/docs-xml/Samba3-HOWTO/index.xml b/docs-xml/Samba3-HOWTO/index.xml index 1253b0352e0..87b07951c7a 100644 --- a/docs-xml/Samba3-HOWTO/index.xml +++ b/docs-xml/Samba3-HOWTO/index.xml @@ -193,6 +193,8 @@ The chapters in this part each cover specific Samba features. + +