Domain backup and rename: Difference between revisions

From SambaWiki
(Created page with "{{subst:NewFeature}}")
 
No edit summary
Line 1: Line 1:
== Overview ==
== Overview ==


'''Added in Samba version:''' ''<The next Samba release containing the feature>''
'''Added in Samba version:''' v4.9


Samba backups provide a way to recover your Samba network, in the unlikely event that a catastrophic failure of the domain occurs. For more details on the different types of Samba backups and how to use them, see [[Back up and Restoring a Samba AD DC]].
''<What does the feature do, Why might users care about it, What is the Microsoft-equivalent that a Windows admin might be familiar with, etc>''

One of the backup options involves renaming the domain (see [[Domain rename tool]]). Note that this works completely differently to the Windows tool for renaming domains, i.e. rendom. Windows renames each DC one at a time in situ. Whereas the Samba approach is to take a renamed copy of the domain, and start re-adding DCs again from scratch.


=== How to configure it ===
=== How to configure it ===


Use the <code>samba-tool domain backup</code> set of commands to create a backup-file. There are three flavours to choose from:
''<Just reference the relevant samba-tool/smb.conf options (your man-page/help documentation should already be clear enough)>''
<pre>
samba-tool domain backup online
samba-tool domain backup offline
samba-tool domain backup rename
</pre>

Then use <code>samba-tool domain backup restore</code> to restore the backup-file. Generally, you'll need to run the backup/restore commands as root. See [[Back up and Restoring a Samba AD DC]] for more details.


=== Known issues and limitations ===
=== Known issues and limitations ===


The most important concept to grasp is you're taking a backup of your entire ''domain'', not an individual DC. So restoring the domain is essentially completely replacing the existing domain DCs.
''<Any outstanding bugs, configurations not supported, etc>''

You can't restore the domain to the default install location (i.e. <tt>/usr/local/samba</tt>). You have to specify a new DC during the restore, i.e. one that is not already in the domain. See our [[Back_up_and_Restoring_a_Samba_AD_DC#Recommended_strategy|recommended strategy]] for how to deal work around these problems.

See bug #13621 in Samba bugzilla for current issues in v4.9.0.


=== Troubleshooting ===
=== Troubleshooting ===


See [[Back_up_and_Restoring_a_Samba_AD_DC#Troubleshooting|Troubleshooting]].
''<What debug level do you need to run to see messages of interest. Are there any other ways to verify the feature is doing what it should>''


== For Developers ==
== For Developers ==
Line 36: Line 49:


[[Category:New Feature]]
[[Category:New Feature]]
[[Category:Backup]]
[[Category:Active Directory]]

Revision as of 03:23, 20 September 2018

Overview

Added in Samba version: v4.9

Samba backups provide a way to recover your Samba network, in the unlikely event that a catastrophic failure of the domain occurs. For more details on the different types of Samba backups and how to use them, see Back up and Restoring a Samba AD DC.

One of the backup options involves renaming the domain (see Domain rename tool). Note that this works completely differently to the Windows tool for renaming domains, i.e. rendom. Windows renames each DC one at a time in situ. Whereas the Samba approach is to take a renamed copy of the domain, and start re-adding DCs again from scratch.

How to configure it

Use the samba-tool domain backup set of commands to create a backup-file. There are three flavours to choose from:

samba-tool domain backup online
samba-tool domain backup offline
samba-tool domain backup rename

Then use samba-tool domain backup restore to restore the backup-file. Generally, you'll need to run the backup/restore commands as root. See Back up and Restoring a Samba AD DC for more details.

Known issues and limitations

The most important concept to grasp is you're taking a backup of your entire domain, not an individual DC. So restoring the domain is essentially completely replacing the existing domain DCs.

You can't restore the domain to the default install location (i.e. /usr/local/samba). You have to specify a new DC during the restore, i.e. one that is not already in the domain. See our recommended strategy for how to deal work around these problems.

See bug #13621 in Samba bugzilla for current issues in v4.9.0.

Troubleshooting

See Troubleshooting.

For Developers

How to test it

make test TESTS=blah

<Anything else notable about running the tests...>

Where the code is located

<Notable files/functions to start looking at...>

Reference Docs

<E.g. Microsoft specification/section that describes the feature in more detail>