View source for Back up and Restore Active Directory Objects with BUS

==Background==
The basic idea is you use a script to export the Active Directory Users and Groups objects to a file, then back up that data file with BUS.  On restore, you recover the export file, then use import it to Active Directory.

==Active Directory Export==
<ol>
 <li>Install the BUS client on the Active Directory server.</li>
 <li>Download the '''ADuserbackup.zip''' file from ftp://ftp.swcp.com/pub/bus/ADuserbackup.zip
 </li>
 <li>Extract and place the files within the '''${BUS-Install-Home}\bin''' directory.</li>
 <li>Create an export directory, for example '''C:\BackupDir'''</li>
[[image:ADExport.png]]
 <li>Open the BUS client, ceate a file backup set for the AD objects backup.</li>
 <li>Select the export directory C:\BackupDir as Backup Source.</li>
 <li>Accept the default encryption settings if no change is necessary.</li>
 <li>Select the newly created backup set in the "Backup Settings" menu, select "Command Line Tool"</li>
 <li>Press "Add" under the Pre-Backup section on the right panel, then enter the following entries in the corresponding text fields:</li>
* Working Directory: C:\Program Files\AhsayOBM\bin
* Command: RunADExport.bat fout:C:\BackupDir\fExport.ldf
 </li>
 <li> Press "OK" to save this setting.</li>
[[image:ADExport2.png]]
</ol>

==Active Directory Import==
<ol>
 <li>Open the BUS client software, select "Restore".</li>
 <li>Select the AD Export backup set from the backup set list, "Next", and then browse to the export file. </li>
[[image:ADImport2a.png]]
 <li>Select the checkbox next to the fExport.ldf node and press "Start Restore"</li>
[[image:ADImport.png]]
 <li>Import all or individual objects from the export file:
* Option 1 - To import all Users and Groups from the export file:
** In command prompt, navigate to the directory that '''RunADImport.bat''' resides in.
** Enter the command: RunADImport.bat fin:${Input_Location}\fExport.ldf
* Option 2 - To import individual User or Group from the export file:
** In command prompt, navigate to the directory that '''RunADImportUser.bat''' resides in.
** Enter the command: RunADImportUser.bat fin:${Input_Location}\fExport.ldf
[[image:ADImport2.png]]
* Press 's' to list the user index ID.
[[image:ADImport3.png]]
* Press 'i' to import user by index ID.
[[image:ADImport4.png]]
* Press 'n' to import user by username.
[[image:ADImport5.png]]
: '''NOTE''': use double quotation marks for usernames with spaces.
* If the name of the group or user cannot be typed in the command prompt or cannot be displayed from the user index:
** Create a text file (e.g. name.txt) with a single line of content 'user:${username}'.
** Press 'f' to import user from file.
[[image:ADImport6.png]]
</li>
</ol>

==See Also==