NetWorker 19.7 Snapshot Management Integration Guide

Configuring preprocessing and postprocessing scripts

You can run user-defined preprocessing and postprocessing scripts from the application client. You can run these scripts only for file system backups.

1. The scripts can produce output such as log files, but the scripts must return an exit status of 0, which means that the script did not fail and the backup can run. Any other exit code for a preprocessing script causes the backup to fail.
2. Provide the script files with the following security:

   • On Microsoft Windows systems, provide the script files with security that grants full control only to the local SYSTEM, local Administrators, or Backup Operators groups. Otherwise, the scripts will not run.

     To set this security in Windows Explorer, right-click the script file, select Properties, click the Security tab, and click Advanced.

   • On UNIX systems, the root user must own the script files. The scripts can set only owner access permissions, and the scripts must at least have run access. Otherwise, the scripts will not run. The parent directory of the scripts must have at least owner run permissions, and must not have write permissions for the group and world.

3. Place the scripts in a directory where a user must have administrator/root privileges to add, modify, or run the resident scripts. Otherwise, any backups that use the scripts fail.

   On Microsoft Windows systems, NetWorker searches for relative pathnames in the NetWorker_install_path/bin directory.

4. Include the pathnames of user-defined scripts in the Application Information attribute of the property window of the application Client resource by typing the following variables:
   NSR_PRE_SNAPSHOT_SCRIPT=pre-mirror_split-script_path NSR_POST_SNAPSHOT_SCRIPT=post-mirror_split-script_path
5. After a backup is completed, verify the log files that are generated in the /nsr/logs (UNIX) directory on the application client host. The log file name is in the form of script_name_LOGFILE.txt. The script output appears in the log file.