NDSBackupServerData

Creates a servdata.nds file and backs up the server information to that file.

NetWare Server:4.x, 5.x, 6.x
Platform:NLM
Service:NDS

Syntax

    #include <ndsback.h> 
     
    int NDSBackupServerData  ( 
       void  *(*memAlloc)(unsigned size),   
       void   (*memFree)(void *p));

Parameters

memAlloc
(IN) Points to the address of the function to use to allocate memory.
memFree
(IN) Points to the address of the function to use to free memory allocated with the memAlloc parameter.

Return Values

0x0000

SUCCESSFUL

Nonzero

Nonzero values indicate errors. See NDS Return Values (001 to 799).

Remarks

This function is an exported symbol from the DSBACKER NLM. To use it, you will need to create an import file.

This function works only if there are two or more servers in the eDirectory tree. The second server must be available to supply partition information and contain a replica that holds the server object of the server being backed up.

The data backed up by this function allows eDirectory to be restored to a server when the Sys volume has failed. For more information on backing up and restoring eDirectory, see the "Backing Up and Restoring Novell Directory Services in NetWare 4.11" article in the October 1996 issue of Novell Application Notes (available at the following Web site: http://developer.novell.com/research/appnotes.htm).

This function backs up the following server information:

  • NDS/eDirectory version
  • Namebase format
  • Single server status
  • Time zone information
  • Server object information such as
  • System partition information
  • Entry records
  • Replica information
  • Supervisor information

The information backed up with this function is restored with the NDSSYSVolumeRecovery function.

NCP Calls

See Also

NDSSYSVolumeRecovery