| 1 | #!/bin/ksh |
|---|
| 2 | # IBM_PROLOG_BEGIN_TAG |
|---|
| 3 | # This is an automatically generated prolog. |
|---|
| 4 | # |
|---|
| 5 | # |
|---|
| 6 | # |
|---|
| 7 | # Licensed Materials - Property of IBM |
|---|
| 8 | # |
|---|
| 9 | # (C) COPYRIGHT International Business Machines Corp. 2002,2006 |
|---|
| 10 | # All Rights Reserved |
|---|
| 11 | # |
|---|
| 12 | # US Government Users Restricted Rights - Use, duplication or |
|---|
| 13 | # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. |
|---|
| 14 | # |
|---|
| 15 | # IBM_PROLOG_END_TAG |
|---|
| 16 | # @(#)65 1.25.1.2 src/avs/fs/mmfs/ts/admin/mmbackup.sh, mmfs, avs_rgpfs24, rgpfs24s005a 6/14/06 14:39:45 |
|---|
| 17 | ############################################################################## |
|---|
| 18 | # |
|---|
| 19 | # Usage: |
|---|
| 20 | # |
|---|
| 21 | # mmbackup Device -n ControlFile [-t {full | incremental}] [-r IOrate] |
|---|
| 22 | # [-s sortDir] [-T] |
|---|
| 23 | # |
|---|
| 24 | # or |
|---|
| 25 | # |
|---|
| 26 | # mmbackup Device -R [-r IOrate] [-s sortDir] [-T] |
|---|
| 27 | # |
|---|
| 28 | # where: |
|---|
| 29 | # |
|---|
| 30 | # -n ControlFile is a file containing information for controlling |
|---|
| 31 | # the backup; this parameter is optional if mmbackup |
|---|
| 32 | # was run previously, in which case the values from |
|---|
| 33 | # the prior control file remain in effect if -n |
|---|
| 34 | # is not specified |
|---|
| 35 | # |
|---|
| 36 | # -r IOrate an integer between 1 and 100 specifying how much |
|---|
| 37 | # I/O bandwidth to allocate to the backup process |
|---|
| 38 | # (the larger the number, the larger the allocated |
|---|
| 39 | # bandwidth; default is 100) |
|---|
| 40 | # |
|---|
| 41 | # -t full | incremental type of backup; default is incremental |
|---|
| 42 | # |
|---|
| 43 | # -R resume backing up files which failed to be |
|---|
| 44 | # backed up on the previous invocation of mmbackup |
|---|
| 45 | # |
|---|
| 46 | # -T enable tracing |
|---|
| 47 | # |
|---|
| 48 | # -s sortDir sort temporary directory name (default /tmp) |
|---|
| 49 | # |
|---|
| 50 | ############################################################################## |
|---|
| 51 | |
|---|
| 52 | # Include global declarations and service routines. |
|---|
| 53 | . /usr/lpp/mmfs/bin/mmglobfuncs |
|---|
| 54 | . /usr/lpp/mmfs/bin/mmsdrfsdef |
|---|
| 55 | . /usr/lpp/mmfs/bin/mmfsfuncs |
|---|
| 56 | |
|---|
| 57 | sourceFile="mmbackup.sh" |
|---|
| 58 | [[ -n $DEBUG || -n $DEBUGmmbackup ]] && set -x |
|---|
| 59 | $mmTRACE_ENTER "$*" |
|---|
| 60 | |
|---|
| 61 | |
|---|
| 62 | # Local work files. Names should be of the form: |
|---|
| 63 | # fn=${tmpDir}fn.${mmcmd}.$$ |
|---|
| 64 | |
|---|
| 65 | tmpCtrlFile=${tmpDir}tmpCtrlFile.mmbackup.$$ |
|---|
| 66 | LOCAL_FILES=" $tmpCtrlFile " |
|---|
| 67 | |
|---|
| 68 | |
|---|
| 69 | # Local variables |
|---|
| 70 | |
|---|
| 71 | usageMsg=458 |
|---|
| 72 | integer rc=0 |
|---|
| 73 | integer nodeCount=0 |
|---|
| 74 | integer n |
|---|
| 75 | backupControlFile=".mmbuControl" |
|---|
| 76 | |
|---|
| 77 | typeset -i freeSpace |
|---|
| 78 | |
|---|
| 79 | |
|---|
| 80 | # Local routines |
|---|
| 81 | |
|---|
| 82 | |
|---|
| 83 | ########################################################################## |
|---|
| 84 | # |
|---|
| 85 | # Function: Get the amount of unused space in the specified file system. |
|---|
| 86 | # |
|---|
| 87 | # Input: $1 - file system dev name or name of a file or directory |
|---|
| 88 | # |
|---|
| 89 | # Output: the number of unused 1K blocks in the filesystem |
|---|
| 90 | # |
|---|
| 91 | # Returns: 0 |
|---|
| 92 | # |
|---|
| 93 | ########################################################################## |
|---|
| 94 | function getFreeSpace # { <fileSytem> | <fileName> } |
|---|
| 95 | { |
|---|
| 96 | typeset sourceFile="mmbackup.sh" |
|---|
| 97 | [[ -n $DEBUG || -n $DEBUGgetFreeSpace ]] && set -x |
|---|
| 98 | $mmTRACE_ENTER "$*" |
|---|
| 99 | typeset fileSystem=$1 |
|---|
| 100 | |
|---|
| 101 | typeset dfInfo |
|---|
| 102 | typeset -i freeBlocks |
|---|
| 103 | |
|---|
| 104 | [[ -z $fileSystem ]] && \ |
|---|
| 105 | checkForErrors "getFreeSpace: missing file system parameter" 1 |
|---|
| 106 | |
|---|
| 107 | # Issue the df command, requesting info in Posix format and 1K blocks. |
|---|
| 108 | LC_ALL=C $df -P -k $fileSystem > $tmpfile |
|---|
| 109 | |
|---|
| 110 | # Read and discard the first line (the header). |
|---|
| 111 | exec 3<&- |
|---|
| 112 | exec 3< $tmpfile |
|---|
| 113 | $rm -f $tmpfile |
|---|
| 114 | read -u3 dfInfo |
|---|
| 115 | |
|---|
| 116 | # Read and extract the desired info from the second line. |
|---|
| 117 | read -u3 dfInfo |
|---|
| 118 | set -f ; set -- $dfInfo ; set +f |
|---|
| 119 | freeBlocks=$4 |
|---|
| 120 | |
|---|
| 121 | # Return the result. |
|---|
| 122 | print -- "$freeBlocks" |
|---|
| 123 | return 0 |
|---|
| 124 | |
|---|
| 125 | } #--------- end of function getFreeSpace ------------------ |
|---|
| 126 | |
|---|
| 127 | |
|---|
| 128 | |
|---|
| 129 | ###################### |
|---|
| 130 | # Mainline processing |
|---|
| 131 | ###################### |
|---|
| 132 | |
|---|
| 133 | |
|---|
| 134 | ################################# |
|---|
| 135 | # Process the command arguments. |
|---|
| 136 | ################################# |
|---|
| 137 | [[ $arg1 = '-?' || $arg1 = '-h' || $arg1 = '--help' || $arg1 = '--' ]] && \ |
|---|
| 138 | syntaxError "help" $usageMsg |
|---|
| 139 | |
|---|
| 140 | [[ $argc -lt 1 ]] && \ |
|---|
| 141 | syntaxError "missingArgs" $usageMsg |
|---|
| 142 | |
|---|
| 143 | device=$arg1 # Save the file system name (always the first parameter). |
|---|
| 144 | shift 1 # Drop the device name from the parameter list. |
|---|
| 145 | |
|---|
| 146 | while getopts :n:r:RTt:s: OPT |
|---|
| 147 | do |
|---|
| 148 | case $OPT in |
|---|
| 149 | |
|---|
| 150 | n) # input control file |
|---|
| 151 | [[ -n $nflag ]] && syntaxError "multiple" $noUsageMsg "-$OPT" |
|---|
| 152 | nflag="-$OPT"; narg=$OPTARG; |
|---|
| 153 | [[ -n $Rflag ]] && \ |
|---|
| 154 | syntaxError "invalidCombination" $usageMsg "-n" "-R" |
|---|
| 155 | ;; |
|---|
| 156 | |
|---|
| 157 | r) [[ -n $rflag ]] && syntaxError "multiple" $noUsageMsg "-$OPT" |
|---|
| 158 | rflag="-$OPT"; rarg=$OPTARG; |
|---|
| 159 | # Ensure that rarg is an integer, and that its value is from 1 to 100. |
|---|
| 160 | n=$(checkIntRange $rflag $rarg 1 100) |
|---|
| 161 | [[ $? -ne 0 ]] && cleanupAndExit |
|---|
| 162 | ;; |
|---|
| 163 | |
|---|
| 164 | s) [[ -n $sflag ]] && syntaxError "multiple" $noUsageMsg "-$OPT" |
|---|
| 165 | sflag="-$OPT"; sarg=$OPTARG; |
|---|
| 166 | ;; |
|---|
| 167 | |
|---|
| 168 | R) [[ -n $Rflag ]] && syntaxError "multiple" $noUsageMsg "-$OPT" |
|---|
| 169 | Rflag="-$OPT"; |
|---|
| 170 | [[ -n $nflag ]] && \ |
|---|
| 171 | syntaxError "invalidCombination" $usageMsg "-n" "-R" |
|---|
| 172 | [[ -n $tflag ]] && \ |
|---|
| 173 | syntaxError "invalidCombination" $usageMsg "-t" "-R" |
|---|
| 174 | ;; |
|---|
| 175 | |
|---|
| 176 | t) [[ -n $tflag ]] && syntaxError "multiple" $noUsageMsg "-$OPT" |
|---|
| 177 | tflag="-$OPT"; targ=$OPTARG; |
|---|
| 178 | [[ $targ != full && $targ != incremental ]] && \ |
|---|
| 179 | syntaxError "invalidOption" $usageMsg "-$OPT $OPTARG" |
|---|
| 180 | [[ -n $Rflag ]] && \ |
|---|
| 181 | syntaxError "invalidCombination" $usageMsg "-t" "-R" |
|---|
| 182 | ;; |
|---|
| 183 | |
|---|
| 184 | T) Tflag="-T"; |
|---|
| 185 | ;; |
|---|
| 186 | |
|---|
| 187 | +[n,r,s,R,t]) # Invalid option |
|---|
| 188 | syntaxError "invalidOption" $usageMsg $OPT |
|---|
| 189 | ;; |
|---|
| 190 | |
|---|
| 191 | :) # Missing argument |
|---|
| 192 | syntaxError "missingValue" $usageMsg $OPTARG |
|---|
| 193 | ;; |
|---|
| 194 | |
|---|
| 195 | *) # Invalid option |
|---|
| 196 | syntaxError "invalidOption" $usageMsg $OPTARG |
|---|
| 197 | ;; |
|---|
| 198 | |
|---|
| 199 | esac |
|---|
| 200 | |
|---|
| 201 | done |
|---|
| 202 | |
|---|
| 203 | shift OPTIND-1 |
|---|
| 204 | [[ $# != 0 ]] && syntaxError "extraArg" $usageMsg $1 |
|---|
| 205 | |
|---|
| 206 | # Complete the parameter checking and set defaults. |
|---|
| 207 | [[ -z $nflag && -z $Rflag ]] && \ |
|---|
| 208 | syntaxError "missingArgs" $usageMsg |
|---|
| 209 | |
|---|
| 210 | [[ -z $rarg ]] && rarg=100 |
|---|
| 211 | rOption="-r $rarg" |
|---|
| 212 | |
|---|
| 213 | if [[ -z $targ ]] |
|---|
| 214 | then |
|---|
| 215 | if [[ -z $Rflag ]] |
|---|
| 216 | then |
|---|
| 217 | tOption="-t incremental" |
|---|
| 218 | else |
|---|
| 219 | tOption="" |
|---|
| 220 | fi |
|---|
| 221 | else |
|---|
| 222 | tOption="-t $targ" |
|---|
| 223 | fi |
|---|
| 224 | |
|---|
| 225 | sOption="" |
|---|
| 226 | if [[ -n $sarg ]] |
|---|
| 227 | then |
|---|
| 228 | if [[ ! -d $sarg ]] |
|---|
| 229 | then |
|---|
| 230 | # The sort temp dir does not exist. Issue an error and quit. |
|---|
| 231 | printErrorMsg 574 $mmcmd $sarg |
|---|
| 232 | cleanupAndExit |
|---|
| 233 | fi |
|---|
| 234 | sOption="-s $sarg" |
|---|
| 235 | fi |
|---|
| 236 | |
|---|
| 237 | |
|---|
| 238 | ####################################################### |
|---|
| 239 | # Make sure there is a reasonable amount of free space |
|---|
| 240 | # in the /var/mmfs filesystem. This is needed so that |
|---|
| 241 | # TSM can create error logs in /var/mmfs/mmbackup. |
|---|
| 242 | ####################################################### |
|---|
| 243 | freeSpace=$(getFreeSpace $mmbackupDir) |
|---|
| 244 | if [[ $freeSpace -lt 100 ]] |
|---|
| 245 | then |
|---|
| 246 | # The filesystem is not mounted. Issue an error and quit. |
|---|
| 247 | printErrorMsg 572 $mmcmd $mmbackupDir "100K" |
|---|
| 248 | cleanupAndExit |
|---|
| 249 | fi |
|---|
| 250 | |
|---|
| 251 | |
|---|
| 252 | ######################################################################## |
|---|
| 253 | # Set up trap exception handling and call the gpfsInit function. |
|---|
| 254 | # It will ensure that the local copy of the mmsdrfs and the rest of the |
|---|
| 255 | # GPFS system files are up-to-date. There is no need to lock the sdr. |
|---|
| 256 | ######################################################################## |
|---|
| 257 | trap pretrap2 HUP INT QUIT KILL |
|---|
| 258 | gpfsInitOutput=$(gpfsInit nolock) |
|---|
| 259 | setGlobalVar $? $gpfsInitOutput |
|---|
| 260 | |
|---|
| 261 | # Determine the lookup order for resolving host names. |
|---|
| 262 | [[ $osName != AIX ]] && resolveOrder=$(setHostResolveOrder) |
|---|
| 263 | |
|---|
| 264 | |
|---|
| 265 | ####################################################### |
|---|
| 266 | # Make sure the file system exists, that it is part of |
|---|
| 267 | # this node's cluster, and that it is mounted. |
|---|
| 268 | ####################################################### |
|---|
| 269 | findFSoutput=$(findFS "$device" $mmsdrfsFile) |
|---|
| 270 | [[ -z $findFSoutput ]] && cleanupAndExit |
|---|
| 271 | |
|---|
| 272 | # Parse the output from the findFS function. |
|---|
| 273 | set -f ; set -- $findFSoutput ; set +f |
|---|
| 274 | fqDeviceName=$1 |
|---|
| 275 | fsHomeCluster=$3 |
|---|
| 276 | |
|---|
| 277 | # Exit with a message if the command was invoked for a remote file system. |
|---|
| 278 | if [[ $fsHomeCluster != $HOME_CLUSTER ]] |
|---|
| 279 | then |
|---|
| 280 | # Command is not allowed for remote file systems. |
|---|
| 281 | printErrorMsg 106 $mmcmd $device $fsHomeCluster |
|---|
| 282 | cleanupAndExit 1 |
|---|
| 283 | fi |
|---|
| 284 | |
|---|
| 285 | # Obtain the name of the file system (i.e., the mount point). |
|---|
| 286 | mountPoint=$(findMountpoint $fqDeviceName) |
|---|
| 287 | if [[ $mountPoint = "" ]] |
|---|
| 288 | then |
|---|
| 289 | # The filesystem is not mounted. Issue an error and quit. |
|---|
| 290 | printErrorMsg 563 $mmcmd $device $ourNodeName |
|---|
| 291 | cleanupAndExit |
|---|
| 292 | fi |
|---|
| 293 | |
|---|
| 294 | |
|---|
| 295 | ########################################################## |
|---|
| 296 | # Check that the control file, if specified, makes sense. |
|---|
| 297 | ########################################################## |
|---|
| 298 | if [[ -z $narg ]] |
|---|
| 299 | then |
|---|
| 300 | nOption="" |
|---|
| 301 | else |
|---|
| 302 | # Verify the existence of the user specified control file |
|---|
| 303 | # and create our own copy. |
|---|
| 304 | checkUserFile $narg $tmpCtrlFile |
|---|
| 305 | [[ $? -ne 0 ]] && cleanupAndExit |
|---|
| 306 | |
|---|
| 307 | # Set nOption to pass the control file to tsbackup. |
|---|
| 308 | nOption="-n $tmpCtrlFile" |
|---|
| 309 | |
|---|
| 310 | # Check whether the backup clients specified in the control file |
|---|
| 311 | # belong to the cluster. |
|---|
| 312 | foundError=false |
|---|
| 313 | IFS_sv="$IFS" # Save the IFS variable. |
|---|
| 314 | exec 3<&- |
|---|
| 315 | exec 3< $tmpCtrlFile |
|---|
| 316 | while read -u3 inputLine |
|---|
| 317 | do |
|---|
| 318 | IFS="=" |
|---|
| 319 | set -f ; set -- $inputLine ; set +f |
|---|
| 320 | lineType=$1 |
|---|
| 321 | lineValue=$2 |
|---|
| 322 | IFS="$IFS_sv" # Restore the IFS variable. |
|---|
| 323 | if [[ $lineType = clientName ]] |
|---|
| 324 | then |
|---|
| 325 | # Find the IP address that corresponds to this node name. |
|---|
| 326 | hostResult=$($host $lineValue) |
|---|
| 327 | set -f ; set -- $hostResult ; set +f |
|---|
| 328 | ipa=${3%%,*} # Exclude everything after the first comma. |
|---|
| 329 | if [[ -z $ipa ]] |
|---|
| 330 | then |
|---|
| 331 | # An invalid node name was specified as a client. |
|---|
| 332 | printErrorMsg 54 $mmcmd $lineValue |
|---|
| 333 | foundError=true |
|---|
| 334 | fi |
|---|
| 335 | nodeName=$(getNodeInfo \ |
|---|
| 336 | $REL_HOSTNAME_Field $IPA_Field $ipa $nsId $mmsdrfsFile) |
|---|
| 337 | if [[ -z $nodeName ]] |
|---|
| 338 | then |
|---|
| 339 | # The specified client node is not a member of the GPFS cluster. |
|---|
| 340 | printErrorMsg 290 $mmcmd $lineValue |
|---|
| 341 | foundError=true |
|---|
| 342 | fi |
|---|
| 343 | fi |
|---|
| 344 | done # end while read -u3 fileName |
|---|
| 345 | |
|---|
| 346 | # If an error was found, print a "command failed" message and exit. |
|---|
| 347 | if [[ $foundError = true ]] |
|---|
| 348 | then |
|---|
| 349 | printErrorMsg 389 $mmcmd |
|---|
| 350 | cleanupAndExit |
|---|
| 351 | fi |
|---|
| 352 | fi |
|---|
| 353 | |
|---|
| 354 | |
|---|
| 355 | ################################################################ |
|---|
| 356 | # If an incremental or a resume backup was specified, make sure |
|---|
| 357 | # there is a readable backup control file from a prior backup. |
|---|
| 358 | ################################################################ |
|---|
| 359 | if [[ $targ = incremental || -n $Rflag ]] |
|---|
| 360 | then |
|---|
| 361 | myBackupCtrlFile="$mountPoint/$backupControlFile" |
|---|
| 362 | if [[ ! -f $myBackupCtrlFile || ! -r $myBackupCtrlFile ]] |
|---|
| 363 | then |
|---|
| 364 | # Can't find or read the backup control file from a prior backup. |
|---|
| 365 | printErrorMsg 565 $mmcmd $myBackupCtrlFile |
|---|
| 366 | cleanupAndExit |
|---|
| 367 | fi |
|---|
| 368 | fi |
|---|
| 369 | |
|---|
| 370 | |
|---|
| 371 | #################################### |
|---|
| 372 | # Invoke tsbackup to do the backup. |
|---|
| 373 | #################################### |
|---|
| 374 | $tsbackup $fqDeviceName $mountPoint $nOption $rOption $tOption $Rflag $Tflag $sOption |
|---|
| 375 | rc=$? |
|---|
| 376 | if [[ $rc -ne 0 ]] |
|---|
| 377 | then |
|---|
| 378 | # The command failed. |
|---|
| 379 | printErrorMsg 389 $mmcmd |
|---|
| 380 | else |
|---|
| 381 | # The command completed successfully. |
|---|
| 382 | printInfoMsg 272 $mmcmd |
|---|
| 383 | fi |
|---|
| 384 | |
|---|
| 385 | cleanupAndExit $rc |
|---|
| 386 | |
|---|
