Veritas NetBackup™ for Informix Administrator's Guide

To modify NetBackup for Informix scripts

1. Copy the example scripts from /usr/openv/netbackup/ext/db_ext/informix/scripts to a different location on your client.

   The Informix scripts can reside anywhere on the client. Do not store your scripts in the sample directory because your modifications are lost if you upgrade or reinstall. Always relocate your scripts to a safe location. In a NetBackup cluster, the script must be available after a failover.

2. Enable proper permissions on the script files so NetBackup can access the script files.

   Set the access permissions of the scripts to 775. For example:

   chmod 775 script_name

3. Open the script file with a text editor.

   For example, use the following command to modify the informix_onbar_backup_of_rootdbs script:

   vi informix_onbar_backup_of_rootdbs

4. Modify the script according to the instructions in the file.

   Customize the scripts to reflect your Informix installation. Refer to the comments in the scripts that indicate "Replace ....". The scripts need to be modified to have the correct Informix home path and Informix server name. The scripts also must include the policy that you want to use to back up the files and the name of the Informix configuration file.

   For example, the informix_onbar_backup_of_rootdbs script contains the following lines:

   #!/bin/sh
   
   # Replace xxxxx below with the extention used for your onconfig file.
   ONCONFIG=onconfig.xxxxx
   
   # Replace yyyyy below with the Informix home path. 
   INFORMIXDIR=/yyyyy/informix
   
   # Replace zzzzz below with the name of the Informix server. 
   INFORMIXSERVER=zzzzz
   
   # Replace informix_etc below with the name of the NetBackup server policy 
   # to be used to back up the $INFORMIXDIR/etc directory. 
   INFX_ETC_POLICY=informix_etc
   
   
   echo "Started 'date'"
   
   export ONCONFIG
   echo "exported ONCONFIG"
   
   export INFORMIXDIR
   echo "exported INFORMIXDIR"
   
   export INFORMIXSERVER
   echo "exported INFORMIXSERVER"
   
   echo "INFXBSA_SERVER = $INFXBSA_SERVER"
   echo "INFXBSA_SCHEDULED = $INFXBSA_SCHEDULED"
   echo "INFXBSA_USER_INITIATED = $INFXBSA_USER_INITIATED"
   echo "INFXBSA_FULL = $INFXBSA_FULL"
   echo "INFXBSA_INCR = $INFXBSA_INCR"
   echo "INFXBSA_POLICY = $INFXBSA_POLICY"
   
   RETURN_STATUS=0
   
   if [ "${INFXBSA_INCR}" = "1" ]
   then
       # NetBackup has started an incremental backup. 
       echo "$INFORMIXDIR/bin/onbar -b -L 1 rootdbs"
       $INFORMIXDIR/bin/onbar -b -L 1 rootdbs
       RETURN_STATUS=$?
   else
   
       echo "$INFORMIXDIR/bin/onbar -b -L 0 rootdbs"
       $INFORMIXDIR/bin/onbar -b -L 0 rootdbs
       RETURN_STATUS=$?
   
   fi
   
   if  [ "$RETURN_STATUS" -eq "0" ]
   then
   
       # Initiate a backup of the directory that contains the onconfig, 
       # sqlhosts, oncfg_$INFORMIXSERVER.SERVERNUM, and ixbar.SERVERNUM 
       # files after doing the backup. 
   
       echo "bpbackup -p $INFX_ETC_POLICY -w 0 $INFORMIXDIR/etc"
       /usr/openv/netbackup/bin/bpbackup -p $INFX_ETC_POLICY -w 0 $INFORMIXDIR/etc
       BPBACKUP_STATUS=$?
   
       if [ "$BPBACKUP_STATUS" -ne "0" ]
       then
           echo ""
           echo "bpbackup of $INFORMIXDIR/etc returned $BPBACKUP_STATUS"
       fi
   fi
   
   echo "Finished 'date'"
   
   echo "exit $RETURN_STATUS"
   echo ""
   
   exit $RETURN_STATUS

5. Test the scripts that you created.

   More information is available on how to test your configuration.