1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 3<refentry id="tdbbackup.8"> 4 5<refmeta> 6 <refentrytitle>tdbbackup</refentrytitle> 7 <manvolnum>8</manvolnum> 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version">3.5</refmiscinfo> 11</refmeta> 12 13 14<refnamediv> 15 <refname>tdbbackup</refname> 16 <refpurpose>tool for backing up and for validating the integrity of samba .tdb files</refpurpose> 17</refnamediv> 18 19<refsynopsisdiv> 20 <cmdsynopsis> 21 <command>tdbbackup</command> 22 <arg choice="opt">-s suffix</arg> 23 <arg choice="opt">-v</arg> 24 <arg choice="opt">-h</arg> 25 </cmdsynopsis> 26</refsynopsisdiv> 27 28<refsect1> 29 <title>DESCRIPTION</title> 30 31 <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle> 32 <manvolnum>1</manvolnum></citerefentry> suite.</para> 33 34 <para><command>tdbbackup</command> is a tool that may be used to backup samba .tdb 35 files. This tool may also be used to verify the integrity of the .tdb files prior 36 to samba startup or during normal operation. If it finds file damage and it finds 37 a prior backup the backup file will be restored. 38 </para> 39</refsect1> 40 41 42<refsect1> 43 <title>OPTIONS</title> 44 45 <variablelist> 46 47 <varlistentry> 48 <term>-h</term> 49 <listitem><para> 50 Get help information. 51 </para></listitem> 52 </varlistentry> 53 54 <varlistentry> 55 <term>-s suffix</term> 56 <listitem><para> 57 The <command>-s</command> option allows the adminisistrator to specify a file 58 backup extension. This way it is possible to keep a history of tdb backup 59 files by using a new suffix for each backup. 60 </para> </listitem> 61 </varlistentry> 62 63 <varlistentry> 64 <term>-v</term> 65 <listitem><para> 66 The <command>-v</command> will check the database for damages (currupt data) 67 which if detected causes the backup to be restored. 68 </para></listitem> 69 </varlistentry> 70 71 </variablelist> 72</refsect1> 73 74 75<refsect1> 76 <title>COMMANDS</title> 77 78 <para><emphasis>GENERAL INFORMATION</emphasis></para> 79 80 <para> 81 The <command>tdbbackup</command> utility can safely be run at any time. It was designed so 82 that it can be used at any time to validate the integrity of tdb files, even during Samba 83 operation. Typical usage for the command will be: 84 </para> 85 86 <para>tdbbackup [-s suffix] *.tdb</para> 87 88 <para> 89 Before restarting samba the following command may be run to validate .tdb files: 90 </para> 91 92 <para>tdbbackup -v [-s suffix] *.tdb</para> 93 94 <para> 95 Samba .tdb files are stored in various locations, be sure to run backup all 96 .tdb file on the system. Important files includes: 97 </para> 98 99 <itemizedlist> 100 <listitem><para> 101 <command>secrets.tdb</command> - usual location is in the /usr/local/samba/private 102 directory, or on some systems in /etc/samba. 103 </para></listitem> 104 105 <listitem><para> 106 <command>passdb.tdb</command> - usual location is in the /usr/local/samba/private 107 directory, or on some systems in /etc/samba. 108 </para></listitem> 109 110 <listitem><para> 111 <command>*.tdb</command> located in the /usr/local/samba/var directory or on some 112 systems in the /var/cache or /var/lib/samba directories. 113 </para></listitem> 114 </itemizedlist> 115 116</refsect1> 117 118<refsect1> 119 <title>VERSION</title> 120 121 <para>This man page is correct for version 3 of the Samba suite.</para> 122</refsect1> 123 124<refsect1> 125 <title>AUTHOR</title> 126 127 <para> 128 The original Samba software and related utilities were created by Andrew Tridgell. 129 Samba is now developed by the Samba Team as an Open Source project similar to the way 130 the Linux kernel is developed. 131 </para> 132 133 <para>The tdbbackup man page was written by John H Terpstra.</para> 134</refsect1> 135 136</refentry> 137