9.1 Maintaining the ZENworks Object Store

The ZENworks Object Store is Novell eDirectory™ 8.7.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

You use zlm_ndsbackup.sh, located in /opt/novell/zenworks/sbin, to back up the Object Store.

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

  2. Enter the following command at the command prompt:

    # 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.

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 file is 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

NDS® Backup creates a directory with the current date in /var/opt/novell/zenworks/backup/nds. The backup file is saved in this directory.

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

If necessary, you can restore the ZENworks Object Store from a backup you created. You use zlm_ndsrestore.sh, located in /opt/novell/zenworks/sbin, to restore the Object Store from a backup.

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

  2. Enter the following command on the command prompt:

    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.

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

  4. After the restore 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.

9.1.3 Deleting the Dangling Objects from ZENworks Object Store

The zlm-edirectory cleanup utility of ZENworks 7.2 Linux Management IR2 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>
    
        <TreeName>
          Management_Zone_Name
        </TreeName>
    
          <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.