Backup3G/COSbackup 3.2.6 Release Notes
From Documentation
| Revision as of 02:17, 4 May 2006 Daniels (Talk | contribs) (→Features) ← Previous diff |
Revision as of 02:19, 4 May 2006 Daniels (Talk | contribs) (→Patch installed same time as COSbackup 3.2) Next diff → |
||
| Line 86: | Line 86: | ||
| === Patch installed same time as COSbackup 3.2 === No further action required. | === Patch installed same time as COSbackup 3.2 === No further action required. | ||
| - | Technical Notes: Using COSbackup V3.2.6 | + | ==Technical Notes: Using COSbackup V3.2.6 == |
| - | This section contains some technical notes, tips, and troubleshooting information to help you when | + | This section contains some technical notes, tips, and troubleshooting information to help you when installing or upgrading to COSbackup V3.2.6. Detailed information on setting up and using COSbackup can be found in the COS/Backup User Guide V3.2. |
| - | installing or upgrading to COSbackup V3.2.6. Detailed information on setting up and using | + | |
| - | COSbackup can be found in the COS/Backup User Guide V3.2. | + | Arbitrary commands can easily be run as part of a backup job The scan method now defaults to multi-volume media scan, where the scan proceeds from the last tape in the set to the first. |
| - | Arbitrary commands can easily be run as part of a backup job | + | |
| - | The scan method now defaults to multi-volume media scan, where the scan proceeds from the last | + | |
| - | tape in the set to the first. | + | |
| To manually scan a single volume from the command line, you can still use the command: | To manually scan a single volume from the command line, you can still use the command: | ||
| - | FSdrive <drivename> scan | + | FSdrive <drivename> scan |
| - | Media scan now default to multi-volume | + | |
| - | The scan method now defaults to multi-volume media scan, where the scan proceeds from the last | + | Media scan now default to multi-volume The scan method now defaults to multi-volume media scan, where the scan proceeds from the last tape in the set to the first. |
| - | tape in the set to the first. | + | |
| To manually scan a single volume from the command line, you can still use the command: | To manually scan a single volume from the command line, you can still use the command: | ||
| - | FSdrive <drivename> scan | + | FSdrive <drivename> scan |
| - | Media copy now run from ‘At-end command’, COSbackup interface or command line | + | |
| - | There are now three ways to produce a duplicate set of a backup media volume set. In all cases the | + | Media copy now run from ‘At-end command’, COSbackup interface or command line There are now three ways to produce a duplicate set of a backup media volume set. In all cases the target drive must be of the same media type as the source drive. |
| - | target drive must be of the same media type as the source drive. | + | |
| - | 1. From the At-end command as defined for a backup job: | + | #From the At-end command as defined for a backup job: |
| - | FScopy [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] <target drive> | + | #:;FScopy [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] <target drive> |
| - | This will copy the media set used for the current backup to a new media set in the target drive. The | + | #:This will copy the media set used for the current backup to a new media set in the target drive. The expiry date of the duplicate set is set to the same date as that of the backup job. This can be overridden by specifying “-r <retention>” or “-r <days>”. |
| - | expiry date of the duplicate set is set to the same date as that of the backup job. This can be | + | #:If the target drive is likely to be busy when needed for creating a duplicate media set, a timeout parameter may be added to the above command, “-T <minutes>”. If this parameter is omitted and the target drive is busy, the media copy will fail. |
| - | overridden by specifying “-r <retention>” or “-r <days>”. | + | #Via COSbackup interface, from the COSbackup button bar: |
| - | If the target drive is likely to be busy when needed for creating a duplicate media set, a timeout | + | #:;Media > select media set > Maintain > Copy |
| - | parameter may be added to the above command, “-T <minutes>”. If this parameter is omitted and | + | #:You will be prompted for the run mode, the source drive and the target drive. The retention defaults to that of the selected media set, but may be overridden. |
| - | the target drive is busy, the media copy will fail. | + | #:When using manually loaded drives, unless the output media volume is preloaded in the target drive, a “Change media” will appear on the backup job monitor. To preload a scratch media volume, from the COSbackup button bar: |
| - | 2. Via COSbackup interface, from the COSbackup button bar: | + | #:;Drive > select target drive > Operations > Load scratch |
| - | Release Notes for COSbackup 3.2.6 (Patch and Application)—March 2004 Page 5 | + | #From the command line, as would be used by COStask or COSduty, or a 3rd party batch processing product: |
| - | Media > select media set > Maintain > Copy | + | #:;FScopy -b [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] -s <media number> <source drive> <target drive> |
| - | You will be prompted for the run mode, the source drive and the target drive. The retention | + | #:The retention period must be defined in the retention table. If it is not, the retention of the duplicate set will be set to “forever”. |
| - | defaults to that of the selected media set, but may be overridden. | + | |
| - | When using manually loaded drives, unless the output media volume is preloaded in the target | + | |
| - | drive, a “Change media” will appear on the backup job monitor. To preload a scratch media | + | |
| - | volume, from the COSbackup button bar: | + | |
| - | Drive > select target drive > Operations > Load scratch | + | |
| - | 3. From the command line, as would be used by COStask or COSduty, or a 3rd party | + | |
| - | batch processing product: | + | |
| - | FScopy -b [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] -s <media number> | + | |
| - | <source drive> <target drive> | + | |
| - | The retention period must be defined in the retention table. If it is not, the retention of the duplicate | + | |
| - | set will be set to “forever”. | + | |
| - | See FScopy(1) man page for further detail. | + | |
| Restore steps may now be pre-configured | Restore steps may now be pre-configured | ||
| - | You may now initiate a restore via the command line. This may be used by COStask or COSduy | + | |
| - | to preconfigure specific application restores. The command is: | + | You may now initiate a restore via the command line. This may be used by COStask or COSduy to preconfigure specific application restores. The command is: |
| - | FSrestore -i|-b [-D <to directory>] [-h <to hostname>] [-v <drive>] [-M <method>] | + | ;FSrestore -i|-b [-D <to directory>] [-h <to hostname>] [-v <drive>] [-M <method>] [-f <files>] [-d <directories>] [<media number>] |
| - | [-f <files>] [-d <directories>] [<media number>] | + | |
| - | If any parameters are missing a prompt will be displayed requesting the missing values. | + | If any parameters are missing a prompt will be displayed requesting the missing values. |
| - | Warnings | + | |
| + | == Warnings == | ||
| None known. | None known. | ||
| Release Notes for COSbackup 3.2.6 (Patch and Application)—March 2004 Page 6 | Release Notes for COSbackup 3.2.6 (Patch and Application)—March 2004 Page 6 | ||
| Hardware and OS Dependencies | Hardware and OS Dependencies | ||
| AIX 4: cpio backup methods do not backup files greater than 2 gigabytes | AIX 4: cpio backup methods do not backup files greater than 2 gigabytes | ||
| - | The /usr/bin/cpio program, as used by COSbackup, cannot backup files that are greater than | + | Th e /usr/bin/cpio program, as used by COSbackup, cannot backup files that are greater than |
| 2 gigabytes in size. The standard cpio header uses a 32 bit signed type to store the file size. this | 2 gigabytes in size. The standard cpio header uses a 32 bit signed type to store the file size. this | ||
| limits the file size to 2 gigabytes minus 1 byte. | limits the file size to 2 gigabytes minus 1 byte. | ||
Revision as of 02:19, 4 May 2006
Contents |
Features
Implementation of the Patch applies fixes according to solutions described in the attached table - please refer for full details.
Fixes included in this Patch are cumulative including prior patches.
They are:
- cpio backup methods do not backup files larger than 2 gigabytes
- index files are removed if backup step completes with non-zero exit status
- automatic jobs cannot have complex scheduling
- backing up read only filesystems produces error messages
- media retention period cannot be overriden when producing a media copy at the end of abackup job
- drives cannot easily be marked as “out of action”
- all users can schedule any backup and restore data from any media
- media indices are not displayed in alphabetical order
- restoring data from index may cause drive status information to become corrupt
- all fixes in COSbackup 3.2.5 patch
- image backup method, as used by the DA-Oracle module, does not backup files larger than2 gigabytes
- cpio backup methods do not backup files larger than 2 gigabytes (see “Hardware and OS Dependencies”)
- multi-part backup methods can not stat files larger than 2 gigabytes
- all fixes in COSbackup 3.2.3 patch
- expiring media may leave unused contents files in the COSbackup media database
- print error when media catalogue is printed from at-end command
- unable to restore files bigger than 2 gigabytes on Dynix/ptx when using TAR or DUMPmethods
- multi-volume scan may only scan a subset of the tape files
- waiting for drive during a media copy may time out even though drive is available
- during a multi-step, multi-part restore a read error occurs, repositioning on media for restore of subsequent step may be incorrect
- all fixes in COSbackup 3.2.2 patch
- unclear details logged or displayed in monitor about media duplication
- media copy hangs if using drivepools
- media copy does not wait for target drive to become available
- retention for duplicated media same as source
- auto job acknowledgement implies auto unload
- log file title displayed as “db_lock: waiting for the drive”
- FSdump backup method uses “dump” command instead of “vdump” on Digital Unix
- recovery cannot be pre-configured
- searching media indexes slow
- media contents incorrect when appending backup job killed
- incremental tar backup method backs up the list of files rather than the files
- a not yet started backup job can be acknowledged
- loading class not displayed when changing drive details
- all fixes in COSbackup 3.2.1 patch
- wrong flags in FScpio
- typo in offsite program
- disable appending backup “ready mode”
- rewind after a backup using Rewind_op
- “unload” not run during auto-acknowledgement
- unload failing should not stop acknowledgement
- messages from auto-acknowledgement and unload not going into logfile
- symbolic links creacted by config task are imcomplete
The major new features in version 3.2.6 are
- backup any size file using the CPIO format
- mark a drive as offline
The major new features in version 3.2.3 are
- improved error recovery during restore if a media error occurs
- scanning multi-volume media sets
The major new features in version 3.2.2 are
- media copy can be run from at end command of backup job, COSbackup interface, and command line
- multi-part file backup on 32 bit architecture was restricted to file sizes up to 1 gigabyte for image backups
Environment
Software Prerequisites: Before you can install COSbackup 3.2.6 (application), COSmanager 4.2 (or newer) must already be installed on the same host. Notes (only applies to patch) Patch applied after COSbackup 3.2 has been configured: If you are using, or choose to use appending backups, you must change the label type for each media type used from “COSstdtape” to “COSstdindx”.
To change media type:
- Select Media from the COSbackup button bar.
- Select Maintain > Media type.
- Select a media type to change, then select Maintain > Change.
- Change label type from “COSstdtape” to “COSstdindx”.
- Label type
- This determines what label format and method will be used to electronically label volumes:
- COSstdtape
- writes a short file containing the media number and ‘date last written’ to the start of the tape, but does not write an end-of-data marker.
- COSstdindx
- writes the label to the start of a tape, and an end-of-data marker after the last file.
- end_label
- writes the label to the last block of a diskette.
- sV_ filesys
- System V filesystem label using the labelit command.
- blank
- volumes will not be labeled.
Press Accept to save this media type information.
If any of your media types have a label type of “COSstdBOT”, please call the Functional Support Line.
Patch applied after COSbackup 3.2.1 patch applied
No further action required.Patch applied after COSbackup 3.2.2 patch applied
No further action required.Patch applied after COSbackup 3.2.3 patch applied
No further action required.Patch installed same time as COSbackup 3.2
No further action required.Technical Notes: Using COSbackup V3.2.6
This section contains some technical notes, tips, and troubleshooting information to help you when installing or upgrading to COSbackup V3.2.6. Detailed information on setting up and using COSbackup can be found in the COS/Backup User Guide V3.2.
Arbitrary commands can easily be run as part of a backup job The scan method now defaults to multi-volume media scan, where the scan proceeds from the last tape in the set to the first.
To manually scan a single volume from the command line, you can still use the command:
FSdrive <drivename> scan
Media scan now default to multi-volume The scan method now defaults to multi-volume media scan, where the scan proceeds from the last tape in the set to the first.
To manually scan a single volume from the command line, you can still use the command:
FSdrive <drivename> scan
Media copy now run from ‘At-end command’, COSbackup interface or command line There are now three ways to produce a duplicate set of a backup media volume set. In all cases the target drive must be of the same media type as the source drive.
- From the At-end command as defined for a backup job:
- FScopy [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] <target drive>
- This will copy the media set used for the current backup to a new media set in the target drive. The expiry date of the duplicate set is set to the same date as that of the backup job. This can be overridden by specifying “-r <retention>” or “-r <days>”.
- If the target drive is likely to be busy when needed for creating a duplicate media set, a timeout parameter may be added to the above command, “-T <minutes>”. If this parameter is omitted and the target drive is busy, the media copy will fail.
- Via COSbackup interface, from the COSbackup button bar:
- Media > select media set > Maintain > Copy
- You will be prompted for the run mode, the source drive and the target drive. The retention defaults to that of the selected media set, but may be overridden.
- When using manually loaded drives, unless the output media volume is preloaded in the target drive, a “Change media” will appear on the backup job monitor. To preload a scratch media volume, from the COSbackup button bar:
- Drive > select target drive > Operations > Load scratch
- From the command line, as would be used by COStask or COSduty, or a 3rd party batch processing product:
- FScopy -b [-u] [-U] [-T <minutes>] [-r <retention>|-r <days>] -s <media number> <source drive> <target drive>
- The retention period must be defined in the retention table. If it is not, the retention of the duplicate set will be set to “forever”.
Restore steps may now be pre-configured
You may now initiate a restore via the command line. This may be used by COStask or COSduy to preconfigure specific application restores. The command is:
- FSrestore -i|-b [-D <to directory>] [-h <to hostname>] [-v <drive>] [-M <method>] [-f <files>] [-d <directories>] [<media number>]
If any parameters are missing a prompt will be displayed requesting the missing values.
Warnings
None known. Release Notes for COSbackup 3.2.6 (Patch and Application)—March 2004 Page 6 Hardware and OS Dependencies AIX 4: cpio backup methods do not backup files greater than 2 gigabytes Th e /usr/bin/cpio program, as used by COSbackup, cannot backup files that are greater than 2 gigabytes in size. The standard cpio header uses a 32 bit signed type to store the file size. this limits the file size to 2 gigabytes minus 1 byte. Appears: “< filename > ?” is displayed in the backup log, when attempting to backup a file greater than 2 gigabytes in size. Suggested actions: • Use a backup format other than cpio for directories containing files greater than 2 gigabytes in size. For example, backup the individual large files using the image backup method. • Alternately, upgrade to AIX 5.1 or later with the System V Affinity package. If installed, COSbackup will use /usr/sysv/bin/cpio instead, that can backup and restore files of any size. /usr/sysv/bin/cpio is backward compatable with /usr/bin/cpio. Linux: cpio backup methods do not backup files greater than 2 gigabytes The /usr/bin/cpio program, as used by COSbackup, cannot backup files that are greater than 2 gigabytes in size. The standard cpio header uses a 32 bit signed type to store the file size. this limits the file size to 2 gigabytes minus 1 byte. Appears: “filename is too large to archive in current mode” is displayed in the backup log, when attempting to backup a file greater than 2 gigabytes in size. Suggested actions: • Use a backup format other than cpio for directories containing files greater than 2 gigabytes in size. For example, backup the individual large files using the image backup method. Solaris: cpio backup methods do not backup files greater than 2 gigabytes The /usr/bin/cpio program, as used by COSbackup, cannot backup files that are greater than 2 gigabytes in size. The standard cpio header uses a 32 bit signed type to store the file size. this limits the file size to 2 gigabytes minus 1 byte. Appears: “filename is too large to archive in current mode” is displayed in the backup log, when attempting to backup a file greater than 2 gigabytes in size. Release Notes for COSbackup 3.2.6 (Patch and Application)—March 2004 Page 7 Suggested actions: • Specify “-p” in the Options field of the Backup Item. This will allow for the backup of files up to 8 gigabytes minus 1 byte in size. Files larger than 8 gigabytes minus 1 byte will display an error in the backup log. Using the “-p” option will display an error message in the backup log when backing up /devices files and limit the file path length to 256 characters long (instead of the normal 1024 characters). • Use a backup format other than cpio for directories containing files greater than 2 gigabytes in size. For example, backup the individual large files using the image backup method. Further Information Contact the Functional Support Line at: support@fs.com.au Tel: +61 2 9869 0240 Fax: +61 2 9869 0280 Visit our website for the latest patch distributions and related documentation at: http://www.fs.com.au/support