| 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>
|
|---|
