These release notes support Backup Toolkit V4.4.4 for use with SAMS:Alexandria V4.50.70 on systems running DYNIX/ptx® V4.4.4 or later maintenance releases, DYNIX/ptx V4.5.x, or DYNIX/ptx V4.6.x.
Backup Toolkit contains scripts for installation, device configuration, disaster preparation and recovery, and other miscellaneous tasks for use with the SAMS:Alexandria® backup product from Computer Associates International, Inc. (CA). Backup Toolkit is a required part of the SAMS:Alexandria installation on a DYNIX/ptx host. Read these release notes before you install or run Backup Toolkit and SAMS:Alexandria on a DYNIX/ptx host.
On DYNIX/ptx V4.4.4 or later maintenance releases or DYNIX/ptx V4.5.x, you can upgrade to Backup Toolkit V4.4.4 and SAMS:Alexandria V4.50.70 from the following earlier versions:
Backup Toolkit V4.4.3 and SAMS:Alexandria V4.50.70.
Backup Toolkit V4.4.2 and SAMS:Alexandria V4.50.53.
Backup Toolkit V4.4.1 and SAMS:Alexandria V4.50.17a.
Backup Toolkit V4.4.0 and SAMS:Alexandria V4.00.97
Backup Toolkit V4.4.0 and SAMS:Alexandria V4.00.70.
These release notes are organized as follows:
Backup Toolkit V4.4.4 requires that Fastpatch #255657 be installed before you install or upgrade SAMS:Alexandria on a host running DYNIX/ptx V4.4.10. This fastpatch is not required for earlier versions of DYNIX/ptx.
On DYNIX/ptx V4.5.3 and V4.6.1, Backup Toolkit V4.4.4 and SAMS:Alexandria V4.50.70, with SAMS:Alexandria fastpatch #255438, can support the IBM 3494 tape library and its internal Fibre Channel-ported IBM Magstar 3590 tape drives (model E1A).
Backup Toolkit and SAMS:Alexandria have also been qualified for use with DLT7000E tape drives in STK libraries connected via Fibre Channel (FC) Bridges on systems running DYNIX/ptx V4.4.9, V4.5.3, or V4.6.1. With fastpatch #255438, SAMS:Alexandria also supports DLT7000E tape drives connected via IBM 2108 R03 SAN Data Gateway (SDG) Routers on systems running DYNIX/ptx V4.5.3 and V4.6.1.
Lastly, Backup Toolkit and SAMS:Alexandria have been qualified for use with DLT8000 tabletop tape drives directly connected to systems running DYNIX/ptx V4.5.3 or V4.6.1. Connection of DLT8000 tabletop tape drives via an FC Bridge or an SDG Router is not supported.
ATTENTION If a host plans to use FC-connected backup devices with SAMS:Alexandria, you must obtain SAMS:Alexandria fastpatch #255438 from customer support and install it.
Furthermore, if you install this patch, you must also install fastpatch #255538, which corrects a problem with buildmini support for SAMS:Alexandria when fastpatch #255438 is installed.
Additionally, for connection of an IBM 3494 tape library to a NUMA system, you must install the IBM Automated Tape Library Software, which contains the lmcpd daemon and some additional files. The IBM Automated Tape Library software enables communication between a NUMA host and an IBM 3494 tape library. For details, refer to the subtopic "Configure IBM 3494 Tape Libraries" of the topic "Configure Backup Devices" in the online document Backup Toolkit Administration for SAMS:Alexandria.
ATTENTION To obtain custom miniroot support for IBM 3494 tape libraries, you must obtain fastpatch #255534 from IBM Customer Support. Without this fastpatch, you will be unable to access and use an IBM 3494 library while booted from the custom miniroot.
Backup Toolkit V4.4.4 is supported on DYNIX/ptx V4.6.x and has the following differences from Backup Toolkit V4.4.4 running on DYNIX/ptx V4.5.x or V4.4.x:
Backup Toolkit has the following changes involving the setting of kernel parameters:
The kernel parameters MSGSEG and MSGSSZ are not adjusted by Backup Toolkit as they are not applicable to DYNIX/ptx V4.6.x. Instead, Backup Toolkit adjusts MSGMEM when the current value is less than 131,072. If this is the case, this parameter is set to 131,072.
The SHMMNI kernel parameter is not adjusted by Backup Toolkit as it is not applicable to DYNIX/ptx V4.6.x. Instead, the base.shm memory pool specifies the maximum number of shared-memory identifiers, system-wide. Backup Toolkit uses kmstune to add 64 to the base.shm memory pool. To preserve the change across system boots, Backup Toolkit also modifies the /etc/ktune.d/base.shm script accordingly.
If needed, you can use kmstune to dynamically adjust the value of the base.shm memory pool without recompiling the kernel. Note that changes made with kmstune are not preserved across system boots. For more information on memory pools and kmstune, refer to "Modify Kernel Parameters Dynamically" in the online DYNIX/ptx System Configuration and Performance topic.
The /etc/init.d/alex startup script checks and dynamically sets the parameters required by SAMS:Alexandria. For this reason, a kernel compile and reboot is not needed immediately after installation. However, to make these changes permanently in the kernel, you must eventually recompile the kernel and reboot.
The systeminfo -B script creates the diskown.out file in addition to the drinfo.out and sysinfo.out files. The diskown.out file contains information returned from the diskown -m command about the disk labels for all disks visible to the host. The DYNIX/ptx V4.6 System Recovery and Troubleshooting Guide, Chapter 2, "Disaster Preparation for SAMS:Alexandria," provides an example of this file and describes how to use the information in this file during a disaster recovery.
Additionally, the drinfo.out file created by systeminfo -B contains VTOC data for all node-owned disks on the host while the sysinfo.out file contains VTOC data for all cluster-owned disks visible to the host.
No new features or changes have occurred to Backup Toolkit V4.4.4 when running on DYNIX/ptx V4.5.x and V4.4.x.
These release notes and the online document Backup Toolkit Administration for SAMS:Alexandria have been updated to include support for running Backup Toolkit V4.4.4 on DYNIX/ptx V4.6.x.
The release of Backup Toolkit V4.4.3 includes the following changes:
Backup Toolkit V4.4.3 supports SAMS:Alexandria V4.50.70 on hosts running DYNIX/ptx V4.4.4 and later maintenance releases and DYNIX/ptx V4.5.x. Previous versions of Backup Toolkit do not support SAMS:Alexandria V4.50.70.
ATTENTION Previously, Backup Toolkit V4.4.3 was supported on DYNIX/ptx V4.6.x only by installing Fastpatch 253655. This fastpatch enabled Backup Toolkit to install SAMS:Alexandria on a DYNIX/ptx V4.6.0 host and provided other required changes to support DYNIX/ptx V4.6.0. All the changes in this fastpatch have been incorporated into Backup Toolkit V4.4.4.
Backup Toolkit V4.4.3 and SAMS:Alexandria V4.50.70 support the new generation L700 library from StorageTek (STK). This library can contain up to 20 DLT7000 tape drives and, depending on the number of tape drives and the cartridge storage capacity selected, from 154 to 678 storage slots for cartridges. The SetupHD.Seq utility has been updated to support configuration of directly-connected STK L700 libraries on DYNIX/ptx V4.5.x hosts.
Information about supported connections for this library and configuring this library for use with SAMS:Alexandria is provided in "Configure Backup Devices" of the online document Backup Toolkit Administration for SAMS:Alexandria.
The SAMS:Alexandria backup product is now owned by CA who acquired Sterling Software, Inc in March 2000. Press releases about this acquisition and the integration into CA are available at the following URL:
SAMS:Alexandria V4.50.70 includes support for a new environment variable, SSW_WAIT_ON_DEVICE, which you use to change the way that COBRA Store operations look for available, active devices. By default, this environment variable is not set and COBRA only checks that a device is configured online before creating child operation cards. No check is made to ensure that the device is not in use by other Store operations. The result is that child operation cards can fail due to unavailable devices. If no devices become available before the number configured for FAILURE-RETRIES has been exhausted, the entire COBRA Store operation will fail. This issue primarily impacts COBRA Stores run on an ad hoc basis when other core SAMS:Alexandria Store operations are running.
If you include the environment variable SSW_WAIT_ON_DEVICE=32 in a parent COBRA Store operation card, COBRA checks that a device is configured online and not in use by another Store operation before creating child operation cards. For example:
ENV SSW_WAIT_ON_DEVICE=32
ATTENTION COBRA Store operation cards with this option enabled do not have a time-out value for how long to wait for a device to become available. Therefore, if you set SSW_WAIT_ON_DEVICE=32 and no devices are available for COBRA to use, the Oracle database designated in the Store operation card will be shutdown or in backup mode for extended periods of time while waiting for a device.
Software defects have been fixed in SAMS:Alexandria and SAMS:Alexandria COBRA. (No software defects were fixed in Backup Toolkit.) For more information, refer to "Fixed Problems in Backup Toolkit V4.4.3 and SAMS:Alexandria V4.50.70" in Chapter 5 of these release notes.
The release of Backup Toolkit V4.4.2 included the following changes:
Backup Toolkit V4.4.2 supports SAMS:Alexandria V4.50.53 on hosts running DYNIX/ptx V4.4.2 and later maintenance releases, and DYNIX/ptx V4.5.x. Previous versions of Backup Toolkit do not support SAMS:Alexandria V4.50.53 and previous versions of Backup Toolkit and SAMS:Alexandria are not supported on DYNIX/ptx V4.5.x.
The Alexandria backup product from Spectra Logic has been acquired by Sterling Software, Inc. Sterling Software has added Alexandria to the SAMS product portfolio under the name SAMS:Alexandria. SAMS:Alexandria V4.50.53 reflects the ownership and name change of Alexandria and is the first release of the product from Sterling Software.
Several software defects have been fixed in Backup Toolkit, SAMS:Alexandria, and SAMS:Alexandria COBRA. For more information, refer to "Fixed Problems in Backup Toolkit V4.4.2 and SAMS:Alexandria V4.50.53" in Chapter 5 of these release notes
Refer to the SAMS:Alexandria Release Notes for information about the enhancements, documentation clarifications, known problems, and repaired defects that are provided in the SAMS:Alexandria V4.50.53 release. The SAMS:Alexandria Release Notes mention devices and personalities that are not supported for use on DYNIX/ptx. For information on the features that are supported on DYNIX/ptx, refer to "Overview of Backup Toolkit and SAMS:Alexandria" later in this chapter.
The release of Backup Toolkit V4.4.1 includes the following changes:
Backup Toolkit V4.4.1 supports SAMS:Alexandria V4.50.17a on hosts running DYNIX/ptx V4.4.2 and later maintenance releases. Previous versions of Backup Toolkit do not support SAMS:Alexandria V4.50.17a.
Scripts were modified to run with SAMS:Alexandria V4.50. These changes are invisible to the user.
The COBRA store operation card template files cobra_cold and cobra_hot have been updated for SAMS:Alexandria V4.50. If you have exported COBRA v4.00 store operation cards to files or used these default operation card template files to create customized template files, manually migrate them for SAMS:Alexandria V4.50. Refer to "Upgrade Operation Card Template Files From COBRA v4.00 to COBRA v4.50" at the end of Chapter 3 for more information.
The ON-Bar store operation card template file onbar_simple has been changed to include the following new keywords: DATABASE-TYPE, ENV-VAR, and INTERLEAVE. If you have exported ON-Bar v4.00 store operation cards to files or used the onbar_simple file to create customized template files, you should consider whether you want to use these new keywords. For more information on ON-Bar keywords, refer to the SAMS:Alexandria ON-Bar Guide.
Several software defects were fixed in Backup Toolkit and SAMS:Alexandria. For more information, refer to "Fixed Problems in Backup Toolkit V4.4.1 and SAMS:Alexandria V4.50.17a" in Chapter 5.
Additionally, the following SAMS:Alexandria personalities are now supported on IBM DYNIX/ptx systems:
AlexClient/NTTM V3.0 personality, which backs up and restores Windows NT®, Windows® 95, and Windows 98 client machines. For more information, refer to the SAMS:Alexandria AlexClient/NT Module Release Notes and the SAMS:AlexClient/NT Guide.
The SAMS:Alexandria Recovery Manager (RMAN) personality, which backs up and restores Oracle® databases using the Oracle Recovery Manager specification. For supported Oracle versions and more information, refer to the SAMS:Alexandria Recover Manager Personality Release Notes and the SAMS:Alexandria Recovery Manager Personality Guide.
ATTENTION For technical support on the AlexClient/NT personality and the RMAN personality, contact IBM Customer Support.
Refer to the SAMS:Alexandria Release Notes for information about the new features, enhancements, documentation clarifications, known problems, and repaired defects that were provided in the SAMS:Alexandria V4.50.17a release. The SAMS:Alexandria Release Notes mention devices and personalities that are not supported for use on IBM DYNIX/ptx systems. For information on those features supported by DYNIX/ptx, refer to "Overview of Backup Toolkit and SAMS:Alexandria" later in this chapter.
Backup Toolkit V4.4.0 is the first release of a new DYNIX/ptx layered product for SAMS:Alexandria, which replaces ptx/ESBM. Backup Toolkit V4.4.0 supports SAMS:Alexandria V4.00.70 on hosts running DYNIX/ptx V4.4.2 or later maintenance releases. For more information on the new product model, refer to "Overview of Backup Toolkit and SAMS:Alexandria."
This section summarizes the features of Backup Toolkit and SAMS:Alexandria. The following product areas are covered:
Backup Toolkit contains scripts for installation, device configuration, disaster preparation and recovery, and other miscellaneous tasks required to install and use SAMS:Alexandria on DYNIX/ptx hosts. Backup Toolkit contains the following features:
Backup Toolkit is installed like any other DYNIX/ptx layered product, with ptx/ADMIN® or ptx/INSTALL, depending on the version of DYNIX/ptx on your host. You can then install or deinstall SAMS:Alexandria using the Backup Toolkit installalex script. (SAMS:Alexandria is not installed with ptx/ADMIN or ptx/INSTALL.) The installalex script performs the necessary pre- and post-installation checks required to run SAMS:Alexandria on a DYNIX/ptx host. The installalex script, once it is installed, reapplies all of the information to SAMS:Alexandria that is necessary for 100% compatibility.
Complete details about installing Backup Toolkit and SAMS:Alexandria are provided later in these release notes; refer to Chapter 3, "Install Backup Toolkit V4.4.4." Those customers new to SAMS:Alexandria should also refer to Chapter 2, "Hardware Installation and First-Time Installations."
Backup Toolkit V4.4.x supports standard libraries and tape drives that are supported by DYNIX/ptx. For details, refer to "Backup Device Requirements" later in this chapter.
SetupHD.Seq can now configure directly-connected STK 9710/9730 libraries in SAMS:Alexandria. Previously, it could not; you had to use Xalex to configure these libraries. For more information on device configuration, refer to the Backup Toolkit Administration for SAMS:Alexandria.
Disaster recovery processes and procedures for IBM DYNIX/ptx systems are integrated into SAMS:Alexandria after installation via Backup Toolkit.
Backup Toolkit includes a collection of miscellaneous scripts and templates, which are located in the /usr/alexbkup/local/bin directory after SAMS:Alexandria is installed. The scripts are primarily intended for use by IBM Customer Support. The templates are provided for use for Backup Toolkit and SAMS:Alexandria users. For more information, refer to the Backup Toolkit Administration for SAMS:Alexandria.
DYNIX/ptx supports most of the features available in SAMS:Alexandria V4.50. Details on the features of SAMS:Alexandria are provided in the SAMS:Alexandria documentation. IBM supports the following personalities and other noteworthy features on DYNIX/ptx:
SAMS:Alexandria COBRA v4.50 personality. For more information, refer to "COBRA/v4.50 Personality" later in this chapter.
The SAMS:Alexandria Oracle Recovery Manager (RMAN) Personality. This personality backs up Oracle using the Oracle Recovery Manager specification; SAMS:Alexandria's RMAN personality provides a graphical interface to RMAN functionality that simplifies its use. For more information, refer to the SAMS:Alexandria Recovery Manager Personality Release Notes and the SAMS:Alexandria Recovery Manager Personality Guide.
SAMS:Alexandria ON-Bar personality. For more information, refer to "ON-Bar Personality" later in this chapter.
AlexClient/NT V3.0 personality. For more information, refer to the SAMS:Alexandria AlexClient/NT Module Release Notes and the SAMS:AlexClient/NT Guide.
The device personalities for tape and library hardware supported on DYNIX/ptx. For more information on supported devices, refer to "Backup Device Requirements" later in this chapter. For more information on the SAMS:Alexandria personalities for these devices, refer to the Backup Toolkit Administration for SAMS:Alexandria.
The StackCopy utility, which makes copies of specific sets of backed up data that are located on one media element onto another piece of media. For more information on this utility, refer to the SAMS:Alexandria Reference Guide.
The transaction database logging option, which provides database protection by reducing the need for the database to require recovery and associated procedures, such as database packing. To implement the transaction logging database, use the alex-dbase commands, which are documented in the SAMS:Alexandria Reference Guide.
Network backups between DYNIX/ptx SAMS:Alexandria servers and non-DYNIX/ptx SAMS:Alexandria clients, and network backups between non-DYNIX/ptx SAMS:Alexandria servers and DYNIX/ptx SAMS:Alexandria clients. Network backups between any server and client must use the same version of SAMS:Alexandria, in this case, SAMS:Alexandria V4.50.70.
Java-based GUI.
IBM does not support the following SAMS:Alexandria personalities or features on DYNIX/ptx:
IBM supports the SAMS:Alexandria COBRA v4.50 personality on DYNIX/ptx. This personality is a backup and recovery agent for use with Oracle databases by SAMS:Alexandria server hosts. COBRA v4.50 includes OPS support. For supported Oracle versions, refer to the SAMS:Alexandria COBRA/v4 Personality Release Notes.
There are no separate installation steps for the COBRA personality; it is available for use after you have installed SAMS:Alexandria and configured a valid COBRA personality activation key. Documentation for this personality is provided in the SAMS:Alexandria COBRA System Administration Guide.
ATTENTION For technical support on the COBRA personality, contact IBM Customer Support.
After Backup Toolkit is installed, the/usr/alexbkup/local/bin directory contains two COBRA v4.50 template store operation cards. The file cobra_cold is a template operation card for cold COBRA backups, and the file cobra_hot is a template operation card for hot COBRA backups. Both of these files can be used with alex-xfer commands to build COBRA v4.50 operation cards.
Existing COBRA v4.00 customers must perform additional steps to migrate from these earlier versions of COBRA to COBRA v4.50 For more information, refer to "Upgrade Operation Card Template Files From COBRA v4.00 to COBRA v4.50" at the end of Chapter 3.
IBM supports the SAMS:Alexandria ON-Bar personality on DYNIX/ptx. This personality is a backup and recovery agent for use with Informix® Dynamic ServerTM databases by SAMS:Alexandria server hosts. The ON-Bar personality also supports the Informix Dynamic Server with the Advanced Decision Support Option and the Extended Parallel Option (ADO/XPO). For supported Informix Dynamic Server versions, refer to the SAMS:Alexandria ON-Bar Personality Release Notes.
There are no separate installation steps for the ON-Bar personality; it is available for use after you have installed SAMS:Alexandria and configured a valid ON-Bar personality activation key. The ON-Bar personality provides a JavaTM-based GUI for creating and running operation cards to back up and restore INFORMIX ODS database data. Documentation for this personality is provided in the SAMS:Alexandria ON-Bar Guide.
ATTENTION For technical support on the ON-Bar personality, contact IBM Customer Support. (For technical support on the ON-Bar utility, contact Informix Technical Support.)
After Backup Toolkit is installed, the/usr/alexbkup/local/bin directory contains one ON-Bar template file, called onbar_simple. This file can be used with the alex-xfer command to build a SAMS:Alexandria ON-Bar operation card.
The following requirements apply to each host that will be using Backup Toolkit 4.4.4 and SAMS:Alexandria V4.50.70.
Backup Toolkit V4.4.4 runs on NUMA systems with the following requirements:
The swap space on a given system should be equal to at least twice the physical memory size.
Each system must have its own version of Backup Toolkit and SAMS:Alexandria. DYNIX/ptx does not support installation of these products on a shared disk of a clustered system.
Each system must observe the backup device requirements that are listed later in this chapter under "Backup Device Requirements."
Each system must have a custom miniroot partition (partition 9) on a bootable disk. This partition is used to build the custom miniroot and is used in system recovery to load the custom miniroot so you can restore the operating system. For more information, refer to the DYNIX/ptx V4.4 System Recovery and Troubleshooting Guide, DYNIX/ptx V4.5 System Recovery and Troubleshooting Guide, or the DYNIX/ptx V4.6 System Recovery and Troubleshooting Guide, as appropriate.
Backup Toolkit and SAMS:Alexandria require ptx/LAN, ptx/TCP/IP, ptx/WINDOWS or ptx/XWM, and ptx/SPDRIVERS. Refer to the appropriate version of the DYNIX/ptx Release Notes for the version of the DYNIX/ptx software that applies to your host.
ATTENTION To use STK L700 libraries on a DYNIX/ptx V4.5.1 host, you must install a fastpatch to ptx/SPDRIVERS V3.1.0, which contains the device driver support for this library.
The firmware requirements are detailed in the following list. These firmware versions are only required for SAMS:Alexandria server hosts; client hosts do not require a specific version of QCIC, DDS-2, or DDS-3 firmware. The minimum versions required are listed; later versions will work as long as they are compatible with the version of DYNIX/ptx on your system.
DDS-2 library firmware V3.02.01 or later.
DDS-2 tape drive firmware 9711 or later.
DDS-3 library firmware V5.00.04 or later.
DDS-3 tape drive firmware 02CA or later.
To obtain the necessary DDS-2 or DDS-3 firmware, contact IBM Customer Support.
Network support is enabled by installing SAMS:Alexandria as a server or as a client. This networking support includes support for SAMS:Alexandria operations that involve ptx/NFS, for example, backup and restoration of ptx/NFS-mounted filesystems. A server backup refers to a backup going to a library attached to the same system submitting the operation card. In this case, the library is local. A client backup refers to a backup going across a network to a library connected to another system, the server. In this case, the library is remote.
SAMS:Alexandria V4.50.53 and later patch releases include changes in network protocols. For this reason, the only network configurations that are supported are those between server and client hosts running SAMS:Alexandria V4.50.53 and later patch releases. Network configurations are not supported between hosts running SAMS:Alexandria V4.50.53 or later patch releases and hosts running versions of SAMS:Alexandria prior to V4.50.53 or running any version of ptx/ESBM.
For more information about configuring network operations, refer to the SAMS:Alexandria documentation.
The installation of Backup Toolkit consumes 1 MB of disk space in the directory /usr/backup_toolkit. The installation requirements for SAMS:Alexandria are described in the SAMS:Alexandria Installation Guide.
The run-time disk space requirements for the scripts from Backup Toolkit are for the creation of disaster recovery information. Approximately 5 MB are needed for disaster recovery information in the subdirectory disaster_recovery, which is in the SAMS:Alexandria home directory, typically /usr/alexbkup. This space is needed for the output files that are created by the systeminfo shell script during housekeeping in preparation for a disaster. Actual disk space requirements will vary with the system configuration and the installed software on the given host.
For more information about the output files created by systeminfo, refer to Chapter 2, "Disaster Preparation for Alexandria" in the DYNIX/ptx V4.4 System Recovery and Troubleshooting Guide, DYNIX/ptx V4.5 System Recovery and Troubleshooting Guide, or the DYNIX/ptx V4.6 System Recovery and Troubleshooting Guide, as appropriate.
ATTENTION The remainder of these release notes refer to the SAMS:Alexandria home directory as /usr/alexbkup. If the software is located in another directory, be sure to use that directory when you see references to /usr/alexbkup.
The run-time disk space requirements for SAMS:Alexandria are for the SAMS:Alexandria database and for the SAMS:Alexandria primary and secondary temporary directories. For more information, refer to the SAMS:Alexandria Installation Guide and the SAMS:Alexandria Reference Guide.
IBM supports these data-storage devices for use with SAMS:Alexandria on DYNIX/ptx: DDS-2 libraries, DDS-3 libraries, Hewlett-Packard® DLT4000 libraries, STK libraries, IBM 3494 libraries, and DLT8000 tabletop tape drives. IBM also supports mixed library configurations for DYNIX/ptx sites that are migrating from one tape device to another. For more information, refer to the online document Backup Toolkit Administration for SAMS:Alexandria.
ATTENTION DYNIX/ptx does not support configurations that use both compressed and non-compressed modes: all configured devices on one host must use the same compression mode.
The first library configured in SAMS:Alexandria on each host should dedicate two tape slots for SAMS:Alexandria database backups. Additionally, each library should dedicate one tape slot for a cleaning cartridge.
Observe the restrictions for connecting these libraries to a DYNIX/ptx system that are described in the IBM documentation for these libraries. Refer to "Library Hardware Documentation" later in this chapter for a list of these documents. For information about library usage considerations and configuring these libraries in SAMS:Alexandria on a DYNIX/ptx host, refer to the Backup Toolkit Administration for SAMS:Alexandria.
Table 1-1 describes the supported backup devices.
Backup Device |
Internal Tape Drive |
Media Type |
Number of Tape Drives |
Number of Tape Slots |
Maximum per Host |
DDS-2 Library |
DDS-2 tape drive |
4-mm DAT 4 GB tapes |
2 4 |
22 or 60 20 or 58 |
8 |
DDS-3 Library |
DDS-3 tape drive |
4-mm DAT 12 GB tapes |
2 4 |
20 60 |
8 |
HP DLT4000 Library |
DLT4000 tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes |
2 4 |
48 48 |
2 |
STK 9710 Library Storage Module (directly- or ACSLS-connected) |
DLT4000 tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes |
1 through 10 |
252 or 420 or 588 |
2 |
DLT7000 or DLT7000E tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes (uncompressed in DLT4000 format) DLTtape IV 35 GB tapes |
||||
STK 9730 Library Storage Module (directly-connected) |
DLT4000 tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes |
1 to 4 |
18 or 30 |
3 |
DLT7000 or DLT7000E tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes (uncompressed in DLT4000 format) DLTtape IV 35 GB tapes |
||||
STK 9740 Library Storage Module (ACSLS-connected) |
DLT7000 or DLT7000E tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes (uncompressed in DLT4000 format) DLTtape IV 35 GB tapes |
1 to 10 |
318-486 per LSMa |
6 LSMs per ACSLS server, 2 ACSs on a single ACSLS servera |
STK L700 Library (directly- or ACSLS-connected)b |
DLT7000 or DLT7000E tape drive |
DLTtape IIIxt 15 GB tapes DLTtape IV 20 GB tapes (uncompressed in DLT4000 format) DLTtape IV 35 GB tapes |
1 to 20 |
154-678 |
2 |
IBM Magstar 3494 Tape Libraryc |
IBM Magstar 3590 Tape Drive (E1A)d |
IBM 3590 High Performance Tape Cartridge |
1 to 7 |
variablee |
1 |
DLT8000 tabletop tape drivef |
- |
DLTtape IIIxt 15 GB tapes DLTtape IV 40 GB tapes (uncompressed in DLT4000 format) DLTtape IV 80GB tapes |
1 |
- |
2 |
a. A single STK 9740 is called a Library Storage Module (LSM). You can connect up to six LSMs. The LSM cabinets bolt together and have a pass-through mechanism with which tape cartridges can be moved between cabinets. An array of LSMs (1 to 6) is called an Automated Cartridge System (ACS).
b. This library is supported as a directly-connected library on xSeries 430 hosts and NUMA-Q 2000 hosts running DYNIX/ptx V4.5.x or V4.6.x. It is supported as an ACSLS-connected library on Symmetry hosts running DYNIX/ptx V4.5.x and all hosts running DYNIX/ptx V4.4.4 or later maintenance releases. On hosts running DYNIX/ptx V4.4.2, the STK L700 library is not supported in any configuration.
c. For connection to a NUMA system, you must obtain the IBM Automated Tape Library Software, which contains the lmcpd daemon and some additional files. For details, refer to the subtopic "Configure IBM 3494 Tape Libraries" of the topic "Configure Backup Devices" in the online document Backup Toolkit Administration for SAMS:Alexandria.
d. Support is only for an FC-ported IBM Magstar 3590 tape drive, model E1A, when internal to an IBM 3494 tape library attached to a NUMA system running DYNIX/ptx V4.5.3 and ptx/SPDRIVERS V3.2.2 or DYNIX/ptx V4.6.1 and ptx/SPDRIVERS V4.1.1. Model E11 (autoloader/stacker) of the IBM Magstar 3590 tape drive and the Automated Cartridge Facility (ACF) functionality is not supported for use with SAMS:Alexandria.
e. The number of supported slots is determined by the lmcpd daemon and not by the NUMA system to which it is attached.
f. DLT8000 tape drives are supported only when directly connected to IBM xSeries 430 and NUMA-Q systems running DYNIX/ptx V4.5.3 and ptx/SPDRIVERS V3.2.2 or DYNIX/ptx V4.6.1 and ptx/SPDRIVERS V4.1.1. Connection via a Fibre Channel (FC) Bridge or a SAN Data Gateway (SDG) Router is not supported.
If you plan to use STK libraries that are ACSLS-connected and you are using ACSLS V5.4, the configuration on the ACSLS server host must meet the following requirements:
The isolation level option must be set to 3, Serializable. This is the only isolation level that IBM supports as it guarantees the most data integrity when performing concurrent transactions during ACSLS database read operations, such as queries and volume reports.
The automatic backup option must be set as follows:
If the host will be using the Backup Toolkit acsls_db.sh shell script to back up the ACSLS database, then the automatic backup option must be set for no automatic backups. The acsls_db.sh script is invoked by the Backup Toolkit systeminfo script, which by default is run during SAMS:Alexandria housekeeping.
ATTENTION When the Backup Toolkit acsls_db.sh shell script is backing up the ACSLS database, all other processes are unable to access the ACSLS database.
If the host is not using the acsls_db.sh shell script to backup the ACSLS database, the automatic backup option should be set according to normal site practices.
These requirements and limitations do not apply to ACSLS server hosts that are running ACSLS V6.x or ACSLS V5.3.2 or earlier versions.
For more information on isolation levels and automatic backup options, refer to the preinstallation discussion in the STK ACSLS Installation and Configuration Guide for Solaris.
For more information about the systeminfo script and SAMS:Alexandria housekeeping, refer to Chapter 2, "Disaster Preparation for Alexandria" in the DYNIX/ptx V4.4 System Recovery and Troubleshooting Guide, DYNIX/ptx V4.5 System Recovery and Troubleshooting Guide, or the DYNIX/ptx V4.6 System Recovery and Troubleshooting Guide, as appropriate.
Only users logged in as root can install Backup Toolkit and SAMS:Alexandria. The user alexbkup and the group alexbkup should be manually created during installation. Once the installation is completed, user alexbkup can configure and perform SAMS:Alexandria operations, including backup and recovery of all system files, even those owned by root. User alexbkup cannot view files owned by root after recovery because of the DYNIX/ptx permissions set on the files owned by root. However, alexbkup can modify all operation cards created by root. Your backup administrator can perform backups and recoveries as root or as alexbkup.
Backup tapes that were created with Alexandria V3.00, Patch Level 53 or later, or any version of ptx/ESBM, can be used with SAMS:Alexandria V4.50.70. IBM strongly recommends that you create new backups of all your data, especially the SAMS:Alexandria database, once the new version of SAMS:Alexandria is installed.
However, the only network configurations that are supported are those between server and client hosts running SAMS:Alexandria V4.50.53 or later patch releases. Network configurations are not supported between hosts running SAMS:Alexandria V4.50.53 or later patch releases and hosts running versions of SAMS:Alexandria prior to V4.50.53 or running any version of ptx/ESBM. This limitation exists because SAMS:Alexandria V4.50.53 and later patch releases include changes in network protocols.
SAMS:Alexandria cannot recover data that was backed up with DYNIX/ptx utilities such as tar and cpio. It can only recover data that it backed up. However, the DYNIX/ptx utilities cpio and tar can recover data backed up by SAMS:Alexandria as long as the data was backed up using the appropriate SAMS:Alexandria storage format, CPIO or TAR.
ATTENTION If you insert a tape that was backed up by another backup product into a library configured for use with SAMS:Alexandria, SAMS:Alexandria will treat the tape as blank and could write over its data. To avoid this problem, you should set the write-protect switch to open for any 4-mm DAT tapes or DLT tapes you want to preserve that were created by another backup product .
Furthermore, to prevent SAMS:Alexandria from attempting to use the write-protected tape, you should mark the tape as User Reserved (UR). Otherwise, store operations will attempt to use the write-protected tape, but then fail when they cannot actually write to the tape.
If your site plans to use multiple backup products in parallel, you must understand how SAMS:Alexandria and any other backup products modify the access time when a given file is backed up.
By default, SAMS:Alexandria modifies the change time of a file when that file is backed up. However, some backup products, like the DYNIX/ptx dump utility, rely on the change time to determine which files should be backed up during an incremental backup. The outcome of using these products in parallel is that incremental backups by products like dump actually back up more files than expected, in some cases a full backup. This happens because these same files have been recently backed up using SAMS:Alexandria.
If this issue affects your site, you should enable the "Modify File Access Time Instead of File Change Time" option on the Store operation card. This option is MODIFY-ACCESS-TIME in the Store operation card file. When this option is enabled, SAMS:Alexandria modifies the file access time instead of the change time, thereby enabling products like dump to create the incremental backups that are desired. By default, this option is not enabled. You can also change the default setting of this option by editing the <<DEFAULT>> Store operation card.
SAMS:Alexandria can back up and recover both the data in ptx/SVM volumes and the ptx/SVM configuration information. Special backup and recovery procedures must be used when backing up or recovering ptx/SVM data. For more information, refer to the Backup Toolkit Administration for SAMS:Alexandria.
On ptx/CLUSTERS systems, you can use SAMS:Alexandria to back up data on shared or local (private) disks by using local libraries. However, SAMS:Alexandria does not provide any special support for ptx/CLUSTERS. For example, SAMS:Alexandria does not have automated failover capabilities and does not support a shared SAMS:Alexandria database.
The restrictions for using SAMS:Alexandria on a ptx/CLUSTERS system are documented in the Backup Toolkit Administration for SAMS:Alexandria. Refer to this documentation before installing SAMS:Alexandria or attempting any backups of data on a ptx/CLUSTERS system.
SAMS:Alexandria is not compatible with the methods that ptx/Clusters Transition Configurator (CTC) uses with ptx/CTC objects that are of type FS or NFS. (These two types include DYNIX/ptx File Systems (UFS), Enhanced File Systems (EFS), and Network File System (NFS).) ptx/CTC enables you to set up and manage failover on a clustered system. Specifically, SAMS:Alexandria does not back up data when the mount point for that data is a symbolic link. For example, the GenOp script will fail when ptx/CTC mounted filesystems are encountered because GenOp determines and sets the Store Root Directory field for the Store operation cards to the mount point, which is a symbolic link when the data is under ptx/CTC control.
Additionally, SAMS:Alexandria cannot track data that ptx/CTC has moved between local mount points and NFS mount points. Lastly, it does not support a shared, single copy of the SAMS:Alexandria database among all nodes of the cluster. As the data moves between nodes of the cluster, each SAMS:Alexandria database on a given node only knows when that data was last backed on that node and has no knowledge of the backups that might have occurred on the other nodes. For more information about ptx/CTC, refer to the ptx/CTC Administration Guide.
SAMS:Alexandria cannot back up the access control list (ACL) information for files and directories in ACL filesystems. However, the data in ACL filesystems can be backed up. SAMS:Alexandria does not display any warning message about this omission.
To determine if a specific file has ACL information, use the getacl(1) command. To back up the ACL information, you can use the getacl command to place the ACL information into a file that can be backed up by SAMS:Alexandria. When the file that previously had ACL information is recovered, you can then also recover the file containing the ACL information and manually reapply the ACL information from this file as appropriate.
SAMS:Alexandria can back up the data in a ptx/Enhanced File System (ptx/EFS) filesystem; however, the persistent extent attributes are not backed up. (Extent attributes are the extent allocation policies associated with a file.) SAMS:Alexandria does not display any warning message about this omission.
To determine if a specific file has persistent extent attributes, use the ls command with the -e option. To display extent attributes for several files on a ptx/EFS filesystem, use the ptx/EFS command getext. To back up the extent attributes, you can save the output from the getext command to a file that can be backed up by SAMS:Alexandria. When the original file is recovered, you can then also recover the getext output file containing the saved extent attributes and manually reapply them as appropriate.
ATTENTION ptx/EFS is a dynamic inode/file allocation filesystem and the ptx/EFS filesystem information (file extent table) shares filesystem space with file data. The size of the ptx/EFS file extent table can vary depending on usage. SAMS:Alexandria is not aware of the size of the file extent tables that it backs up or the size of the file extent tables in ptx/EFS filesystems to which data is restored. For these reasons, when using SAMS:Alexandria with ptx/EFS, ensure that each ptx/EFS filesystem has at least one percent of free disk space.
For more information about ptx/EFS, refer to the online document ptx/EFS and ptx/CFS Administration.
SAMS:Alexandria is not compatible with extended fundamental types that are supported in DYNIX/ptx. For this reason, SAMS:Alexandria cannot save files that have 32-bit user IDs and group IDs. If you try to back up these types of files, the store operation will fail. Ensure that your system uses only user ID and group ID values less than or equal to 60,000. (By default, the ptx/ADMIN menu system limits user ID and group ID values to 60,000.)
SAMS:Alexandria is affected by the settings of the environment variables used for internationalization, for example, LANG and LC_COLLATE, when these variables are set for the root login when the SAMS:Alexandria daemons are started by the alex-install command. The setting of these environment variables can cause the sort command to sort the backup file list differently than it would in the default C language environment. The unexpected sorting order causes SAMS:Alexandria to fail the backup. To avoid this situation, do not set the internationalization environment variables for the root login. Also, always use the Backup Toolkit /etc/init.d/alex script to start SAMS:Alexandria. This startup script unsets these environment variables if they are set.
DYNIX/ptx supports raw partitions, files, and filesystems up to 1 TB in size (commonly called large files). SAMS:Alexandria automatically detects and backs up files and raw partitions that are 2 GB or larger when the RPF storage format is designated in the Store operation card. (COBRA always uses the RPF format to perform backups of Oracle datafiles.) Generally, you should create a separate Store operation card to back up this type of data.
ATTENTION The Detail-File information for a raw partition backup always shows zero total kilobytes.
If you try to use the storage formats Alexandria, CPIO, or TAR to back up files or raw partitions that are 2 GB or larger, SAMS:Alexandria excludes these files from the backup and lists these files in the exclude files for that day. Exclude files are found in the /usr/alexbkup/Store directory and have the filename Xmachine_name.##, for example, /usr/alexbkup/Store/Xhost1.2.
ATTENTION SAMS:Alexandria outputs a warning message only in the daily housekeeping mail that any files equal to or greater than 2 GB have been excluded from the backup. Note that the corresponding Store operation is marked as successful even though large files were excluded.
Backup Toolkit includes man pages that describe the DYNIX/ptx disaster recovery tools. The man pages can be viewed online with the man command. For example, to view the systeminfo man page, enter the following command:
# man systeminfo
The following man pages are included with Backup Toolkit:
SetupHD.Seq, which is provided by Backup Toolkit, does not have a man page; this command is documented in the Backup Toolkit Administration for SAMS:Alexandria.
The following product documentation is described:
Additionally, this section describes the ways in which the SAMS:Alexandria documentation does not apply to DYNIX/ptx hosts.
The following versions of IBM documentation support the versions of Backup Toolkit and SAMS:Alexandria as described by these release notes:
Backup Toolkit Administration for SAMS:Alexandria is applicable to DYNIX/ptx V4.4.x, V4.5.x, and V4.6.x and is available on the online documentation CD distributed with DYNIX/ptx V4.5.x and V4.6.x or at http://webdocs.numaq.ibm.com/.
System recovery documentation describes disaster preparation and recovery information for a specific version of DYNIX/ptx and the latest version of SAMS:Alexandria supported on that version of DYNIX/ptx. These documents are available on the online documentation CD distributed with DYNIX/ptx V4.5.x and V4.6.x or at http://webdocs.numaq.ibm.com/. IBM no longer provides these documents in hardcopy. To obtain hardcopy, print the desired information directly from your web browser.
If your system is running DYNIX/ptx V4.4.x, refer to the DYNIX/ptx V4.4 System Recovery and Troubleshooting Guide.
If your system is running DYNIX/ptx V4.5.x, refer to the DYNIX/ptx V4.5 System Recovery and Troubleshooting Guide.
If your system is running DYNIX/ptx V4.6.x, refer to the DYNIX/ptx V4.56 System Recovery and Troubleshooting Guide.
SAMS:Alexandria includes a documentation CD-ROM that provides web-browser and Adobe® Acrobat® access to the complete set of SAMS:Alexandria documentation. This CD-ROM also includes online-only troubleshooting and error messages guides. If you are an existing SAMS:Alexandria customer, this documentation has not changed from that provided with SAMS:Alexandria V4.50.53.
ATTENTION The release notes included on this CD-ROM are not the latest available. Be sure to refer to the hard-copy version of the release notes you receive, as well as the online readme file included with SAMS:Alexandria, for the most recent information.
The following subset of documentation is applicable when using SAMS:Alexandria on DYNIX/ptx systems:
The SAMS:Alexandria Release Notes describe new features in this release, enhancements, documentation corrections, known problems, and repaired defects.
The SAMS:Alexandria Installation Guide provides instructions on how to prepare clients and servers, install supported libraries, and install, test, and initially configure SAMS:Alexandria software.
The SAMS:Alexandria Quick Start provides a brief introduction to SAMS:Alexandria and the tasks you can complete using the SAMS:Alexandria X interface, including backup and restore tasks, and some media management tasks. The installation information in this document should not be used when installing SAMS:Alexandria on a DYNIX/ptx system.
The SAMS:Alexandria X Interface Guide provides instructions on how to use the SAMS:Alexandria X interface.
The SAMS:Alexandria Reference Guide provides an overview of SAMS:Alexandria software, a glossary of terms, a road map to developing and analyzing backup strategies, command reference, and a review of tasks a SAMS:Alexandria administrator may need to complete.
The Troubleshooting document provides troubleshooting tips.
The Error Messages document provides a listing of common error messages.
The SAMS:Alexandria COBRA/v4 Personality Release Notes describe new features, documentation clarifications, repaired defects, and known defects.
The SAMS:Alexandria COBRA System Administration Guide reviews the installation and use of COBRA, which is the Comprehensive Oracle Backup and Recovery Agent.
The SAMS:Alexandria ON-Bar Personality Release Notes describes new features, documentation clarifications, repaired defects, and known defects.
The SAMS:Alexandria ON-Bar Guide reviews the installation and use of the ON-Bar personality to backup and restore Informix OnLine Dynamic Server.
The SAMS:Alexandria AlexClient/NT Module Release Notes describes new features, repaired defects, and known defects.
The SAMS:AlexClient/NT Guide reviews the installation and use of the AlexClient/NT personality to back up and restore Windows NT, Windows 95, and Windows 98 systems.
The SAMS:Alexandria Recovery Manager Personality Release Notes describes supported platforms and known defects.
The SAMS:Alexandria Recovery Manager Personality Guide reviews the installation and use of the Recovery Manager personality used to back up Oracle databases.
The SAMS:Alexandria ACSLS Guide describes the SAMS:Alexandria-specific information about using an ACSLS-connected STK library with the SAMS:Alexandria ACSLS personality.
The following IBM documentation describes the libraries supported for use with SAMS:Alexandria. All of these documents are available on the online documentation CD or at http://webdocs.numaq.ibm.com/.
The DDSTM-2 Tape Library Operator's Guide explains how to install and operate the DDS-2 tape library and lists the library specifications and error codes displayed by the library.
The DDS-3 Tape Library Operator's Guide explains how to install and operate the DDS-3 tape library and lists the library specifications and error codes displayed by the library.
The NUMA-Q Supplement to the DLTTM Tape Library User's Guide provides information about the HP® DLT4000 tape library that is specific to NUMA systems. It is a supplement to the DLT Tape Library 28- and 48-Slot Models User's Guide, which is the vendor manual included with the library. Refer to the vendor manual for most user tasks.
Online documentation is available from IBM Beaverton for the supported StorageTek® libraries. The IBM documentation for STK L700, STK 9710, STK 9730, and STK 9740 libraries provides an overview of how the STK libraries are configured with an xSeries 430 or NUMA system and explains how to use the library operator panels. This information should be used in conjunction with the hardware manuals provided by STK for each particular library.
The SAMS:Alexandria documentation does not apply to DYNIX/ptx systems in the following ways.
The SAMS:Alexandria Installation Guide is applicable to DYNIX/ptx customers; however, this document must be used in conjunction with these Backup Toolkit release notes. You should start with these IBM release notes first, then as needed, refer to the SAMS:Alexandria Installation Guide for specific SAMS:Alexandria information.
For software installation information, refer to Chapter 3, "Install Backup Toolkit V4.4.4," of these release notes. For hardware installation information, refer to the IBM hardware manuals described earlier in this chapter under "IBM Library Hardware Documentation."
For technical support or activation keys, contact IBM Customer Support, not CA.
The SAMS:Alexandria documentation refers to password-protected personalities. Some of the supported library and tape drive personalities are unprotected and do not require activation keys. Only the ACSLS, ST-9710, ST-9730, and the ST-L700 library personalities require activation keys. For more information, refer to the section in Chapter 2 entitled "Obtain Activation Keys for SAMS:Alexandria."
The SAMS:Alexandria documentation describes the use of the SSCL interface for device communication. DYNIX/ptx systems do not use the SSCL interface. Instead, a SCSI pass-through interface is used. For more information, refer to the Backup Toolkit Administration for SAMS:Alexandria.
The SAMS:Alexandria documentation for configuring libraries and tape drives is not entirely applicable. Instead, refer to Backup Toolkit Administration for SAMS:Alexandria.