**************************** ECO SUMMARY INFORMATION **************************** Release Date: 21-DEC-2006 Kit Name: ABS_AXPVMS_V43_703.ZIP Kit Applies To: OpenVMS Alpha V7.3-2 & V8.2 Approximate Kit Size: 63070 blocks Installation Rating: INSTALL_2 Reboot Required: No Superseded Kits: None Mandatory Kit Dependencies: None Optional Kit Dependencies: None Checksums: ABS_AXPVMS_V43_703.ZIP Checksum: 603535569 ABS_AXPVMS_V43_703.ZIP MD5 Checksum: AB0408863F62133DD96EE5714FF84913 ____________________________________________________ Archive/Backup System for OpenVMS Version 4.3- ECO01 Release Notes November 2006 This release note describes new features, known restrictions, and errors found in the Archive/Backup System software and documentation, and provides a brief description of the changes for this version. The "New Features/Enhancements for this release" and "Documentation Updates and Errata" sections are updated for V4.3-ECO01 release. All other sections remain same from V4.3 release. Software Version: Archive/Backup System for OpenVMS V4.3-ECO01 Required Operating System: OpenVMS VAX V7.3, OpenVMS Alpha V7.3-2 & V8.2 and OpenVMS I64 V8.2 Required Software: Media, Device and Management Services for OpenVMS V4.3-ECO01 Optional Software: DECnet (Phase IV) or DECnet-Plus (PhaseV) or TCP/IP Services for OpenVMS ________________________________________________________________ November 2006 © Copyright 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendors standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. UNIX is a registered trademark of The Open Group. Oracle is a registered US trademark of Oracle Corporation, Redwood City, California. Java is a US trademark of Sun Microsystems, Inc. Printed in the US This document was prepared using VAX DOCUMENT, Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Introduction..................................... 1 1.1 Installing ABS/MDMS ........................... 3 2 Software Version Requirements.................... 4 2.1 Archive/Backup System Software Version Requirements................................... 4 2.2 Media Management Software Version Requirements................................... 5 3 New Features/Enhancements in this Release........ 5 3.1 New Archive/Backup System Features in this Release ....................................... 6 3.2 New MDMS Features/Enhancements in this Release........................................ 6 4 Problems Fixed in this Release................... 6 4.1 Archive/Backup System Problems fixed in This Release........................................ 6 4.1.1 ABS saves fail with BACKUP-F-POSITERR....... 6 4.1.2 ABS restores fail with BACKUP-F-LABELERR.... 7 4.1.3 MDMS Domain Scheduler set to NONE during V3.2A to V4.1 upgrade....................... 7 4.1.4 Inappropriate error message logged when a save fails.................................. 7 4.1.5 ABS NT Client save fails with ACCVIO........ 8 4.1.6 ABS - mail notification error............... 8 4.1.7 ABS RMU save returns "Qualified Success" when "RMU-E-FATALERR" is encountered........ 8 4.1.8 Problems with ABS and MDMS Delete Programs.. 8 4.1.9 ABS not updating scratch date............... 9 4.1.10 Scheduling Type is reset when a new node is added....................................... 9 4.1.11 RDF processes not shut down by the MDMS$SHUTDOWN.COM command procedure......... 9 4.1.12 ABS upgrade fails to rename file............ 9 iii 4.1.13 ABS save request returns "Completed with failure status" when BACKUP-W-AFNOTSAVED is encountered................................. 10 4.1.14 A failing incremental restore sometimes logs ABS_NO_LICENSE error with ABS_NOMORE_SOS error....................................... 10 4.1.15 ABS mail notification errors................ 10 4.1.16 ABS catalog lookup fails on ODS-5 disk...... 11 4.1.17 ABS save fails when -%MDMS-E-DRVEMPTY is encountered................................. 11 4.1.18 ABS save request fails with "ABS_ACCESS_DENIED"......................... 11 4.1.19 ABS restore ACCVIOs......................... 12 4.2 Media Management Problems Fixed in this Release........................................ 12 4.2.1 MDMS does not allocate a non-shared but disabled drive.............................. 12 4.2.2 At MDMS prompt, "SHOW JUKEBOX /CONT" or "SHOW JUKEBOX /CONT/BRIEF" gives incorrect information................................. 12 4.2.3 The MDMS$SERVER process is consuming 96% of the CPU time................................ 13 4.2.4 Wrong section block count in EOF1........... 13 4.2.5 Modified MDMS.CLD to fix the following issues...................................... 13 4.2.6 ABS/MDMS client save's schedule is updated with last run time, where as the save is not starting.................................... 14 4.2.7 MDMS scheduler is ignoring the exclude dates of a schedule............................... 14 4.2.8 MDMS$SERVER process hangs and logs a ranking violation................................... 14 4.2.9 MDMS$SERVER logs a ranking violation in the logfile..................................... 15 4.2.10 MDMS SET DRIVE/NONODE does not clear all the nodes in the drive object................... 15 4.2.11 ON_DEMAND job starts unexpectedly exactly after one year from the base date........... 15 4.2.12 MDMS Save/Restore request fails with "Invalid request name specified"............ 15 4.2.13 MDMS move volume command hangs in WAIT TIMER state....................................... 16 4.2.14 MDMS attempts to allocate the wrong drive... 16 iv 4.2.15 When the MDMS CREATE RESTORE is issued with /DESTINATION=[directory], the current working path is not prefixed to the destination................................. 17 4.2.16 Problems with MDMS$UNINSTALL.COM............ 17 4.2.17 The /Destination qualifier of restore object does not accept more than one location enclosed within brace or double quotes...... 17 4.2.18 MDMS translates the logical specified as part of the include specification of a save request..................................... 18 4.2.19 MDMS SHOW CATALOG command does not allow a prefix to be mentioned for the /SYMBOL qualifier................................... 18 4.2.20 MDMS SAVE request fails to execute on the second node specified in the execution node list........................................ 18 4.2.21 The startup process goes in an infinite loop during the volume label check and drive does not get deallocated......................... 19 4.2.22 MDMS SHOW CATALOG command fails with "MDMS-E-CANCELLED, request cancelled by user"....................................... 19 4.2.23 MDMS SHOW CATALOG/SAVE command fails when /PIECE qualifier is specified............... 19 4.2.24 RDCDRIVER crashes when ABS$STARTUP is executed followed by MDMS$STARTUP........... 20 4.2.25 MDMS SHOW CATALOG /SAVE command does not handle save names with more than 32 characters correctly........................ 20 4.2.26 ABS installation fails for ABS-OMT license.. 20 4.2.27 ABS custom schedule misbehaves.............. 21 4.2.28 DCSC LOAD/UNLOAD commands hang.............. 21 4.2.29 SHOW CATALOG/FILE displays incorrect information................................. 21 5 Known Problems and Restrictions in this Release.. 22 5.1 Archive/Backup System Known Problems .......... 22 5.1.1 SBT functionality on OpenVMS................ 22 5.1.2 Aborted save logs multiple messages on OpenVMS I64................................. 22 5.1.3 Staging unpack operation logs CMA exception on OpenVMS I64.............................. 22 v 5.1.4 ABS save fails with CMA exception if the catalog is not present...................... 22 5.1.5 SBT test program with RDF devices........... 22 5.1.6 One Movement Type Allowed Per Save Request.. 23 5.1.7 ABS REPORT SAVE_LOG Fails When Searching SLS Catalogs.................................... 24 5.1.8 ABS May Have Problems in Saving Files Greater Than 2 GB in Size................... 24 5.1.9 Setting Volume on Archive While Save is Running..................................... 24 5.1.10 Inherited Problems in Backup Agent ABS$BACKUP.EXE.............................. 24 5.1.11 Verifying Installation...................... 25 5.1.12 Permission Denied or Invalid Argument Error on Windows Save Request..................... 25 5.1.13 Save Request Must Specify The Correct Object Type........................................ 26 5.1.14 ABS RESTORE with Brief Listing Fails to Provide Listing File........................ 26 5.1.15 RMU Backup Exclude_Specification Parameter.. 26 5.1.16 RMU Backup Include_Specification Parameter.. 27 5.1.17 Selective Restore Operation................. 28 5.1.18 Avoid Use of ABS$UBS_VERBOSE Logical Name... 28 5.2 Archive/Backup System Restrictions ............ 28 5.2.1 SCSNODE must be defined for ABS/MDMS to start....................................... 28 5.2.2 Using DECnet-Plus (Phase V) With ABS........ 29 5.2.3 Post-processing Command Fails to Execute.... 29 5.2.4 Restriction On The "-bnn" Value for UNIX or NT Clients.................................. 29 5.2.5 Restoring an Entire Tru64 UNIX Filesystem... 30 5.2.6 Tape Device Protection...................... 30 5.2.7 OPCOM Restriction........................... 31 5.2.8 Request Restart............................. 31 5.2.9 No Restart Operation........................ 31 5.2.10 Restoring Multi-File Oracle Rdb Databases... 31 5.2.11 Restrictions with ABS Windows 2000 Client... 31 5.2.12 Restrictions with SBT....................... 32 vi 5.3 Known Media Management Problems and Restrictions................................... 32 5.3.1 RDF is not supported in OpenVMS V8.2........ 32 5.3.2 DCL Syntax For Lists Must be Followed or You May Get Unexpected Results.................. 32 5.3.3 Motif Look and Feel......................... 33 5.3.4 /AFTER_SCHEDULE logic misbehaves if ABS is shutdown when a save is executing........... 33 5.3.5 /AFTER_SCHEDULE qualifier................... 33 5.3.6 V4.1 stores object names in upper case only........................................ 34 5.3.7 Fiber channel Environment................... 34 5.3.8 MDMS does not support multiple NIC interfaces with TCP/IP on the same node..... 35 6 Media Management Configuration and Operation..... 35 7 Documentation Updates and Errata for V4.3-ECO01.. 35 7.1 Expiration Date and Retention Days ............ 35 7.2 Errata ........................................ 37 8 Converting ABS 3.* to V4.3....................... 38 9 Upgrading from ABS V2.*.......................... 39 10 How to Remove V4.3 ABS/MDMS Files................ 40 vii _________________________________________________________________ Preface Conventions The following conventions are used in this document: ___________________________________________________________ Convention_______Meaning___________________________________ {} In format command descriptions, braces indicate required elements. [ ] In format command descriptions, square brackets indicate optional elements of the command syntax. You can omit these elements if you wish to use the default responses. boldface text Boldface type in text indicates the first instance of a term defined in the Glossary or defined in text. italic text Italic type emphasizes important information, indicates variables, indicates complete titles of manuals, and indicates parameters for system information. Starting test This type font denotes system response, ... user input, and examples. Ctrl/x Hold down the key labels Ctrl (Control) and the specified key simultaneously (such as Ctrl/Z). v ___________________________________________________________ Convention_______Meaning___________________________________ PF1 x The key sequence PF1 x instructs you to press and release the PF1 key, and then press and release another key (indicated here by x). n A lowercase italic n denotes the generic use of a number. For example, 19nn indicates a four-digit number which the last two digits are unknown. x A lowercase x denotes the generic use of a letter. For example, xxx indicates any combination of three alphabetic _________________characters._______________________________ Related Products The following related products may be mentioned in this document: ___________________________________________________________ Product__________Description_______________________________ HSM HSM refers to Hierarchical Storage Management for OpenVMS software. MDMS MDMS refers to Media, Device and Management Services for OpenVMS software. OpenVMS OpenVMS refers to OpenVMS operating system. SLS SLS refers to Storage Library System for _________________OpenVMS_software._________________________ Associated Documents The following documents are part of the Archive/Backup System documentation set: o Archive/Backup System for OpenVMS Installation Guide o Archive/Backup System for OpenVMS Guide to Operations o Archive/Backup System for OpenVMS Command Reference Guide vi 1 Introduction This document describes new features, known problems, restrictions, and errors found in the Archive/Backup System software and documentation. This document also includes Media Device and Management Services changes for version 4.3-ECO01. o ABS V4.3 uses the MDMS server to manage policies (saves, restores, archives, and environments). See the MDMS sections of the release notes for more information on using the new database. ________________________ Note ________________________ Before upgrading from V3.n, we recommend that you do an ABS SHOW object/FULL/ OUT=filename on all your ABS objects. This is useful for comparison of the objects after the upgrade and the conversion. ______________________________________________________ o During the upgrade to V4.3 from V3.n, the MDMS database files will be copied to files named MDMS$DATABASE_LOCATION:MDMS$*_DB.DAT_COPY. The ABS policy engine configuration file is also renamed to ABS$SYSTEM:ABS$POLICY_CONFIG.DAT_OLD and the ABS$SYSTEM:ABS$EXT_*.COM files are renamed to ABS$EXT_ *.COM_OLD. These are used if you remove the V4.3 files, see Section 10 o ABS V4.0 did NOT allow a rolling upgrade on the servers or clients. This is because the policy engine has been moved into the MDMS server, so all nodes must be using the same mechanism to talk to the database server. If you are on an ABS V4.x stream you once again have the rolling upgrade option. o The V4.3 MDMS server provides the scheduling of save and restore requests. See the MDMS sections of the release notes for more information on the scheduling options. o If you are upgrading from 3.n the DECSCHEDULER scheduling option will be converted to SCHEDULER during the installation. Jobs will be submitted to DECscheduler using the MDMS$SYSTEM:MDMS$EXT_SCHEDULER.COM command procedure. 1 ________________________ Note ________________________ Because of this change, the SCHEDULER option will not work if you do not have a license for DECscheduler. If you are using the DECscheduler for flexibility of scheduling, check out the options available in V4.3 for the INTERNAL schedule with custom schedules. It offers very flexible scheduling. ______________________________________________________ o The ABS$SYSTEM:ABS$EXT*.COM external scheduling files were changed between V3.n and V4.0. In V3.n, the files were called ABS$SYSTEM:ABS$EXT_*.COM. In V4.0, these were moved and renamed to MDMS$SYSTEM:MDMS$EXT*.COM. If you are upgrading from V3.n and if you have made modifications to these procedures, be sure to incorporate your modifications into the new versions. Take the changes from ABS$SYSTEM:ABS$EXT_*.COM and put them into the MDMS$SYSTEM:MDMS$EXT*.COM files. The installation will not incorporate your changes into the command procedures, it will provide a new command procedure. The new command procedure must be used for the V4.3 external scheduling to work. o ABS V4.3 does not require DECnet for server communications. Since MDMS server handles the communications, you may use TCP/IP and/or DECnet. o If you are using the MDMS GUI on Microsoft Windows, and you do not have Java installed in the default path provided in the MDMSView.bat file, you must edit this file and change the path to point to the directory where Java.exe resides. The default in the batch file is C:\Program Files\JavaSoft\JRE\1.2\bin\java.exe. o When using the MDMS GUI on OpenVMS Alpha, the account quota PGFLQUO should be set to at least 200,000. Correspondingly, the system pagefile should be large enough to accommodate this quota. The process quota WSQUOTA should be set to 10,000. Correspondingly, the sysgen parameter WSMAX, should be set to 10,000 or higher. The system where you are running the GUI should have at least 128 MB of memory (preferably higher). 2 o When you install ABS and you are using HSM on your system, the installation procedure will ask you if you want to use the backup-via-shelving paradigm. If you answer "yes", a logical will be defined in your ABS$SYSTARTUP.COM file. If you say "no", the logical is not defined. If you later decide to use the backup-via-shelving paradigm, you must define the logical ABS$SHELVING_ SUPPORT to TRUE in your ABS$SYSTARTUP.COM procedure. Failure to define the logical will mean that /noshelved and /nopreshelved qualifiers will not be used during backup and files will be unshelved during the backup. o Earlier versions of ABS had allowed the use of SLS/MDMS V2.9x as the media manager. That interface has been removed from ABS V4.3. You must be prepared to use MDMS V4.3 before upgrading. See the "Converting to ABS/MDMS V4.0" chapter of the the Archive/Backup System for OpenVMS Installation Guide for important information and guidelines on converting from SLS/MDMS V2.9x to MDMS V4.3. o ABS V4.3 does not support the use of an Rdb database for the ABS policies. If you are currently using ABS with an Rdb database you must convert the Rdb database using the conversion procedure described in the release notes for V3.2A prior to upgrading to V4.3. 1.1 Installing ABS/MDMS If you are installing Archive Backup System (ABS)/Media Device and Management System (MDMS) for the first time, refer to the Installation Guide before installing the products. Refer to the Archive Backup System Guide to Operations for information on configuring ABS/MDMS. ABS/MDMS V4.3-ECO01 Kit contains the following savesets: o ABS043.A - Installation procedure and Release notes o ABS043.B - Common files o ABS043.C - OpenVMS Alpha Executables o ABS043.D - OpenVMS Vax Executables o ABS043.E - RDF kit 3 o ABS043.F - GUI Kit for OpenVMS Alpha/I64 o ABS043.G - GUI kit for Windows o ABS043.H - OpenVMS I64 Executables 2 Software Version Requirements The following sections describe the software version requirements for ABS and MDMS. 2.1 Archive/Backup System Software Version Requirements Before installing Archive/Backup System V4.3-ECO01, you must meet the following requirements: o OpenVMS Alpha V7.3-2 and V8.2 o OpenVMS VAX V7.3 o OpenVMS I64 V8.2 o DECnet Phase IV or DECnet-Plus[TM] for OpenVMS if you plan to use DECnet for communication. o TCP/IP Services for OpenVMS if you plan to support UNIX or NT clients or use TCP/IP for the server communication. o Java Runtime Environment (JRE) version 1.2 or above. The same is an optional requirement just in case the customer requires MDMS GUI. ________________________ Note ________________________ Archive/Backup System for OpenVMS works with HP TCP/IP services for OpenVMS. Our limited testing involving Multinet with ABS/MDMS has not uncovered any issues. Engineering will not reject an escalation because of use with this product. But if through investigation Multinet is suspected of being the problem, the customer will be asked to pursue remedy through their existing contract with Multinet service. ______________________________________________________ 4 2.2 Media Management Software Version Requirements MDMS V4.3-ECO01 is supported on the following platforms: o OpenVMS VAX V7.3 o OpenVMS Alpha V7.3-2 and V8.2 o OpenVMS I64 V8.2 In addition, a Graphical User Interface is supported on the following platforms for V4.3-ECO01: o OpenVMS Alpha V7.3-2 and V8.2 o OpenVMS I64 V8.2 o Windows Intel Platforms (95/98/2000/XP) The GUI requires the Java Runtime Environment (JRE) or Java Development Kit (JDK) V1.2 or later. In addition, the GUI communicates with the MDMS server on an OpenVMS system using the TCP/IP protocol. Therefore, a product supporting the TCP/IP protocol (e.g. TCP/IP Services for OpenVMS or Multinet) is a pre-requisite to use the MDMS GUI. MDMS V4.3-ECO01 can be installed and configured as a brand new installation if you are using ABS V4.3-ECO01 for the first time. For OpenVMS VAX and Alpha, you can upgrade from any ABS V3.x version or from V4.0, V4.1 or V4.2. Alternatively, if you have a previous installation of SLS/MDMS V2.9x, you can convert the information in TAPESTART.COM by executing the MDMS$CONVERT_V2_TO_V3.COM file after installation of software. In addition, the volume, magazine, jukebox and pool databases may be similarly converted. 3 New Features/Enhancements in this Release The following section describes the new features /enhancements in this release: 5 3.1 New Archive/Backup System Features in this Release There are no new features in this release. 3.2 New MDMS Features/Enhancements in this Release The following section describes the new features /enhancements for MDMS V4.3-ECO01 release: MDMS has been enhanced to display the following message when /RETENTION_DAYS = 0 is specified while creating an archive using MDMS CREATE ARCHIVE or modifying its attributes using MDMS SET ARCHIVE: %MDMS-I-CONFIRM, SETTING RETENTION TO 0 WILL RESULT IN VOLUMES HAVING THEIR SCRATCH DATE SET TO THE SAME DAY AS THE COMPLETION OF THE BACKUP. NO RETENTION OF THE DATA WILL TAKE PLACE. ARE YOU SURE (Y/N): Selecting Y will scratch the data on the same day as the completion of the backup; else selecting N will ignore the command with the following confirmation: %MDMS-I-CMDIGNORED, The previous command was ignored This message is displayed to make you aware of the consequences of setting /RETENTION_DAYS = 0. 4 Problems Fixed in this Release The following sections describe problems since V4.2(SSB) fixed in V4.3. 4.1 Archive/Backup System Problems fixed in This Release 4.1.1 ABS saves fail with BACKUP-F-POSITERR Problem: The problem is seen with appending saves on VMS 7.3- 1 systems. The problem was due to issues with ABS and multipath support. Solution: The code has been modified to overcome the problem. The customer should also install the latest MKDRIVER image which also resolves some potential POSITERR issues. The 6 problem was reported in CFS.104409, 104139, 104645, and 99409 and has been fixed. 4.1.2 ABS restores fail with BACKUP-F-LABELERR Problem: The problem was seen with restores on VMS 7.3-1 system on an intermittent basis. The problem was due to issues with ABS and multipath support. Solution: Currently the code has been modified to overcome the problem. The customer should also install the latest MKDRIVER image which also resolves some potential POSITERR issues. The problem was reported in CFS.104582 and CFS.104174 and has been fixed. 4.1.3 MDMS Domain Scheduler set to NONE during V3.2A to V4.1 upgrade Problem: ABS V4.x upgrade from V3.2A results in domain scheduler being set to NONE even when the scheduler was INT_QUEUE_ MANAGER in 3.2A. Solution: The problem was reported in CFS.104830 and has been fixed. 4.1.4 Inappropriate error message logged when a save fails Problem: ABS save does not log appropriate error message when save fails due to error encountered by MDMS initialization problems. Solution: The code has been modified to log the appropriate message for the mentioned scenario. The above problem was reported in CFS.104910 and has been fixed. 7 4.1.5 ABS NT Client save fails with ACCVIO Problem: ABS NT Client save fails with ACCVIO when the environment or storage class contains the OWNER field blank. Solution: The problem was reported in CFS.105807 and has been fixed. 4.1.6 ABS - mail notification error Problem: ABS incorrectly sends a mail during an ERROR condition, even though the environment object is configured to notify the user only on FATAL ERROR. Additionally,the mail message that is being sent at the end of the transaction is formatted incorrectly. Solution: The problem was reported in CFS.106160 and has been fixed. 4.1.7 ABS RMU save returns "Qualified Success" when "RMU-E-FATALERR" is encountered Problem: ABS handles "RMU-E-FATALERR" as an error instead of fatal error. Hence the thread completes with "Qualified success". Solution: The problem was reported in CFS.107086 and has been fixed. 4.1.8 Problems with ABS and MDMS Delete Programs Problem: Problems with ABS$DELETE_ABS.COM and the MDMS$UNINSTALL.COM. Solution: The problem was reported in CFS.107123 and has been fixed. 8 4.1.9 ABS not updating scratch date Problem: ABS save request fails to set the scratch date of volume correctly when the "EXPIRATION_DATE" is set to NONE in the archive class. Solution: The problem was reported in CFS.106625 and has been fixed. 4.1.10 Scheduling Type is reset when a new node is added Problem: ABS V4.x fresh client installation resets the scheduler type of the domain object in the server node to INTERNAL type. Solution: The problem was reported in CFS.107129 and has been fixed. 4.1.11 RDF processes not shut down by the MDMS$SHUTDOWN.COM command procedure Problem: The SYS$STARTUP:MDMS$SHUTDOWN.COM command procedure fails to shutdown the RDF processes. This problem occurs when an upgradation to ABS V4.2, prior to this shutdown, failed because ABS and MDMS processes were running. Solution: The problem was reported in QXCM1000021880 and has been fixed. 4.1.12 ABS upgrade fails to rename file Problem: During ABS V4.2 upgrade, the customized template files in the ABS$TEMPLATES directory are not copied to *.*_OLD as stated in the installation. Solution: 9 The problem was reported in QXCM1000022205 and has been fixed. 4.1.13 ABS save request returns "Completed with failure status" when BACKUP-W-AFNOTSAVED is encountered Problem: When encountering WARNING error messages (%BACKUP-W- AFNOTSAVED) the SAVE request returned the final status as "Completed with failure status", where the expected Final status should be of "Qualified Success". Solution: The problem was reported in CFS.106447 and has been fixed. 4.1.14 A failing incremental restore sometimes logs ABS_NO_LICENSE error with ABS_NOMORE_SOS error Problem: During ABS incremental restore, when it fails sometimes logs the error ABS_NO_LICENSE along with the ABS_NOMORE_SOS error. Solution: The problem was reported in CFS.106789 and has been fixed. 4.1.15 ABS mail notification errors Problem: ABS does not send a mail when COORDINATOR encounters a error and a savefails. Also a wrong mail stating "normal successful completion" was sent for a failed thread. Solution: The problem was reported in QXCM1000191446, QXCM1000091327, QXCM1000194018, 135-7-2304, 135-7-2305 and has been fixed. 10 4.1.16 ABS catalog lookup fails on ODS-5 disk Problem: ABS lookup of catalog on ODS-5 disk fails if the include specification in the lookup command has special characters like comma(,) and colon(:). Solution: The problem was reported in QXCM1000195836 and has been fixed. 4.1.17 ABS save fails when -%MDMS-E-DRVEMPTY is encountered Problem: ABS save fails when -%MDMS-E-DRVEMPTY is encountered while loading the allocated volume. This results in backup waiting for "BACKUP-I-READYWRITE" on the wrong drive as well as the drives being used displayed as allocated to non-existing process after the ABS save request completes execution. Solution: The problem was reported in QXCM1000201927, QXCM1000201935 and has been fixed. 4.1.18 ABS save request fails with "ABS_ACCESS_DENIED" Problem: ABS save failed with ABS_ACCESS_DENIED, when a user profile is set in the environment object. ABS does not allow a group name in the access control list. Code has been added along to check for the group name in the access control list. Solution: The problem was reported in QXCM1000194973/QXCM1000205351 and has been fixed. 11 4.1.19 ABS restore ACCVIOs Problem: ABS restore via ABS with /BEFORE qualifier ACCVIOs, when there are multiple entries for a single file, in the AOE catalog file and the first entry is not having the corresponding entry in the AOEI file. Solution: The problem was reported in CFS.107699 and has been fixed. 4.2 Media Management Problems Fixed in this Release 4.2.1 MDMS does not allocate a non-shared but disabled drive Problem: The customer wanted MDMS to be a resource manager irrespective of whether drive is disabled/enabled. The same has been changed and the drive shared/noshared characteristic will now be treated on par with enabled /disabled characteristic. Solution: This problem was elevated in CFS.104523 and has been fixed in this release. 4.2.2 At MDMS prompt, "SHOW JUKEBOX /CONT" or "SHOW JUKEBOX /CONT/BRIEF" gives incorrect information Problem: At MDMS prompt "SHOW JUKEBOX /CONT" or "SHOW JUKEBOX /CONT/BRIEF" gives incorrect information if it is issued immediately after a "REPORT VOLUME VOLUME/SORT". Solution: This problem was elevated in CFS.104521 and has been fixed in this release. 12 4.2.3 The MDMS$SERVER process is consuming 96% of the CPU time Problem: The MDMS$SERVER process is consuming 96% of the CPU time. It appears to be in a loop looking for a particular file during the execution of an MDMS request to view a SAVE /RESTORE logfile from MDMS View GUI. Solution: This problem was elevated in CFS.105175 and has been fixed in this release. 4.2.4 Wrong section block count in EOF1 Problem: Wrong section block count in EOF1: when using SBT to validate the database. The section block count field when checked for value greater than 999999 fails as it can hold only maximum of 6 bytes. Solution: This problem was elevated in CFS.105470 and has been fixed in this release. 4.2.5 Modified MDMS.CLD to fix the following issues 1. /TITLE qualifier in MDMS REPORT command does not accept strings with blank or special characters. 2. /SYMBOL qualifier with MDMS SHOW commands does not allow a value to be specified. 3. /FILES qualifier with MDMS SHOW CATALOG command does not accept filenames with blanks. 4. /HEADER qualifier with MDMS REPORT command was missing in the new cld file. 5. /MESSAGE qualifier with MDMS LOAD VOLUME command does not accept strings with blanks. 6. The qualifiers /DBSERVER, /NODE_NAME,/ALL and /KEEP with SET SERVER command were missing. 7. /WEEKS qualifier with CREATE/SET SCHEDULE was missing. 13 8. /MOUNT qualifier with MDMS LOAD VOLUME command does not accept strings with blanks. The above problems were reported in CFS.105737,CFS.105871, CFS.105894, CFS.105844,CFS.106069, CFS.106164, CFS.106362 and has been fixed in this release. 4.2.6 ABS/MDMS client save's schedule is updated with last run time, where as the save is not starting Problem: ABS/MDMS client save's schedule is updated with last run time, where as the save is not starting. This problem can be seen on server also. Solution: This problem was elevated in CFS.104152 and has been fixed in this release. 4.2.7 MDMS scheduler is ignoring the exclude dates of a schedule Problem: MDMS scheduler calculates 'day of the year' and 'day of the the week' incorrectly during a leap year and hence the problem. Solution: This problem was elevated in CFS.105457 and CFS.105503. This has been fixed in this release. 4.2.8 MDMS$SERVER process hangs and logs a ranking violation Problem: MDMS$SERVER process hangs and logs a ranking violation. Solution: This problem was elevated in CFS.104110 and has been fixed in this release. 14 4.2.9 MDMS$SERVER logs a ranking violation in the logfile Problem: MDMS$SERVER logs a ranking violation in the logfile. Solution: This problem was elevated in CFS.105272 and has been fixed in this release. 4.2.10 MDMS SET DRIVE/NONODE does not clear all the nodes in the drive object Problem: MDMS SET DRIVE/NONODE does not clear all the nodes in the drive object. Solution: This problem was raised as QAR 135-7-2284 and has been fixed in this release. 4.2.11 ON_DEMAND job starts unexpectedly exactly after one year from the base date Problem: ON_DEMAND job starts unexpectedly exactly after one year from the base date. MDMS is setting next_start_date field if we modify the frequency field on base date's anniversary. Solution: This problem was elevated in CFS.105187, CFS.106020 and CFS.106052. This has been fixed in this release. 4.2.12 MDMS Save/Restore request fails with "Invalid request name specified" Problem: MDMS save/restore request fails with "Invalid request name specified" if the request name contains a "$". The same has been corrected for execution environment, archive class and catalog. 15 Solution: This problem was elevated in CFS.106976 and has been fixed in this release. 4.2.13 MDMS move volume command hangs in WAIT TIMER state Problem: MDMS move volume /noassist command hangs in "WAIT TIMER state" when the volume to be moved is not in the jukebox. The request can not be cancelled and the subsequent move commands stall. Solution: This problem was elevated in CFS.105181 and has been fixed in this release. 4.2.14 MDMS attempts to allocate the wrong drive Problem: MDMS attempts to allocate the wrong drive when ALLOCATE DRIVE command is preceded by any of the following commands from MDMS prompt: - CREATE DRIVE - DEALLOCATE DRIVE - DELETE DRIVE - LOAD DRIVE - SET DRIVE - SHOW DRIVE drive_name - UNLOAD DRIVE The same sequence works correctly from the DCL prompt. Solution: This problem was elevated in CFS.106441, QAR 135-7-2289 and QAR 135-7-275. This has been fixed in this release. 16 4.2.15 When the MDMS CREATE RESTORE is issued with /DESTINATION=[directory], the current working path is not prefixed to the destination Problem: When the MDMS CREATE RESTORE is issued with /DESTINATION=[directory], the current working path is not prefixed to the destination. Solution: This problem was elevated in QAR 135-7-2293 and has been fixed in this release. 4.2.16 Problems with MDMS$UNINSTALL.COM Problem: Problem with deassigning MDMS logicals during uninstallation. Solution: This problem was elevated in CFS.107123 and has been fixed in this release. 4.2.17 The /Destination qualifier of restore object does not accept more than one location enclosed within brace or double quotes Problem: The /Destination qualifier of restore object does not accept more than one location enclosed within brace or double quotes. Solution: This problem was elevated in QXCM1000022650 and has been fixed in this release. 17 4.2.18 MDMS translates the logical specified as part of the include specification of a save request Problem: MDMS translates the logical specified as part of the include specification of a save request, to the definition on the server node. This happens when the logical is defined as a concealed logical on the client node but not a concealed one on the server node. Solution: This problem was elevated in CFS.106921 and has been fixed in this release. 4.2.19 MDMS SHOW CATALOG command does not allow a prefix to be mentioned for the /SYMBOL qualifier Problem: MDMS SHOW CATALOG command does not allow a prefix to be mentioned for the /SYMBOL qualifier. Solution: This problem was elevated in CFS.107466 and has been fixed in this release. 4.2.20 MDMS SAVE request fails to execute on the second node specified in the execution node list Problem: When the first Node in the execution node list is disabled, MDMS SAVE request fails to execute on the second node specified in the execution node list and the following message is displayed. "Status: %MDMS-E-SCHEDNOSUCHJOB, failed to find a scheduling job %MDMS-E-NODENOTENA, node not in database or not fully enable" Solution: This problem was elevated in CFS.107247 and has been fixed in this release. 18 4.2.21 The startup process goes in an infinite loop during the volume label check and drive does not get deallocated Problem: When MDMS is started with volume already loaded in the drive, the startup process performs an inventory on the juke as a part of MDMS SHOW JUKE. During inventory the drive check will be performed and when the drive is found to be full, the volume label will be checked. Before this check, the drive is allocated to MDMS$SERVER. The startup process goes in an infinite loop during this check and drive does not get deallocated. This problem is seen only with NON-VISION devices. Solution: This problem was elevated in CFS.107445 and CFS.106441. This has been fixed in this release. 4.2.22 MDMS SHOW CATALOG command fails with "MDMS-E-CANCELLED, request cancelled by user" Problem: The customer issued the MDMS SHOW CATALOG /FILES command. While the output was being displayed, the display was aborted abruptly using Ctrl-Y. When the same command was issued again, MDMS failed with the MDMS-E- CANCELLED error. The command would succeed on its third attempt. Solution: This problem was elevated in CFS.106685 and has been fixed in this release. 4.2.23 MDMS SHOW CATALOG/SAVE command fails when /PIECE qualifier is specified Problem: The command "$ MDMS SHOW CATALOG/SAVES" fails with "%MDMS- E-NOSUCHSAVES, no such save entries" when /PIECE_NAME qualifier is used. Solution: 19 This problem was elevated in QXCM1000088460 and has been fixed in this release. 4.2.24 RDCDRIVER crashes when ABS$STARTUP is executed followed by MDMS$STARTUP Problem: When ABS$STARTUP is executed followed by MDMS$STARTUP, RDCDRIVER crashes. RDF Engineering fixed this and provided a RDF Kit with a new version RDF4.3I. Solution: This problem was elevated in CFS.106833 and has been fixed in this release. 4.2.25 MDMS SHOW CATALOG /SAVE command does not handle save names with more than 32 characters correctly Problem: The command fails with "%MDMS-E-NOSUCHSAVES, no such save entries" when the save name has more than 32 characters. Solution: This problem was elevated in QXCM1000089022 and has been fixed in this release. 4.2.26 ABS installation fails for ABS-OMT license Problem: ABS/MDMS V4.1 installation fails while creating the definition for the DB server node, when only the OMT license is present. As a result the product is inoperable without a functioning MDMS server. Solution: This problem was elevated in CFS.104960/QXCM1000197108 and has been fixed in this release. 20 4.2.27 ABS custom schedule misbehaves Problem: For a complex customize schedule, MDMS fails to calculate the correct next start date based on the policy settings provided in the save request's corresponding schedule object.This caused the save request to execute on schedules which are not part of the policy settings. Solution: This problem was elevated in CFS.108032 and has been fixed in this release. 4.2.28 DCSC LOAD/UNLOAD commands hang Problem: The DCSC API maintains a single outstanding request context. Hence, simulta DCSC calls from the MDMS threads would result in this DCSC request context thrashed for either or both the calls. This problem would manifest itself i form of MDMS calls to the DCSC API not getting a return status back, giving impression that the LOAD/UNLOAD commands are hanging. This problem has been resolved by serializing the DCSC operations performed MDMS. Also, adding LT_DCSC = 0x2000 to the MDMS$LOGFILTER will provide more related logging in the MDMS log file. Solution: This problem was elevated in CFS.108061/QXCM1000198577 and has been fixed in this release. 4.2.29 SHOW CATALOG/FILE displays incorrect information Problem: MDMS SHOW CATALOG /FILE/FULL command displays incorrect output when the corresponding TLE is not present. Solution: This problem was elevated in QXCM1000086396 and has been fixed in this release. 21 5 Known Problems and Restrictions in this Release The following sections describe known problems and restrictions with ABS and MDMS. 5.1 Archive/Backup System Known Problems The following sections describe the known problems with ABS. 5.1.1 SBT functionality on OpenVMS SBT functionality is not available on OpenVMS I64 Version 8.2. 5.1.2 Aborted save logs multiple messages on OpenVMS I64 When an ABS save/restore request is aborted, the status "Job Terminated" is written in the Log file multiple times. 5.1.3 Staging unpack operation logs CMA exception on OpenVMS I64 When staging is enabled for a catalog, the staging unpack operation after writing all the files into the catalog fails with a CMA exception and creates a dump file in ABS$ROOT directory. This exception will not affect the normal operation of saves/restores. ABS save will be successful and all the files will be cataloged. The user will also be able to restore the data. 5.1.4 ABS save fails with CMA exception if the catalog is not present ABS save fails with a CMA exception instead of CATLG_DB_ NOT_FOUND if the catalog specified in the archive is not present. 5.1.5 SBT test program with RDF devices SBT is provided as a shareable image, which is invoked by the Oracle Recovery Manager (RMAN) to backup Oracle databases. SBT allocates and mounts the devices for RMAN to backup databases. SBT test program which is supplied with SBT is used to test SBT interface with ABS/MDMS 4.x. An attempt to backup and restore to an RDF device using the SBT test program fails with the following footprint: 22 MMAPI error: err_code=7501, Fatal media movement error Failed to allocate drive System Error: %SYSTEM-F-ACCVIO, access violation, reason mask=!XB, virtual address=!XH, PC=!XH, PS=!XL %SYSTEM-F-ACCVIO, access violation, reason mask=!XB, virtual address=!XH, PC=!XH, PS=!XL The problem is seen only with Rdserver running on OpenVMS (Alpha) 6.2-1 and 7.2-1 and Rdclient running on OpenVMS Alpha (7.2-1). The problem is not seen with Rdserver running on OpenVMS (VAX).The problem is seen only when both backup and restore operation is done in a single session from the SBT test program .We are in touch with RDF Engineering to resolve this problem. However you can still use the RDF with the Rdserver running on OpenVMS (Alpha and VAX) to backup and restore your Oracle database without any problems as long as backup and restore operations of the database are done in separate sessions. Please note that before doing the configuration for SBT, you should make sure that Oracle's Recovery Manager is setup and you are able to access it. Please refer to the chapter "System Backup to tape for Oracle Databases" in ABS guide to operations manual for configuring SBT. 5.1.6 One Movement Type Allowed Per Save Request Only one movement type is allowed per save request. The movement types are FULL, INCREMENTAL, and SELECTIVE. If you specify include specifications for more than one type of movement, you may get backup errors. For example, if your save request contains include specifications with a disk name and also other objects with more than a disk name (ie. disk:[dir]), backup will return an error on some objects because an image backup works with a disk name only. Workaround: Include only one type of include specification in your save request. For example, a save request should only include disk names, or directory names. 23 5.1.7 ABS REPORT SAVE_LOG Fails When Searching SLS Catalogs If you do an ABS REPORT SAVE_LOG command and do not specify a catalog or storage_class, once ABS has searched an SLS catalog, the command will stop and will not search the remaining catalogs on the system. Workaround: Until this problem has been resolved, specify a catalog or storage_class name on the ABS REPORT SAVE_LOG command. 5.1.8 ABS May Have Problems in Saving Files Greater Than 2 GB in Size You may have problems saving files greater than 2 GB in size on Unix and Windows NT systems. On Unix systems, please refer to the documentation provided with the gtar you are using. The gtar version that we supply for Windows NT and the source that we provide for Unix do not accommodate files greater than 2 GB in size. 5.1.9 Setting Volume on Archive While Save is Running Adding a volume set name to an archive while a save request is running can cause problems with the cleanup after the save request (leaving it in a locked state). Two archives referencing the same volume set is not supported. 5.1.10 Inherited Problems in Backup Agent ABS$BACKUP.EXE Problem: If you are using Backup-Via-Shelving the default backup agent for backing up OpenVMS files is SYS$SYSTEM:ABS$BACKUP.EXE. This image was built using the V6.1 source code of OpenVMS Backup (BACKUP.EXE) with some HSM features added. Thus, ABS$BACKUP has inherited the problems known to exist in V6.1 of BACKUP and new features added to BACKUP since V6.1 are not available in ABS$BACKUP. Solution: The HSM features will be incorporated into BACKUP in an OpenVMS remedial ECO scheduled for release sometime after OpenVMS V7.3. If you are not using Backup-Via-Shelving ABS will use SYS$SYSTEM:BACKUP.EXE. 24 5.1.11 Verifying Installation Problem: When installing ABS as a new installation, the database initialization programs may fail to run. In this case, IVP fails with errors failing to show the storage classes and execution environments. Solution: After the installation, run SYS$SYSTEM:ABS$DB_INIT.EXE. This executable initializes the database with the default storage classes and execution environments. 5.1.12 Permission Denied or Invalid Argument Error on Windows Save Request Problem: ABS may produce the following log file errors after executing an NT save request: ABSgtar: can't add file C:\AFILE.EXT: : Permission denied ABSgtar: can't open directory C:\ADIR: : Invalid argument The cause of these errors is either the directory or file is open for write access by a user or application, or the system has been denied read access to the file or directory. ABS runs under the system account. Workaround: Close all open files or set the access on the files for the SYSTEM account. To set the file access, select the file from a fileview window. Select Properties from the File pulldown. Click the Security tab and then select Permissions. Select Add, and highlight SYSTEM. Add the type of access (full control is best, so you can restore files). Click the Add button. This gives the SYSTEM account access to the files. Solution: This problem will be corrected in the future version of ABS. 25 5.1.13 Save Request Must Specify The Correct Object Type Problem: If you create a save request for a Tru64 UNIX or Windows file and you do not specify the UNIX_FILES_GTAR or WINDOWS_ NT_FILES_GTAR object type (default is VMS_FILES), ABS produces a scheduler error. Solution: Be sure to specify the UNIX_FILES_GTAR or WINDOWS_NT_FILES_ GTAR object type for the include specification. 5.1.14 ABS RESTORE with Brief Listing Fails to Provide Listing File Problem: If you are executing a RESTORE request which uses an environment policy with a BRIEF_LISTING setting, the restore will not create a listing file. Workaround: You may set the environment policy to FULL_LISTING and get a full listing instead. Solution: This problem will be addressed in a future version of ABS. 5.1.15 RMU Backup Exclude_Specification Parameter Problem: Save Request If you create or modify a save request for an Oracle Rdb storage area and enter an exclude_specification parameter, ABS generates an incorrect syntax for the RMU Backup Utility. As a result, the save request fails. Solution: This problem will be corrected in a future version of ABS software. Problem: Restore Request 26 If you create or modify a restore request for an Oracle Rdb database or storage area and enter an exclude_specification parameter, ABS ignores the file name entered for exclude_ specification parameter. Solution: None. The RMU Backup Utility does not support an exclude_ specification parameter for a restore request. 5.1.16 RMU Backup Include_Specification Parameter Problem: Wildcard Character The RMU Backup Utility does not support wildcard characters (* or %) in the include_specification parameter for a save or restore request. However, if you enter one of these characters, ABS fails to invalidate the illegal entry. ABS executes the save or restore request but generates an incorrect file name and as a result, the save or restore request fails. Solution: For an Oracle Rdb database or storage area, do not enter any wildcard characters in the include_specification parameter. Problem: Comma-Separated List If the include_specification parameter on a restore request for an Oracle Rdb database or storage area consists of a comma-separated list of disks or file names, ABS may not correctly restore the data. Example: The Include-Specification Contains: DISK$USER1:[USER1]SITE_PERSONNEL.RDB,DISK$USER2:[USER2]PERSONNEL.RDB Possible result: If the restore of DISK$USER1:[USER1]SITE_PERSONNEL.RDB includes any incremental restore operations, ABS may terminate the restore operation without restoring the subsequent Oracle Rdb file names specified in the list. Solution: 27 For each Oracle Rdb database or storage area that you want to restore, create a separate restore request or use Add Object option on the GUI to individually add each file name. Table 9-3 in Archive/Backup System for OpenVMS Guide to Operations explains how to use Add Object option. 5.1.17 Selective Restore Operation Problem: If a selective restore request is performed for an Oracle Rdb storage area, but the last backup operation of the Oracle Rdb database was an incremental, the restore request fails and ABS generates the following message: %RMU-F-WRNGDBBTYP, save_set_name does not contain a full backup Solution: Create an incremental restore request so that ABS will restore both full and incremental backups of the storage area. 5.1.18 Avoid Use of ABS$UBS_VERBOSE Logical Name Problem: The system logical name ABS$UBS_VERBOSE should be defined only when requested by Compaq. It may cause adverse side-effects after save request failures, which include unintended initialization of the output volume. Please check to ensure this logical name has not been defined on nodes running ABS. 5.2 Archive/Backup System Restrictions The following are known restrictions for ABS V4.3. 5.2.1 SCSNODE must be defined for ABS/MDMS to start The sysgen parameter SCSNODE must be defined on your system to run ABS/MDMS. The current startup procedures require this value or the SYS$NODE logical name to be defined. 28 5.2.2 Using DECnet-Plus (Phase V) With ABS If you use DECnet-Plus with ABS, you must define Phase IV synonyms (6 characters or less) for your nodes. ABS cannot use the long node names. 5.2.3 Post-processing Command Fails to Execute Problem: If a save request does not complete successfully, and a post-processing command is specified either on the save request or the environment policy, the post-processing command will not execute. Solution: None. ABS only executes the post-processing command on the basis of a successful completion. The next time the save request completes successfully, ABS will execute the post-processing command. 5.2.4 Restriction On The "-bnn" Value for UNIX or NT Clients Problem: When doing NT or UNIX save or restore requests, you may have set the agent qualifier "-bnn" to set the block length of a disk. If you set the value of "-bnn" to a number higher than 127 (-b127), you may get unexpected results for the save request. In this situation, ABS may generate ASSERT and ACCVIO errors. Solution: This is a restriction in OpenVMS. Do not set the -bnn agent qualifier value to a number higher than 127. If the disk is large enough to exceed this amount, create more than one save request for that particular disk. More Information: For more information about the -bnn qualifier, see Archive /Backup System for OpenVMS Guide to Operations . 29 5.2.5 Restoring an Entire Tru64 UNIX Filesystem You cannot restore an entire Tru64 UNIX filesystem to either the original location or to a different location by specifying only a "/" for the include specification. To restore the entire UNIX filesystem, you must specify each top level directory as shown in the following example: /usr /dev 5.2.6 Tape Device Protection Problem: When performing a user backup, if the tape device is protected against the user, the following error is logged in the execution log file: THREAD #1:%BACKUP-F-PARSE, error opening NODE01MKA500:[000000]13JUL19951339120.; THREAD #1: -RMS-E-PRV, insufficient privilege or file protection violation Workaround: If this error occurs, check the device protection of the target tape device by entering the following command from a privileged account: $ SHOW SECURITY/CLASS=device _Object name: MKA500 _MKA500: object of class DEVICE Owner: [SYSTEM] Protection: (System: RWPL, Owner: RWPL, Group: RWPL, World) Access Control List: To set the protection of the tape device for the world access, enter the following command: $ SET SECURITY/CLASS=DEVICE/PROT=(W:RWPL) MKA500 $ SHOW SECURITY /CLASS=DEVICE MKA500 _MKA500: object of class DEVICE Owner: [SYSTEM] Protection: (System: RWPL, Owner: RWPL, Group: RWPL, World: RWPL) Access Control List: 30 When the tape drive enables access to the user, the insufficient privilege problem from the backup command is eliminated. 5.2.7 OPCOM Restriction If you select OPCOM as the method of notification, then you must select the BRIEF option. If you select VERBOSE or NORMAL, the message could be truncated. 5.2.8 Request Restart ABS does not support restarting a save or restore request in the middle of the operation. All save and restore requests are restarted from the beginning. 5.2.9 No Restart Operation ABS does not attempt to replace a faulty member of a volume set and, as a result, the save operation fails. ABS also may not take advantage of the restart capabilities built into some of the backup agents. 5.2.10 Restoring Multi-File Oracle Rdb Databases Do not specify an output location while restoring a multi-file Oracle Rdb database. If an output location is specified, ABS places all storage area files in the specified output location. 5.2.11 Restrictions with ABS Windows 2000 Client - Encrypted files not supported. - Backup of open files not supported. - Mount point save and restore operations are successful when mount point exists while restoring. But if the mount point is removed, ABS Windows Client would restore the data of the mounted volumes to a new folder. This folder is no longer a mount point. - Restoration of Hard Link files results in the hard link being broken and two different individual files being restored. - The backup agent (ABSgtar) for Windows client does not allow wildcards in the file specification strings for save requests. 31 5.2.12 Restrictions with SBT - Restriction for proxy copy feature of ORACLE RMAN System Backup to Tape (SBT) feature of ABS for Oracle Recovery manager (RMAN) does not support the "proxy copy" feature of ORACLE RMAN. - Restriction with Oracle RDB Database support - The following scenarios will cause backup not to complete: * Setting the Drives List in the archive to a number of drives less than the number of data streams that RMU starts. * Setting the Maximum Saves in the Archive to a number less than the number of data streams that RMU starts. * Specifying more number of writer threads than than you have tape drives. 5.3 Known Media Management Problems and Restrictions This section describes known problems and restrictions for V4.3 of the Media, Device and Management Services for OpenVMS. 5.3.1 RDF is not supported in OpenVMS V8.2 RDF is not supported in OpenVMS Alpha and I64 version 8.2. 5.3.2 DCL Syntax For Lists Must be Followed or You May Get Unexpected Results If you do not use the correct syntax when specifying lists in MDMS commands, DCL parsing may cause the command to work differently than expected. Since MDMS allows multiple objects on all commands, if a list is specified for one of the qualifiers, you must put parentheses () or quotes "" around the lists or you will get unexpected behavior. For example: $MDMS CREATE DRIVE d1/MEDIA=m1,m2 32 This will create two drives, d1 and m2. No error would be generated. If you use the correct syntax, you will get one drive d1 with two media types. The correct syntax is: $MDMS CREATE DRIVE d1/MEDIA=(m1,m2) Workaround: Use the syntax as described in the MDMS Reference Guide and in MDMS help. 5.3.3 Motif Look and Feel We have the arrow button for List, Combo and Date fields in MDMSGUI. The size of the arrow button is same for all the above fields. But the arrow button size varies in the Motif Look and Feel using Java 1.4 version. 5.3.4 /AFTER_SCHEDULE logic misbehaves if ABS is shutdown when a save is executing Consider a schedule TEST_SAVE_SCHED corresponding to save TEST. When the schedule is started, MDMS just initiates the save, which executes in the context of ABS. When the save completes, ABS updates the status of the save request in the 'transaction status' field. If ABS is shutdown when the save request is executing/initiated, the save status is not updated to the 'transaction status' field (since ABS is not running), which continues to show the status from the previous run. Since the 'transaction status' field continues to have the old status, the /AFTER_SCHEDULE logic ends up using this old status to schedule the after schedule jobs. Hence we see the /AFTER_SCHEDULE logic misbehaving. This problem will be fixed in a remedial after V4.1. 5.3.5 /AFTER_SCHEDULE qualifier There is a restriction with using the /AFTER_SCHEDULE qualifier to link jobs. Only those schedules(created automatically by MDMS) that have an associated save can be assigned to the /AFTER_SCHEDULE qualifier. Schedules that do NOT have an associated save cannot be assigned to the /AFTER_SCHEDULE qualifier. Hence, any schedule(one with an associated save, or one which executes DCL commands) can have a dependency on a schedule with an associated save, but not on a schedule which executes DCL commands. This is a current MDMS design limitation. 33 5.3.6 V4.1 stores object names in upper case only ABS V3.x versions allowed both lower and upper case for object names. But ABS/MDMS V4.1 supports only upper case names. That is the names are stored in uppercase in the database. Hence if you upgrade from V3.2A to V4.1, and you have two drives names "xxx", and "XXX", you may not be able to modify the attributes of the drive named "xxx". Any attempts to change the attributes will affect the drive named "XXX"(uppercase) only. 5.3.7 Fiber channel Environment In FC environment, we don't have any universal manager who maintains the information of devices (like which node has the device allocated). Further in FC enviroment VMS does not manage the allocation of drive across two or more clusters. Hence multiple users can allocate the same drive at the same time from two nodes (they may be either standalone nodes or they may be present in two different clusters). To overcome this MDMS polls the nodes listed in the drive object to ensure that none of the nodes listed in the drive list has allocated the device. Thus if MDMS cannot reach a node it returns the drive check error. MDMS will not allow other nodes to access the drive without knowing the status of drive on one node as it may possibly lead to a dataloss scenario. This is a design restriction with MDMS and the system administrator has to take judicious decision when the node is not reachable for some reasons like a node was shutdown. This restriction may lead to a potential save failure with a drive access error. A possible workaround to the issue is listed below: The customer needs to create an MDMS GROUP object. The GROUP object should consist of all the NODEs accessing the DRIVE/JUKEBOX and the DRIVE/JUKEBOX objects should have the GROUP listed in the DRIVE/JUKEBOX objects. At the time of system bootup the following command needs to be executed. $ MDMS SET GROUP xyx/NODE=node_name/ADD At the time of the system shutdown the following needs to be executed. $ MDMS SET GROUP xyx/NODE=node_name/REMOVE 34 The above workaround is applicable only when the node is shutting down normally. In case the node is not reachable when there is a network issue due to reasons other than a normal node shutdown ( Eg Due to a node crash or due to a network cable issue) the above workaround will not be applicable. Another alternative the system administrator can consider is to remove the NODE name from the DRIVE object in case of the customer wants to shutdown one of the nodes in a FC environment. 5.3.8 MDMS does not support multiple NIC interfaces with TCP/IP on the same node Due to a design limitation, MDMS does not support multiple NIC interfaces on the same node. We will plan to provide this support in the future releases. 6 Media Management Configuration and Operation Once MDMS V4.3-ECO01 is installed and any conversions are performed, you may wish to adjust your configuration prior to performing MDMS operations. A DCL command procedure MDMS$SYSTEM:MDMS$CONFIGURE.COM has been provided for initial installation (not a conversion from V2.9x). Please refer to the Guide to Operations section of your ABS documentation set for more information on configuration and operation. 7 Documentation Updates and Errata for V4.3-ECO01 The following section describes the documentation updates and errata for the Archive Backup System for OpenVMS MDMS Reference Guide and Archive Backup System for OpenVMS Guide to Operations manuals, and MDMS Help. 7.1 Expiration Date and Retention Days In Section 3.1.7 of the Archive Backup System for OpenVMS Guide to Operations guide, the /RETENTION_DAYS and /EXPIRATION_DATE qualifiers for MDMS CREATE ARCHIVE command are not defined completely. The /EXPIRATION_DATE and /RETENTION_DAYS qualifier for the archive object are mutually exclusive, as a result of which input values can be provided for only one of the qualifiers. Hence, the MDMS 35 SHOW ARCHIVE command is modified to display the qualifier that has been used. When either of the qualifiers are used, the value for the other qualifier in the MDMS SHOW ARCHIVE command is displayed as "-". If none of these qualifiers are used in the MDMS CREATE ARCHIVE command, a default retention period of 365 days is used. When /RETENTION_DAYS = 0 is specified while creating an archive using MDMS CREATE ARCHIVE or modifying the attributes of an archive using MDMS SET ARCHIVE, the following message is displayed: %MDMS-I-CONFIRM, SETTING RETENTION TO 0 WILL RESULT IN VOLUMES HAVING THEIR SCRATCH DATE SET TO THE SAME DAY AS THE COMPLETION OF THE BACKUP. NO RETENTION OF THE DATA WILL TAKE PLACE. ARE YOU SURE (Y/N): Selecting Y will scratch the data on the same day as the completion of the backup; else selecting N will ignore the command with the following confirmation: %MDMS-I-CMDIGNORED, The previous command was ignored The following table lists the usage of these qualifiers and the appropriate values: _________________________________________________________________ As displayed for MDMS SHOW ARCHIVE command Input speci- Qualifier EXPIRATION_ RETENTION_ Usage_________fication______specified___DATE__________DAYS_______ Definite Date format xx:xx:xx - retention /EXPIRATION_ DATE=xx:xx:xx Number of - xxxx days /RETENTION_ DAYS=xxxx Infinite NONE - retention /NOEXPIRATION For ZERO - 0 retention /RETENTION_ ____________________________DAYS=0_______________________________ 36 The following example shows the creation of an archive using /RETENTION=0 and the display of the archive using MDMS SHOW ARCHIVE: $ MDMS CREATE ARCHIVE TEST/RETENTION=0 %MDMS-I-CONFIRM, SETTING RETENTION TO 0 WILL RESULT IN VOLUMES HAVING THEIR SCRATCH DATE SET TO THE SAME DAY AS THE COMPLETION OF THE BACKUP. NO RETENTION OF THE DATA WILL TAKE PLACE. ARE YOU SURE (Y/N):y $ MDMS SHOW ARCHIVE TEST Archive: TEST Description: Access Control: NONE Owner: UNO::SYSTEM Archive Type: TAPE Catalog - - Name: ABS_CATALOG - Nodes: Consolidation - - Interval: 0007 00:00:00 - Savesets: 0 - Volumes: 0 Destination: Drives: Expiration Date: -- Location: Maximum Saves: 1 Media Type: Pool: Retention Days: 0 Volume Sets: 7.2 Errata In the Archive Backup System for OpenVMS MDMS Reference Guide (on pages 1-19 and 1-148) manual and MDMS Help, the following text for the commands MDMS CREATE ARCHIVE and MDMS SET ARCHIVE: "If neither an expiration date nor retention days are specified, then the data is retained indefinitely" stands corrected as "If neither expiration date nor retention days are specified, then the data is retained for 365 days." 37 In the Archive Backup System for OpenVMS Guide to Operations manual, the display for Expiration Date in the examples specified for "Creating an Archive" (Section 9.4.2, Page 9-10) and "$ MDMS SHOW ARCHIVE SYSTEM_BACKUPS" (in Appendix A, Page A-9) should be "-" instead of "NONE". 8 Converting ABS 3.* to V4.3 In ABS V4.3 the ABS Policy engine is in the MDMS Server. To upgrade to ABS V4.3, the ABS 3.x Policy Database information needs to be exported to the MDMS Database. Before running the conversion ensure that: o On the V3.x system, you have done an ABS SHOW object /FULL and kept the listing files. These will be useful when comparing the results of the conversion. o The old ABS Policy database files (ABS$DATABASE:EPCOT.DB%) are not being currently used. o ABS V4.3 and MDMS V4.3 are configured and running on all the Clients and Servers. Run the SYS$SYSTEM:ABS$CONVERT_V3_TO_V4.EXE utility to convert the ABS 3.x database to the MDMS Database. The utility exports only the highest version of the policy object. Details of new MDMS objects created are logged in ABS$CONVERT_V3_TO_V4.LOG. Sample Conversion: $ RUN SYS$SYSTEM:ABS$CONVERT_V3_TO_V4.EXE Enter the Path of ABS V3.x Policy Database Files [ABS$DATABASE:] : Converting ARCHIVE Objects... Converting ENVIRONMENT Objects... Converting SAVE Objects... Converting RESTORE Objects... 38 9 Upgrading from ABS V2.* If you are upgrading from ABS Version 2.1, 2.1A, or 2.1B, you must execute the catalog upgrade utility prior to executing any save and restore requests using ABS Version 2.2 or higher. The catalog upgrade utility upgrades catalogs from their previous format to the new ABS Version 2.2 format. It also deletes expired summary records from those catalogs. A log file named ABS_LOG:ABS_CATALOG_V22_UPGRADE.LOG is generated with information about all of the catalog entries it has modified or deleted. The catalog upgrade utility has one update parameter: p1. The input to the p1 parameter is the name of the catalog you wish to upgrade. You can use the catalog upgrade utility to upgrade a single ABS catalog or all ABS catalogs. To upgrade an ABS single catalog, specify the catalog name to the p1 parameter. To upgrade all catalogs, enter an asterisk (*) as the wildcard character, or do not supply anything to the p1 parameter. To run the utility, use the following procedure: 1. Define the following symbol: $ CATALOG_UPGRADE :== $ABS_SYSTEM:ABS$CATALOG_UPGRADE.EXE 2. Enter one of the following commands: $ CATALOG_UPGRADE ! Upgrades all ABS catalogs and deletes ! all expired summary entry records. $ CATALOG_UPGRADE * ! Equivalent to example above. $ CATALOG_UPGRADE ABS_CATALOG ! Upgrades the ABS catalog named ! ABS_CATALOG and deletes all expired summary ! entry records from ABS_CATALOG. Restriction: The ABS catalogs must be quiescent while executing the catalog upgrade utility. The catalog that is being upgraded will be locked; no save, restore, or lookup operations are allowed while the upgrade is occurring. 39 10 How to Remove V4.3 ABS/MDMS Files Rolling back ABS to V3.2 is only to be used in EMERGENCY situations. Any save requests done since the upgrade will be lost. Any MDMS database changes done since the upgrade will be lost. If tape volumes have been allocated, deallocated, or re-used since the upgrade, these will not be reflected in the volume database after the rollback. Please use caution when deciding to do a rollback. ________________________ Note ________________________ Prior to upgrading to ABS V4.3, to be able to get back to the exact V3.2A situation you were at before the upgrade, your catalogs would have to be backed up while in a quiet state. Then, you could restore the V3.2A catalogs and they would not reflect any saves run after the V4.1 upgrade. If you do not do this, then there will be entries in the catalog which reference tapes which may be in a free state in the old database files. ______________________________________________________ If you have installed ABS V4.3 and then need to do a rollback to V3.n: o Shutdown ABS and MDMS. o Execute the following command procedure: $ @ABS$SYSTEM:ABS$REMOVE_V40_FILES.COM o Reinstall ABS/MDMS V3.2A. Be sure that you do not use the STANDARD installation option and that you install both ABS and MDMS. You may optionally restore backups of your ABS catalogs. 40