Visitor Stats

Visits today:2
Visits yesterday:46
Visits in this month:1166
Visits total:115235
Bots today:1

Article Index
NDSBackup config general
ndsbackup config service
ndsbackup config logging
ndsbackup config restore
All Pages

There is an interactive and a service version (extended version only) of the backup.

  • Backup.exe Allows you to backup a tree interactively. The windows user must have enough (admin) rights to the eDirectory. It is also possible to  backup trustee rights.
  • Service (backserv.exe). The windows service can backup multiple trees (sequentieel), it is also possible to backup trustee rights.
  • Restore.exe There are only 3 settings for restore.exe.

Backup and the service use the same configuration data, for the service you need to give the user/password combination for the tree to login.

The configuration information is partial tree specific and some is general information, all the information is stored in the backrest.ini file.

With the program bsrConfig.exe (config in the menu) you can setup the configuration At the top there are 3 buttons. From left to right: Exit, language, “What is This” (short help).

Tree Info: Select the tree, if it is not in the list, use Add Tree.  Warning: You need to be authenticated to the tree you want to add.

Top: Select the “top” of your tree, normally this will be [ROOT]. In case your company is part of a larger company, where you can only manager a smaller sub-tree, you can set the “top” of your subtree as your new top. This will save a lot of time, the program doesn’t have to browse the  objects above your sub-tree. You probably even couldn’t read the data above your sub-tree. In this situation you probably aren’t allowed to change the schema! Keep you company policies always in mind!

Autostart: This option is only used by backup.exe. If checked then backup.exe will automatically start the backup (after a 30 seconds delay) with the default settings.

Path: The program stores all the backup data into a single file. Give the path where the file need to be saved. There is a special charactersequence  %t. The program will replace the %t with the current treename.

Filename: Give the filename for the backup file. There are 3 special charactersequences:

%t this will be replaced with the treename
%d replaced by the current date
%h replaced by the current time

Do not give an extention or path!

Ext: Default the extention of the backupfile is nds.

Links: Many objects in the NDS have other objects pointing to them, you can think of the links between group and users, but also ACL-rights  (nds-rights) are pointers from other objects to the object. If you include the links to an object, you can also restore security equals and ACL-rights  (and others). Gettting all the links is a intensive process, so an backup without links will be much faster, but you can’t restore the whole  functionality of an object. Default are the links included.

File rights: The program can also backup the trustee rights to directories (on a Netware server) of an object. On restore these rights can also be  restored. The program needs to know which servers and volumes must be included. You have to create a special ini-file where you define the  properties. This option is only usefull in the extended version or during the first 60 days of the standard version.

Vols: Give the complete path and filename of the file where the server/volumes are given that need to be scanned for the trustees. Only available in the extended version.

Partition check: Not supported in this version.

Use Master if possible: The program will always use the master replica of the partitions for the backup. This can be a problem if the server with the replica is down. In the next version the program will use the master unless the server is not available and will use any R/W replica


The service needs to login into the tree before it can make the backup. If you want to use the service, enter the username and password. The  password will be masked with * and will be stored encrypted in the ini-file. This Tab is only available in the extended version. Don't forget to set the  service information on the Global-tab!

There are some logging options available.

All Object names:  This will generated a long list with all objects that are backupped. This option is mostly used for debugging purposes.

Count Object types: in the log there will be a list of all classnames and the count in the backup file.

Add log to backup-file: The program will write a log-file with the same name in the backup destination directory. If this option is checked, then the logfile is also be included in the backup-file, so  you can delete the log-files in the destination directory later.

Send Mail:  If checked then the program will send an SMTP mail with some status information about the backup. You have to setup the mail information on the global Mail tab.

Add log to Mail: Not supported yet.


Auxiliary classes When Unchecked the program will use the standaard Novell library, and it is not possible to restore objects with auxiliary classes attachted to them. When checked then the program will use a non-standaard library/methode to restore the object. It is possible to restore objects with auxiliary-classes, but there are some limitations (see also restore).
Auto Retry During a (large) restore it could happen that the NDS is to slow and there are –659 errors. When this option is checked, the program will do an automatic retry to restore the object. It uses the following methode: After an error it will wait, and will do an new restore. The time the program waits is first 200ms then 500ms, 1 secode, 2 secodes, 5,10,20 secodes. If the restore fails after 7 retries,  then the program will show an error.
Auto Show When checked the program will write a warning to the log-window for every retry.