22

✏️ Editing: 500_make_TSM_backup.sh

# This file is part of Relax-and-Recover, licensed under the GNU General
# Public License. Refer to the included COPYING for full text of license.

# Exit if TSM binary cannot be found.
has_binary dsmc || Error "Can't find TSM client dsmc; Please check your configuration."

# If the TSM client is found, do an incremental backup:
backup_tsm_log=/var/lib/rear/backup_tsm_log

if [[ ! -d "$backup_tsm_log" ]]; then
    mkdir -p $v $backup_tsm_log
fi

function check_TSM_dsmc_return_code() {

dsmc_exit_code=$1

# When 'dsmc' results a non-zero exit code inform the user but do not abort the whole "rear recover" here
    # because it could be an unimportant reason why 'dsmc' finished with a non-zero exit code.
    # What usual exit codes mean see http://publib.boulder.ibm.com/tividd/td/TSMC/GC32-0787-04/en_US/HTML/ans10000117.htm
    # that reads in particular (as of this writing on Dec. 13 2017):
    #   0     All operations completed successfully.
    #   4     The operation completed successfully, but some files were not processed. There were no other errors or warnings.
    #         This return code is very common. Files are not processed for various reasons. The most common reasons are:
    #          - The file is in an exclude list.
    #          - The file was in use by another application and could not be accessed by the client.
    #          - The file changed during the operation to an extent prohibited by the copy serialization attribute.
    #   8     The operation completed with at least one warning message. For scheduled events, the status will be Completed.
    #         Review TSM Error Log (and dsmsched.log for scheduled events) to determine what warning messages were issued and to assess their impact on the operation.
    #   12    The operation completed with at least one error message (except for error messages for skipped files). For scheduled events, the status will be Failed.
    #         Review the TSM Error Log file (and dsmsched.log file for scheduled events) to determine what error messages were issued and to assess their impact
    #         on the operation. As a general rule, this return code means that the error was severe enough to prevent the successful completion of the operation.
    #         For example, an error that prevents an entire from being processed yields return code 12. When a file is not found the operation yields return code 12.
    #   other For scheduled operations where the scheduled action is COMMAND, the return code will be the return code from the command that was executed.
    #         If the return code is 0, the status of the scheduled operation will be Completed. If the return code is nonzero, then the status will be Failed.
    #         Some commands may issue a nonzero return code to indicate success. For these commands, you can avoid a Failed status by wrapping the command in a script
    #         that invokes the command, interprets the results, and exits with return code 0 if the command was successful (the script should exit with a nonzero return code
    #         if the command failed). Then ask your Tivoli Storage Manager server administrator modify the schedule definition to invoke your script instead of the command.
    #   The return code for a client macro will be the highest return code issued among the individual commands that comprise the macro.
    #   For example, suppose a macro consists of these commands: If the first command completes with return code 0; the second command completes with return code 8;
    #   and the third command completes with return code 4, the return code for the macro will be 8.
    if test $dsmc_exit_code -eq 0 ; then
        LogUserOutput "[TSM] dsmc backup operation completed successfully"
    else
        LogUserOutput "[TSM] dsmc backup operation completed with 'dsmc' exit code $dsmc_exit_code"
        test $dsmc_exit_code -eq 4 && LogUserOutput "[TSM rc=4] dsmc backup operation completed successfully, but some files (e.g. in an exclude list) were not processed"
        test $dsmc_exit_code -eq 8 && LogUserOutput "[TSM rc=8] dsmc backup operation completed with at least one warning message (review the TSM Error Log)"
        test $dsmc_exit_code -eq 12 && LogUserOutput "[TSM rc=12] dsmc backup operation completed with at least one error message (review the TSM Error Log)"
    fi
}

# Create TSM friendly include list.
for backup_include in $(cat $TMP_DIR/backup-include.txt); do
    include_list+=("$backup_include ")
done

LogUserOutput ""
LogUserOutput "Starting Incremental Backup with TSM [ ${include_list[@]} ]"
LogUserOutput "You can follow the backup with [ tail -f ${TMP_DIR}/${BACKUP_PROG_ARCHIVE}.log ]"
LC_ALL=${LANG_RECOVER} dsmc incremental \
-verbose -tapeprompt=no "${TSM_DSMC_BACKUP_OPTIONS[@]}" \
"${include_list[@]}" > "${TMP_DIR}/${BACKUP_PROG_ARCHIVE}.log"
dsmc_exit_code=$?
check_TSM_dsmc_return_code $dsmc_exit_code

test $dsmc_exit_code -eq 12 && Error "Error during TSM backup... Check your configuration."

### Copy progress log to backup media
if cp $v "${TMP_DIR}/${BACKUP_PROG_ARCHIVE}.log" "${backup_tsm_log}/${BACKUP_PROG_ARCHIVE}.log"; then
    LogUserOutput "TSM Backup log available: ${backup_tsm_log}/${BACKUP_PROG_ARCHIVE}.log"
    LogUserOutput "Adding TSM log file to the backup"
    dsmc incremental ${backup_tsm_log}/${BACKUP_PROG_ARCHIVE}.log
    dsmc_exit_code=$?

check_TSM_dsmc_return_code $dsmc_exit_code

if test $dsmc_exit_code -eq 12; then
        LogUserOutput "Failed to add ${backup_tsm_log}/${BACKUP_PROG_ARCHIVE}.log to the backup"
    else
        LogUserOutput "${backup_tsm_log}/${BACKUP_PROG_ARCHIVE}.log added to the backup"
    fi
fi

MR SKB