#EDIR DATA#
NetWare 3.12 Server BackupDisclaimerNovell®, Inc. makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.Further, Novell, Inc. makes no representations or warranties with respect to any NetWare software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of NetWare software, at any time, without any obligation to notify any person or entity of such changes.TrademarksBtrieve, DR DOS, EXOS, LANalyzer, NetWare, OnLan/PC, Novell, and the N design are registered trademarks of Novell, Inc.Advanced NetWare, Boot Support Module, BSM, ElectroText, Hardware Specific Module, Hot Fix, HSM, Internetwork Packet Exchange, LAN Service, Link Support Layer, LSL, Media Support Module, MSM, Multiple Link Interface, MLI, Multiple Link Interface Driver, MLID, Multiple Protocol Interface, MPI, NetWare Access Server, NetWare Access Services, NetWare Core Protocol, NCP, NetWare Directory Services, NDS, NetWare DOS Requester, NDR, NetWare Express, NetWare Loadable Module, NLM, NetWare Management Agent, NetWare MultiProtocol Router, NetWare NFS, NetWare Requester, NetWare RPC, NetWare Runtime, Network Support Encyclopedia, NetWare 3270 LAN Workstation, NetWare 3270 LAN Workstation for DOS, NetWare 3270 LAN Workstation for Windows, NLM, NE/2, NE/2-32, NE1000, NE1500T, NE2000, NE2100, NE3200, NE32HUB, Novell Labs, Novell Virtual Terminal, NVT, NTR2000, Open Data-Link Interface, ODI, Packet Burst, RX-Net/2, SFT, Topology Specific Module, TSM, TSA, Transaction Tracking System, TTS, Turbo RX-Net, Virtual Loadable Module, and VLM are trademarks of Novell, Inc.NetWire is a service mark of Novell, Inc.Novell Authorized Reseller is a collective mark of Novell, Inc.3Com and 3+Share are registered trademarks of 3Com Corporation.ARCnet is a registered trademark of Datapoint Corporation.AT&T is a registered trademark of AT&T.Apple, AppleShare, AppleTalk, ImageWriter, LaserWriter, LocalTalk, and Macintosh are registered trademarks of Apple Computer, Inc.Citizen is a registered trademark of Tokei Kabushiki Kaisha.COMPAQ is a registered trademark of Compaq Computer Corporation.CompuServe is a registered trademark of CompuServe, Inc.DDS is a trademark of Sony Corporation.DEC is a trademark of Digital Equipment Corporation.Epson is a registered trademark of Seiko Epson Corporation.GE Information Services is a trademark of General Electric Company, USA, which is not connected with the General Electric Company p.l.c. of England.Hayes is a registered trademark of Hayes Microcomputer Products, Inc.Hewlett-Packard, Deskjet, HP, Laserjet, PCL, and Vectra are registered trademarks of Hewlett-Packard Company.IBM, AT, Micro Channel, NetView, OS/2, ProPrinter, and PS/2 are registered trademarks of International Business Machines Corporation.IBM Operating System/2 Local Area Network Server (LAN Server), Presentation Manager, SAA, and XT are trademarks of International Business Machines Corporation.Intel is a registered trademark of Intel Corporation.LAN Manager and LAN Manager Server are trademarks of Microsoft Corporation.Lotus is a registered trademark of Lotus Development Corporation.Microsoft and MS-DOS are registered trademarks of Microsoft Corporation.NFS is a registered trademark of Sun Microsystems, Inc.Okidata and Microline are registered trademarks of Oki Electric Industry Co., Ltd.Panasonic is a registered trademark of Panasonic Office Automation.Pinwriter, Spinwriter, and NEC are registered trademarks of NEC Corporation.PostScript is a registered trademark of Adobe Systems Incorporated.SDI is a registered trademark of Systems Data, Inc.SQL Server is a trademark of Sybase, Inc.Unicode is a registered trademark of Transoft Ltd.UNIX is a registered trademark of UNIX System Laboratories, Inc., a subsidiary of AT&T.WordPerfect is a registered trademark of WordPerfect Corporation.Xerox Diablo is a registered trademark of Xerox Corporation.Copyright Notices© Copyright 1983-1993 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.Novell, Inc.122 East 1700 SouthProvo, UT 84606U.S.A.lbl="0"How to Use this ManualOverviewThis manual is designed to help experienced NetWare system users back up and restore data across a network using a storage device attached to a NetWare 3.12 file server.This manual contains information and instructions about the Server Backup product only. Use this manual with your NetWare 3.12 manual set.Other Resources for HelpBesides this manual, you can use the following resources:Context-sensitive help. If you are using a NetWare menu utility and want more information about how to complete a task, press <F1> for help.If you are unsure how to use a command line utility, type the utility name and add the /? option for help. For instance, for help with using the RIGHTS utility, type RIGHTS /?.Hardware manuals. Many network problems occur because of malfunctioning hardware. If you can isolate a problem to a certain computer component or cable segment, check the manuals that came with the hardware involved.Novell ElectroText. The NetWare Communication Services(tm) viewer allows you to read NetWare manuals from your Windows or OS/2 workstation.All NetWare v3.12 manuals except the Quick Access Guide are available on the NetWarev3.12 CD-ROM.Novell Network Management System (NMS). This product helps you manage the cabling system, computers, software, and other components of the network. Contact your Novell Authorized Reseller for more information about using NMS on your network.NetWare Application Notes and Research Reports. These documents cover technical aspects of NetWare-based system design, implementation, and management. Application Notes are a collection of technical articles published monthly.Novell publishes Research Reports as the research becomes available.You may purchase subscriptions and back issues of these publications from within the United States or Canada by calling the Novell Research Order Desk at (800) UPDATE1. From outside the United States or Canada, call (801) 429-5380.Third-party books and periodicals. A number of books on NetWare, including books published by Novell Press, are available at most bookstores. In addition, numerous networking periodicals give advice on configuring, managing, and troubleshooting your network.NetWire on CompuServe. A fairly inexpensive way to getup-to-date advice and patches is through NetWire on the CompuServe bulletin board. To open a CompuServe account, call one of the following numbers:From within the United States or Canada, call (800) 524-3388.From within the United Kingdom, call 0800-289-378.From within Germany, call 0130-37-32.From the rest of Europe, call 44-272-255-111.From outside of the United States, Canada, and Europe, use the appropriate country code for the U.S. to call (614) 457-0802.Ask for "Representative 200." This key phrase simply lets the membership representative know that you are a Novell customer.NetWare Support Encyclopedia. The NSE program gives customers access to regularly-updated information from Novell and other vendors on products and services. In addition, an NSE Professional Volume is available that provides customers with all of the information in the NSE, plus patches, fixes, and more.Both versions of the NSE are distributed on CD-ROM on a subscription basis. Updates are sent out to subscribers several times each year.For more information on the NSE, contact your Novell Authorized Reseller.Troubleshooting hardware and software. Specialized hardware and software packages, such as Novell's LANalyzer, are available to help you isolate network problems.NetWare training. Many Novell courses are available to help you learn more about NetWare. In addition, you can pursue the title of Certified NetWare Engineer (CNE), Enterprise Certified NetWare Engineer (ECNE), Certified NetWare Administrator (CNA), or Certified NetWare Instructor (CNI) by taking classes and passing tests. For more information on the CNE, ECNE, CNA, and CNI programs, contact Novell's NetWare Technical Institute (NTI) at (512) 794-1795.Customer service. You may want to contact your Novell Authorized Reseller for technical assistance. Most Novell Authorized Resellers have Certified NetWare Engineers on their staffs ready to assist users with their networking problems.User CommentsWe are continually looking for ways to make our products and our manuals as easy to use as possible. You can help us by sharing your comments and suggestions about how our manuals could be made more useful to you and about any inaccuracies or information gaps they may contain.You can submit your comments either by filling out the "User Comments" form at the end of this manual or by writing to us directly at the following address:Novell, Inc.Technical Publications MS C-23-1122 East 1700 South Provo, UT 84606 USAWe sincerely appreciate your comments about our products.LBL="1"Getting ReadyWhat SBACKUP DoesSBACKUP is a NetWare® Loadable Module(tm) (NLM) that allows you to back up and restore data for NetWare 3.1x, 4.0 (including Directory Services), and OS/2® network servers, as well as workstations or other services you select.SBACKUP can take a snapshot copy of data that you select, store the data on the tape of your choice, and retrieve the data later. SBACKUP also allows you toMake full, incremental, or differential backups.Perform backups immediately or schedule them for a later time.Restore all or part of your data.Restore a volume to a different volume.Back up a server even when other users are working on it. (However, files in use are not backed up.) Back up and restore multiple name-space formats defined on a volume (including MS-DOS®, FTAM, Macintosh®, NFS®, and OS/2 files), retaining file attributes associated with each format.Backup ConceptsBefore using SBACKUP, you should be familiar with the following concepts (see IDREF="FM76359"Appendix A, "Terms," on page 65):IDREF="FM99408"Archive Needed attributeIDREF="FM91660"BackupIDREF="FM73958"Backup hosts and targetsIDREF="FM83330"Data setIDREF="FM34549"Major resourceIDREF="FM74176"Media managerIDREF="FM51647"Minor resourceIDREF="FM34781"Modify bitIDREF="FM84298"RestoreIDREF="FM50027"Storage Management Services (SMS)®IDREF="FM24727"Target service agent (TSA)IDREF="FM17087"TSA resourcesBackup SessionsA idxid="w0"book="_idx" docset="nw312" tidref="i6142"backup session occurs whenever a backup is performed.The backup session produces three types of files:Data files, which are sent to the selected storage mediaThe Backup Session Log, put into the Backup and Restore Log file on the hostThe Backup Error Log, put into the Backup and Restore Errors file on the hostThe idxid="w1"book="_idx" docset="nw312" tidref="i1841"Backup and Restore Log file and the Backup and Restore Error file are labeled with the same description you give the session. Any time this session is restored, SBACKUP adds more information to these files.If the session log and error files on the hard disk are destroyed when you restore a session, SBACKUP creates a new error log on the hard disk.Backup TypesSBACKUP performs the following backups:idxid="w2"book="_idx" docset="nw312" tidref="i646"Full backup:idxid="w3"book="_idx" docset="nw312" tidref="i641"Backs up all data. After files are backed up, the modify bit (Archive Needed attribute) is cleared from those files.idxid="w4"book="_idx" docset="nw312" tidref="i646"Incremental backup: idxid="w5"book="_idx" docset="nw312" tidref="i641"Backs up all data modified since the last full or incremental backup (whichever was last). After files are backed up, the modify bit (Archive Needed attribute) is cleared from those files.idxid="w6"book="_idx" docset="nw312" tidref="i646"Differential idxid="w7"book="_idx" docset="nw312" tidref="i640"backup: Backs up all data modified since the last full backup. After files are backed up, the modify bit (Archive Needed attribute) is not cleared.idxid="w8"book="_idx" docset="nw312" tidref="i646"Custom backup: Backs up only the data you specify. You can also specify whether the modify bit (Archive Needed attribute) should be left in a cleared or uncleared state after the backup is finished.For information about the modify bit, see IDREF="FM99408""Archive Needed attribute" on page 65 and IDREF="FM34781""Modify bit" on page 68.Comparative Speed of Backup TypesThe different types of backups also have an effect on the speed of the backup and restore operations, and on the amount of media required for the backup. Details of these relationships are shown in IDREF="FM96538"Table 1-1.LBL="1-1" INLINE="F"ID="FM96538"Comparative speed and media use of different backup typesWIDTH="96"VariableWIDTH="96"Differential backups  (combined with full  backups)WIDTH="96"Incremental backups  (combined with full  backups)WIDTH="96"Backup speedWIDTH="96"SlowerWIDTH="96"FasterRestore speedFasterSlowerMedia usage for  storageMore media usedLess media usedHow the Backup Type Affects a RestoreEach type of backup has a different effect on the process of restoring files.To compare the differences in restore procedures, see IDREF="FM78126"Table 1-2 and IDREF="FM41474"Table 1-3.These examples use the same backup log examples shown in IDREF="FM61319"Table 1-4 on page 6 and IDREF="FM15011"Table 1-5 on page 7, and assume that you performed either an incremental or a differential backup.Restoring after incremental backups. If you have done full and incremental backups and idxid="w9"book="_idx" docset="nw312" tidref="i5924"need to restore data, you must restore (in the order shown in IDREF="FM78126"Table 1-2) the last full backup as well as all subsequent incremental backups.LBL="1-2" INLINE="F"ID="FM78126"A restore procedure after incremental backupsWIDTH="96"Date (Day)WIDTH="108"EventWIDTH="96"Restore this session?WIDTH="96"Sep 10 (Thu)WIDTH="108"Unexpected data lossWIDTH="96"---Sep 4 (Fri)FullYesSep 7 (Mon)IncrementalYesSep 8 (Tue)IncrementalYesSep 9 (Wed)IncrementalYesRestoring after idxid="w10"book="_idx" docset="nw312" tidref="i5924"differential backups. If you have done full and differential backups and need to restore data after an unexpected loss, you only need to restore the last full and the last differential backup (in the order shown in IDREF="FM41474"Table 1-3).This is because each differential backup includes all files modified since the last full backup.LBL="1-3" INLINE="F"ID="FM41474"A restore procedure after differential backupsWIDTH="96"Date (Day)WIDTH="108"EventWIDTH="96"Necessary to restore  this backup session?WIDTH="96"Sep 10 (Thu)WIDTH="108"Unexpected data lossWIDTH="96"---Sep 4 (Fri)FullYesSep 7 (Mon)DifferentialNoSep 8 (Tue)DifferentialNoSep 9 (Wed)DifferentialYesBackup SchedulesBefore you begin actual backup procedures, plan a backup idxid="w11"book="_idx" docset="nw312" tidref="i642"schedule based on your needs. Consider such factors as the number of users, frequency of changes to files, etc.You may want to perform different types of backups on different schedules, as illustrated by the following examples.Daily: After the close of business, back up all files changed that day. If file revision is heavy and rapid, consider several backup sessions each day.Weekly: Perform an incremental or differential backup after the close of business on the last day of the week for three of the four weeks in the month.Monthly: On the last business day of the remaining week of the month (for example, the first or last Friday), perform a full backup.Major changes: In addition, perform a full backup any time you change your configuration, when you upgrade your server to a new version of NetWare, or when you modify applications.The information in IDREF="FM78126"Tables 1-2IDREF="FM15011"through 1-5 can help you decide how to schedule your backups.IDREF="FM61319"Table 1-4 illustrates a series of full and incremental backups. At each full backup, all files are backed up, whether they have been modified or not.Don't combine differential and incremental backups. If you do, the differential backup won't contain all changes since the last full backup. Use full backups interspersed with differential backups, or full backups interspersed with incremental backups.LBL="1-4" INLINE="F"ID="FM61319"A backup history of full and incremental backupsWIDTH="72"Date (day)WIDTH="60"TypeWIDTH="48"Total filesWIDTH="48"No. of new or  revised filesWIDTH="48"No. of files  backed upWIDTH="72"Sep 4 (Fri)WIDTH="60"FullWIDTH="48"47WIDTH="48"N/AWIDTH="48"47Sep 7 (Mon)Incremental582727Sep 8 (Tue)Incremental653232Sep 9 (Wed)Incremental1053838Sep 10 (Thu)Incremental1285151Sep 11 (Fri)Full140N/A140At each incremental backup, only files that have the modify bit (Archive Needed attribute) set are recognized as having been changed.Therefore, only files changed since the last full or incremental backup (when the modify bit was cleared) are backed up.Files that do not have the modify bit set are excluded from the incremental backup. IDREF="FM15011"Table 1-5 illustrates a series of full and differential backups. As in the previous table, all files are backed up during a full backup.LBL="1-5" INLINE="F"ID="FM15011"A backup history of full and differential backupsWIDTH="72"Date (Day)WIDTH="60"TypeWIDTH="48"Total # filesWIDTH="48"No. of new or  revised filesWIDTH="48"No. of files  backed upWIDTH="72"Sep 4 (Fri)WIDTH="60"FullWIDTH="48"47WIDTH="48"N/AWIDTH="48"47Sep 7 (Mon)Differential582727Sep 8 (Tue)Differential653259Sep 9 (Wed)Differential1053897Sep 10 (Thu)Differential12851128Sep 11 (Fri)Full140N/A140When you perform a differential backup, the modify bit isn't cleared after the backup, as it is after a full or incremental backup. Therefore, it doesn't matter whether files have been modified since the last differential backup; all files modified since the last full backup are included in the backup (unless they have been deleted).For more on backup scheduling, see "book="concepts" docset="nw312"Backup" in Concepts.Restore SessionsUse SBACKUP to retrieve and reinstate to the file structure data you have backed up to a storage media. Normally, you perform a restore if data has been lost or corrupted since the backup was made.What is a Restore Session?A idxid="w12"book="_idx" docset="nw312" tidref="i6142"restore session restores data from a backup. The restore session produces the following:The requested data, retrieved from the storage media and restored to the location you specify.The Restore idxid="w13"book="_idx" docset="nw312" tidref="i1841"Error Log file, appended to the Backup and Restore Errors file on the host.SBACKUP finds the error log that has the same description as the data being restored. It then appends this information to the data files being restored.Each time these data files are restored, if errors have occurred, SBACKUP adds more information to the error log. How Does a Restore Work?SBACKUP's "Restore Options" menu allows you to specify exactly which data to restore. Several menu options work together to allow you maximum flexibility in your restore procedure.These options allow you to do the following:Choose subsets of data to restore.Scan what you are restoring.Overwrite an existing parent or child.These options are described on the following pages.Choosing SubsetsYou can select the idxid="w14"book="_idx" docset="nw312" tidref="i6142"subsets of data to restore by including or excluding parts of the directory displayed on the "Selection List Options" screen within SBACKUP. You may be familiar with choosing subsets to restore if you performed a custom backup. You use the subsets of data included in "Include and Exclude Options" the same way during a restore as you do during a custom backup.ID="FM79836"Scanning Data Setsidxid="w15"book="_idx" docset="nw312" tidref="i6142"A data set is a group of data that can be manipulated by SBACKUP. Each data set in the file structure (for example, volumes, directories, files, etc.) includes several different types of information.The types of information differ, depending on whether the data set is a parent or a child. (For more about parents and children, see IDREF="FM25391""Overwriting a Parent or Child" on page 10.)Select data set items you want backed up or restored by using the "Selection List Options" or "Restore Options."Data sets can contain different items, depending on which TSA they are related to. IDREF="FM27634"Figure 1-1 shows typical NetWare data sets.LBL="1-1"ID="FM27634"Types of informational items data sets containFILE="n312b10a.pbm"Use the "Selection List Options" screen to select the items you want SBACKUP to consider for the restore.ID="FM25391"Overwriting a Parent or Childidxid="w16"book="_idx" docset="nw312" tidref="i642"SBACKUP idxid="w17"book="_idx" docset="nw312" tidref="i958"allows you to idxid="w18"book="_idx" docset="nw312" tidref="i2017"overwrite idxid="w19"book="_idx" docset="nw312" tidref="i640"all idxid="w20"book="_idx" docset="nw312" tidref="i4862"existing idxid="w21"book="_idx" docset="nw312" tidref="i4975"parents or children.It also allows you to idxid="w22"book="_idx" docset="nw312" tidref="i4862"idxid="w23"book="_idx" docset="nw312" tidref="i6142"specify that children be overwritten only if the date on data sets on the hard disk is more recent than the date of the data set that was backed up.Within SBACKUP, a idxid="w24"book="_idx" docset="nw312" tidref="i4975"parent might be a server, a volume, or a directory. A idxid="w25"book="_idx" docset="nw312" tidref="i958"child is the lowest level of the directory structure, beyond which subunits cannot be created (for example, a file).The unit below a parent is not necessarily a child; it might be another parent, or the line might end with the parent. The unit above a child must always be a parent. (See IDREF="FM66337"Figure 1-2.)LBL="1-2"ID="FM66337"Parent and child levels in a idxid="w26"book="_idx" docset="nw312" tidref="i6142"file structureFILE="n312b09a.pbm"How Subsets, Scan, and Overwrite Work Together to Perform a RestoreSBACKUP reads the backup storage media and the TSA compares it to the hard disk. The TSA evaluates each data set according to the following criteria:Is this data set specified as a subset of what is being restored? Is this data set found on the hard disk?Which parts of the data set are subject to restoring? Is this data set a parent or a child?Is the Overwrite parameter for parent or child set to Yes, No, or "Overwrite only if newer"?If the parameters for a child are set to "Overwrite only if newer," does the backup copy have a more recent date than the existing copy?IDREF="FM25934"Figure 1-3 on page 12 shows how SBACKUP evaluates data sets before performing a restore.LBL="1-3"ID="FM25934"How SBACKUP and the TSAs evaluate dataID="FM35417"FILE="n312b11a.pbm"idxid="w27"book="_idx" docset="nw312" tidref="i6254"idxid="w28"book="_idx" docset="nw312" tidref="i6396"idxid="w29"book="_idx" docset="nw312" tidref="i6097"idxid="w30"book="_idx" docset="nw312" tidref="i6134"idxid="w31"book="_idx" docset="nw312" tidref="i2651"idxid="w32"book="_idx" docset="nw312" tidref="i5895"Hardware RequirementsCompatible Storage DeviceSee IDREF="FM37133"Appendix B, "Supported Storage Devices," on page 71 or see your Novell Authorized Reseller.idxid="w33"book="_idx" docset="nw312" tidref="i5895"idxid="w34"book="_idx" docset="nw312" tidref="i3794"MemoryThe host server requires a minimum of 3 MB of memory above the memory required to run NetWare (approximately 2 MB).SBACKUP will not run on the host server if it does not have the additional 3 MB of memory (unless you set the number and size of storage buffers lower than the default).For memory and buffer settings, see IDREF="FM18131"Appendix D, "Enhancing Host Server Performance," on page 77.Software RequirementsFor host server software requirements, see IDREF="FM40978"Table 1-6, "Software for a Host or Host/Target Server" on page 14.For target server software requirements, see IDREF="FM17504""Software for a Target Server" on page 15.To install software, see IDREF="FM87179""Installing Backup Files on the Host Server (attached to a backup device)" on page 20 and IDREF="FM85148""Installing Backup Files on the Target Server (not attached to a backup device)" on page 21.To load SBACKUP modules, see IDREF="FM39780"Chapter 2, "Getting Started," on page 19.SBACKUP files were installed on the server unless you used the "Skip" option during NetWare installation and did not install files from the Server Backup diskette.Individual modules and functions are defined in IDREF="FM76359"Appendix A, "Terms," on page 65. Their relationships are shown in IDREF="FM93617"Figure 1-4, "Host/Target Server Configuration" on page 16.Software for a Host or Host/Target ServerLBL="1-6" INLINE="F"ID="FM40978"Software for a Host or Host/Target Server WIDTH="96"Host Server DirectoryWIDTH="84"For a WANGTEK  DIBI-II DriverWIDTH="84"For a TAPEDAI.DSK  and DIBIDAI.NLM  DIBI-II DriverWIDTH="84"For a TAPEDC00  DIBI-II DriverWIDTH="96"SYS:SYSTEM(NetWare 3.12  modules)WIDTH="84"CLIB.NLM NUT.NLM TLI.NLM SPXS.NLM STREAMS.NLM WIDTH="84"CLIB.NLM NUT.NLM TLI.NLM SPXS.NLM STREAMS.NLM WIDTH="84"CLIB.NLM NUT.NLM TLI.NLM SPXS.NLM STREAMS.NLM WIDTH="96"SYS:SYSTEM(SBACKUP Modules)WIDTH="84"SBACKUP.NLM TSA312.NLMSMDR31X.NLMWANGTEK.NLMWIDTH="84"AHAnnnn.DSK ASPITRAN.DSKSBACKUP.NLM SMDR31X.NLMTSA312.NLMTAPEDAI.DSKDIBIDAI.NLM WIDTH="84"ADAPTEC.NLM SBACKUP.NLM SMDR31X.NLMTSA312.NLM TAPEDC00.NLM WIDTH="96"SYS:SYSTEM/DIBI(SBACKUP Modules)WIDTH="84"DIBI2$DV.DAT WIDTH="84"DIBI2$DV.DATWIDTH="84"DIBI2$DV.DAT Use the version of NetWare 3.12 modules that came with the NetWare 3.12 installation or upgrade kit.The nnnn in AHAnnnn.DSK represents the specific host adapter number. For example, a 1540 host adapter uses AHA1540.DSK and a 1640 host adapter uses AHA1640.DSK.AHAnnnn.DSK, ASPITRAN.DSK, and ADAPTEC.NLM are loaded from the disk that comes with the backup device host adapter.Load TSA311.NLM or TSA312.NLM, AHAnnnn.DSK, ASPITRAN.DSK, and ADAPTEC.NLM before loading SBACKUP.NLM.TSA311.NLM or TSA312.NLM is required if the host server is to be backed up.TAPEDAI.DSK and DIBIDAI.NLM, and the TAPEDC00.NLM are loaded automatically by SBACKUP.NLM.ID="FM17504"Software for a Target ServerThe target server directory SYS:SYSTEM for NetWare 3.11 or 3.12 servers should contain the following NetWare modules:CLIB.NLMNUT.NLMTLI.NLMSPXS.NLMSTREAMS.NLM TSA311.NLM or TSA312.NLMSMDR31X.NLMUse the version of each module that came with the NetWare 3.12 installation or upgrade kit.LBL="1-4"ID="FM93617"Host/Target Server ConfigurationFILE="n312b01a.pbm"ID="FM44853"Rules for Using SBACKUPThis section lists rules that will help you avoid problems when using SBACKUP.Do not use SBACKUP and idxid="w35"book="_idx" docset="nw312" tidref="i4035"NBACKUP together.SBACKUP and NBACKUP formats are not compatible. Do not use NBACKUP for NetWare 3.11, 3.12, and higher.Use the NetWare 3.12 version of STREAMS.NLM, SPXS.NLM, TLI.NLM, CLIB.NLM, and NUT.NLM.If you use an old version of these files, SBACKUP may not load or may crash.Log in as SUPERVISOR or equivalent.This maintains network security and ensures data integrity.Do not mount or dismount volumes during a session.You might corrupt data or abend the host server.Make sure you have enough disk space on the target server's volume SYS: for temporary files.SBACKUP creates temporary files on the target server during backup. If you have linked idxid="w36"book="_idx" docset="nw312" tidref="i7073"UNIX files or files with extended attributes, the temporary files may be larger than a megabyte.Exit SBACKUP before unloading manually-loaded drivers.If you unload a manually-loaded driver (such as AHAnnnn.DSK, ASPITRAN.DSK, and ADAPTEC.NLM) before exiting SBACKUP, you abend the host server. Be aware of the name-space formats supported on your system.If file attributes and name-space formats are not configured on the volume you restore data to, the files are restored and a message specifies which name-space formats were not restored.Use correct name-space formats when entering paths and filenames.For Macintosh name-space formats, use the following format:  Volume::Directory:Directory:filenameFor other formats, use the following format:  volume:directory/directory/filenameWhen you restore data, use the same case you used when you backed up the data.Non-DOS path names and filenames are case-sensitive. NetWare recognizes DOS path names and filenames in uppercase, lowercase, or mixed case. If you're not sure of the original case, refer to your log file.LBL="2"ID="FM39780"Getting StartedThis chapter explains how to set up your hardware and software so that you can perform the backup and restore operations described in Chapters 3 and 4.The procedures described in this chapter are the following:Installing backup files (if necessary)Loading the TSA312.NLM (or TSA311.NLM)Loading SBACKUP and the correct driver softwareID="FM49128"Installing Backup FilesBackup files should already be installed on your server if you've properly installed NetWare 3.12 (unless you used the "Skip" option during installation).If backup files were not installed during, use the following procedures to install these files on the host or target server.ID="FM87179"Installing Backup Files on the Host Server (attached to a backup device)ProcedureBefore you begin, make sure you have properly installed NetWare 3.11 or 3.12 on the host server.Install and set up your hardware.For installation instructions and jumper settings, see your host adapter documentation. Use a unique I/O port address, IRQ, and DMA setting.Install the correct disk driver files.If you use the TAPEDAI.DSK and DIBIDAI.DSK DIBI-II driver software, copy the AHAnnnn.DSK and ASPITRAN.DSK files from the driver diskette that came with your host adapter to the host server's SYS:SYSTEM directory.Install SBACKUP on your server.From a workstation, attach to the host server and log in as SUPERVISOR.Copy the SBACKUP files from diskette into the applicable directories.See IDREF="FM40978"Table 1-6, "Software for a Host or Host/Target Server" on page 14.Include the following commands in the host server's AUTOEXEC.NCF file:SEARCH ADD SYS:SYSTEM/DIBISEARCH ADD SYS:SYSTEM/DRSEARCH ADD SYS:SYSTEM/TSAReboot the server.ID="FM85148"Installing Backup Files on the Target Server (not attached to a backup device)Before you begin, make sure the target server is running NetWare 3.12 or 3.11. To install SBACKUP files, do the following at a workstation.ProcedureAttach to the target server and log in as SUPERVISOR.Create a SYS:SYSTEM/TSA directory.Copy the SBACKUP files from diskette into the applicable directories. See IDREF="FM17504""Software for a Target Server" on page 15.Make sure SYS:SYSTEM does not contain files that should be in SYS:SYSTEM/TSA.Include the following command in the target server's AUTOEXEC.NCF file:SEARCH ADD SYS:SYSTEM/TSAReboot the target server.Loading the TSA312.NLM (or TSA311.NLM) on each ServerYou must load TSA312.NLM or TSA311.NLM on the target server to back up from or restore data to that server. Be sure the TSA you use matches the NetWare version installed on your server.ProcedureID="FM74519"Load the TSA312.NLM (or TSA311.NLM).Be sure to load the same TSA version as your server version.For a host or target NetWare 3.12 (or 3.11) server, at the console of each server to be backed up or restored to, type  LOAD TSA312 <Enter>To automatically load TSA312.NLM, include commands in each NetWare 3.12 target server's AUTOEXEC.NCF file. For more on AUTOEXEC.NCF, see "book="utilref" docset="nw312"Create or Modify the System's AUTOEXEC File" inUtilities Reference.Repeat IDREF="FM74519"Step 1 until each server to be backed up or restored has TSA312. NLM (or TSA311.NLM) loaded.Loading SBACKUP and the Correct Driver SoftwareDetermining Driver Software and Loading SBACKUPYou probably need to use DIBI-II (Device Independent Backup Interface) driver software when using SBACKUP on your system.ProcedureDetermine the DIBI-II driver software (WANGTEK.NLM, DIBIDAI.NLM, or TAPEDC00.NLM) for your storage device and host adapter. See IDREF="FM37133"Appendix B, "Supported Storage Devices," on page 71.At the host server console prompt, type the commands for the DIBI-II driver that your storage device and host adapter require.For a WANGTEK DIBI-II driver, type  LOAD SBACKUP <Enter>For a DIBIDAI DIBI-II driver, type  LOAD AHAnnnn  LOAD TAPEDAI  LOAD SBACKUPFor a TAPEDC00 DIBI-II driver, type  LOAD ADAPTEC <Enter>  LOAD SBACKUP <Enter>To automatically load AHAnnnn, ASPITRAN, or ADAPTEC, include the LOAD command in the host server's AUTOEXEC.NCF file.For AHAnnnn, thennnn represents the specific host adapter number. (For example, a 1540 host adapter uses AHA1540.DSK, and a 1640 host adapter uses AHA1640.DSK.) If a non-default port I/O address was used when the host adapter was installed, include P=xxx, where xxx is the non-default port address (example: LOAD AHA1640 P=200).To enhance server performance, include parameters with the LOAD SBACKUP command to change the buffers on the host server. (See IDREF="FM18131""Enhancing Host Server Performance" on page 77.)Enter your username for the host server; then enter your password as prompted.Select a target or device driver.If only one device driver is available, the "Main Menu" appears. See IDREF="FM52505""Selecting a Target" on page 25.If more than one device driver is available, the "Select the Device Driver" list appears. Select the device driver for your storage device and host adapter; then refer to IDREF="FM52505""Selecting a Target" on page 25.To edit, add, or remove device driver entries, modify the DIBI2$DV.DAT file located in SYS:SYSTEM/DIBI. (See IDREF="FM58484"Appendix C, "Editing the Storage Device Interface," on page 75.)ID="FM52505"Selecting a TargetProcedureID="FM29071"From the "Main Menu," choose "Select Target to Backup/Restore."LBL="2-1"Main MenuFILE="n312b12a.pbm"If only one target with a loaded TSA is on the network, the "Enter Username" box appears.If more than one target with a loaded TSA is on the network, the "Select a Target" list appears.LBL="2-2"Select a Target listFILE="n312b14a.pbm"Select a target.If the "Enter Username" box appears and your target is listed, go to IDREF="FM80913"Step 3.If the "Select a Target" list appears and your target is listed, select a target from the list and go to IDREF="FM80913"Step 3.If the "Enter Username" box appears, but your target is not listed, or the "Select a Target" list appears, but your target is not listed, do the following:Enter "LOAD TSA312" (or "LOAD TSA311") at the target server's console prompt.At the host server console, press <Esc>.The "Main Menu" appears.Choose "Select Target to Backup/Restore." Select a target from the list.When the "Enter Username" box appears, go to IDREF="FM80913"Step 3ID="FM80913"Enter your username for the host server; then enter your password as prompted.The "Main Menu" appears.Verify that the target's name is in the screen header. If it is not, repeat IDREF="FM29071"Step 1See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM99935"ID="FM38084"Inserting a Path NameProcedureAt an entry box, press <Insert>.The "Network Volumes," "Network Directories," or "Select" list appears.ID="FM70947"Highlight an entry and press <Enter>.The highlighted entry appears in the entry box and another list appears.Repeat step 2 until the entire path name appears in the entry box.Exit the list by pressing <Esc>.The path name and entry box remain on the screen.Accept the path name and go to a menu by pressing <Enter>.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM94546"Where to Go from HereWIDTH="84"ToWIDTH="216"Do thisWIDTH="84"Select a different  targetWIDTH="216"See IDREF="FM52505""Selecting a Target" on page 25.Back up data  from the targetSee IDREF="FM64144""Backing Up Data" on page 29.Restore data to  the targetSee IDREF="FM21947""Restoring Data to a Target" on page 43.View backup  logsSee IDREF="FM23553""Selecting a Working Directory" on page 54.View error logsSee IDREF="FM11640""Viewing an Error Log" on page 56.Exit SBACKUPPress <Esc> and answer confirmation boxes until  the "Exit SBACKUP" box appears. Select Yes.The SBACKUP.NLM and the NLMs it loaded are  unloaded and the console prompt appears.LBL="3"ID="FM64144"Backing Up DataID="FM84714"Beginning the Backup ProcessBefore attempting to back up data, make sure that TSA312.NLM (or TSA311.NLM) is loaded on each target server and that SBACKUP is loaded on the host server. (See IDREF="FM39780"Chapter 2, "Getting Started," on page 19.)Prerequisites to Backing UpHave all required files loaded. (See IDREF="FM40978"Table 1-6, "Software for a Host or Host/Target Server," on page 14.)Know the idxid="w37"book="_idx" docset="nw312" tidref="i4980"password assigned to the target (for example, server or workstation) you want to back up.If you are backing up an OS/2 or a idxid="w38"book="_idx" docset="nw312" tidref="i3"DOS idxid="w39"book="_idx" docset="nw312" tidref="i1"workstation, know the idxid="w40"book="_idx" docset="nw312" tidref="i4980"workstation password if the user has used the idxid="w41"book="_idx" docset="nw312" tidref="i0"/password option instead of the idxid="w42"book="_idx" docset="nw312" tidref="i2"/trust option.Selecting a Working Directory and the Correct Backup TypeThe working directory is on the host server and stores backup logs and error logs.ProcedureFrom the "Main Menu," select "Backup Menu."If you have multiple servers, and this is the first time you have loaded SBACKUP, a screen appears prompting you to "Select a Target (Client or Server) with a Loaded TSA." Highlight the server you want to be your target server; then press <Enter>. You are then prompted to provide your username and password (if any).The "Backup Menu" appears.LBL="3-1"Backup MenuFILE="n312b13a.pbm"ID="FM30012"Choose "Select Working Directory."ID="FM79666"Type the path name and press <Enter>, or press <Insert> and select the path. (See IDREF="FM38084""Inserting a Path Name" on page 27.)If the path exists, the "Backup Menu" reappears.If the path does not exist, the "OK to create the path?" message appears. Create the path by pressing <Enter>, or choose a new path by pressing <Esc> and selecting a different path. The "Backup Menu" reappears. ID="FM87603"From the "Backup Menu," select "Backup Selected Target." The "Backup Options" screen then appears (see IDREF="FM23207"Figure 3-2).For information on the options on this screen, see IDREF="FM42176""Explanation of Backup Options Screen" on page 37.LBL="3-2"ID="FM23207"Backup OptionsFILE="n312b15a.pbm"From the "Backup Options" screen, select the "Options" field by highlighting "See list" and pressing <Enter>.The "Options" menu appears. By selecting the appropriate options, you can specify the type of backup you want to perform. Each backup type is described on the following pages.Full BackupA Full backup allows you to back up all data, regardless of when or whether it has been previously revised or backed up.ProcedureSet "Exclude files that have not changed" to No by typing N and pressing <Enter>. Return to the "Backup Options" menu by pressing <Esc>.Set "Clear Modify Bit" to Yes by typing Y and pressing <Enter>.ID="FM74595"Save your backup options.Press <Esc>. The "Proceed with Backup" box appears. Proceed by selecting Yes. The "Start Backup" menu appears.ID="FM79666"Start the backup now (see the following section, "Start Backup Now"), or set the backup to begin later (see IDREF="FM48702""Start Backup Later" on page 35).Differential BackupA Differential backup allows you to back up all data that has been modified since the last Full backup.ProcedureSet "Exclude files that have not changed" to Yes by typing Y and pressing <Enter>. Return to the "Backup Options" menu by pressing <Esc>.Set "Clear Modify Bit" to No by typing N and pressing <Enter>.Use "Selection List Options" to further refine your options.ID="FM74595"Save your backup options.Press <Esc>. The "Proceed with Backup" box appears. Proceed by selecting Yes. The "Start Backup" menu appears.ID="FM79666"Start the backup now (see the following section, "Start Backup Now"), or set the backup to begin later (see IDREF="FM48702""Start Backup Later" on page 35).Incremental BackupAn Incremental backup allows you to back up all data that has been modified since the last Full or Incremental backup (whichever was last).ProcedureSet "Exclude files that have not changed" to Yes by typing Y and pressing <Enter>. Return to the "Backup Options" menu by pressing <Esc>.Set "Clear Modify Bit" to Yes by typing Y and pressing <Enter>.Use "Selection List Options" to further refine your options.ID="FM74595"Save your backup options.Press <Esc>. The "Proceed with Backup" box appears. Proceed by selecting Yes. The "Start Backup" menu appears.ID="FM79666"Start the backup now (see the following section, "Start Backup Now"), or set the backup to begin later (see IDREF="FM48702""Start Backup Later" on page 35).Custom BackupA Custom backup allows you to back up only the specific files, directories, or file types that you choose.ProcedureID="FM88318"For a Custom Backup, select the "Backup Menu" options you need.For information about these options, see IDREF="FM42176""Explanation of Backup Options Screen" on page 37.ID="FM74595"Save your backup options.Press <Esc>. The "Proceed with Backup" box appears. Proceed by selecting Yes. The "Start Backup" menu appears.The following section explains how to proceed from here.ID="FM57372"Performing the BackupAt the "Start Backup" menu, determine whether to start the backup now, or set the backup to begin later. Each alternative is described in the following section, "Start Backup Now," or in IDREF="FM48702""Start Backup Later" on page 35.Start Backup NowProcedureFrom the "Start Backup" menu, select "Start Backup Now."If the backup device can append to media and "Append this Session" is set to Yes, the "Insert Media to Append to" message appears.If the backup device cannot append to media or if "Append this Session" is set to No, the "Enter Label for Media Set" message appears.Insert or label the media.ID="FM51966"If the screen message is "Insert Media to Append to," then insert the media cartridge into the storage device and go to IDREF="FM43926"Step 3.If the screen message is "Enter Label for Media Set," then label the media cartridge. At the console, type the name of the media set and press <Enter>. Include information to help you identify the media. The "Insert Media" message appears.Insert the media cartridge into the storage device and go to IDREF="FM43926"Step 3.ID="FM43926"Start the backup session by pressing <Enter>.The backup session begins. A status screen shows the progress of the backup. This restricts you to one backup session at a time.To stop a backup session, see IDREF="FM92311""Aborting a Backup Session" on page 37.If prompted, insert another media cartridge.Remove the old cartridge from the storage device. Label the new cartridge and insert it into the storage device.SBACKUP increments the media label tape number, records it on the new tape, and continues with the backup. Wait until the backup session is finished.When the "Backup Completed" message appears, press <Enter>. The "Backup Menu" appears. Select "View Error Log" to view the error log to determine if any files were not backed up.See IDREF="FM11640""Viewing an Error Log" on page 56.If you do not want to view the error log, press <Esc>. The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM48702"Start Backup LaterProcedureFrom the "Start Backup" menu, select "Start Backup Later."The "Start Backup Timer" box appears.Enter the date and time to begin this backup.Type the starting date and press <Tab> or <Enter>. The default is the current date.Type the time you want the backup to start and press <Tab> or <Enter>. The default is 11:59:59 pm. When the date and time are set, press <Esc>. The "Save Changes" box appears.Save changes by selecting Yes.Insert or label the media.If the backup device can append to media and "Append this Session" is set to Yes, the "Insert Media to Append to" message appears. Insert the media cartridge into the storage device and go to IDREF="FM26708"Step 4.If the backup device cannot append to media or if "Append this Session" is set to No, the "Enter Label for Media Set" message appears. Label the media cartridge. At the console, type the name of the media set and press <Enter>. Include information to help you identify the media. The "Insert Media" message appears. Insert the media cartridge into the storage device and go to IDREF="FM26708"Step 4.ID="FM26708"Start the backup session countdown by pressing <Enter>.A status screen displays the date and time when the backup session will start. The status screen remains until the session is complete. This restricts you to one backup session at a time.To stop a backup session, see IDREF="FM92311""Aborting a Backup Session" on page 37.If you are prompted, insert another media cartridge. Remove the old cartridge from the storage device. Label the new cartridge. Insert the new cartridge into the storage device.SBACKUP increments the media label tape number, records it on the new tape, and continues with the backup. Wait until the backup session is finished.When the backup is complete, SBACKUP disconnects from the target and the "Main Menu" appears.View the error log to determine if any files were not backed up.See IDREF="FM11640""Viewing an Error Log" on page 56.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM92311"idxid="w43"book="_idx" docset="nw312" tidref="i67"idxid="w44"book="_idx" docset="nw312" tidref="i630"Aborting a Backup SessionProcedureDuring the backup session, press <Esc>.Select Yes when the "Abort Backup Session" box appears.The current data set is backed up and the "Dismounting Media" message appears. Dismounting may take a few minutes.When the media is dismounted, the "Backup Terminated" message appears. Press <Enter>. The "Backup Menu" appears. Press <Esc>. The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM42176"Explanation of Backup Options ScreenThe following items appear on the "Backup Options" screen.What to Back UpYou can back up a server, bindery, volume, directory, or files.The default option, "NetWare server," backs up the entire server, except the bindery. If you want the bindery backed up, you must specify that you want it backed up.To specify what to back up, highlight "What to Back Up" and press <Enter>. The "What to Back Up" box appears with the "NetWare server" default.Type a path name and press <Enter>, or press <Insert> and select the path. (See IDREF="FM38084""Inserting a Path Name" on page 27.) The path appears in the box.Session DescriptionA session description helps you locate a session when you restore data. To specify a session description, highlight "Session Description" and press <Enter>. Type a unique description and press <Enter>. The cursor moves to the next field.OptionsBackup options included in the "Options" form let you limit the scope of your backup.You can exclude user account information (such as bindery information) or types of files and directories (such as hidden files). The default is No. (Nothing is excluded from the backup.)Options are specific to the TSA on the target to be backed up. The following options are from TSA312.NLM. To change an option, highlight "Options" and press <Enter>.The "Options" screen appears:LBL="3-3"Options ScreenFILE="n312b02a.pbm"To change a setting, highlight an item and type Y for Yes or N for No. Then press <Enter>. Return to the "Backup Options" menu by pressing <Esc>.Selection List OptionsSelection list options let you specify directories, paths, and files to back up. The default is None. (Everything in the "What to Back Up" box is backed up.)For example, to exclude a directory in volume SYS: from the backup, include volume SYS: and exclude the directory you do not want backed up.The target server's directories and files are not affected by entries in the "Include/Exclude Lists."Selection list options are specific to the TSA on the target to be backed up. The following options are from TSA312.NLM. To change options, highlight "Selection List Options" and press <Enter>. The "Include/Exclude Lists" screen appears.LBL="3-4""Include/Exclude List" ScreenFILE="n312b03a.pbm"To include or exclude a major TSA resource, highlight a resource field and press <Enter>. A file server entry box appears.To add an entry, press <Insert>. A list showing the server's bindery and volumes appears. Highlight an entry and press <Enter>. Return to the "Include/Exclude Lists" form by pressing <Esc>.To modify an entry, highlight the entry and press <Enter>. When the entry box appears, make your changes and press <Enter>. Return to the "Include/Exclude Lists" form by pressing <Esc>.To remove an entry, highlight the entry and press <Delete>. When the "Delete Marked Entry" box appears, select Yes. Return to the "Include/Exclude Lists" form by pressing <Esc>.To include or exclude directories or files, highlight a field and press <Enter>. An entry box appears.To add an entry, press <Insert>. The "Select Name Space Type" list appears. Highlight a name-space type and press <Enter>. An entry box appears. Type the directory path or filename and press <Enter>. (Wildcard characters are allowed in filenames or in the directory name at the end of a directory path.)If you use a non-DOS name-space type, the path and filenames (uppercase, lowercase, or mixed case letters) must exactly match.You cannot use wildcard characters for the Macintosh name-space type.Return to the "Include/Exclude Lists" form by pressing <Esc>.To modify an entry, highlight the entry and press <Enter>. When the entry box appears, make your changes and press <Enter>. Return to the "Include/Exclude Lists" form by pressing <Esc>.To remove an entry, highlight an entry and press <Delete>. When the "Delete Marked Entry" box appears, select Yes. Return to the "Include/Exclude Lists" form by pressing <Esc>. Exit to the "Backup Options" menu by pressing <Esc>.Clear Modify BitTo set the field, highlight "Clear Modify Bit." Type Y for Yes or N for No; then press <Enter>. Exit to the "Backup Options" menu by pressing <Esc>.If the field is Yes, the modify bit is cleared after files are backed up. Only modified files are backed up in the next backup session (if the "Exclude Non-Modified Files" field on the "Options" form is Yes).If the field is No, the modify bit is not changed after files are backed up. Files are backed up in the next backup session, even if they were not modified.Append this SessionThis option appears only if your backup device supports appendable sessions. To set the field, highlight "Append this Session." Type Y for Yes or N for No; then press <Enter>. Exit to the "Backup Options" menu by pressing <Esc>.If the field is Yes, the backup session is appended to the media at the end of the previous session. Each appended session has separate backup and error logs.If the field is No, the tape rewinds and existing data is overwritten by the next backup.LBL="4"ID="FM44424"Restoring DataYou can restore with or without session files (backup and error logs). You specify whether to use session files when you back up data. You need less time to restore data if you use session files.If you do not use session files, SBACKUP must go through the media, display the session header information, and ask if you want to restore this session or skip to the next session.Before attempting to restore data to a target, make sure TSA312.NLM (or TSA311.NLM) is loaded on each target server. Make sure SBACKUP is loaded on the host server. (See IDREF="FM39780"Chapter 2, "Getting Started," on page 19.)ID="FM21947"idxid="w45"book="_idx" docset="nw312" tidref="i5914"idxid="w46"book="_idx" docset="nw312" tidref="i5918"Restoring Data to a TargetProcedureFrom the "Main Menu," select "Restore Menu."If you do not have session files (backup and error logs) select "Restore Without Session Files." The "Restore Options" screen appears.If you have session files (backup and error logs), do the following:Choose "Select Working Directory." Type or select the directory path.Type the directory path and press <Enter>, or press <Insert> and select the path. (See IDREF="FM38084""Inserting a Path Name" on page 27.) The "Restore" menu appears.Select "Restore Session."idxid="w47"book="_idx" docset="nw312" tidref="i5916"The "Restore Session" menu appears. Select a session.Press <Enter>. The "Restore Options" screen appears.ID="FM64440"Select options from the "Restore Options" screen.For information about these options, see IDREF="FM96031""Explanation of Restore Options Screen" on page 46.ID="FM10688"Save your restore options by pressing <Esc>.The "Proceed with Restore" box appears. Proceed by selecting Yes. The "Start Restore" box appears.Start the restore by selecting Yes from the "Start Restore" box.ID="FM14755"To stop a restore session, see IDREF="FM79342""Aborting a Restore Session" on page 46.Insert the source media cartridge into the storage device and press <Enter>. The "Mounting media" message appears.If you are using session files, the restore begins. When the restore is complete, the "Restore Completed" message appears. Press <Enter>. Go to IDREF="FM41347"Step 7.If you are not using session files, the "Restore Session" menu appears. Continue with IDREF="FM60997"Step 6.ID="FM60997"From the "Restore Session" menu, select a session to restore.Follow the prompts to restore the displayed session or to select another session.When the restore session starts, a status screen shows which data is being restored, which data has been restored, and how much time has elapsed since the restore session began. The inset at the bottom of the screen shows errors as they occur.When the restore is complete, the "Restore Completed" message appears. Press <Enter>. The "Restore Menu" appears. ID="FM41347"View the error log to determine if any files were not restored.See IDREF="FM11640""Viewing an Error Log" on page 56.If you do not want to view the error log, press <Esc>. The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM39768"Restoring Volume SYS: and DataBefore performing this procedure, try to fix volume SYS: using idxid="w48"book="_idx" docset="nw312" tidref="i7413"VREPAIR.To restore a network server when the NetWare option "Set immediate purge of deleted files" is set to Off, you need an extra 20 percent of free disk space (so unpurged files can be restored).If you do not have this much free disk space, turn the "Set immediate purge of deleted files" field to On. (Remember, all deleted files are purged.)ProcedureAt the server to be restored, load INSTALL; then create and mount volume SYS:.For detailed instructions, see book="install" docset="nw312"Installation and Upgrade.Copy the files from your CD-ROM or diskettes into the applicable directories.For host servers, see IDREF="FM40978"Table 1-6, "Software for a Host or Host/Target Server," on page 14.For target servers, see IDREF="FM17504""Software for a Target Server" on page 15.At the server being restored (target server), log in as SUPERVISOR and type  LOAD TSA312 <Enter>At the host server, log in as SUPERVISOR and load SBACKUP.See IDREF="FM39780"Chapter 2, "Getting Started," on page 19.Restore the server.Use the procedure in IDREF="FM21947""Restoring Data to a Target" on page 43.ID="FM79342"idxid="w49"book="_idx" docset="nw312" tidref="i69"idxid="w50"book="_idx" docset="nw312" tidref="i5918"Aborting a Restore SessionProcedureDuring the restore session, press <Esc>.The "Abort Restore Session" box appears.Select Yes when the "Abort Backup Session" box appears.The current data set is backed up and the "Dismounting Media" message appears. Dismounting may take a few minutes.When the media is dismounted, the "Backup Terminated" message appears. Press <Enter>. The "Backup Menu" appears. Press <Esc>. The "Main Menu" appears.Go to IDREF="FM94546""Where to Go from Here" on page 28.ID="FM96031"Explanation of Restore Options ScreenThe "Restore Options" screen allows you to customize the restore method you want to perform. This section explains how to use each option.Overwrite Existing ParentIf the field is set to Yes (the default), existing parents (such as directories) are overwritten. Directory trustee rights, owner attributes, and extended attributes are updated. If a parent does not exist, it is created and its information is restored.If the field is set to No, existing directories are not changed. If a parent does not exist, it is created and the information is restored.To change "Overwrite Existing Parent," highlight the field, type Y for Yes or N for No; then press <Enter>. The cursor moves to the next field.Overwrite Existing ChildIf the field is set to Yes (the default), existing children (files) are overwritten and file attributes, trustee rights, and data are updated. If a child does not exist, it is created and restored.If the field is set to No, files are not changed. To change "Overwrite Existing Child," highlight the field, type Y for Yes or N for No; then press <Enter>. The cursor moves to the next field.Selection List OptionsSelection list options let you include or exclude directories, paths, and files to restore. The default is None. (Everything is restored except bindery files containing users and groups, passwords, account restrictions and balances, etc.)For example, to restore a few directories, specify those directories in the "Include directories (full path)" list. To restore most directories, specify the directories you do not want restored in the "Exclude directories (full path)" list.Selection list options are specific to the TSA on the target to be restored. The following options are from TSA312.NLM.To change options, highlight "Selection List Options" and press <Enter>. The "Include/Exclude Lists" screen appears, as shown in IDREF="FM69993"Figure 4-1.LBL="4-1"ID="FM69993""Include/Exclude List" ScreenFILE="n312b03a.pbm"Include or Exclude a Major TSA ResourceTo include or exclude a major TSA resource, highlight a TSA resource field and press <Enter>. A file server entry box appears.Add an EntryTo add an entry, press <Insert>. A list showing the server's bindery and volumes appears. Highlight an entry and press <Enter>. Return to the "Include/Exclude Lists" screen by pressing <Esc>.Modify an EntryTo modify an entry, highlight the entry and press <Enter>. When the entry box appears, make your changes and press <Enter>. Return to the "Include/Exclude Lists" screen by pressing <Esc>.Remove an entryTo remove an entry, highlight the entry and press <Delete>. When the "Delete Marked Entry" box appears, select Yes. Return to the "Include/Exclude Lists" screen by pressing <Esc>.Include or Exclude Directories, Files, or PathsTo include or exclude directories, files, or paths, highlight an include or exclude field and press <Enter>. An entry box appears. Add an EntryTo add an entry, press <Insert>. The "Select Name Space Type" list appears.Highlight a name-space type and press <Enter>. An entry box appears. Type the directory path or filename and press <Enter>. Wildcard characters are not allowed in path names, but are allowed in filenames. If you use a non-DOS name-space type, the path and filenames, in uppercase, lowercase, or mixed case letters, must exactly match.You cannot use wildcard characters for the Macintosh name-space type.Return to the "Include/Exclude Lists" screen by pressing <Esc>.Modify an EntryTo modify an entry, highlight the entry and press <Enter>. When the entry box appears, make your changes and press <Enter>. Return to the "Include/Exclude Lists" screen by pressing <Esc>.Remove an EntryTo remove an entry, highlight an entry and press <Delete>. When the "Delete Marked Entry" box appears, select Yes. Return to the "Include/Exclude Lists" screen by pressing <Esc>. Exit to the "Restore Options" menu by pressing <Esc>.Destination PathsThe source path is where the data was when the backup was made.The destination path is where you want to restore the data.Select "Destination Paths" to restore data to a volume or directory other than the one it was backed up from. (This provides an easy way to restore data to a new directory structure.)If you specify a path that has not been created, the program creates the path. Your next restore session will follow the same path unless you delete the destination path or unless you exit from SBACKUP and reload it.Change a Destination PathTo change a destination path, highlight the field and press <Enter>. The "Source Paths/Destination Paths" list appears.Add an EntryProcedureTo add an entry, press <Insert>. The "Select Name Space Type" list appears. Highlight a name-space type and press <Enter>.The "Path Source" box appears. Type the source path and press <Enter>. Use only full path names without filenames. Wild card characters are not allowed.The "Path Destination" box appears. Type the destination path and press <Enter>. The target server can be different from the server where the backup was made. The "Source Paths/Destination Paths" list appears. Return to the "Restore Options" screen by pressing <Esc>.Modify a Source PathProcedureTo modify a source path, highlight the entry and press <F3>. The "Source Path" box appears. Change the path and press <Enter>.The "Restore Options" screen appears.Modify a Destination PathProcedureTo modify a destination path, highlight the entry and press <Enter>.The "Destination Path" box appears. Change the path and press <Enter>.The "Source Path/Destination Path" list appears. Return to the "Restore Options" screen by pressing <Esc>.Remove an EntryProcedureTo remove an entry, highlight the entry and press <Delete>.When the "Delete Marked Entry" box appears, select Yes. Return to the "Restore Options" screen by pressing <Esc>.LBL="5"ID="FM28887"Viewing Backup Logs and Error LogsSBACKUP generates idxid="w51"book="_idx" docset="nw312" tidref="i635"backup and idxid="w52"book="_idx" docset="nw312" tidref="i1841"error logs for each session. They are stored in a idxid="w53"book="_idx" docset="nw312" tidref="i7481"idxid="w54"book="_idx" docset="nw312" tidref="i7481"idxid="w55"book="_idx" docset="nw312" tidref="i635"idxid="w56"book="_idx" docset="nw312" tidref="i1841"working directory on the host server. The backup log contains the following:Session date and timeDescription of the backup sessionTarget (server or client backed up)Media set ID (label of the backup media cartridge)List of data backed up, name-space types for each file, and data position on the mediaThe error log records errors that occur when you back up or restore data.If a file is open during a backup session, it is not backed up. idxid="w57"book="_idx" docset="nw312" tidref="i2300"idxid="w58"book="_idx" docset="nw312" tidref="i4827"Files open during the backup are listed in the error log as skipped data sets. ID="FM23553"idxid="w59"book="_idx" docset="nw312" tidref="i635"idxid="w60"book="_idx" docset="nw312" tidref="i7295"Selecting a Working DirectoryProcedureAt the "Main Menu," select "Backup Menu" or "Restore Menu."The "Backup Menu" or "Restore Menu" appears.ID="FM30012"Choose "Select Working Directory."The "Select Working Directory" box appears.ID="FM79666"Type the path name of an existing working directory and press <Enter>, or press <Insert> and select a working directory path See IDREF="FM38084""Inserting a Path Name" on page 27.If the path exists, the "Backup Menu" or "Restore Menu" appears. If the path does not exist, the "OK to create the path?" message appears. Press <Esc> and select an existing path. The "Backup Menu" or "Restore Menu" appears.See the next section, "Viewing a Backup Log," or see IDREF="FM11640""Viewing an Error Log" on page 56.ID="FM95479"Viewing a Backup LogProcedureID="FM68000"After selecting a working directory, select "View Backup Log" from the "Backup Menu" or "Restore Menu."A list of backup sessions appears. Each session is listed by description, date, time, and source.Select a backup log.A backup log appears, similar to the log on the next page. Use the Up- and Down-arrow keys to view the file.The backup log displays all supported name-space types. The DOS name space is the first in the group. A right angle bracket (>) appears next to the file's name-space type.SBACKUP retains both symbolic and hard idxid="w61"book="_idx" docset="nw312" tidref="i3219"idxid="w62"book="_idx" docset="nw312" tidref="i3219"links created under the idxid="w63"book="_idx" docset="nw312" tidref="i3992"NFS name-space type, but links are not listed in the backup log. Restoring the original file restores associated links. The data position information (a number like 0001 00000102 00005248) is on the left side.LBL="5-1"Sample Backup Log for Weekly Full BackupFILE="n312b04a.pbm"Exit the backup log and return to the "Main Menu."Press <Esc>. The "Select Session" list appears. Press <Esc> again. The "Backup Menu" or "Restore Menu" appears. Press <Esc> a third time. The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM11640"idxid="w64"book="_idx" docset="nw312" tidref="i7295"idxid="w65"book="_idx" docset="nw312" tidref="i1841"Viewing an Error LogAn error log records errors that occur when you back up or restore data.ProcedureAfter selecting a working directory, select "View Error Log" from the "Backup Menu" or "Restore Menu." The "Select Session" list appears. Each session is listed by description, date, time, and source.Select an error log.An error log appears, similar to the log shown in IDREF="FM70971"Figure 5-2 on page 57. Use the Up-arrow and Down-arrow keys to view the file.idxid="w66"book="_idx" docset="nw312" tidref="i5918"idxid="w67"book="_idx" docset="nw312" tidref="i635"Restore errors are appended to a session's backup error log. A "Restore Session Begins" message marks the beginning of the restore errors.Symbolic and hard idxid="w68"book="_idx" docset="nw312" tidref="i3219"idxid="w69"book="_idx" docset="nw312" tidref="i3219"links created under the idxid="w70"book="_idx" docset="nw312" tidref="i3992"NFS name-space type can fail to be restored if the path name for the restored link contains a regular file. When this happens, the error log contains messages similar to the following:  Error restoring name space specific information of "XXXX:tmp/hosts" in NFS name space, error 0x7!  Unable to allocate directory handle for "XXXX:tmp/test"!Exit the error log and return to the "Main Menu."Press <Esc>. The "Select Session" list appears. Press <Esc> again. The "Backup Menu" or "Restore Menu" appears. Press <Esc> a third time. The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.LBL="5-2"ID="FM70971"Sample Error Log for Weekly Full BackupFILE="n312b05a.pbm"LBL="6"ID="FM28887"TroubleshootingThis chapter provides information on resolving problems you may encounter during backup.No Target List AppearsThis is probably not a problem. If only one target with a loaded TSA is on the network, the target list will not appear. The target is automatically selected and the "Enter User Name" box appears.Target is Not Included in Target ListProcedureAt the target server's console prompt, type  LOAD TSA312 <Enter>The TSA is loaded and the console prompt (:) reappears.At the host server console, press <Esc> until the "Main Menu" appears.Choose "Select Target to Backup/Restore."The "Select a Target" list appears.Select a target from the list.Target is Listed, but an Error Message AppearsEven though your target server is listed, a message appears saying that a "Connect to target service error" has occurred. Either you typed a wrong username and password, or the TSA is an old version.ProcedureAt the "Connect to target service error" message, press <Enter>.Enter your username and password when prompted.Either the "Main Menu" or the "Connect to target service error" message appears.Do one of the following:If the "Main Menu" appears, see IDREF="FM94546""Where to Go from Here" on page 28.If the "Connect to target service error" message reappears, continue with the next step.Press <Esc> until you get to the "Main Menu."At the target server, copy TSA312.NLM to SYS:SYSTEM.At the target server, type  LOAD TSA312 <Enter>Choose "Select Target to Backup/Restore."The "Select a Target" list appears.Select the target from the list.The "Enter Username" box appears.Type your username and password when prompted.The "Main Menu" appears.See IDREF="FM94546""Where to Go from Here" on page 28.ID="FM54906"Using the TAPEDC00.NLM Tape Driver Console ScreenThe "Tape Driver Console" screen is available only if you load TAPEDC00.NLM.ProcedureAccess the "Tape Driver Console" screen.Press <Alt><Esc> until the screen appears, or press <Ctrl><Esc> and select the screen.Select a command by typing a letter, pressing <Enter>, and following the prompts.WIDTH="72"CommandWIDTH="240"DescriptionWIDTH="72"InitializeWIDTH="240"Initializes the tape device if the device was not turned  on when you loaded ADAPTEC.NLM. Also reinitializes a  device if it does not respond properly.idxid="w71"book="_idx" docset="nw312" tidref="i1836"idxid="w72"book="_idx" docset="nw312" tidref="i6692"EraseErases data from a media (including the media name).  If you use a 4mm or 8mm tape device, ERASE can take  several hours. (For more information, see the tape  device manual.)idxid="w73"book="_idx" docset="nw312" tidref="i5928"idxid="w74"book="_idx" docset="nw312" tidref="i6692"RetensionAdjusts tape tension. (For more information, see the  tape device manual.)TestVerifies the interoperability of ADAPTEC.NLM, the host  adapter card, and the tape device. After entering the  TEST command, the tape contents are destroyed. At  the "Continue Y/N?" prompt, type Y.The test writes sample data to the media and verifies  the data. If your tape device supports random access,  four seek operations with verification are performed.  You are notified when the test is successfully  completed. (Sample data is erased.) Return to the  menu by pressing any key.Unload  NLMUnloads the TAPEDC00.NLM.Exit the "Tape Driver Console" screen.Exit by pressing <Esc>.Access SBACKUP.Press <Alt><Esc> until an SBACKUP screen appears, or press <Ctrl><Esc> and select "SBACKUP Screen" from the list.Error Codes and MeaningsIf you get an error message with an error code, look up the error code in the left column and determine the error using the description in the right column of the following table.LBL="6-1" INLINE="F"Server Backup Error Codes and MeaningsWIDTH="96"0x10001WIDTH="216"The backup restore thread is active0x10002The file type is invalid.0x10003The session ID is invalid.0x10004A buffer overflow error occurred.0x10005A close file error occurred.0x10006The DIBI driver is already loaded.0x10007A seek file error occurred.0x10008A get transfer buffer error occurred.0x10009The head FID cannot be found.0x1000AThe control block is invalid.0x1000BAn invalid offset to end was found.0x1000CAn invalid record was found.0x1000DThe SMSDF revision is invalid.0x1000EA media dismount error occurred.0x1000FA media mount error occurred.0x10010A media read error occurred.0x10011A media sector size error occurred.0x10012A media write error occurred.0x10013The next record is not in the buffer.0x10014Record header information is missing.0x10015No buffer is available.0x10016No media label can be found.0x10017No sessions are available.0x10018An open data file error occurred.0x10019An open session files error occurred.0x1001AOperator has aborted this operation.0x1001BAn out of memory error occurred.0x1001CA push list error occurred.0x1001DThe session file is corrupted.0x1001EA skip set mark error occurred.0x1001FA spanned sector counts mismatch occurred.0x10020A time out error occurred.0x10021The transfer buffer is invalid.0x10022The transfer buffer is in use.0x10023The TSA level is invalid.0x10024The TSA connection is invalid.LBL="A"ID="FM76359"TermsID="FM99408"Archive Needed attribute idxid="w75"book="_idx" docset="nw312" tidref="i454"A file attribute, set by NetWare, indicating that the file has been changed since the last time it was backed up.ID="FM91660"Backup idxid="w76"book="_idx" docset="nw312" tidref="i630"A duplicate of data (file, directory, volume), copied to a storage device (floppy diskette, cartridge tape, hard disk). A backup can be retrieved and restored if the original is corrupted or destroyed.For more information, see "book="concepts" docset="nw312"Backup" in Concepts.Backup engineA module loaded on a host server that contains the backup and restore interface. It reads and translates user requests, determines the type of session being initiated, and decides which modules to activate.ID="FM73958"Backup hosts and targetsA backup host is a NetWare server with a storage device and a storage device controller attached.A target is a server that contains data you back up or restore data to.Any server, workstation, or service (such as NetWare Directory Services) on the network can be a target, as long as it contains Target Service Agent (TSA) files.A target can be any server, even the host. If you back up data on the host, the target and host are the same.idxid="w77"book="_idx" docset="nw312" tidref="i956"ChildA data set with no subordinates. For example, in NetWare v3.12, a file would be a child, but a directory would not be, because a directory can contain subordinate directories or files.idxid="w78"book="_idx" docset="nw312" tidref="i983"ClientA network service, server, or workstation that has a loaded TSA and can be backed up or restored by a host server.idxid="w79"book="_idx" docset="nw312" tidref="i1310"Data requesterThe NLM that transports data between the backup engine and the TSA.ID="FM83330"Data set idxid="w80"book="_idx" docset="nw312" tidref="i1312"idxid="w81"book="_idx" docset="nw312" tidref="i6139"A group of data that can be manipulated by SBACKUP.Data sets can contain different items depending on which TSA they are related to.DIBIDevice Independent Backup Interface.Differential backupA backup of files marked with a modify bit. A differential backup does not clear the modify bit.For example, if you do a full backup on Monday, the modify bit for each file is cleared. If you do a differential backup on Tuesday, only files modified on Monday are included in Tuesday's differential backup, and the modify bit is not cleared.If you do another differential backup on Wednesday, only files modified on Monday and Tuesday are included on Wednesday's differential backup, and the modify bit is still not cleared.idxid="w82"book="_idx" docset="nw312" tidref="i2534"idxid="w83"book="_idx" docset="nw312" tidref="i630"Full backupA copy of the entire contents of the target server. All bindery information, all directories, and all files are copied to the backup media. A full backup clears the modify bit.Host adapterA board in a host server that controls the storage device.idxid="w84"book="_idx" docset="nw312" tidref="i2677"Host serverA NetWare server with a host adapter and storage device, such as a tape drive, attached.Incremental backupA backup of files marked with a modify bit. An incremental backup clears the modify bit.For example, if you do a full backup on Monday, the modify bit for each file is cleared. If you do an incremental backup on Tuesday, only files modified on Monday are included in Tuesday's incremental backup, and the modify bit for each file is cleared.If you do another incremental backup on Wednesday, only files modified on Tuesday are included on Wednesday's incremental backup, and the modify bit for each file is cleared.ID="FM34549"Major resourceA category of data defined by the Target Service Agent, and recognized by SBACKUP. A major resource contains data that can be backed up as a group, for example, server, volume, etc.Media labelA description of the contents of the backup that helps you locate data if you restore it.Include the type of backup (full or incremental), backup frequency (daily, weekly, etc.), and a description of data sets being backed up.ID="FM74176"Media managerA set of routines within NetWare v3.12 and v4.0 that provide to applications a generic view of the different types of backup storage devices (disk, tape, autochanger, etc.).These routines enable applications to communicate with the different storage devices without having device-specific drivers.idxid="w85"book="_idx" docset="nw312" tidref="i3755"Media set IDThe media label, cartridge number, and date and time of the backup. This information is recorded on the media so you can identify the data stored on the cartridge.ID="FM51647"Minor resourceA category of data defined by the Target Service Agent and recognized by SBACKUP.A minor resource might be located in the directory structure below the selected major resource; for example, directories, subdirectories, or files.ID="FM34781"Modify bitA bit set by the operating system, when a file is changed, to indicate that data has been modified.When a backup is performed, SBACKUP can check to see whether modify bits are set, and can back up only those files that have their modify bit set.Different types of backups have different actions on the modify bit and on files that aren't marked with a modify bit (non-modified files).Name-space formatThe file-naming format required for different types of operating systems. For example, DOS, Macintosh, NFS, and OS/2 have different name-space formats.idxid="w86"book="_idx" docset="nw312" tidref="i4973"ParentA data set that can have subordinate data sets (other parents or children). For example, in NetWare v3.12, a parent would be a bindery, directory, or subdirectory.ID="FM84298"RestoreA retrieval of data previously copied and backed up to a storage media. Perform a restore if data has been lost or corrupted since the backup.idxid="w87"book="_idx" docset="nw312" tidref="i6280"SessionOne backup or restore operation.ID="FM50027"Storage Management Services (SMS)Services that allow data to be stored and retrieved. SMS is independent of backup/restore hardware and file systems (such as DOS, OS/2, Macintosh, Windows, or UNIX).For more, see "book="concepts" docset="nw312"Storage Management Services" in Concepts.idxid="w88"book="_idx" docset="nw312" tidref="i6533"Storage deviceA device, such as a tape drive or optical disk, used to store the contents of a server or workstation.Storage device driverSoftware that controls the operation of a storage device attached to a compatible host adapter.idxid="w89"book="_idx" docset="nw312" tidref="i6536"Storage device support driverSoftware used with a DIBI interface and a storage device driver.Storage device driver databaseA database file on the host server that contains the list of supported storage device drivers.idxid="w90"book="_idx" docset="nw312" tidref="i6695"TargetA server from which you back up data or to which you restore data. Any NetWare server, workstation, or service on the network can be a target, as long as the Target Service Agent (TSA) files are loaded.A target can be either a different server than the host or the same server as the host. If you are backing up and restoring on the same server, the target and the host are the same.ID="FM24727"idxid="w91"book="_idx" docset="nw312" tidref="i7035"Target service agent (TSA)A program that processes data moving between a specific target and SBACKUP. SBACKUP, running on the host, sends requests to the TSA.Servers and workstations running different software releases, or having different operating systems, require NetWare-compatible TSAs to communicate with SBACKUP.TSAs perform the following functions:Receive the commands from SBACKUP and process them so that the target operating system can handle the request for data.Pass the data request from SBACKUP to the target.Receive the requested data from the target and return it to SBACKUP in standard SMS format.ID="FM17087"TSA resourcesCategories of data, referred to as major resources and minor resources, created by each TSA. (See IDREF="FM34549""Major resource" and IDREF="FM51647""Minor resource.") Because these resources vary with each TSA, SBACKUP processes these resources in different ways.idxid="w92"book="_idx" docset="nw312" tidref="i7481"idxid="w93"book="_idx" docset="nw312" tidref="i5895"idxid="w94"book="_idx" docset="nw312" tidref="i7481"Working directoryA directory on the host server where log and error files for each backup session are recorded and stored.LBL="B"ID="FM37133"Supported Storage DevicesDriversThe following idxid="w95"book="_idx" docset="nw312" tidref="i1423"DIBI-II drivers are supported by SBACKUP 3.12:TAPEDC00.NLMWANGTEK.NLMDIBIDAI.NLMStorage DevicesFor supported idxid="w96"book="_idx" docset="nw312" tidref="i6535"storage device tables, see the following pages.LBL="B-1"Storage Devices Compatible with TAPEDC00.NLM DIBI-II Driver SoftwareFILE="n312b06a.pbm"LBL="B-1"<continued>Storage Devices Compatible with TAPEDC00.NLM DIBI-II Driver SoftwareFILE="n312b07a.pbm"LBL="B-2"Storage Devices Compatible with WANGTEK.NLM DIBI-II Driver SoftwareFILE="n312b08a.pbm"LBL="C"ID="FM58484"Editing the Storage Device InterfaceOverviewDevice driver information and parameters are stored in the file SYS:SYSTEM/DIBI/DIBI2$DV.DAT. You can add, modify, or delete device driver information from the file.To modify DIBI2$DV.DAT, use the following procedure:ProcedureAt a workstation, log in to the host server as SUPERVISOR or equivalent.Change the DIBI2$DV.DAT file attribute to Normal. From the command line, type  FLAG SYS:SYSTEM\DIBI\DIBI2$DV.DAT N <Enter>At the host server's console, log in as SUPERVISOR or equivalent.Load idxid="w97"book="_idx" docset="nw312" tidref="i1780"idxid="w98"book="_idx" docset="nw312" tidref="i3236"idxid="w99"book="_idx" docset="nw312" tidref="i1773"idxid="w100"book="_idx" docset="nw312" tidref="i1773"idxid="w101"book="_idx" docset="nw312" tidref="i1425"EDIT.NLM and edit the DIBI2$DV.DAT file. From the command line, type  LOAD EDIT SYS:SYSTEM/DIBI/DIBI2$DV.DAT <Enter>Edit the file.To change a parameter, highlight the line and edit the parameter.To delete a driver, delete the line.To add a new driver, type the driver name in quotation marks, the filename, and optional parameters.For example,  "Wangtek Tape Drive." WANGTEK PORT=200 DMA=1 IRQ=5(For parameter information, see the documentation that came with the driver.)If you leave all driver lines in the file, you can select the driver after you load SBACKUP.Exit the file by pressing <Esc>.If changes were made, the "Save File" box appears. Save changes by selecting Yes. The console prompt (:) appears.If no changes were made, the console prompt (:) appears.At a workstation, change the file's attribute back to Read Only. From the command line, type  FLAG SYS:SYSTEM\DIBI\DIBI2$DV.DAT Ro <Enter>LBL="D"ID="FM18131"Enhancing Host Server PerformanceThe speed of SBACKUP depends upon the host server's configuration and whether or not the server is backing up its own data or that of another server. A server backing up its own data runs about four times faster than a server backing up data from another server.This appendix includes four options using LOAD and SET commands that can enhance your host server's performance:Changing buffer sizeModifying the packet receive buffersSetting subdirectory levels and minimum cache buffersSetting reserved buffers below 16 megabytesFor more information on the following commands and files, see book="sysadmin" docset="nw312"System Administration.Changing the Size and Number of BuffersIf your server has insufficient free memory, or if it has memory not being used, you can speed up a backup session by changing the number and size of the host server's buffers when you load SBACKUP. (For more about changing the size or number of buffers, see your device driver's documentation.)If you change the size or number of buffers, you also must change the total memory allowed. Calculate how much memory is needed by multiplying the number of buffers by the buffer size, in kilobytes. Remember that the operating system also requires 2 MB of memory.To change the size and number of buffers, specify the size and number of buffers when loading SBACKUP. Type  LOAD SBACKUP SIZE=XXX BUFFER=X<Enter>Select the size and number of buffers from the following chart:WIDTH="144"Available OptionWIDTH="96"RangeWIDTH="72"DefaultWIDTH="144"Buffer Size (XXX)WIDTH="96"16 KB to 256 KBWIDTH="72"64 KBNumber of Buffers (X)2 to 104If you use an 8- or 16-bit host adapter and a driver that does not force the use of memory below 16 MB, do not specify a buffer- and memory-size combination that exceeds 16 MB. If you do, corrupt data is copied to the backup tape. idxid="w102"book="_idx" docset="nw312" tidref="i6285"idxid="w103"book="_idx" docset="nw312" tidref="i851"Setting Minimum Packet Receive BuffersProcedureInclude the following SET command in your STARTUP.NCF file:  SET MINIMUM PACKET RECEIVE BUFFERS = XXXSet 2 buffers for each user on the system.To set the changes, down the server and bring it back up.Setting Maximum Subdirectory Level and idxid="w104"book="_idx" docset="nw312" tidref="i6285"idxid="w105"book="_idx" docset="nw312" tidref="i851"Minimum Cache BuffersIf you change the maximum subdirectory level in the server's AUTOEXEC.NCF file, you must also change the minimum cache buffers. The maximum subdirectory level default is 25.ProcedureInclude the following commands in the STARTUP.NCF file:  SET MINIMUM CACHE BUFFERS=X  SET MAXIMUM DIRECTORY BUFFERS=XReplace X with a number equal to or greater than the subdirectory level you set in the AUTOEXEC.NCF file. The default for both is 25.To set the changes, down the server and bring it back up.ID="FM79794"idxid="w106"book="_idx" docset="nw312" tidref="i6285"idxid="w107"book="_idx" docset="nw312" tidref="i851"Setting Reserved Buffers Below 16 MegabytesIf your driver requires memory below 16 megabytes and you get an OUT OF MEMORY message, increase the number of low memory buffers by modifying your STARTUP.NCF file.ProcedureInclude the following command in the STARTUP.NCF file:  SET RESERVED BUFFERS BELOW 16 MEG=XReplace X with a number between 8 and 200. The default is 8. If your machine has 4 to 5 MB of memory, use the default. If you have more than 8 MB, set the number of buffers to 200.To set the changes, down the server and bring it back up.