9.1 Maintaining the ZENworks Object Store

The ZENworks Object Store is Novell eDirectory 8.8.3. The Novell eDirectory Service /etc/init.d/ndsd should be running to allow the backup and restore operations for ZENworks Object Store.

The following sections provide information for backing up and restoring the Object Store:

9.1.1 Backing Up the ZENworks Object Store

The zlm_ndsbackup.sh located in /opt/novell/zenworks/sbin allows you to create the ZENworks Object Store backup by using the ndsbackup utility, and the full backup of eDirectory DIB by using the dsbk utility.

You can either back up the Object Store or take a full backup of the eDirectory DIB. We recommend that you back up both of them.

  1. Make sure you are logged in as root to the ZENworks Server.

  2. Enter the following command to back up the Object Store:

    # zlm_ndsbackup.sh -U admin.system

  3. Enter the password to authenticate to the Object Store.

    This is the password for the ZENworks Administrator account.

    You can also automate the backup process by using the # zlm_ndsbackup.sh -U admin.system -P authentication_password_to_the_object_store command.

  4. Enter the following command to take a full backup of the eDirectory DIB:

    # zlm_ndsbackup.sh -U admin.system -B

IMPORTANT:The Object Store backup and the full backup of eDirectory must run separately, either manually or through a cron job. This is because the backup files need to be created with different time stamps to save them as different files.

The backup program creates a directory in /var/opt/novell/zenworks/backup/nds/month-yyyy/yyyy-mm-dd. The directory name is the date on which the backup is taken. The backup files are saved in this directory. The name of the backup file has the format timestamp-backup, and the time stamp indicates the time when the backup was taken. For example:

/var/opt/novell/zenworks/backup/nds/August-2005/2005-08-23/10:12:23-backup

The log information about the backup operation is saved to /var/opt/novell/log/zenworks/ndsbackup.log.

9.1.2 Restoring the ZENworks Object Store

The zlm_ndsrestore.sh allows you to restore both the ZENworks Object Store backup and the full backup of the eDirectory DIB.

  1. Make sure you are logged in as root to the ZENworks Server.

  2. Enter the following command to restore the Object Store:

    zlm_ndsrestore.sh -U admin.system -F path_to_the_backup_file

    Make sure that the -F option includes the backup file's complete path.

  3. Enter the password to authenticate to the Object Store.

    This is the password for the ZENworks Administrator account.

  4. Enter the following command to restore the full backup of eDirectory:

    # zlm_ndsbackup.sh -U admin.system -F path_to_the_backup_file -B

  5. After the restore operation is complete, you need to ensure that the Data Store is synchronized with the Object Store. For instructions, see Section 9.4, Synchronizing the Object Store and Data Store.

The log information about the restore operation is saved to /var/opt/novell/log/zenworks/ndsrestore.log.

9.1.3 Deleting the Dangling Objects from ZENworks Object Store

The zlm-edirectory cleanup utility of ZENworks 7.3 Linux Management IR4 helps you to delete dangling objects from ZENworks Object Store.

To run the zlm-edirectory cleanup utility on the ZENworks Server:

  1. Close all ZENworks Linux Management operations, if any are running.

  2. Create an XML file with the following content:

    <?xml version="1.0" encoding="UTF-8"?>
    
    <ZLMedirectoryCleanup xmlns="http://www.novell.com/zenworks/edirectoryCleanup" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    
      <Tree>
    
        <ZoneName> 
          Management_Zone_Name 
        </ZoneName> 
    
          <Password>eDirectory_password </Password>
    
          <Principle>
            Base_DN_of_the_eDirectory (usually, cn=admin,o=system)       </Principle>
    
          <RootContext>
            Root_context_to_which_LDAP_connection_is_to_be_established (usually, o=cell)       </RootContext>
    
          <IPAddress>IP_address_of_the_ZENworks_Server</IPAddress>
    
          <Port>
            SSL_port_number_used_by_the_ZENworks_Server (usually, 10636)       </Port>
    
          <SSL>true</SSL>
    
          <ImportCertificate> True or False </ImportCertificate>
    
       </Tree>
    
    </ZLMedirectoryCleanup>
    

    The ZENworks server uses the information in the XML file to establish connection with eDirectory.

  3. At the server console prompt, go to /opt/novell/zenworks/sbin and execute the following command:

    zlm_edirCleanup complete_path_of_the_xml_file

    Where complete_path_of_the_xml_file is completed path of the XML file created in Step 2.

  4. (Optional) To review the status of the utility, see /var/opt/novell/log/zenworks/edirCleanup.log.