January 11, 2005
NetWorker
™
Release 7.2
Linux® Version
Installation Guide
Copyright © 1990-2005 by EMC Corporation. All rights reserved. This software (including documentation) is subject to the terms and
conditions set forth in the end user license agreement or other applicable agreement, and you may use this software only if you accept all
the terms and conditions of the license agreement. This software comprises proprietary and confidential information of EMC.
Unauthorized use, disclosure, and distribution are strictly prohibited. Use, duplication, or disclosure of the software and documentation
by the U.S. Government are subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software
clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software - Restricted Rights at 48 CFR 52.227-19,
as applicable. Manufacturer is LEGATO Software, a division of EMC, 2350 West El Camino Real, Mountain View, CA 94040.
LEGATO NetWorker, Release 7.2, Linux Version, Installation Guide
January 11, 2005
e6-1750-01
LEGATO and the LEGATO logo are registered trademarks, and LEGATO NetWorker, NetWorker, AAM, Co-StandbyServer, RepliStor,
SnapShotServer, QuikStartz, AlphaStor, ClientPak, Xtender, XtenderSolutions, DiskXtender, ApplicationXtender, ArchiveXtender,
EmailXtender, and EmailXaminer are trademarks or registered trademarks of LEGATO Software, a division of EMC. This is a nonexhaustive
list of LEGATO trademarks, and other trademarks may be the property of their respective owners.
The following may be trademarks or registered trademarks of the companies identified next to them, and may be used in this document for
identification purposes only.
Acrobat, Adobe / Adobe Systems, Inc.
Apple, Macintosh / Apple Computer, Inc.
Caldera Systems, SCO, SCO OpenServer, UnixWare / Caldera, Inc.
TELEform / Cardiff
Check Point, FireWall-1 / Check Point Software Technologies, Ltd.
Unicenter / Computer Associates International, Inc.
Access Logix, Celerra, Centera, CLARiiON, EMC, EMC2, MirrorView, Navisphere, SnapView, SRDF, Symmetrix, Symmetrix DMX,
TimeFinder / EMC Corporation
Fujitsu / Fujitsu, Ltd.
Hewlett-Packard, HP, HP-UX, HP Tru64, HP TruCluster, OpenVMS, ProLiant / Hewlett-Packard Company
AIX, DB2, DB2 Universal Database, Domino, DYNIX, DYNIXptx, IBM, Informix, Lotus, Lotus Notes, OS/2, PTX, ptx/ADMIN, Raid Plus,
ServeRAID, Sequent, Symmetry, Tivoli, / IBM Corporation
InstallShield / InstallShield Software Corporation
Intel, Itanium / Intel Corporation
Linux / Linus Torvalds
Active Directory, Microsoft, MS-DOS, Outlook, SQL Server, Windows, Windows NT / Microsoft Corporation
Netscape, Netscape Navigator / Netscape Communications Corporation
Data ONTAP, NetApp, NetCache, Network Appliance, SnapMirror, SnapRestore / Network Appliance, Inc.
IntraNetWare, NetWare, Novell / Novell, Inc.
Oracle, Oracle8i, Oracle9i / Oracle Corporation
NetFORCE / Procom Technology, Inc.
DLTtape / Quantum Corporation
Red Hat / Red Hat, Inc.
R/3, SAP / SAP AG
IRIX, OpenVault, SGI / Silicon Graphics, Inc.
SPARC / SPARC International, Inc.a
ACSLS, REELbackup, StorageTek / Storage Technology Corporation
Solaris, Solstice Backup, Sun, SunOS, Sun StorEdge, Ultra / Sun Microsystems, Inc.
SuSE / SuSE, Inc.
Sybase / Sybase, Inc.
Turbolinux / Turbolinux, Inc.
Unicode / Unicode, Inc.
VERITAS, VERITAS File System/ VERITAS Software Corporation
WumpusWare / WumpusWare, LLC
UNIX / X/Open Company Ltdb
Notes:
a. Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems, Inc.
b. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd.
All other brand or product names may be trademarks or registered trademarks of their respective owners.
LEGATO Software
A Division of EMC Corporation
End-User License Agreement
THIS PRODUCT CONTAINS CERTAIN COMPUTER PROGRAMS AND OTHER PROPRIETARY MATERIAL, THE USE OF WHICH IS SUBJECT TO THIS
END-USER LICENSE AGREEMENT (THE "EULA"). DO NOT PROCEED WITH THE INSTALLATION OF THIS PRODUCT UNTIL YOU (LATER DEFINED
AS LICENSEE) HAVE READ THIS EULA AND AGREE TO BE BOUND BY AND BECOME A PARTY TO THIS EULA. BY PROCEEDING WITH THE
INSTALLATION OF THIS PRODUCT (OR AUTHORIZING ANY OTHER PERSON TO DO SO), YOU AND YOUR COMPANY ACCEPT THIS EULA AND
YOU REPRESENT THAT YOU ARE AUTHORIZED TO DO SO. IF YOU ARE ACCESSING THE PRODUCT ELECTRONICALLY INDICATE YOUR
ACCEPTANCE OF THESE TERMS BY SELECTING THE "ACCEPT" BUTTON AT THE END OF THE EULA. IF YOU DO NOT AGREE TO THE TERMS OF
THIS EULA, YOU MAY RETURN THIS PRODUCT, ALL MEDIA AND DOCUMENTATION, AND PROOF OF PAYMENT, TO THE PLACE YOU OBTAINED
THEM FOR A FULL REFUND WITHIN THIRTY (30) DAYS OF FIRST ACQUIRING THIS PRODUCT OR, IF THE PRODUCT IS ACCESSED
ELECTRONICALLY, SELECT THE "DECLINE" BUTTON AT THE END OF THIS EULA AND RETURN PROOF OF PAYMENT IN ACCORDANCE WITH THE
ABOVE REFERENCED RETURN/REFUND PROCESS. WRITTEN APPROVAL IS NOT A PREREQUISITE TO THE VALIDITY OR ENFORCEABILITY OF
THIS EULA AND NO SOLICITATION OF ANY SUCH WRITTEN APPROVAL BY OR ON BEHALF OF LEGATO SHALL BE CONSTRUED AS AN
INFERENCE TO THE CONTRARY. IF YOU HAVE ORDERED THIS PRODUCT, LEGATO'S ACCEPTANCE IS EXPRESSLY CONDITIONAL ON YOUR
ASSENT TO THESE TERMS TO THE EXCLUSION OF ALL OTHER TERMS; IF THESE TERMS ARE CONSIDERED AN OFFER BY LEGATO, ACCEPTANCE
IS EXPRESSLY LIMITED TO THESE TERMS.
1. DEFINITIONS
1.1 Authorization Code: means the unique code provided to Licensee by
LEGATO for permanent activation of the Software. The Authorization Code
is provided to Licensee once the Enabler Code is registered with LEGATO.
The Authorization Code may be tied to a unique machine ID code supplied
by Licensee.
1.2 Documentation: Documentation: means the user reference materials on
any media, provided by LEGATO for use with the Software.
1.3 Enabler Code: means the code provided by LEGATO for activation of the
Software.
1.4 Licensee: means the person or entity acquiring this License or for whom
this License was acquired.
1.5 Software: means the object code copy of the software program provided
to You in association with this EULA, together with the associated original
media and all accompanying Documentation, and together with all Updates
that may be provided by LEGATO to You from time to time.
2. OWNERSHIP AND ADMINISTRATION OF SOFTWARE
2.1 Ownership and Title. As between the parties, LEGATO, and its licensors,
own and shall retain all right, title, and interest in and to: (i) the Software
including all intellectual property rights embodied therein; (ii) all of the
service marks, trademarks, trade names, or any other designations associated
with the Software; and (iii) all copyrights, patent rights, trade secret rights,
and other proprietary rights relating to the Software.
2.2 Software Activation. LEGATO employs Enabler Codes and
Authorization Codes that enable the use of the Software. The Software is
shipped in a ”Media Kit” which consists of object code software on CD-ROM
and an Enabler Code for initial activation of the Software or the Software and
Enabler Code may be delivered electronically. Once LEGATO receives
confirmation from Licensee that the Software is installed with the correct
Enabler Code, and is provided with the host ID information, LEGATO will
provide the Authorization Code to Licensee. LEGATO administers the
generation and distribution of Enabler and Authorization Codes, which
administration may be modified by LEGATO from time to time.
2.3 Administration of Software. LEGATO may include on the media with
the Software additional computer programs which are not currently licensed
for use by Licensee and to which the Enabler Code or Authorization code will
not permit access. Inclusion of such additional computer programs in no way
implies a license from LEGATO and access or use of such programs is strictly
prohibited unless Licensee procures the right to use any such program and
the applicable Enabler Code is provided thereto.
3. LICENSE GRANT
3.1 Grant. LEGATO grants to Licensee a non-exclusive, nontransferable,
non-sublicensable, perpetual (unless terminated in accordance with the
provisions of this EULA), license (the “License”) to (i) use the Software
installed in accordance with the Documentation and only on the licensed
computer(s) solely for its own internal operations; and (ii) move the Software
temporarily in case of computer system malfunction. The Software may be
licensed: (a) on a per copy or per seat basis, on a physical or virtual machine,
(b) based upon the number of mailboxes or the number of non-concurrent
users for which it may be used, or (c) based upon data volumes it supports.
The License granted under this EULA does not constitute a sale of the
Software or any portion or copy of it. Licensee may not use the Software on
more than one computer system unless otherwise specifically authorized by
an explicit Software product, or additional licenses for additional computers
are purchased. Rights not expressly granted are reserved by LEGATO.
3.2 Copies. Licensee may make copies of the Software provided that any such
copy is: (i) created as an essential step in utilization of the Software as
licensed and is used in no other manner; or (ii) used for archival purposes.
All trademark and copyright notices must be reproduced and included on
such copies. Licensee may not make any other copies of the Software.
3.3 Restrictions on use. Licensee shall not, and shall not aid, abet, or permit
any third party to: (i) decompile, disassemble, or otherwise reverse engineer
or attempt to reconstruct or discover any source code or underlying ideas or
algorithms of the Software by any means whatsoever; (ii) remove any
identification, copyright, or other notices from the Software; (iii) provide,
lease, lend, use for timesharing or service bureau purposes; (iv) create a
derivative work of any part of the Software; or (v) develop methods to enable
unauthorized parties to use the Software. If EC law is applicable, the
restrictions in Section 3.3 (i) are limited so that they prohibit such activity only
to the maximum extent such activity may be prohibited without violating the
EC Directive on the legal protection of computer programs. Notwithstanding
the foregoing, prior to decompiling, disassembling, or otherwise reverse
engineering any of the Software, Licensee shall request LEGATO in writing,
to provide Licensee with such information or assistance and Licensee shall
refrain from decompiling, disassembling, or otherwise reverse engineering
any of the Software unless LEGATO cannot or has not complied with such
request in a commercially reasonable amount of time.
3.4 Purchase Orders. Nothing contained in any purchase order,
acknowledgment, or invoice shall in any way modify the terms or add any
additional terms or conditions to this EULA.
3.5 Updates. This section applies if the Software acquired is an update to the
original Software (the “Update”). An Update does not constitute a legally
licensed copy of the Software unless purchased as an Update to a previously
licensed version of the same Software. The Update may only be used in
accordance with the provisions of this EULA. The Update, together with the
original Software, constitutes one (1) legally licensed copy of the Software.
3.6 Evaluation License. This Section applies if the Software is being used for
an initial thirty (30) day evaluation period. The license is valid only for a
period of thirty (30) days from the delivery of the Software, and is designed
to allow Licensee the right to evaluate the Software during such period. In
the event that Licensee desires to continue to license the Software, Licensee
must purchase a license to the Software. Upon such purchase, Licensee will
be provided with an Enabler Code in accordance with Section 2.2 above. In
the event Licensee determines not to purchase a license for the Software at the
end of such thirty (30) day evaluation period, then Licensee’s rights under
this EULA shall terminate automatically and Licensee shall promptly return
to LEGATO or destroy all copies of the Software and so certify to LEGATO.
3.7 General Public License ("GPL"). The Software may include one or more
components which are derived from software subject to a General Public
License. Any such components are licensed exclusively under the applicable
GPL and not under this EULA.
4. MAINTENANCE AND SUPPORT
4.1 LEGATO has no obligation to provide support, maintenance, upgrades,
modifications, or new releases under this EULA. LEGATO may provide such
services under separate EULA.
5. LIMITED WARRANTY
5.1 Media and Documentation. LEGATO warrants that if the media or
documentation are damaged or physically defective at the time of delivery of
the first copy of the Software to Licensee and if defective or damaged product
is returned to LEGATO (postage prepaid) within thirty (30) days thereafter,
then LEGATO will provide Licensee with replacements at no cost.
5.2 Limited Software Warranty. Subject to the conditions and limitations of
liability stated herein, LEGATO warrants for a period of thirty (30) days from
the delivery of the first copy of the Software to Licensee that the Software, as
delivered, will materially conform to LEGATO’s then current published
Documentation for the Software. This warranty covers only problems
reported to LEGATO during the warranty period. For customers outside of
the United States, this Limited Software Warranty shall be construed to limit
the warranty to the minimum warranty required by law.
5.3 Remedies. The remedies available to Licensee hereunder for any such
Software which does not perform as set out herein shall be either repair or
replacement, or, if such remedy is not practicable in LEGATO’s opinion,
refund of the license fees paid by Licensee upon a return of all copies of the
Software to LEGATO. In the event of a refund this EULA shall terminate
immediately without notice with respect to such Software.
6. WARRANTY DISCLAIMER
6.1 Warranty Disclaimer. EXCEPT FOR THE LIMITED WARRANTY
PROVIDED IN SECTION 5 ABOVE, ALL SOFTWARE IS PROVIDED "AS IS".
LEGATO AND ITS LICENSORS MAKE NO WARRANTIES WITH RESPECT
TO ANY SOFTWARE AND DISCLAIMS ALL STATUTORY OR IMPLIED
WARRANTIES, INCLUDING WITHOUT LIMITATION WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
ARISING FROM A COURSE OF DEALING OR USAGE OF TRADE AND
ANY WARRANTIES OF NONINFRINGEMENT. LEGATO DOES NOT
WARRANT THAT THE SOFTWARE WILL MEET ANY REQUIREMENTS
OR THAT THE OPERATION OF SOFTWARE WILL BE UNINTERRUPTED
OR ERROR FREE. ANY LIABILITY OF LEGATO WITH RESPECT TO THE
SOFTWARE OR THE PERFORMANCE THEREOF UNDER ANY
WARRANTY, NEGLIGENCE, STRICT LIABILITY OR OTHER THEORY
WILL BE LIMITED EXCLUSIVELY TO THE REMEDIES SPECIFIED IN
SECTION 5.3 ABOVE. Some jurisdictions do not allow the exclusion of
implied warranties or limitations on how long an implied warranty may last,
so the above limitations may not be applicable.
7. LIMITATION OF LIABILITY
7.1 Limitation of Liability. EXCEPT FOR BODILY INJURY, LEGATO (AND
ITS LICENSORS) WILL NOT BE LIABLE OR RESPONSIBLE WITH
RESPECT TO THE SUBJECT MATTER OF THIS EULA UNDER ANY
CONTRACT, NEGLIGENCE, STRICT LIABILITY, OR OTHER LEGAL OR
EQUITABLE THEORY FOR: (I) ANY INDIRECT, SPECIAL, INCIDENTAL
OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND
WHETHER OR NOT ADVISED IN ADVANCE OF THE POSSIBILITY OF
SUCH DAMAGES; OR (II) DAMAGES FOR LOST PROFITS OR LOST
DATA; OR (III) COST OF PROCUREMENT OF SUBSTITUTE GOODS,
TECHNOLOGY, SERVICES, OR RIGHTS; OR (IV) FOR AMOUNTS IN
EXCESS OF THOSE RECEIVED BY LEGATO FOR THE PARTICULAR
LEGATO SOFTWARE THAT CAUSED THE LIABILITY. Because some
jurisdictions do not allow the exclusion or limitation of incidental or
consequential damages, LEGATO's liability in such jurisdictions shall be
limited to the extent permitted by law.
8. TERM AND TERMINATION
8.1 Term. The term of this EULA is perpetual unless terminated in accordance
with its provisions.
8.2 Termination. LEGATO may terminate this EULA, without notice, upon
Licensee's breach of any of the provisions hereof.
8.3 Effect of Termination. Upon termination of this EULA, Licensee agrees
to cease all use of the Software and to return to LEGATO or destroy the
Software and all Documentation and related materials in Licensee's
possession, and so certify to LEGATO. Except for the License granted herein
and as expressly provided herein, the terms of this EULA shall survive
termination.
9. MISCELLANEOUS
9.1 Governing Law. This EULA shall be governed by the laws of the
Commonwealth of Massachusetts, without regard to the principles of conflict
of laws or the United Nations Convention on Contracts for the International
Sale of Goods.
9.2 Government Restricted Rights. Any Software which is acquired directly
or indirectly for or on behalf of the United States of America, its agencies
and/or instrumentalities (“U.S. Government”), is provided with Restricted
Rights. Use, duplication, or disclosure by the U.S. Government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical
Data and Computer Software clause at DFARS 252.227-7013 or
subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at 48 CFR 52.227-19, as applicable. Manufacturer is
LEGATO Software, a division of EMC Corporation, 2350 W. El Caiman Real,
Mountain View, CA 94040. The Software is a commercial software product,
licensed on the open market at market prices, and was developed entirely at
private expense and without the use of any government funds.
9.3 Export and Import Controls. Regardless of any disclosure made by
Licensee to LEGATO of an ultimate destination of the Products, Licensee may
not directly or indirectly export or transfer any portion of the Software, or any
system containing a portion of the Software, to anyone outside the United
States (including further export if Licensee took delivery outside the U.S.)
without first complying with any export or import controls that may be
imposed on the Software by the U.S. Government or any country or
organization of nations within whose jurisdiction Licensee operates or does
business. Licensee shall at all times strictly comply with all such laws,
regulations, and orders, and agrees to commit no act which, directly or
indirectly, would violate any such law, regulation or order.
9.4 Assignment. This EULA may not be assigned or transferred by Licensee
without the prior written consent of LEGATO, which shall not be
unreasonably withheld. LEGATO may assign or otherwise transfer any or all
of its rights and obligations under this EULA upon notice to Licensee.
9.5 Sole Remedy and Allocation of Risk. Licensee's sole and exclusive
remedies are set forth in this EULA. This EULA defines a mutually
agreed-upon allocation of risk, and the License price reflects such allocation
of risk.
9.6 Equitable Relief. The parties agree that a breach of this EULA adversely
affecting LEGATO's intellectual property rights in the Software may cause
irreparable injury to LEGATO for which monetary damages may not be an
adequate remedy and LEGATO shall be entitled to equitable relief in addition
to any remedies it may have hereunder or at law.
9.7 No Waiver. Failure by either party to enforce any provision of this EULA
will not be deemed a waiver of future enforcement of that or any other
provision, nor will any single or partial exercise of any right or power
hereunder preclude further exercise of any other right hereunder.
9.8 Severalties. If for any reason a court of competent jurisdiction finds any
provision of this EULA, or portion thereof, to be unenforceable, that
provision of the EULA will be enforced to the maximum extent permissible
so as to effect the intent of the parties, and the remainder of this EULA will
continue in full force and effect.
10. ENTIRE EULA
10.1 This EULA sets forth the entire understanding and EULA between the
parties and may be amended only in a writing signed by authorized
representatives of both parties. No vendor, distributor, reseller, dealer,
retailer, sales person, or other person is authorized by LEGATO to modify this
EULA or to make any warranty, representation, or promise which is different
than, or in addition to, the warranties, representations, or promises made in
this EULA. No pre-printed purchase order terms shall in any way modify,
replace or supersede the terms of this EULA.
Contents
Preface..................................................................................................................... 10.
Audience....................................................................................................................................... 10.
Product Documentation ................................................................................................................ 10.
Conventions.................................................................................................................................. 11.
Information and Services .............................................................................................................. 12.
General Information ............................................................................................................... 12.
Technical Support .................................................................................................................. 12.
Licensing and Registration..................................................................................................... 13.
Customer Feedback ..................................................................................................................... 13.
Chapter 1: Introduction.......................................................................................... 14.
About the LEGATO NetWorker Product ....................................................................................... 14.
NetWorker Client.................................................................................................................... 15.
NetWorker Storage Node....................................................................................................... 15.
NetWorker Server .................................................................................................................. 15.
LEGATO License Manager .................................................................................................... 16.
Supported Devices ....................................................................................................................... 16.
Enabler Codes.............................................................................................................................. 16.
Related Documentation ................................................................................................................ 16.
Chapter 2: Installing NetWorker Software on Linux for Intel x86 ...................... 17.
Software Installation Roadmap..................................................................................................... 17.
Installation Requirements ............................................................................................................. 18.
General Requirements ........................................................................................................... 18.
Client Software....................................................................................................................... 18.
System Requirements ..................................................................................................... 18.
Client Backup and Recovery Guidelines ......................................................................... 19.
Storage Node Software.......................................................................................................... 19.
Server Software ..................................................................................................................... 19.
System Requirements ..................................................................................................... 20.
Directories and Pathnames ............................................................................................. 21.
Updating from a Previous Release ............................................................................................... 22.
Task 1: Prepare to Update the NetWorker Software on the NetWorker Server..................... 22.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
5
Contents
Task 2: Update the NetWorker Software ............................................................................... 22.
Installing the NetWorker Software ................................................................................................ 23.
Task 1: Access the NetWorker Software ............................................................................... 24.
From a Local CD-ROM .................................................................................................... 24.
From a Remote CD-ROM ................................................................................................ 24.
From the LEGATO Web Site ........................................................................................... 25.
Task 2: Install the NetWorker Software.................................................................................. 25.
Installing to the Default Location...................................................................................... 25.
Client Installation....................................................................................................... 26.
Storage Node Installation.......................................................................................... 26.
Server Installation ..................................................................................................... 27.
Installing to a Nondefault Location................................................................................... 28.
Task 3: Change the NetWorker Servers with Access to a Client ........................................... 29.
Task 4: Start the NetWorker Daemons .................................................................................. 29.
Verifying the Installation ............................................................................................................... 30.
Ensuring that the NetWorker Software Starts ........................................................................ 30.
How to Start the NetWorker Administrator Program........................................................ 30.
Performing a Test Backup...................................................................................................... 31.
Uninstalling the NetWorker Software............................................................................................ 32.
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor ..... 34.
Software Installation Roadmap..................................................................................................... 34.
Installation Requirements ............................................................................................................. 35.
General Requirements ........................................................................................................... 35.
Client Software....................................................................................................................... 35.
System Requirements ..................................................................................................... 35.
Client Backup and Recovery Guidelines ......................................................................... 36.
Storage Node Software.......................................................................................................... 36.
Server Software ..................................................................................................................... 36.
System Requirements ..................................................................................................... 36.
Installation Guidelines...................................................................................................... 37.
Directories and Pathnames ............................................................................................. 37.
Installing the NetWorker Software ................................................................................................ 38.
Task 1: Access the NetWorker Software ............................................................................... 38.
From a Local CD-ROM .................................................................................................... 39.
From a Remote CD-ROM ................................................................................................ 39.
From the LEGATO Web Site ........................................................................................... 39.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
6
Contents
Task 2: Install the NetWorker Software.................................................................................. 40.
Installing to the Default Location...................................................................................... 40.
Client Installation....................................................................................................... 41.
Storage Node Installation.......................................................................................... 41.
Server Installation ..................................................................................................... 42.
Installing to a Nondefault Location................................................................................... 42.
Task 3: Change the NetWorker Servers with Access to a Client ........................................... 43.
Task 4: Start the NetWorker Daemons .................................................................................. 44.
Verifying the Installation ............................................................................................................... 44.
Starting the NetWorker Administrator Program...................................................................... 44.
Performing a Test Backup...................................................................................................... 45.
Uninstalling the NetWorker Software............................................................................................ 46.
Chapter 4: Installing NetWorker Software in a LAAM Environment .................. 47.
Software Installation Roadmap..................................................................................................... 48.
Installation Requirements ............................................................................................................. 48.
Software Requirements.......................................................................................................... 48.
Hardware Requirements ........................................................................................................ 48.
Configuration Options ............................................................................................................ 49.
System Information Requirements......................................................................................... 49.
Installing a NetWorker Virtual Server ........................................................................................... 50.
Task 1: Install the NetWorker Software in a Cluster .............................................................. 50.
Task 2: Define the NetWorker Server as a Highly Available Application ............................... 50.
Task 3: Grant Access to the NetWorker Virtual Server.......................................................... 51.
Task 4: Configure the NetWorker Server ............................................................................... 53.
Task 5: Configure Clients under the NetWorker Server......................................................... 53.
Task 6: Register NetWorker Licenses for Virtual Server Failover.......................................... 54.
Installing Only the NetWorker Client Software in a Cluster .......................................................... 55.
Task 1: Install the NetWorker Cluster Client Software ........................................................... 55.
Task 2: Configure NetWorker Client Software as a Highly Available Application .................. 55.
Task 3: Define the List of Trusted NetWorker Servers........................................................... 56.
Task 4: Configure Clients under the NetWorker Server......................................................... 56.
Configuring an External Client to a Virtual Server ........................................................................ 57.
Defining Ownership of a Raw Partition for Virtual Clients ............................................................ 58.
Tracking Scheduled Saves ........................................................................................................... 58.
Uninstalling the NetWorker Software............................................................................................ 59.
NetWorker Cluster Script .............................................................................................................. 59.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
7
Contents
Chapter 5: Autochanger Configuration ................................................................ 61.
Supported Vendor-Specific ASC and ASCQ Codes..................................................................... 61.
Detecting the Autochanger ........................................................................................................... 62.
Configuring the Hardware and Kernel to Enable Autochanger Detection .............................. 62.
Configuring the Autochanger ................................................................................................. 63.
Testing the Autochanger Connection ........................................................................................... 66.
The jbconfig Command Output .............................................................................................. 66.
Chapter 6: Evaluating and Licensing NetWorker Software ................................ 68.
How NetWorker Software Is Licensed .......................................................................................... 68.
The Evaluation Process................................................................................................................ 69.
Evaluating a New Installation ................................................................................................. 69.
Evaluating Features on an Existing Installation ..................................................................... 69.
How to Enter a Temporary Enabler Code........................................................................ 69.
The Licensing Process ................................................................................................................. 70.
Task 1: Enter the License Enabler Code ............................................................................... 70.
Task 2: Obtain an Authorization Code ................................................................................... 71.
Using the LEGATO Web Site .......................................................................................... 71.
By Fax or E-mail .............................................................................................................. 71.
Task 3: Enter the Authorization Code .................................................................................... 72.
NetWorker Licenses ..................................................................................................................... 73.
Multiplatform Licensing .......................................................................................................... 73.
Example: Multiplatform Licensing Schemes .................................................................... 74.
Update Enablers .................................................................................................................... 74.
Required Update Enablers .............................................................................................. 74.
Additional Licenses ................................................................................................................ 75.
Client Connection Licenses ............................................................................................. 75.
Storage Nodes................................................................................................................. 75.
LEGATO NetWorker Application Modules....................................................................... 75.
Cluster Clients ................................................................................................................. 75.
NDMP Licensing .............................................................................................................. 75.
Managing LEGATO Licenses ....................................................................................................... 76.
Appendix A: Sample stinit.def File ....................................................................... 77.
Usage ........................................................................................................................................... 77.
Examples of the stinit File............................................................................................................. 77.
SONY AIT-3 ........................................................................................................................... 78.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
8
Contents
Noncompressing DAT (DDS-1).............................................................................................. 78.
Compressing DAT (DDS-1-DC or DDS-[234]) ....................................................................... 78.
QIC-150 Drive ........................................................................................................................ 78.
QIC-320/525 Drive ................................................................................................................. 79.
Exabyte 8505 and Other Similar 8 mm Helical Scan Drivers................................................. 79.
Reel-to-Reel Tape with 6250/1600/800 bpi Densities............................................................ 79.
Appendix B: stinit(8) Man Page............................................................................. 80.
Synopsis ....................................................................................................................................... 80.
Description.................................................................................................................................... 80.
Options ......................................................................................................................................... 80.
The Devices Being Initiated .......................................................................................................... 81.
Return Value................................................................................................................................. 83.
Restrictions ................................................................................................................................... 83.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
9
Preface
This guide provides instructions on how to install the LEGATO NetWorker® software.
After installing the NetWorker™ software, refer to the LEGATO NetWorker, Release 7.2,
UNIX and Linux Version Administrator’s Guide and the program’s Online Help for
detailed instructions on how to configure, administer, and use the NetWorker
software.
Post-release information is contained in the Release Supplement for this product. This
document is available on the LEGATO web site at www.legato.com. Refer to the web site
periodically to view the latest Release Supplement.
Audience
The information in this guide is intended for system administrators who are
responsible for installing software and maintaining the servers and clients on a
network. Operators who monitor the daily backups may also find this manual useful.
Product Documentation
For a complete list of documentation related to this product, see "Related
Documentation" on page 16. Most of the documents are Adobe Acrobat PDFs, and can
be viewed by downloading and installing the Adobe Acrobat Reader. The Reader is
available in the /viewers/acroread directory on the LEGATO® Documentation Suite
CD-ROM, or directly from Adobe. To install and use the Reader on the preferred
platform, refer to the instructions in the CD-ROM’s /viewers/acroread/readme.txt file or
at the Adobe web site.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
10
Preface
Conventions
This document uses the following typographic conventions and symbols to make
information easier to access and understand.
Convention
Indicates
Example
boldface
Names of line commands,
daemons, options, programs,
or scripts
The nsradmin command starts the command
line version of the NetWorker Administrator
program.
italic in text
Pathnames, filenames,
computer names, new terms
defined in the Glossary or
within the chapter, or
emphasized words
Displayed messages are also written to
/nsr/logs/daemon.log.
italic in command
line
A variable that must be
provided in the command line
nwadmin -s server_name
fixed-width
Examples and information
displayed on the screen
media waiting: recover waiting for 8mm
5GB tape volume name
fixed-width,
boldface
Commands and options that
must be entered exactly as
shown
nsr_shutdown -a
Menu_Name>
Command
A path or an order to follow for Volume>Change Mode>Appendable
making selections in the user
interface
Important:
Information that must be read
and followed to ensure
successful backup and
recovery of data
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
The specifications are created, one for each swap
file, in c:\pagefile.sys.
Important: Use the no_verify option with
extreme caution.
11
Preface
Information and Services
LEGATO offers a variety of methods (including e-mail, telephone, and fax support) to
obtain company, product, and technical information.
General Information
The LEGATO web site provides most of the information that customers might need,
including technical bulletins and binary patches from its FTP site. For specific sales or
training needs, e-mail or call LEGATO.
Service or Resource
Technical
Bulletins
Binary
Patches
Company
and Product
Information
Training
www.legato.com
Yes
Yes
Yes
Yes
ftp.legato.com
(log in as anonymous)
Yes
Yes
LEGATO Sales
(650) 210-7000 (option 1)
[email protected]
LEGATO Education Services
(650) 842-9357
[email protected]
Yes
Yes
Technical Support
The LEGATO web site provides contact information, software patches, technical
documentation, and information about available support programs.
•
•
Customers with an active support agreement have access to the LEGATO
integrated product knowledge base. Help with software issues is also available
through Technical Support.
Customers without an active support agreement can contact Support Sales and
Renewal to purchase annual software update subscriptions, or technical support
services for per-update/per-incident assistance.
Note: LEGATO Software technical support and update subscription services apply
only to (i) LEGATO price-listed software that LEGATO supplies to its customers; and
(ii) customers that have entered into an authorized LEGATO technical support
agreement.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
12
Preface
Licensing and Registration
To license and register products, go to the licensing web site. To change contact
information, transfer licenses, or ask questions about licensing, contact LEGATO by
using one of the following methods.
Licensing and Registration
Contact
Telephone number
(650) 812 6000 (option 3, option 2)a
+31 23 554 8881b
Fax number
(650) 745-1477a
+31 23 554 8808b
E-mail
[email protected]
[email protected]
a. Contact information for the Americas, Asia, and the Pacific.
b. Contact information for Europe, the Middle East, and Africa.
Customer Feedback
LEGATO welcomes comments and suggestions about software features, the
installation procedure, and its documentation.
•
•
•
To comment on a particular guide, complete the Comments form at
www.legato.com. Navigate to the documentation page and click the Comments link
beside the name of the guide. All comments are reviewed and acted upon, usually
within one business day.
To help improve our documentation in general, complete a brief survey at
www.legato.com. Navigate to the documentation page and click the link to the
survey.
To provide other suggestions and comments, send e-mail to [email protected].
Although LEGATO cannot respond personally to every request, all comments
and suggestions are considered during product design.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
13
Chapter 1: Introduction
This chapter provides background information on LEGATO NetWorker software and
supported devices. It includes the following sections:
•
•
•
•
"About the LEGATO NetWorker Product" on page 14
"Supported Devices" on page 16
"Enabler Codes" on page 16
"Related Documentation" on page 16
About the LEGATO NetWorker Product
The LEGATO NetWorker product is a suite of storage management software that
provides backup, recovery, and other services to computers with a wide variety of
operating systems and data types. NetWorker products for different operating systems
are interoperable, which provides flexibility in designing a storage management setup
that works best with your current computing environment.
The NetWorker software is distributed in the following formats:
•
•
In a media kit of CD-ROMs that contain the software and electronic
documentation for several related LEGATO products.
As a downloadable archive file from the LEGATO web site.
The NetWorker product has four major components:
•
•
•
•
NetWorker client
NetWorker storage node
NetWorker server
LEGATO License Manager
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
14
Chapter 1: Introduction
NetWorker Client
The NetWorker client software communicates with the NetWorker server and provides
recover and on-demand backup functionality. You install the NetWorker client
software on all computers that you want to back up to the NetWorker server.
NetWorker clients do not have to be of the same operating system as the NetWorker
server. However, to back up clients of other operating systems, your NetWorker server
must have a ClientPak® enabler for that type of client. For example, the NetWorker
server for Solaris is allowed to back up NetWorker clients on the Solaris operating
system, but to back up NetWorker clients on another operating system, such as Linux
running on Intel x86, you must purchase and enter the ClientPak enabler for that
operating system.
NetWorker Storage Node
You can back up data directly to devices attached to either a NetWorker server or to a
NetWorker storage node. A storage node controls storage devices such as tape drives,
autochangers, and silos.
Storage nodes depend on the NetWorker server for the following functions:
•
•
•
•
Control over which clients use the storage node’s devices for backups
License management
Management of the client file indexes that track each client’s data
Management of the media database that tracks the data contained on each
volume
NetWorker storage nodes and the NetWorker server can use different operating
systems. For example, you can use a NetWorker storage node on a Solaris operating
system with a NetWorker server on an AIX operating system. However, the storage
node’s enabler on the server must be of the same edition (either Network Edition or
Power Edition) as the base enabler for the NetWorker server.
NetWorker Server
The NetWorker server software provides control and scheduling for NetWorker
operations. On the NetWorker server, you can:
•
•
•
•
•
•
Enter the enabler licenses for the NetWorker server and all the functions the
NetWorker server controls, such as autochanger modules, additional client
connections, and ClientPak licenses.
Define the clients, devices, and media that the NetWorker server controls.
Define the schedules for backups and other operations.
Monitor the results of backups and other operations.
Manage the client file indexes that track each client’s data.
Manage the media database that tracks the data contained on each volume.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
15
Chapter 1: Introduction
LEGATO License Manager
The LEGATO License® Manager provides a central place for managing the licenses of
all your NetWorker clients and servers. Instead of managing licenses separately, you
can maintain all your NetWorker licenses from a single computer. Installation of the
License Manager is an option when installing the NetWorker software.
Supported Devices
LEGATO NetWorker software supports a variety of media types and devices, either
stand-alone or in an autochanger or silo tape library. Devices can be attached to a
NetWorker server or a designated storage node. To obtain the latest list of supported
devices, refer to the LEGATO Compatibility Guides on the LEGATO web site.
You must use a nonrewinding device for NetWorker backups. If you use a file device,
you must enter it as a directory path (the same as for other device types) rather than as
just a filename.
This NetWorker product uses the following naming standard to indicate a
nonrewinding device:
no_rewind_example=/dev/nst0
Note: The term “autochanger” refers to a variety of backup devices: autoloader,
carousel, datawheel, jukebox, library, and near-line storage.
Enabler Codes
Enabler codes (licenses), which activate the functionality of NetWorker software and
other LEGATO software, are sold separately. For more information, see
"Chapter 6: Evaluating and Licensing NetWorker Software" on page 68.
Related Documentation
For further information about LEGATO NetWorker software for UNIX, refer to the
following related documentation:
•
•
•
•
•
•
NetWorker, Release 7.2, UNIX and Linux Version Administrator’s Guide
NetWorker, Release 7.2, UNIX and Linux Version Release Supplement
NetWorker, Release 7.2, Multiplatform Version, Disaster Recovery Guide
LEGATO Command Reference Guide
LEGATO Software Compatibility Guide
UNIX man pages
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
16
Chapter 2: Installing NetWorker Software on Linux
for Intel x86
This chapter explains how to install the NetWorker software on Linux for Intel x86
processors. It contains the following sections:
•
•
•
•
•
•
"Software Installation Roadmap" on page 17
"Installation Requirements" on page 18
"Updating from a Previous Release" on page 22
"Installing the NetWorker Software" on page 23
"Verifying the Installation" on page 30
"Uninstalling the NetWorker Software" on page 32
Software Installation Roadmap
Use the following roadmap when installing the NetWorker software. Read the
roadmap and the referenced sections before installing the software.
1. Review the requirements section and note the default directory location and space
requirements for the software installation file. For more information, see
"Installation Requirements" on page 18.
2. If there is an earlier release of NetWorker software installed, update the software.
For more information, see "Updating from a Previous Release" on page 22.
3. Install the required NetWorker software. For more information, see "Installing the
NetWorker Software" on page 23.
4. Install the device driver software for the NetWorker server and any storage nodes,
and configure the system as necessary. For more information, refer to the
following:
•
•
"Chapter 5: Autochanger Configuration" on page 61.
The autochanger and silo chapters in the NetWorker Administrator’s Guide.
5. Enable and register all NetWorker products. For more information,
see"Chapter 6: Evaluating and Licensing NetWorker Software" on page 68.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
17
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Installation Requirements
The following sections provide information on the system requirements for the
different components being installed:
•
•
•
•
"General Requirements" on page 18
"Client Software" on page 18
"Storage Node Software" on page 19
"Server Software" on page 19
Note: NetWorker software does not support locales (defined by the operating system)
or code sets that remap characters that have special meaning for filesystems.
Depending on the filesystem, these special characters might include the forward slash
(/), the backslash (\), the colon (:), or the period(.). An example of one locale is
De_DE.646. For detailed information, refer to the NetWorker Administrator’s Guide.
General Requirements
The following are general NetWorker installation requirements:
•
•
•
All NetWorker servers, clients, and storage nodes must have TCP/IP installed,
configured, and networked.
The designated server name that the NetWorker software requests must be the
hostname of the backup server.
The TCP/IP hostname must be identical to the computer name. Do not include an
underscore character (_) in the computer name.
Client Software
The following sections describe NetWorker installation requirements and
recommendations for Linux client software:
•
•
"System Requirements" on page 18
"Client Backup and Recovery Guidelines" on page 19
System Requirements
If the client software is being installed as part of the server installation, use the same
installation media and methods. The space requirements remain the same.
If only the NetWorker client software for Linux is being installed, purchase the
LEGATO NetWorker ClientPak for Linux with a separate enabler code. The NetWorker
for Linux software is licensed as a separate platform.
Important: If client computers have a previous release of the NetWorker ClientPak for
Linux installed, update those clients to the latest NetWorker release to fully exercise all
the features in the software. When the installation identifies an existing NetWorker
client package for Linux, it prompts for permission to update the client. The update
process removes the existing NetWorker client and man pages and it installs the new
version of the NetWorker client software.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
18
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Before installing the client software, review "Server Software" on page 19 for other
relevant requirements and recommendations, which include supported software,
hardware, and directory information.
Guidelines specific to the indexes and storage do not apply to a client installation.
Adobe Acrobat software and documentation are optional.
Client Backup and Recovery Guidelines
A client can be configured to use the NetWorker software to access the NetWorker
server in one of two ways:
•
•
Install the NetWorker client program directly on the local disk.
Configure the client with a directory on the network filesystem (NFS) on the
remote system where the NetWorker programs are located.
To back up a NetWorker client, the nsrexecd daemon must be active on the client. To
start the nsrexecd daemon, enter the following command:
/etc/init.d/networker start
Storage Node Software
A storage node is a computer with at least one attached storage device or autochanger.
A NetWorker storage node must have both the NetWorker client software and the
storage node software installed.
Each storage node requires a client connection license. A dedicated storage node,
which allows the storage node to back up only itself, is licensed separately.
Before installing the storage node software, review "Server Software" on page 19 for
other relevant requirements and recommendations. These include supported software
and hardware, and directory information. Guidelines specific to the indexes and media
databases do not apply to a storage node installation. Adobe Acrobat software and
documentation are optional.
Storage devices must be supported by a NetWorker server. The NetWorker software
also supports a wide variety of devices attached to a NetWorker server or a designated
storage node, either as a stand-alone device or in an autochanger. For a list of
supported devices, refer to the LEGATO Compatibility Guides available at the
LEGATO web site.
Server Software
The following sections describe NetWorker installation requirements and
recommendations for a Linux server:
•
•
"System Requirements" on page 20
"Directories and Pathnames" on page 21
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
19
Chapter 2: Installing NetWorker Software on Linux for Intel x86
System Requirements
Table 1 on page 20 lists the Linux distributions supported in release 7.2 of NetWorker
server software on Linux for Intel x86, along with package requirements for each of the
installations.
Important: Make sure the kernel is supported and that all of the required packages and
patches are installed before beginning the NetWorker software installation. For
additional information, refer to the Linux distribution software documentation or
other Linux documentation sources.
Table 1. Software Requirements by Supported Linux Distribution
Linux Distribution
Kernel
Additional Modules, Libraries, or Upgrades
Red Hat 7.1
2.4.2-2
Upgrade the following packages:
• rpm-build-4.0.3-0.66.i386.rpm
• rpm-devel-4.0.3-0.66.i386.rpm
• rpm-4.0.3-0.66.i386.rpm
• glibc-2.2.3-14.i386.rpm
• glibc-common-2.2.3-14.i386.rpm
• glibc-devel-2.2.3-14.i386.rpm
Red Hat Advanced Server
Edition 2.1
2.4.9-e.3
pdksh-5.2.14-13.i386.rpm
Red Hat Enterprise Linux 3
2.4.21-4.EL
pdksh-5.2.14-21.i386.rpm
Red Hat 7.2
2.4.7-10
pdksh-5.2.14-13.i386.rpm
Red Hat 7.3
2.4.18-3
pdksh-5.2.14-16.i386.rpm
Red Hat 8
2.4.18-1
pdksh-5.2.14-19.i386.rpm
Red Hat 9
2.4.20-8
pdksh-5.2.14-21.i386.rpm
SuSE 8.2
2.4.20-4GB
pdksh-5.2.14-580.i386.rpm
SuSE Linux Enterprise Server 8
2.4.19-4GB
pdksh-5.2.14-532.i386.rpm
Note: Red Hat 7.1 is the only
Linux distribution that supports
NetWorker on Linux x86 in a
cluster environment.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
20
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Table 2 on page 21 lists the minimum memory and storage requirements for the
NetWorker server for Linux software. Additionally, because the client file index and
media database that a NetWorker server generates can grow large over time, the
NetWorker server needs enough free storage space to accommodate these indexes.
Table 2. Hardware Requirements for NetWorker Server
Requirement
Value
Recommended RAM
128 MB
Disk storage for software
120 MB
Online indexes
5% of total backup data (allowing for up to three times the index size
during software update conversion)
Install the appropriate storage devices, including SCSI adapter, cabling, termination,
and driver software prior to installing the NetWorker server. The NetWorker
installation program assumes that the storage devices have been properly installed
and configured, and that the operating system recognizes the devices.
For a list of the currently supported devices, refer to the LEGATO Compatibility
Guides on the LEGATO web site.
Directories and Pathnames
The following pathnames and directories are required for installation:
•
•
•
A directory on the server large enough for the NetWorker client and server
indexes and media database (usually /nsr).
The system pathname of at least one storage device for use by the NetWorker
server to back up and recover files.
A directory for the PDF documentation files and for Adobe Acrobat Reader if it is
not already installed.
Table 3 on page 21 lists the default directories that the NetWorker installation program
creates.
Table 3. Default Locations and Space Requirements (Part 1 of 2)
Software and Documentation Files
NetWorker Server
Default Location
Space Needed
NetWorker Administrator program and NetWorker Client /usr/bin
program files
17 MB
NetWorker daemon and utility command files
/usr/sbin
72 MB
Device drivers
/usr/lib/nsr
6 MB
Online client file and server indexes; media database
/nsr
4 MB
License Manager files
/usr/sbin
/usr/nsr/lic/res
/nsr/lic/res
2 MB
22 KB
21 KB
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
21
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Table 3. Default Locations and Space Requirements (Part 2 of 2)
Software and Documentation Files
NetWorker Server
Default Location
Space Needed
NetWorker man pages
/usr/share/man
2 MB
PDF files
optional
varies
Updating from a Previous Release
Use the following roadmap to update the NetWorker software:
•
•
"Task 1: Prepare to Update the NetWorker Software on the NetWorker Server" on
page 22
"Task 2: Update the NetWorker Software" on page 22
Task 1: Prepare to Update the NetWorker Software on the NetWorker Server
To update from a previous release of NetWorker software:
1. Back up all client file indexes and generate a bootstrap for the server.
If a current bootstrap and backup of all client file indexes does not exist, perform
scheduled backups on all clients before updating to the next NetWorker release.
For example, to save bootstrap information, enter the following command:
savegrp -O group
Note: Ensure that all clients are included in the groups being backed up.
2. Record the latest bootstrap save set ID and its associated volume label. To obtain
this information, enter the following command:
mminfo -B
3. If the NetWorker software is not currently installed in the default location, record
the location of the client file indexes.
Task 2: Update the NetWorker Software
To update the NetWorker software on the NetWorker client, storage node and server:
1. Keep a copy of the current configuration.
2. Shut down the NetWorker software, as follows:
nsr_shutdown
3. Uninstall the previous NetWorker release, but do not remove the client file indexes,
the resource files, or the media database. For information, see "Uninstalling the
NetWorker Software" on page 32.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
22
Chapter 2: Installing NetWorker Software on Linux for Intel x86
4. Install the new release of the NetWorker software. For information, see "Installing
the NetWorker Software" on page 23.
Important: Do not start the NetWorker daemons.
5. Apply any required NetWorker software patches.
6. Restart the NetWorker software by running the NetWorker startup script:
/etc/init.d/networker start
The media database and the client file index are converted automatically.
Client file index conversion can be enhanced by running multiple instances of the
nsrck program concurrently. This process converts multiple client file indexes in
parallel.
To convert multiple client file indexes in parallel, perform one of the following:
• Specify the client file index to convert. For example:
nsrck client_name
• Enter the nsrck command without a client name. This initiates the conversion
of the next client in the list.
Each instance of nsrck running occupies a portion of the server’s processing,
memory, and space-swapping capability. Balance the speed of the index
conversion against other NetWorker server needs. Monitor system
performance by using a diagnostic tool to determine the optimum number of
nsrck instances to launch.
7. Once the media database is converted, scheduled backups can be run. These
backups, however, are not browsable until the associated client is converted.
8. Enable and register the NetWorker software. For information, see
"Chapter 6: Evaluating and Licensing NetWorker Software" on page 68.
Installing the NetWorker Software
The following sections explain how to install the NetWorker software:
•
•
•
•
"Task 1: Access the NetWorker Software" on page 24
"Task 2: Install the NetWorker Software" on page 25
"Task 3: Change the NetWorker Servers with Access to a Client" on page 29
"Task 4: Start the NetWorker Daemons" on page 29
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
23
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Task 1: Access the NetWorker Software
To access NetWorker software:
•
•
•
"From a Local CD-ROM" on page 24
"From a Remote CD-ROM" on page 24
"From the LEGATO Web Site" on page 25
Important: The evaluation version of NetWorker software contains tarred and
compressed versions of the NetWorker software distribution files. Make sure that there
is adequate disk space for both the compressed download file (about 60 MB) and the
fully uncompressed files (about 60 MB).
From a Local CD-ROM
To access NetWorker software from a local CD-ROM:
1. Log in as root on the computer where the NetWorker software is being installed.
2. Mount the CD-ROM.
3. Locate the /linux_x86 directory on the installation CD-ROM.
4. On both the NetWorker server and client, set the PATH environment variable for
user root to contain the directory where the NetWorker executables reside. For
information on this directory, see Table 3, "Default Locations and Space
Requirements," on page 21.
From a Remote CD-ROM
To access NetWorker software from a remote CD-ROM:
1. On the remote system:
a. Insert the CD-ROM into the remote system’s drive.
b. Mount the CD-ROM on the remote system.
c. Make the CD-ROM exportable through NFS.
2. On the local system:
a. Log in as root on the computer where the NetWorker software is being
installed.
b. Create a mount point.
c. Mount the remote CD-ROM filesystem. For example:
mount -t nfs remote_host:mountpoint /cdrom/mount_dir
d. On both the NetWorker server and client, set the PATH environment variable
for user root to contain the directory where the NetWorker executables reside.
For information on this directory, see Table 3, "Default Locations and Space
Requirements," on page 21.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
24
Chapter 2: Installing NetWorker Software on Linux for Intel x86
From the LEGATO Web Site
To access NetWorker software from the LEGATO web site:
1. Log in as root on the computer where the NetWorker software is being installed.
2. Complete and submit the Evaluation Download Request page located at
http://www.legato.com/resources/downloads/index.cfm.
When the Evaluation Download Request page is completed and submitted, you
will receive an e-mail with the URL to download the NetWorker software.
3. Download the NetWorker evaluation software to a temporary directory.
4. Uncompress the downloaded software using the following command:
gunzip nw72_ncw10_linux_x86.tar.gz
5. Extract the uncompressed, tarred file using the following command:
tar -xvpBf nw72_ncw10_linux_x86.tar
The NetWorker distribution software directories and files are listed on the screen
as the extraction proceeds.
6. On both the NetWorker server and client, set the PATH environment variable for
the user root, to contain the directory where the NetWorker executables will be
installed, that is /usr/sbin. For information on this directory, see Table 3 on page 21.
Task 2: Install the NetWorker Software
By default, the NetWorker software is installed in the /usr directory; however, the
software can be installed in a different directory. If you have insufficient disk space on
the /usr partition, choose another location to install the software.
Follow the instructions in one of the following sections to install the software:
•
•
"Installing to the Default Location" on page 25
"Installing to a Nondefault Location" on page 28
Installing to the Default Location
To install the client, storage node, and server software to the default location, see the
following sections:
•
•
•
"Client Installation" on page 26
"Storage Node Installation" on page 26
"Server Installation" on page 27
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
25
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Important: Before installing the NetWorker client software with Red Hat Linux 8,
manually set the RPM_INSTALL_PREFIX environment variable to /usr.
For example:
# RPM_INSTALL_PREFIX=/usr; export RPM_INSTALL_PREFIX
# rpm -ivh lgtoclnt-7.2-1.i686.rpm
If the RPM_INSTALL_PREFIX environment variable is not set, the installation will fail.
For more information about the Red Hat Linux 8 RPM, refer to the Red Hat web site.
Client Installation
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
To install the NetWorker software on the computer designated as the NetWorker client:
1. Log in to the NetWorker Linux client.
2. Change directories to the temporary directory created for downloading and
extracting the software.
3. Enter the following command:
rpm -ivh lgtoclnt-7.2-1.i686.rpm
4. (Optional) To install the man pages, enter the following command:
rpm -ivh lgtoman-7.2-1.i686.rpm
Storage Node Installation
To install the NetWorker storage node software:
•
•
Install the NetWorker for Linux client and storage node software on the
computers designated as storage nodes if you purchased an enabler for storage
node support.
The storage node package must be installed on the NetWorker server, regardless
of whether separate systems are used as designated storage nodes. For
instructions, see "Server Software" on page 19.
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
26
Chapter 2: Installing NetWorker Software on Linux for Intel x86
To install the required software:
1. Enter the following command to install the client, driver, and storage node
packages:
rpm -ivh lgtoclnt-7.2-1.i686.rpm lgtodrvr-7.2-1.i686.rpm
lgtonode-7.2-1.i686.rpm
2. (Optional) To install the man pages, enter the following command:
rpm -ivh lgtoman-7.2-1.i686.rpm
3. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
4. Configure the driver software to provide support for NetWorker software to back
up data to the SCSI storage devices attached to the system. For more information,
see "Chapter 5: Autochanger Configuration" on page 61.
Server Installation
On the computer designated as the NetWorker server, install all the NetWorker
software packages in the following order: client, device driver, storage node, server.
The License Manager software can be installed at any point in this sequence after the
client package is installed.
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
To install the software:
1. Enter the following commands to install the client, device driver, storage node,
server, and License Manager software:
rpm -ivh lgtoclnt-7.2-1.i686.rpm lgtodrvr-7.2-1.i686.rpm
lgtonode-7.2-1.i686.rpm lgtoserv-7.2-1.i686.rpm
lgtolicm-7.2-1.i686.rpm
Note: Installing the License Manager software is optional. It can be installed any
time after the client software.
2. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
3. (Optional) To install the man pages, enter the following command:
rpm -ivh lgtoman-7.2-1.i686.rpm
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
27
Chapter 2: Installing NetWorker Software on Linux for Intel x86
The NetWorker software installation modifies the following system files during
installation. To keep a copy of the current configuration, save the following original
files:
•
•
•
/etc/rpc
/etc/syslog.conf
/etc/ld.so.conf
The following files are added during the installation process:
•
•
•
•
/etc/init.d/networker
/etc/init.d/rc3.d/S95networker
/etc/init.d/rc5.d/S95networker
/etc/init.d/rc0.d/K05networker
Installing to a Nondefault Location
By default, the NetWorker software is installed in the /usr directory. If there is
insufficient disk space on the /usr partition, relocate the NetWorker packages to a
specified directory on another partition. For information about directories and space
requirements, see "Default Locations and Space Requirements" on page 21.
To install the NetWorker software to a nondefault location:
1. Change directories to the temporary directory created for downloading the
software.
2. Enter the following command to install the NetWorker client, device driver,
storage node, server, and License Manager software:
rpm -ivh --relocate old path=new path lgtoclnt-7.2-1.i686.rpm
lgtodrvr-7.2-1.i686.rpm lgtonode-7.2-1.i686.rpm
lgtoserv-7.2-1.i686.rpm
Note: The storage node software can be installed any time after the client software
is installed. Installing the License Manager software is optional. It can be installed
any time after the client software is installed.
3. Modify the root PATH variable to designate the /usr/bin, /usr/sbin, and /usr/lib/nsr
subdirectories of the directory just created.
For example, if you relocated the /usr/bin directory to a new directory called
/backup, you would enter the following command to relocate the /sbin subdirectory:
/backup:/usr/sbin
Important: Installation to a nondefault location is not supported on Red Hat Linux 8.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
28
Chapter 2: Installing NetWorker Software on Linux for Intel x86
4. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
5. (Optional) To install the man pages, enter the following command:
rpm -ivh --relocate old path=new path lgtoman-7.2-1.i686.rpm
Task 3: Change the NetWorker Servers with Access to a Client
To limit the servers authorized to access a client, a list of trusted NetWorker servers can
be specified for a client in the /nsr/res/servers file. After installing the client, storage
node, and server software, use the following procedure to change the NetWorker
servers that are authorized to access a client.
To change the NetWorker servers that can access a client:
1. Enter the following command to shut down the NetWorker daemons:
nsr_shutdown
2. Edit or create the /nsr/res/servers file and add the NetWorker servers, one per line,
that require access to the client. The first entry in this file becomes the default
NetWorker server.
Important: If the /nsr/res/servers file is empty or does not exist, any NetWorker server is
authorized to:
• Access and back up the client
• Perform a directed recover to the client
3. If necessary, delete the -s option from the nsrexecd command that is invoked by
the boot-time startup file. Running nsrexecd with the -s option supersedes the
/nsr/res/servers file.
Task 4: Start the NetWorker Daemons
The NetWorker daemons must be started after the installation procedure:
1. Start the NetWorker daemons:
For all Linux platforms:
/etc/init.d/networker start
For Caldera Linux 3.1.1:
/etc/rc.d/init.d/networker start
2. Enter the following command to determine if the NetWorker daemons are started:
ps -ef | grep nsr
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
29
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Table 4 on page 30 lists the NetWorker daemons for each of the software components.
Table 4. NetWorker Daemons
NetWorker Installation Packages
NetWorker Daemons
NetWorker server
nsrd, nsrexecd, nsrindexd,
nsrmmdbd, nsrmmd
NetWorker client
nsrexecd
NetWorker storage node
nsrexecd, nsrmmd
Note: The NetWorker daemon nsrmmd is only present if one or more devices are
enabled.
Verifying the Installation
The following sections explain how to verify the installation:
•
•
"Ensuring that the NetWorker Software Starts" on page 30
"Performing a Test Backup" on page 31
Ensuring that the NetWorker Software Starts
The NetWorker software provides both a graphical user interface (NetWorker
Administrator program) and a command line interface. Use the NetWorker
Administrator program for the following procedures. To learn more about the
command line interface, refer to the nsradmin(8) man page.
How to Start the NetWorker Administrator Program
Use the NetWorker Administrator program to verify that NetWorker has been installed
correctly.
To start the NetWorker Administrator program, enter the following command:
nwadmin -s server_name &
If the NetWorker Administrator program does not open, check for the following:
•
•
The DISPLAY environment variable is set correctly.
The PATH environment variable contains the correct path to the NetWorker
programs:
– /usr/bin
– /usr/sbin
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
30
Chapter 2: Installing NetWorker Software on Linux for Intel x86
If the NetWorker Administrator program cannot connect to the specified server:
1. Enter the ps command to check that the required NetWorker daemons:
ps -ef | grep nsr
2. If the output does not list nsrd and nsrexecd as current processes, run the
following command to start the NetWorker daemons on the NetWorker server:
For all Linux platforms:
/etc/init.d/networker start
For Caldera Linux 3.1.1 only:
/etc/rc.d/init.d/networker start
Performing a Test Backup
To perform a test backup using stand-alone devices:
1. Configure a device on the NetWorker server. For more information, refer to the
NetWorkerAdministrator’s Guide.
2. Insert a volume into the configured device.
3. Label the volume in the Default label pool:
a. Select a device.
b. Select Label from the main window. The NetWorker Administrator program
displays the preconfigured label templates.
c. Select the Default pool and click OK.
4. Mount the volume in the drive by selecting Mount from the main window.
5. Configure the NetWorker client:
a. From the Clients menu, select Client Setup.
The Clients dialog box, appears.
b. For the Clients attribute, select the NetWorker server host.
c. For the Save Set attribute, specify the path of a single file that requires
backing up and click Change. For example, /etc/hosts.
d. Click Apply.
6. Test the group backup:
a. Select Group Control from the main window. The Group Control window
appears with the Default group highlighted.
b. Select Start.
7. To view the progress of the test backup, select Details from the Group Control
window.
Messages appear in the panels of the main window as the backup progresses.
8. To view the client file index entries, select Indexes from the main window.
These entries were created during the test backup. Entries under Save Sets indicate
what data was backed up.
If the test backup is not successful, refer to the troubleshooting information in the
NetWorker Administrator’s Guide, to determine the cause.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
31
Chapter 2: Installing NetWorker Software on Linux for Intel x86
Uninstalling the NetWorker Software
Use the rpm -e package_name command to uninstall individual NetWorker packages or
all of the NetWorker packages simultaneously. For information about using rpm, refer
to the rpm man page.
Important: The NetWorker software packages have dependencies on each other and
must be uninstalled in the following order: lgtowizd, lgtolicm, lgtoserv, lgtonode, lgtodrvr,
lgtoclnt. The man pages (lgtoman) and document files have no dependencies and can be
uninstalled any time.
The LGTOwizd package must be uninstalled before the LGTOclnt package. For more
information on the NetWorker configuration wizards, refer to the NetWorker Release
Supplement, Linux and UNIX Version.
To uninstall the NetWorker software packages:
1. Log in as root to the computer from which the software is being uninstalled.
2. Run a query to see which packages are installed:
rpm -qa | grep lgto
The packages appear in the following format, where 7.x is the release number and
-1 is appended by the RPM utility:
lgtowizd-1.0-1
lgtonode-7.2-1
lgtoclnt-7.2-1
lgtodrvr-7.2-1
lgtoserv-7.2-1
lgtoman-7.2-1
lgtolicm-7.2-1
3. Enter the rpm -e package_name command to uninstall the software.
•
•
To uninstall all the packages, enter:
rpm -e lgtowizd lgtolicm lgtoserv lgtonode lgtodrvr lgtoclnt
lgtoman
To uninstall packages individually, enter rpm -e followed by the specified
packages:
– For the NetWorker device configuration wizard, follow with
lgtowizd-1.0-1
– For License Manager, follow with lgtolicm-7.2-1
– For server software, follow with lgtoserv-7.2-1
– For storage node software, follow with lgtonode-7.2-1
– For device driver software, follow with lgtodrvr-7.2-1
– For client software, follow with lgtoclnt-7.2-1
– For NetWorker man pages, follow with lgtoman-7.2-1
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
32
Chapter 2: Installing NetWorker Software on Linux for Intel x86
For example, if NetWorker release 6.1 is installed and an update to NetWorker
release 7.2 is required, enter the following command to uninstall all NetWorker
packages:
rpm -e lgtolicm-6.1 lgtoserv-6.1 lgtonode-6.1 lgtodrvr-6.1
lgtoclnt-6.1 lgtoman-6.1
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
33
Chapter 3: Installing NetWorker Software on Linux
for Itanium Processor
This chapter explains how to install the NetWorker software on Linux for the Itanium
processor. It contains the following sections:
•
•
•
•
•
"Software Installation Roadmap" on page 34
"Installation Requirements" on page 35
"Installing the NetWorker Software" on page 38
"Verifying the Installation" on page 44
"Uninstalling the NetWorker Software" on page 46
Software Installation Roadmap
Use the following roadmap when installing the NetWorker software. Read the
roadmap and the referenced sections before installing the software.
1. Review the requirements section and note the default directory location and space
requirements for the software installation file. For more information, see
"Installation Requirements" on page 35.
2. Install the required NetWorker software. For more information, see "Installing the
NetWorker Software" on page 38.
3. Install the device driver for the NetWorker server and any storage nodes, and
configure the system as necessary. For more information, refer to the following:
•
•
"Chapter 5: Autochanger Configuration" on page 61.
The autochanger and silo chapters in the NetWorker Administrator’s Guide.
4. Enable and register all NetWorker products. For more information, see
"Chapter 6: Evaluating and Licensing NetWorker Software" on page 68.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
34
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Installation Requirements
The following sections provide information on the system requirements for the
different components being installed:
•
•
•
•
"General Requirements" on page 35
"Client Software" on page 35
"Storage Node Software" on page 36
"Server Software" on page 36
Note: NetWorker software does not support locales (defined by the operating system)
or code sets that remap characters that have special meaning for filesystems.
Depending on the filesystem, these special characters might include the slash (/), the
backslash (\), the colon (:), or the period(.). An example of one unsupported locale is
De_DE.646. For detailed information, refer to the NetWorker Administrator’s Guide.
General Requirements
The following are general NetWorker installation requirements:
•
•
•
All NetWorker servers, clients, and storage nodes must have TCP/IP installed,
configured, and networked.
The designated server name that the NetWorker software requests must be the
hostname of the backup server.
The TCP/IP hostname must be identical to the computer name. Do not include an
underscore character (_) in the computer name.
Client Software
The following sections describe NetWorker installation requirements and
recommendations for Linux client software:
•
•
"System Requirements" on page 35
"Client Backup and Recovery Guidelines" on page 36
System Requirements
If the client software is being installed as part of the server installation, use the same
installation media and methods. The space requirements remain the same.
If only the NetWorker client software for Linux is being installed, purchase the
LEGATO NetWorker ClientPak for Linux with a separate enabler code. The NetWorker
for Linux software is licensed as a separate NetWorker platform.
Before installing the client software, review "Server Software" on page 36 for other
relevant requirements and recommendations, which include supported software,
hardware, and directory information.
Guidelines specific to the indexes and storage do not apply to a client installation.
Adobe Acrobat software and documentation are optional.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
35
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Client Backup and Recovery Guidelines
A client can be configured to use the NetWorker software to access the NetWorker
server in one of two ways:
•
•
Install the NetWorker client program directly on the local disk.
Configure the client with a directory on the NFS on the remote computer where
the NetWorker programs are located.
To back up a NetWorker client, the nsrexecd daemon must be active on the client. To
start the nsrexecd daemon, enter the following command:
/etc/init.d/networker start
Storage Node Software
A storage node is a computer with at least one attached storage device or autochanger.
A NetWorker storage node must have both the NetWorker client software and the
storage node software installed.
Each storage node requires a client connection license. A dedicated storage node,
which allows the storage node to back up only itself, is licensed separately.
Before installing the storage node software, review "Server Software" on page 36 for
other relevant requirements and recommendations. These include supported software
and hardware, and directory information. Guidelines specific to the indexes and media
databases do not apply to a storage node installation. Adobe Acrobat software and
documentation are optional.
Storage devices must be supported by a NetWorker server. The NetWorker software
also supports a wide variety of devices attached to a NetWorker server or a designated
storage node, either as a stand-alone device or in an autochanger. For a list of
supported devices, refer to the LEGATO Compatibility Guides available on the
LEGATO web site.
Server Software
The following sections describe NetWorker installation requirements and
recommendations for a Linux server:
•
•
"System Requirements" on page 36
"Directories and Pathnames" on page 37
System Requirements
This release of NetWorker software on Linux for Itanium supports the following Linux
distributions:
•
•
SuSE Linux Enterprise Server 8 with:
– Kernel: 2.4.18-1
– Additional module: pdksh-5.2.14-19
RedHat Advanced Server 2.1 with:
– Kernel: 2.4.9-e.3
– Additional module: pdksh-5.2.14-13.i386.rpm
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
36
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Important: Make sure the kernel is supported and that the required package is
installed before beginning the NetWorker software installation. For additional
information, refer to the Linux distribution software documentation, or other Linux
documentation sources.
Table 5 on page 37 lists the minimum memory and storage requirements for the
NetWorker Server for Linux software. Additionally, because the client file index and
media database that a NetWorker server generates can grow large over time, the
NetWorker server needs enough free storage space to accommodate these indexes.
Table 5. Hardware Requirements for NetWorker Server
Requirement
Value
Recommended RAM
64 MB
Disk storage for software
100 MB
Online indexes
5% of total backup data (allowing for up to three times the index size during software update conversion)
Installation Guidelines
Install the appropriate storage devices, including SCSI adapter, cabling, termination,
and driver software prior to installing the NetWorker server. The NetWorker
installation program assumes that the storage devices have been properly installed
and configured, and that the operating system recognizes the devices.
Note: For a list of the currently supported devices, refer to the LEGATO Compatibility
Guides on the LEGATO web site.
On the NetWorker server, install all of the NetWorker software: client, storage node,
server, and device driver. It is recommended that all of the NetWorker software be
installed on the server at the same time.
Directories and Pathnames
The following pathnames and directories are required for installation:
•
•
•
A directory on the server large enough for the NetWorker client and server
indexes and media database (usually /nsr).
The system pathname of at least one storage device for use by the NetWorker
server to back up and recover files.
A directory for the PDF documentation files and for Adobe Acrobat Reader if it is
not already installed.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
37
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
If the default locations and space requirements are accepted during installation, the
installation script creates the directories listed in Table 6 on page 38.
Table 6. Default Locations and Space Requirements
Software and Documentation Files
NetWorker Server
Default Location
Space Needed
NetWorker Administrator program and NetWorker Client /usr/bin
program files
29 MB
NetWorker daemon and utility command files
/usr/sbin
66 MB
Device drivers
/usr/lib/nsr
10 MB
Online client file and server indexes; media database
/nsr
4 MB
License Manager files
/usr/sbin
/usr/nsr/lic/res
/nsr/lic/res
2 MB
22 KB
21 KB
NetWorker man pages
/usr/share/man
2 MB
PDF files
optional
varies
Installing the NetWorker Software
The following sections explain how to install the NetWorker software:
•
•
•
•
"Task 1: Access the NetWorker Software" on page 38
"Task 2: Install the NetWorker Software" on page 40
"Task 3: Change the NetWorker Servers with Access to a Client" on page 43
"Task 4: Start the NetWorker Daemons" on page 44
Task 1: Access the NetWorker Software
The NetWorker software can be accessed:
•
•
•
"From a Local CD-ROM" on page 39
"From a Remote CD-ROM" on page 39
"From the LEGATO Web Site" on page 39
Important: The evaluation release of NetWorker software contains tarred and
compressed versions of the NetWorker software distribution files. Make sure that there
is adequate disk space for both the compressed download file (about 60 MB) and the
fully uncompressed files (about 60 MB).
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
38
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
From a Local CD-ROM
To access the NetWorker software from a local system:
1. Log in as root on the computer where the NetWorker software is being installed.
2. Mount the CD-ROM.
3. Locate the /linux_ia64 directory on the installation CD-ROM.
4. On both the NetWorker server and client, set the PATH environment variable for
user root to contain the directory where the NetWorker executables reside. For
information on this directory, see Table 6, "Default Locations and Space
Requirements," on page 38.
From a Remote CD-ROM
To access the NetWorker software from a remote CD-ROM:
1. On the remote system:
a. Insert the CD-ROM into the remote system’s drive.
b. Mount the CD-ROM on the remote system.
c. Make the CD-ROM exportable through NFS.
2. On the local system:
a. Log in as root on the computer where the NetWorker software is being
installed.
b. Create a mount point.
c. Mount the remote CD-ROM filesystem. For example:
mount -t nfs remote_host:mountpoint /cdrom/mount_dir
Important: On both the NetWorker server and client, set the PATH environment
variable for user root to contain the directory where the NetWorker executables reside.
For information on this directory, see Table 6, "Default Locations and Space
Requirements," on page 38.
From the LEGATO Web Site
To access NetWorker software from the LEGATO web site:
1. Log in as root on the computer where the NetWorker software is being installed.
2. Complete and submit the Evaluation Download Request page located at
http://www.legato.com/resources/downloads/index.cfm.
When the Evaluation Download Request page is completed and submitted, you
will receive an e-mail with the URL to download the NetWorker software.
3. Download the NetWorker evaluation software to a temporary directory.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
39
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
4. Uncompress the downloaded software using the following command:
gunzip nw72_ncw10_linux_ia64.tar.gz
5. Extract the uncompressed, tarred file using the following command:
tar -xvpBf nw72_ncw10_linux_ia64.tar
The NetWorker distribution software directories and files are listed on the screen
as the extraction proceeds.
6. On both the NetWorker server and client, set the PATH environment variable for
the user root, to contain the directory where the NetWorker executables will be
installed, that is /usr/sbin. For information on this directory, see Table 6 on page 38.
Task 2: Install the NetWorker Software
By default, the NetWorker software is installed in the /usr directory. The software can,
however, be installed in a different directory. If there is insufficient disk space on the
/usr partition, choose another location to install the software.
Follow the instructions in one of the following sections to install the software:
•
•
"Installing to the Default Location" on page 40
"Installing to a Nondefault Location" on page 42
Installing to the Default Location
To install the client, storage node, and server software to the default location, see the
following sections:
•
•
•
"Client Installation" on page 41
"Storage Node Installation" on page 41
"Server Installation" on page 42
Important: Prior to installing the NetWorker client software with Red Hat Linux 8,
manually set the RPM_INSTALL_PREFIX environment variable to /usr.
For example:
# RPM_INSTALL_PREFIX=/usr; export RPM_INSTALL_PREFIX
# rpm -ivh lgtoclnt-7.2-1.ia64.rpm
If the RPM_INSTALL_PREFIX environment variable is not set, the installation will fail.
For more information about the Red Hat Linux 8 RPM, refer to the Red Hat web site.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
40
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Client Installation
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
To install the NetWorker software on computers designated as NetWorker clients:
1. Log in to the NetWorker Linux client.
2. Change directories to the temporary directory created for downloading and
extracting the software.
3. Enter the following command:
rpm -ivh lgtoclnt-7.2-1.ia64.rpm
4. (Optional) To install the man pages, enter the following command:
rpm -ivh lgtoman-7.2-1.ia64.rpm
Storage Node Installation
Install the NetWorker software on the following systems:
•
•
Install the client and storage node software on the computers designated as
storage nodes if you purchased an enabler for storage node support.
The storage node package must be installed on the NetWorker server, regardless
of whether separate systems are designated storage nodes. For instructions, see
"Server Installation" on page 42.
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
To install the NetWorker client, driver, and storage node software:
1. Enter the following command to install the client, driver, and storage node
packages:
rpm -ivh lgtoclnt-7.2-1.ia64.rpm lgtodrvr-7.2-1.ia64.rpm
lgtonode-7.2-1.ia64.rpm
2. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
3. (Optional) To install the man page package, enter the following command:
rpm -ivh lgtoman-7.2-1.ia64.rpm
4. Configure the driver software to provide support for NetWorker software to back
up data to the SCSI storage devices attached to the system. For more information,
see "Chapter 5: Autochanger Configuration" on page 61.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
41
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Server Installation
On the computer designated as the NetWorker server, install all the NetWorker
software packages in the following order: client, device driver, storage node, server.
The License Manager can be installed any time after the client package is installed.
Note: The NetWorker software uses the rpm utility for installation. For information
about using rpm, refer to the Linux rpm man page.
To install the software:
1. Enter the following command to install the client, device driver, storage node,
server, and License Manager software:
rpm -ivh lgtoclnt-7.2-1.ia64.rpm lgtodrvr-7.2-1.ia64.rpm
lgtonode-7.2-1.ia64.rpm lgtoserv-7.2-1.ia64.rpm
lgtolicm-7.2-1.ia64.rpm
Note: Installing the License Manager software is optional. It can be installed any
time after the client software.
2. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
3. (Optional) To install the man pages, enter the following command:
rpm -ivh lgtoman-7.2-1.ia64.rpm
The installation process adds the following files:
–
–
–
–
/etc/init.d/networker
/etc/init.d/rc3.d/S95networker
/etc/init.d/rc5.d/S95networker
/etc/init.d/rc0.d/K05networker
Installing to a Nondefault Location
By default, the NetWorker software is installed in the /usr directory. If there is
insufficient disk space on the /usr partition, relocate the NetWorker packages to a
specified directory on another partition. For information about directories and space
requirements, see Table 6 on page 38.
To install the NetWorker software to a nondefault location:
1. Change directories to the temporary directory created for downloading the
packages.
2. Enter the following command to install the NetWorker client, device driver,
storage node, server, and License Manager software:
rpm -ivh --relocate old path=new path lgtoclnt-7.2-1.ia64.rpm
lgtodrvr-7.2-1.ia64.rpm lgtonode-7.2-1.ia64.rpm
lgtoserv-7.2-1.ia64.rpm lgtolicm-7.2-1.ia64.rpm
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
42
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
For example, if you relocated the /usr/bin directory to a new directory called
/backup, you would enter the following command to relocate the /sbin subdirectory:
rpm -ivh --relocate /usr/bin=/backup lgtoclnt-7.2-1.ia64.rpm
lgtodrvr-7.2-1.ia64.rpm lgtonode-7.2-1.ia64.rpm
lgtoserv-7.2-1.ia64.rpm lgtolicm-7.2-1.ia64.rpm
Note: Installing the License Manager software is optional. It can be installed any
time after the client software is installed.
3. (Optional) To install the NetWorker device configuration wizard, run the
following script:
WIZDinstall
For more information on the NetWorker configuration wizards, refer to the
NetWorker Release Supplement, Linux and UNIX Version.
4. (Optional) To install the man pages, enter the following command:
rpm -ivh --relocate old path=new path lgtoman-7.2-1.ia64.rpm
5. Modify the root PATH variable to designate the /usr/bin and /usr/lib/nsr
subdirectories of the directory just created.
Note: Installation to a nondefault location is not supported on Red Hat Linux 8.
Task 3: Change the NetWorker Servers with Access to a Client
To limit the servers authorized to access a client, a list of trusted NetWorker servers can
be specified for a client in the /nsr/res/servers file. After installing the client, storage
node, and server software, use the following procedure to change the NetWorker
servers that are authorized to access a client.
To change the NetWorker servers that can access a client:
1. Enter the following command to shut down the NetWorker daemons:
nsr_shutdown
2. Edit or create the /nsr/res/servers file and add the NetWorker servers, one per line,
that require access to the client. The first entry in this file becomes the default
NetWorker server.
Important: If the /nsr/res/servers file is empty or does not exist, any NetWorker server is
authorized to:
• Access and back up the client
• Perform a directed recover to the client
3. If necessary, delete the -s option from the nsrexecd command that is invoked by
the boot-time startup file. Running nsrexecd with the -s option supersedes the
/nsr/res/servers file.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
43
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Task 4: Start the NetWorker Daemons
The NetWorker daemons must be started after the installation procedure:
1. Start the NetWorker daemons:
/etc/init.d/networker start
2. Enter the following command to determine if the NetWorker daemons are started:
ps -ef | grep nsr
Table 7 on page 44 lists the NetWorker daemons for each of the software components.
Table 7. NetWorker Daemons
NetWorker Installation Packages
NetWorker Daemons
NetWorker server
nsrd, nsrexecd, nsrindexd,
nsrmmdbd, nsrmmd
NetWorker client
nsrexecd
NetWorker storage node
nsrexecd, nsrmmd
Note: The NetWorker daemon nsrmmd is present only if one or more devices are
enabled.
Verifying the Installation
This section explains how to use the NetWorker Administrator program to verify that
the NetWorker software is installed correctly.
Starting the NetWorker Administrator Program
To start the NetWorker Administrator program, enter the following command:
nwadmin -s server_name &
If the NetWorker Administrator program does not open, check for the following:
•
•
The DISPLAY environment variable is set correctly.
The PATH environment variable contains the correct path to the NetWorker
programs:
– /usr/bin
– /usr/sbin
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
44
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
If the NetWorker Administrator program cannot connect to the specified server:
1. Enter the ps command to check that the required NetWorker daemons (specified
in Table 7 on page 44) are present on the NetWorker server:
ps -ef | grep nsr
2. If the output does not list nsrd and nsrexecd as current processes, run the
following command to start the NetWorker daemons on the NetWorker server:
/etc/init.d/networker start
Performing a Test Backup
To perform a test backup using stand-alone devices:
1. Configure a device on the NetWorker server. For more information, refer to the
NetWorker Administrator’s Guide.
2. Insert a volume into the configured device.
3. Label the volume in the Default label pool:
a. Select a device.
b. Select Label from the main window. The NetWorker Administrator program
displays the preconfigured label templates.
c. Select the Default pool and click OK.
4. Mount the volume in the drive by selecting Mount from the main window.
5. Configure the NetWorker client:
a. From the Clients menu, select Client Setup.
The Clients dialog box appears.
b. For the Clients attribute, select the NetWorker server host.
c. For the Save Set attribute, specify the path of a single file that requires
backing up and click Change. For example, /etc/hosts.
d. Click Apply.
6. Test the group backup:
a. Select Group Control from the main window. The Group Control window
appears with the Default group highlighted.
b. Select Start.
7. To view the progress of the test backup, select Details from the Group Control
window.
Messages appear in the panels of the main window as the backup progresses.
8. To view the client file index entries, select Indexes from the main window.
These entries were created during the test backup. Entries under Save Sets indicate
what data was backed up.
If the test backup is not successful, refer to the troubleshooting information in the
NetWorker Administrator’s Guide, to determine the cause.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
45
Chapter 3: Installing NetWorker Software on Linux for Itanium Processor
Uninstalling the NetWorker Software
Use the rpm -e package_name command to uninstall individual NetWorker packages or
all of the NetWorker packages at the same time. For information about using rpm, refer
to the rpm man page.
Important: The following sequence must be used to uninstall all of the NetWorker
software packages: lgtowizd lgtolicm, lgtoserv, lgtonode, lgtoclnt. The man pages (lgtoman)
and document files have no dependencies and can be uninstalled any time.
The LGTOwizd package must be uninstalled before the LGTOclnt package. For more
information on the NetWorker configuration wizards, refer to the NetWorker Release
Supplement, Linux and UNIX Version.
To uninstall the NetWorker software packages:
1. Log in as root on the computer where the software is being uninstalled.
2. Run a query to see which packages are installed:
rpm -qa | grep lgto
The packages are displayed in the following format, 7.2 is the release number and
-1 is appended by the RPM utility:
lgtowizd-1.0-1
lgtonode-7.2-1
lgtoclnt-7.2-1
lgtodrvr-7.2-1
lgtoserv-7.2-1
lgtoman-7.2-1
lgtolicm-7.2-1
3. Enter the rpm -e package_name command to uninstall the software.
•
•
•
To uninstall all the packages, enter:
rpm -e lgtowizd lgtolicm lgtoserv lgtonode lgtodrvr lgtoclnt
lgtoman
To uninstall packages individually, enter rpm -e followed by the specified
packages:
– For device configuration wizard software, follow with lgtowizd-1.0-1
– For License Manager, follow with lgtolicm-7.2-1
– For server software, follow with lgtoserv-7.2-1
– For storage node software, follow with lgtonode-7.2-1
– For device driver software, follow with lgtodrvr-7.2-1
– For client software, follow with lgtoclnt-7.2-1
For NetWorker man pages, follow with lgtoman-7.2-1
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
46
Chapter 4: Installing NetWorker Software in a
LAAM Environment
The NetWorker on Linux for Intel x86 software supports cluster environments. This
chapter explains how to install NetWorker software in a LEGATO Automated
Availability Manager (LAAM™) environment (formerly LEGATO Cluster). It includes
the following sections:
•
•
•
•
•
•
•
•
•
"Software Installation Roadmap" on page 48
"Installation Requirements" on page 48
"Installing a NetWorker Virtual Server" on page 50
"Installing Only the NetWorker Client Software in a Cluster" on page 55
"Configuring an External Client to a Virtual Server" on page 57
"Defining Ownership of a Raw Partition for Virtual Clients" on page 58
"Tracking Scheduled Saves" on page 58
"Uninstalling the NetWorker Software" on page 59
"NetWorker Cluster Script" on page 59
Note: LAAM is supported on the Linux for the Intel x86 platform. It is not supported
on other NetWorker Linux platforms.
A single LAAM cluster consists of multiple nodes in a NetWorker configuration and
provides additional security with the failover capability. Failover allows another node
in the cluster to take over operations from the first node. For information, refer to the
LEGATO Automated Availability Manager User Guide and the LEGATO Automated
Availability Manager Enterprise Programming Guide.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
47
Chapter 4: Installing NetWorker Software in a LAAM Environment
Software Installation Roadmap
Use the following roadmap when installing the NetWorker software. Read the
roadmap and the referenced sections before installing the software.
1. Review the requirements section and note the default directory location. For more
information, see "Installation Requirements" on page 48.
2. Install the required NetWorker software. For more detailed information, see one of
the following sections:
•
•
"Installing a NetWorker Virtual Server" on page 50
"Installing Only the NetWorker Client Software in a Cluster" on page 55
3. Enable and register all of the NetWorker products. For more information, see
"Chapter 6: Evaluating and Licensing NetWorker Software" on page 68.
Installation Requirements
The following sections discuss the software and hardware required to install and
configure the NetWorker server or client software within a LAAM cluster
environment:
•
•
•
•
"Software Requirements" on page 48
"Hardware Requirements" on page 48
"Configuration Options" on page 49
"System Information Requirements" on page 49
For the most up-to-date information regarding software and hardware requirements,
refer to the LEGATO Compatibility Guides on the LEGATO web site.
Software Requirements
To install a NetWorker cluster server, ensure that the following software is installed on
each node in the cluster:
•
•
•
Red Hat Linux 7.1
LAAM release 4.8.1
NetWorker release 7.2
Ensure that the operating system is up to date with the most recent LAAM patch.
Note: For information about LEGATO products that are compatible with LAAM, refer
to the LEGATO Compatibility Guides available on the LEGATO web site.
Hardware Requirements
To install the NetWorker software, make sure that the following hardware
requirements are met for server installation only:
•
•
Dedicated shared disk used as the NetWorker storage disk (for the /nsr directory)
connected to all the nodes within the cluster.
Device with local affinity for the local bootstrap backup connected to all the nodes
within the cluster.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
48
Chapter 4: Installing NetWorker Software in a LAAM Environment
Configuration Options
Refer to the NetWorker Administrators Guide for information on how to configure:
•
•
Tape libraries with a NetWorker virtual server.
Remote physical storage node with a NetWorker virtual server.
System Information Requirements
Figure 1 on page 49 and Table 8 on page 49 display the system information needed to
install NetWorker software within a LAAM environment.
Different platforms use different terms for the same cluster concepts. LAAM refers to:
•
•
Physical hosts as nodes
Virtual server as a Resource Group (application service)
Figure 1. Sample Cluster Configuration
Node A
clus_phys1
Node B
clus_phys2
Local
Disk 1
(If Node A fails,
clus_vir1 fails
over to Node B)
Local
Disk 2
NetWorker Virtual Server
Shared Disks 3
Public Network
Table 8. Required Information (Part 1 of 2)
Information Required
Example
NetWorker virtual name with an IP address
clus_vir1
192.168.1.10
NetWorker package mount point for virtual volume
/nsr_shared_mnt_pt
Shared storage disk virtual volume
/dev/sdc1
NetWorker control script
/usr/sbin/nsr/nw_ux.lc
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
49
Chapter 4: Installing NetWorker Software in a LAAM Environment
Table 8. Required Information (Part 2 of 2)
Information Required
Example
File containing the host IDs of all the cluster members
/nsr/res/hostids
NetWorker monitor script
/usr/sbin/nsr/nw_ux.lc
Installing a NetWorker Virtual Server
To install and configure the NetWorker software as a highly available service in a
cluster, read and follow the procedures for these tasks:
•
•
•
•
•
•
"Task 1: Install the NetWorker Software in a Cluster" on page 50
"Task 2: Define the NetWorker Server as a Highly Available Application" on
page 50
"Task 3: Grant Access to the NetWorker Virtual Server" on page 51
"Task 4: Configure the NetWorker Server" on page 53
"Task 5: Configure Clients under the NetWorker Server" on page 53
"Task 6: Register NetWorker Licenses for Virtual Server Failover" on page 54
Task 1: Install the NetWorker Software in a Cluster
To install the NetWorker software:
1. Make sure that the most recent cluster patch for the operating system is installed.
2. Install the following NetWorker software on each node in the cluster:
•
•
•
•
Client
Driver
Storage node
Server
Task 2: Define the NetWorker Server as a Highly Available Application
To define and configure NetWorker server as a highly available application:
1. Log in as root.
2. Make sure that the /etc/hosts file on each cluster node contains the name of the
virtual host. The virtual hostname can be published in the Domain Name System
(DNS) or Network Information Service (NIS).
3. Set and export the FT_DIR, FT_DOMAIN, and the FT_CONSOLE_DIR
environment variables. For example, from the Bourne shell, enter the following
commands:
FT_DIR=/opt/LGTOaam48
FT_CONSOLE_DIR=$FT_DIR/console
FT_DOMAIN=cluster_domain_name
export FT_DIR FT_DOMAIN FT_CONSOLE_DIR
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
50
Chapter 4: Installing NetWorker Software in a LAAM Environment
4. From each node in the cluster that will run the NetWorker server process:
a. Run the cluster configuration script, networker.cluster, located in the /usr/sbin
directory. For an example, see "NetWorker Cluster Script" on page 59.
b. Enter the following information:
– Location of the local NetWorker database directory provided during the
installation procedure: /nsr
– Published virtual hostname: clus_vir1
– Shared nsr mount directory: /nsr_shared_mnt_pt
Note: Any changes to the configuration can be undone by running the
networker.cluster -r option.
5. From one node in the cluster, customize the /usr/sbin/nw_ux.lc.imp file. Use the
nw_ux.lc.imp file to create the NetWorker Resource Group and its dependant
objects in one step.
Important: In the /usr/sbin/nw_ux.lc.imp file, there are multiple instances of the “NW
Customize” comment. Make sure that all entries are replaced with the appropriate
cluster configuration values.
Follow the instructions listed in the comments at the beginning of the nw_ux.lc.imp
file to customize the following NetWorker default values based on the cluster
configuration:
• Virtual host’s IP address: 192.168.1.10
• Physical hostnames: clus_phys1, clus_phys2
• Shared disk file system: /nsr_shared_mnt_pt
• Device name: /dev/dsk/c1t3d0s0
For a list of the sample values provided, see Table 8 on page 49.
6. Enter the following command:
$FT_DIR/bin/ftcli -c “import /usr/sbin/nw_ux.lc.imp”
7. Verify that the NetWorker Resource Group was imported correctly by using the
LAAM Management Console.
Task 3: Grant Access to the NetWorker Virtual Server
Before a NetWorker server can backup a client, the client must grant the server access.
Granting access is controlled by the /nsr/res/servers file.
Important: If the /nsr/res/servers file is empty or does not exist, any NetWorker server is
authorized to:
• Access and back up the client
• Perform a directed recover to the client
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
51
Chapter 4: Installing NetWorker Software in a LAAM Environment
To grant access to the NetWorker virtual server:
1. On each node in the cluster:
a. Shut down the NetWorker processes and verify that all NetWorker daemons
have stopped.
b. Edit or create the /nsr.NetWorker.local/res/servers file:
– Add the set of NetWorker servers, one per line, that require access to this
client.
– For each virtual NetWorker server, add an entry for each physical host
and the virtual NetWorker server. For example:
clus_vir1
clus_phys1
clus_phys2
c. Check the NetWorker boot-time startup file to see whether nsrexecd is being
run with the -s option. If the -s option exists, remove all occurrences of
-s servername in the file.
2. On one node in the cluster, start the NetWorker service by using the cluster
management software.
a. Bring the NetWorker Resource Group online by using ftconsole.
b. Edit or create the /nsr/res/servers file:
– Add the set of NetWorker servers, one per line, that require access to this
client.
– For each virtual NetWorker server, add an entry for each physical host
and the virtual NetWorker server. For example:
clus_vir1
clus_phys1
clus_phys2
3. If required, grant access to each NetWorker client that is outside of the cluster:
a. Shut down the NetWorker processes and verify that all NetWorker daemons
have stopped.
b. Edit or create the /nsr/res/servers file:
– Add the set of NetWorker servers, one per line, that require access to this
client.
– For each virtual NetWorker server, add an entry for each physical host
and the virtual NetWorker server. For example:
clus_vir1
clus_phys1
clus_phys2
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
52
Chapter 4: Installing NetWorker Software in a LAAM Environment
Task 4: Configure the NetWorker Server
To configure the NetWorker server:
1. Log in as root on the cluster node that is running the NetWorker virtual server and
start the NetWorker Administrator program:
nwadmin -s clus_vir1
2. From the NetWorker Administrator program, select Server Setup:
a. In the Administrator attribute, add entries for any cluster nodes that are not
already listed. For example:
root@hostname
b. Click Add and select Apply.
Task 5: Configure Clients under the NetWorker Server
When the /usr/sbin/networker.cluster script runs, it creates a symbolic link, /nsr, that
points to a local disk. It also creates a second link named nsr.NetWorkerBackup.local that
points to the local NetWorker directory. For example, if the local NetWorker directory
was created in /var/nsr, each client member will have the following links:
•
•
/nsr->/nsr.NetWorkerBackup.local
/nsr.NetWorkerBackup.local->/var/nsr
To configure each client under the NetWorker server:
1. (Optional) Define save groups as required:
a.
b.
c.
d.
e.
Open the NetWorker Administrator program.
Select Customize>Groups from the main menu.
Select View>Details from the main menu.
Click Create to create a new save group.
Define the remaining attributes and click Apply.
Important: Save groups must have the Autorestart attribute enabled and the Manual
Restart option disabled for their save sets to restart after a virtual client or NetWorker
server failover.
f. For each save group, click Enabled in the Autorestart attribute.
g. For each save group, make sure that the Manual Restart option is unchecked
in the Options check box.
2. Make each physical client within the cluster a NetWorker client of the virtual
NetWorker server.
For each physical client in the cluster:
a. Using the NetWorker Administrator program, select Clients>Client Setup.
b. Click Create and enter the name of the physical client for the Name attribute.
c. Define the remaining attributes in the Client window, click Add, and select
Apply.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
53
Chapter 4: Installing NetWorker Software in a LAAM Environment
3. Make each virtual client within the cluster a NetWorker client of the virtual
NetWorker server.
For each virtual client in the cluster:
a. In the NetWorker Administrator program, select Clients>Client Setup.
b. Click Create and enter the name of the virtual client for the Name attribute.
c. In the Remote Access attribute, add entries for each physical client within the
cluster. For example:
root@clus_phys1
d. For the group attribute, select a group.
e. Define the remaining attributes in the Client window, click Add, and select
Apply.
The first time the NetWorker application runs, it creates the Client resource for the
NetWorker virtual server.
4. Run a test probe to verify that the Client and Group resources have been properly
configured.
On the node on which the NetWorker server resides, run the following command:
savegrp -pv -c client_name group_name
If the test probe does not display the scheduled back ups and index, see "Tracking
Scheduled Saves" on page 58.
Task 6: Register NetWorker Licenses for Virtual Server Failover
To register a NetWorker server in a cluster environment:
1. Make sure that the NetWorker virtual server is defined as a part of the cluster.
2. Make sure that the NetWorker service is running.
3. On each physical node in the cluster:
a. Relocate sequentially the NetWorker server to this node.
b. In the NetWorker Administrator program, select Server>Registration.
c. Note the host ID that is displayed on the Registration window.
4. Log in to the system running the NetWorker virtual server and create a file named
/nsr/res/hostids that contains the host IDs of all the cluster nodes. Use the following
syntax: hostid1:hostid2:hostid3:...
For example: 12345678:87654321
5. Restart the server by taking the NetWorker virtual server offline and then putting
it back online.
6. In the NetWorker Administrator program, select Server>Registration. Note the
host ID that is displayed in the Registration window.
7. Register the NetWorker software. For details, see "Chapter 6: Evaluating and
Licensing NetWorker Software" on page 68.
Customer Service will then send the authorization codes using the composite
hostid. The composite host ID was created after step 4.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
54
Chapter 4: Installing NetWorker Software in a LAAM Environment
Installing Only the NetWorker Client Software in a Cluster
To install NetWorker cluster client, follow the procedures for these tasks:
•
•
•
•
"Task 1: Install the NetWorker Cluster Client Software" on page 55
"Task 2: Configure NetWorker Client Software as a Highly Available Application"
on page 55
"Task 3: Define the List of Trusted NetWorker Servers" on page 56
"Task 4: Configure Clients under the NetWorker Server" on page 56
Important: Make sure the NetWorker client software is installed on every node to be
backed up in the cluster.
Task 1: Install the NetWorker Cluster Client Software
To install the NetWorker client software on each node in the cluster:
1. Make sure that the operating system is updated with the most recent cluster patch.
2. Install the NetWorker software on every node in the cluster to be backed up.
Task 2: Configure NetWorker Client Software as a Highly Available Application
To define and configure a NetWorker client as a highly available application:
1. Log in as root on each node where the NetWorker software is being installed.
2. Make sure that the /etc/hosts file on each cluster node contains the name of the
virtual host. The virtual hostname can be published in the DNS or NIS.
3. Set and export the FT_DIR, FT_DOMAIN, and the FT_CONSOLE_DIR
environment variables. For example, from the Bourne shell enter the following
commands:
FT_DIR=/opt/LGTOaam48
FT_CONSOLE_DIR=$FT_DIR/console
FT_DOMAIN=cluster_domain_name
export FT_DIR FT_DOMAIN FT_CONSOLE_DIR
4. For each node in the cluster:
a. Run the cluster configuration script, /usr/sbin/networker.cluster.
b. In response to the prompt to configure the NetWorker server, enter No.
Note: Any changes to the configuration can be undone by running the
networker.cluster -r option.
For an example of the script, see "NetWorker Cluster Script" on page 59.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
55
Chapter 4: Installing NetWorker Software in a LAAM Environment
Task 3: Define the List of Trusted NetWorker Servers
Before a NetWorker server can back up a client, the client must grant the server access.
Granting access is controlled by the /nsr/res/servers file.
Important: If the /nsr/res/servers file is empty or does not exist, any NetWorker server is
authorized to:
• Access and back up the client
• Perform a directed recover to the client
To define the list of trusted NetWorker servers, perform the following steps on each
node in the cluster:
1. Shut down the NetWorker processes and verify that all NetWorker daemons have
stopped.
2. Edit or create the /nsr/res/servers file:
a. Add the set of NetWorker servers, one per line, that require access to this
client.
b. For each virtual NetWorker server, add an entry for each physical host and
the virtual NetWorker server. For example:
clus_vir1
clus_phys1
clus_phys2
3. Check the NetWorker boot-time startup file to see whether nsrexecd is being run
with the -s option. If the -s option exists, remove all occurrences of -s servername in
the file.
Task 4: Configure Clients under the NetWorker Server
Note: The NetWorker server might reside outside of the cluster.
To configure each client under the NetWorker server:
1. Make each physical client within the cluster a NetWorker client of the NetWorker
server.
For each physical client in the cluster:
a. In the NetWorker Administrator program, select Clients>Client Setup. Click
Create and enter the name of the physical client for the Name attribute.
b. Define the remaining attributes in the Client window and click Apply.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
56
Chapter 4: Installing NetWorker Software in a LAAM Environment
2. Make each virtual client within the cluster a client of the NetWorker server.
For each virtual client in the cluster:
a. In the NetWorker Administrator program, select Clients>Client Setup.
b. Click Create and enter the name of the NetWorker server for the Name
attribute.
c. For the Remote Access attribute, add entries for each physical client within
the cluster. For example:
root@clus_phys1
d. For the group attribute, select a group.
e. Define the remaining attributes in the Client window and click Apply.
3. Schedule backups by using the NetWorker Administrator program. For detailed
instructions, refer to the NetWorker Administrator’s Guide.
Configuring an External Client to a Virtual Server
Before a NetWorker server can back up a client, the server must be granted access.
Granting access is controlled by editing the /nsr/res/servers file.
Important: If the /nsr/res/servers file is empty or does not exist, any NetWorker server is
authorized to:
• Access and back up the client
• Perform a directed recover to the client
To configure and back up an external NetWorker client to a NetWorker server, perform
the following on each NetWorker client that is outside of the cluster:
1. Shut down the NetWorker processes and verify that all NetWorker daemons have
stopped.
2. Edit or create the /nsr/res/servers file:
a. Add the set of NetWorker servers, one per line, that require access to this
client.
b. For each virtual NetWorker server, add an entry for each physical host and
the virtual NetWorker server. For example:
clus_vir1
clus_phys1
clus_phys2
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
57
Chapter 4: Installing NetWorker Software in a LAAM Environment
Defining Ownership of a Raw Partition for Virtual Clients
Use the IPOverride option to back up the raw partitions of a NetWorker virtual client,
as described in the following steps:
1. Open the LAAM Management Console and select Resource Group.
The Resource Group Editor window appears.
2. Select the Edit View tab and then select Edit>Attributes.
The Define Resource Group Attributes window opens.
3. Add the following line in the Define Resource Group Attributes window:
IPOverride=IP_address=raw_partition_path
For example: IPOverride=135.69.103.149=/dev/rdsk/c1t3d0s1
Note: The IPOverride attribute does not add to the normal list of virtual client owned
paths, but completely overrides them. In the previous example, if the virtual client also
owns the filesystem /share/web, set the following path:
IPOverrride=135.69.103.149=/dev/rdsk/c1t3d0s1, /share/web
Tracking Scheduled Saves
To verify that the Client and Group resources have been properly configured, run a test
probe for each client from the node where the NetWorker is running:
savegrp -pv -c client_name group_name
If the test probe does not display all the scheduled save sets, do one of the following
and run a second test probe to verify the configuration:
•
•
Check the cluster configuration. If necessary, reconfigure the cluster.
Make sure that the save sets defined for the client are owned by that client. If
necessary, redistribute the client save sets to the appropriate Client resources.
Important: Misconfiguration of the Cluster resources might cause scheduled save sets
to be dropped from the backup. For more information, see NetWorker Administrator’s
Guide.
To override scheduled save rules (not path ownership rules), enter the following
command on each node in the cluster:
touch networker_bin_dir/pathownerignore
This command allows any path to be backed up for a client, whether it is owned
by the virtual client or physical node. For detailed information, refer to the
NetWorker Administrator’s Guide.
If pathownerignore was used, check that the NetWorker scheduled save uses the
correct client file index. If it uses the wrong index, save sets can be forced to go to a
specific index.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
58
Chapter 4: Installing NetWorker Software in a LAAM Environment
To force save sets to go to a specific index:
1. In the NetWorker Administrator program, select Clients>Client Setup.
2. For the Backup Command attribute, enter the name of a backup script that
contains save -c client_name.
For detailed information about the Backup Command attribute, refer to the NetWorker
Administrator’s Guide.
Uninstalling the NetWorker Software
To uninstall the NetWorker software from a cluster environment:
1. If necessary, use the cluster management software to stop the NetWorker server
daemons.
2. Shut down the client daemons on the node on which the NetWorker software is
being removed:
nsr_shutdown
3. Make sure that the $FT_DIR and the $FT_DOMAIN environment variables have
been set.
4. Enter the /usr/sbin/networker.cluster -r command. For example:
/usr/sbin/networker.cluster -r
5. Remove the subsets for the following packages with the rpm command in the
following order, as follows:
rpm -e lgtolicm-7.2.i686-1 lgtoserv-7.2.i686-1
lgtonode-7.2.i686-1 lgtodrvr-7.2.i686-1 lgtoclnt-7.2.i686-1
lgtoman-7.2.i686-1
NetWorker Cluster Script
This example, generated when the networker.cluster script runs, it uses the following
configuration:
•
•
•
Virtual server: clus_vir1
Virtual server IP address: 192.168.1.10
Mount point: /nsr_shared_mnt_pt
-----------------------------------------------------------Availability Manager 4.8.1 installations have a hierarchy of
cluster objects which define high available applications. Each
application service is associated with a resource group that
encapsulates services, IPs and data sources, which may fail
over from one physical host to the next, depending on the
availability and health of the machine it is running upon. When
a failover occurs, this logical host--aka resource
group--moves, carrying its IP addresses and data sources.
One must define a NetWorker resource group with an IP and
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
59
Chapter 4: Installing NetWorker Software in a LAAM Environment
shared data source, which contains the shared /nsr directory,
before using NetWorker. This can be done before or after
running this script. The optional ftcli-import template file
/usr/sbin/nw_ux.lc.imp can be used for this purpose.
-----------------------------------------------------------Do you wish to continue? [Yes]? Yes
Enter directory where local NetWorker database is installed
[/nsr]?
Do you wish to automatically add site-specific values for:
NSR_SHARED_DISK_DIR and NSR_SERVICE_ID in /usr/sbin/nw_ux.lc
Yes or No [Yes]? Yes
Enter the published virtual hostname used for NetWorker?
clus_vir1
The mountpoint of the shared NetWorker directory (the nsr
directory) must be the same for all the nodes where NetWorker
server can failover to.
In what path will this nsr directory be created/located?
/nsr_shared_mnt_pt
/usr/sbin/nw_ux.lc has been modified
Now please ensure NetWorker is configured as a resource group
in Legato Cluster. Refer to the Legato Cluster & NetWorker
manuals.
Creating /usr/sbin/lcmap file ...
!/bin/sh
PATH=/usr/ucb:/usr/bsd:/bin:/usr/bin:/etc:/usr/etc:/usr/sbin:/u
sr/bin:/sbin:/usr/sbin:/sat-tools/bin:/usr/local/bin:/usr/bsd:/
bin:/net/acadia/space2/mccabe/7.2/bin:/usr/openwin/bin:/usr/ucb
:/opt/networker/bin:/space/bin:/opt/LGTOaam48/bin:/opt/LGTOaam4
8/console:/bin
export PATH
FT_DIR=/opt/LGTOaam48
FT_DOMAIN=avro
export FT_DIR FT_DOMAIN
$FT_DIR/bin/ftPerl $FT_DIR/bin/nwclust.pl
Finished creating /usr/sbin/lcmap file.
You can now use ftconsole to add a resource group for NetWorker
using the template specifications given in
/usr/sbin/nw_ux.lc.imp. Alternatively, you can modify
/usr/sbin/nw_ux.lc.imp and then run ftcli with '-c "import
/usr/sbin/nw_ux.lc.imp"'.
Note that the users who will run NetWorker on the cluster nodes
must be added as secure users of Availability Manager.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
60
Chapter 5: Autochanger Configuration
This chapter explains how to configure the NetWorker software to work with
autochangers. It contains the following sections:
•
•
•
•
"Supported Vendor-Specific ASC and ASCQ Codes" on page 61
"Detecting the Autochanger" on page 62
"Configuring the Autochanger" on page 63
"Testing the Autochanger Connection" on page 66
Note: The term autochanger refers to a variety of backup devices: library, autoloader,
carousel, datawheel, jukebox, and near-line storage.
Important: For all tape devices used with NetWorker software, ensure that the block
size mode specified in the operating system is set to variable. Otherwise, data recovery
may fail. To ensure that the devices are variable block size, edit their definitions in the
/etc/stinit.def file. See "Appendix A: Sample stinit.def File" on page 77 for a sample
stinit.def file to use as a guide. For information about setting the tape device block size
mode through the operating system, refer to the operating system documentation.
Supported Vendor-Specific ASC and ASCQ Codes
In NetWorker software, the Additional Sense Code (ASC) utility, including its
associated ascdcode and library, translates vendor specific ASC and Additional Sense
Code Qualifier (ASCQ) error messages.
The ASC utility is located in the NetWorker driver package, which is a software
requirement for the storage node and the server package. Requisite software is
installed automatically by default, so if you elect to install the storage node, then the
driver package, and thus the ASC utility, is installed automatically.
Notes:
•
•
If you elect not to install the requisite software automatically, and you do not
manually select drivers to install with the storage node, the storage node
installation will fail.
If you install only the client package, then the storage node package, and the ASC
utility are not installed.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
61
Chapter 5: Autochanger Configuration
The ASC utility translates vendor-specific error messages for the following vendors:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
ADIC
ATL
BHTi
Benchmark
Exabyte
Fujitsu
HP
IBM
Overland
Plasmon
Qualstar
Quantum
Seagate
STK
Tandberg
Detecting the Autochanger
Before configuring an autochanger to use for storage operations, it must be detected by
the NetWorker software and the operating system. This section provides information
about detecting an autochanger on a NetWorker server or storage node with an
attached autochanger.
This section contains the following sections:
•
•
"Configuring the Hardware and Kernel to Enable Autochanger Detection" on
page 62
"Configuring the Autochanger" on page 63
Configuring the Hardware and Kernel to Enable Autochanger Detection
For proper autochanger detection and SCSI support, certain SCSI-related
configurations should be enabled in the kernel.
•
•
If using an HP autochanger, the SCSI card must also be configured to support
multiple logical unit numbers (LUNs).
If the inquire command does not report the devices that are connected, perform
these configurations by rebuilding the kernel.
Important: Before making changes to the kernel, save a copy of the original kernel.
For detailed instructions on rebuilding the kernel, refer to the readme file in
usr/src/linux.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
62
Chapter 5: Autochanger Configuration
To enable the correct SCSI support in the kernel:
1. Enable the following options under SCSI support:
•
•
SCSI tape support
SCSI generic support
2. Probe all LUNs on each device.
3. Save the new kernel configurations and reboot the computer.
4. Run the inquire command again to see whether it detects the autochanger.
•
•
If the adapter is configured properly and the kernel support is correct, there
should be a busid file in the /proc/scsi/<adapter-type> directory, where busid is
the actual number of the bus ID of the adapter, for example 0 or 1.
If autodetection still does not work, use the following steps to configure the
device manually:
a. Obtain the bus ID, channel, and LUN from the dmesg output or by
entering the following command:
cat /proc/scsi/scsi
b. Run inquire -a with the bus ID, channel, and LUN as arguments
separated by a period.
For example, if the bus ID is 4, the channel is 0, and the LUN is 1, enter
the following at the command line:
/usr/sbin/inquire -a 4.0.1
c. Run the jbconfig script by using the output returned in step b on page 63.
For example:
– [email protected] (as control path to the device)
– /dev/sg4 (as tape path)
Configuring the Autochanger
To configure the autochanger:
1. Make sure the autochanger is connected.
2. Log in as root on the NetWorker server.
3. Enter the inquire command, as shown:
/usr/sbin/inquire
The inquire command verifies that the autochanger is attached, and determines
the following information about the robotics and tape drives:
• SCSI address
• Vendor and model
• Firmware
• Device type and pathname
• Serial number
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
63
Chapter 5: Autochanger Configuration
Note: If inquire does not display the device pathname, do the following:
• Reboot the computer.
• Check that the cabling and hardware configuration is correct.
• Ensure that the device driver is installed. If it is not installed, contact the
vendor to obtain the driver.
For more information about the inquire command, refer to the inquire man page.
4. Run the sjisn command with the SCSI address of the autochanger to be configured:
sjisn scsi_address
For supported autochangers, the sjisn command lists the drives in the order that
they occur in the autochanger. For example, for the ADIC Scalar 24, enter:
sjisn 4.0.1
The output from sjisn displays the identification of the drives one by one, for
example:
sjisn 4.0.1
Serial Number data for 4.0.1 (ADIC Scalar 24
Serial Number: ADIC_1_10052002067
SCSI-3 Device Identifiers:
VENN:ADIC
Scalar 24
IENN:20100060451732D7
IEPN:20010060451732D7
WWNN:20100060451732D7
WWPN:20010060451732D7
PORT:00000001
Drive at element
SCSI-3 Device
ATNN:IBM
Drive at element
SCSI-3 Device
ATNN:IBM
address 256:
Identifiers:
ULTRIUM-TD1
address 257:
Identifiers:
ULTRIUM-TD1
): Library:
CIDA1_1_25000200 76
6811133671
6811132279
If the sjisn output does not provide the serial number, the autochanger does not
support the sjisn command. However, you can continue to use jbconfig to
configure the autochanger.
Note: For more information about the sjisn command, refer to the sjisn man page.
5. Verify that the NetWorker daemons are running by entering one of the following
commands:
• ps -ef | grep nsr
• ps -aux | grep nsr
If the NetWorker daemons are not running, start them in the following order:
a. nsrexecd
b. nsrd
c. (Optional) nwadmin &
This command launches the NetWorker Administrator program, which
should display the drives after the configuration is complete.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
64
Chapter 5: Autochanger Configuration
6. Run the jbconfig command:
jbconfig
The program lists the autochanger types that are supported on the platform used.
7. Select one of the available options to indicate which kind of autochanger to install.
The jbconfig command automatically displays the autochanger pathname in
response to the selection, as shown in the following example:
Installing 'ADIC' jukebox - [email protected].
8. Enter a name to assign to the autochanger at the jbconfig command prompt. For
example:
What name do you want to assign to this jukebox device? adic
9. Use the output from the sjisn command, if supported by the autochanger, to verify
the serial number of the first drive in the autochanger, or to identify if the
pathname is not automatically supplied. The first drive in the autochanger is the
first drive listed under the library in the sjisn output.
For example, the first drive listed in the sample output from sjisn has the
identification number 6811133671:
Drive at element address 256:
SCSI-3 Device Identifiers:
ATNN:IBM
ULTRIUM-TD1
6811133671
10. Use the output from the inquire command to identify the drive pathname of the
serial number obtained in step 9.
11. Continue configuring the other drives in the autochanger.
When the configuration is complete, the program displays the following message:
Jukebox has been added successfully.
When you use the jbconfig program to configure an autochanger, a new resource is
created with the name you specified.
•
•
To view the new Jukebox resource, use the NetWorker Administrator program:
a. If the NetWorker Administrator program is not running, enter the command:
nwadmin &
b. From the Media menu, select Jukeboxes.
To understand the attributes of the Jukebox resource, refer to the Online Help or
the nsr_jukebox(5) man page.
Note: For additional information about configuring autochangers, refer to the
NetWorker Administrator’s Guide.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
65
Chapter 5: Autochanger Configuration
Testing the Autochanger Connection
To test the autochanger connection:
1. Log in as root on the NetWorker server or storage node.
2. Insert two volumes; one each into the first and last slots of the autochanger. Make
sure that the drives are empty and that the autochanger and drive doors are
positioned correctly (refer to the device manual).
3. Enter the jbexercise command and specify the control port and the jukebox model.
Use the same control port pathname that was displayed after running jbconfig
(see step 7 on page 65).
For example, the following command runs the jbexercise program on the ADIC
Scalar 24 autochanger detected by the jbconfig script:
jbexercise -c [email protected] -m “Standard SCSI Jukebox”
For additional information on the command options available for the jbexercise
command, refer to the jbexercise(1m) man page.
Notes:
• To list the SCSI devices that are available, use the inquire command. The
control port for SCSI autochangers is typically expressed in the format
[email protected].
• To obtain the exact control port pathname, use the response displayed by the
jbconfig command when the autochanger was configured:
These are the SCSI Jukeboxes currently attached to your
system
1)[email protected]: Standard SCSI Jukebox
The jbconfig Command Output
The following is an example of the output when installing an autodetected SCSI
jukebox on a computer with Red Hat Linux installed:
# jbconfig
1) Configure an AlphaStor/SmartMedia Jukebox.
2) Configure an Autodetected SCSI Jukebox.
3) Configure an Autodetected NDMP SCSI Jukebox.
4) Configure an SJI Jukebox.
5) Configure an STL Silo.
What kind of Jukebox are you configuring? [1] 2
Installing ’ADIC Scalar 28 Series’ jukebox - [email protected]
What name do you want to assign to this jukebox device? adic
Turn NetWorker auto-cleaning on (yes / no) [yes]? yes
The following drives have been detected in this auto-changer:
1> [email protected] ==> /dev/nst0
2> [email protected] ==> /dev/nst1
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
66
Chapter 5: Autochanger Configuration
These are all the drives that this auto changer possesses.
Do you want to change the model(s) or configure them as shared
or NDMP drives? (yes / no) n
Jukebox has been added successfully
The following configuration options have been set:
> Jukebox description to the control port and model.
> Autochanger controlport to the port at which we found it.
> Networker managed tape autocleaning on.
> Barcode reading to on.
> Volume labels that match the barcodes.
> Slot intended to hold cleaning cartridge to 1. Please insure
that a cleaning cartridge is in that slot
> Number of times we will use a new cleaning cartridge to 12.
> Cleaning interval for the tape drives to 6 months.
You can review and change the characteristics of the
autochanger and its associated devices using nwadmin.
Would you like to configure another jukebox? (yes/no) [no] n
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
67
Chapter 6: Evaluating and Licensing NetWorker
Software
When the NetWorker software is installed, it is in a temporary evaluation mode with
all of the features available. This chapter explains how to enable the NetWorker
software and features for permanent use. The chapter also describes the LEGATO
NetWorker licensing model and provides a basic explanation of licensing for the
different NetWorker editions, modules, and features, but it does not provide a
comprehensive description of every possible licensing scenario. For specific licensing
questions, contact a LEGATO sales representative.
The chapter includes the following sections:
•
•
•
•
•
"How NetWorker Software Is Licensed" on page 68
"The Evaluation Process" on page 69
"The Licensing Process" on page 70
"NetWorker Licenses" on page 73
"Managing LEGATO Licenses" on page 76
How NetWorker Software Is Licensed
Licensing NetWorker software means entering enabler and authorization codes on the
server for the NetWorker environment. Without these codes, the software or added
features will not run beyond the evaluation period.
Each installation of NetWorker server software must be licensed with a base enabler
which “turns on” the software and allows you to use a particular bundle of features,
such as a specified number of clients and devices. All licensing takes place on the
server: The licenses are entered and stored on the server, and the server enforces the
licensing.
Base enablers come in four editions:
•
•
•
•
Power Edition
Network Edition
Workgroup Edition
Business Edition
These four editions enable varying degrees of functionality. Add-on enablers allow a
broader scope of features. For more information about the editions and different
functionality, see "NetWorker Licenses" on page 73.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
68
Chapter 6: Evaluating and Licensing NetWorker Software
The Evaluation Process
Evaluating NetWorker software can take place in two ways:
•
•
Evaluating a new installation of the software on a NetWorker server
Evaluating NetWorker features on an existing NetWorker installation
Evaluating a New Installation
When you first install the NetWorker software, you can evaluate it with all the features
for 30 days free without entering any codes.
By the end of the evaluation period, you must purchase, enter, and authorize a base
enabler to continue using the NetWorker software to back up data. The base enabler is
the license that enables the edition purchased. To obtain a base enabler, contact either
LEGATO Sales or a LEGATO Reseller. For contact information, see "Information and
Services" on page 12. For more information about entering and authorizing the enabler,
see "The Licensing Process" on page 70.
To continue using some of the features that were available with the evaluation
software, you may need to purchase add-on enablers, depending on the edition of base
enabler you purchase. For more information about the different NetWorker editions
and features, see "NetWorker Licenses" on page 73.
Evaluating Features on an Existing Installation
If you are evaluating one or more NetWorker features on an edition of NetWorker
software that has already been installed and enabled, you must enter a temporary
enabler for each feature. The temporary enabler is valid for 45 days.
•
•
To obtain a temporary enabler code, to which you can refer to the Contents
documentation in the LEGATO media kit, or contact LEGATO Sales or a LEGATO
Reseller.
To enter the temporary enabler code, see "How to Enter a Temporary Enabler
Code" on page 69.
Note: If the Business, Network, or Workgroup edition is already installed and enabled
on a computer, and you want to evaluate Power Edition, LEGATO recommends using
a different computer as a temporary NetWorker server for evaluation purposes.
By the end of the evaluation period, you must purchase, enter, and authorize the
corresponding license enablers to continue using features you have evaluated. For
instructions, see "The Licensing Process" on page 70. For more information about the
different NetWorker editions and features, see "NetWorker Licenses" on page 73.
How to Enter a Temporary Enabler Code
To enter the temporary enabler code:
1. Log in as root or as NetWorker administrator on the NetWorker server.
2. Start the NetWorker Administrator program:
nwadmin &
3. From the Server menu, select Registration. The Registration window opens.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
69
Chapter 6: Evaluating and Licensing NetWorker Software
4. Click Create.
5. Enter the enabler code in the Enable Code attribute.
Note: Filling in the Comment attribute is optional.
6. Click Apply.
Important: The temporary enabler code is valid on only one computer in a network. If
you enter the same code on more than one computer in a network, a copy protection
violation error occurs and the NetWorker server software is disabled on all NetWorker
servers with duplicate enablers.
The Licensing Process
To permanently use NetWorker software, you must purchase and enter a license
enabler code, and then authorize it. This licensing process is the same for all editions
of NetWorker software as well as for individual features. To purchase the license
enabler, contact a LEGATO sales representative.
The license enabler code that you purchase is valid for 45 days, as a registration period.
During the registration period, you must obtain and enter a corresponding
authorization code.
The following sections explain how to enter and authorize the license enabler:
•
•
•
"Task 1: Enter the License Enabler Code" on page 70
"Task 2: Obtain an Authorization Code" on page 71
"Task 3: Enter the Authorization Code" on page 72
Task 1: Enter the License Enabler Code
License enabler codes are included in either the letter announcing the updated or
upgraded software, or on the Enabler Certificate you receive when you purchase a
software license. This depends on whether the software purchased is a first-time
purchase, or an updated or upgraded version.
Note: To save time when entering a number of licenses, enter the base enabler last.
Otherwise, once a base enabler is entered, devices that do not yet have licenses entered
may be disabled; those devices would have to be re-enabled manually after their
licenses were installed.
To enter the license enabler code:
1. Log in as root or as NetWorker administrator on the NetWorker server.
2. Start the NetWorker Administrator program:
nwadmin &
3. From the Server menu, select Registration. The Registration window opens.
4. If the Registration list displays a temporary enabler for the product or feature
being licensed, highlight the enabler and click Delete.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
70
Chapter 6: Evaluating and Licensing NetWorker Software
5. In the Registration window, click Create.
6. Enter the enabler code in the Enabler code attribute.
Note: Completing the Comment attribute is optional.
7. Click Apply.
After you enter the license enabler code, you have 45 days, as a registration period, to
authorize the NetWorker software.
Task 2: Obtain an Authorization Code
Registration of NetWorker software takes place by obtaining an authorization code.
Obtain a unique authorization code through one of the following methods:
•
•
"Using the LEGATO Web Site"
"By Fax or E-mail"
Important: If the software or feature is not authorized by the end of the 45-day
registration period, the NetWorker backup function or feature is disabled. However,
data that was backed up during the registration period can still be recovered from local
devices.
Using the LEGATO Web Site
Register LEGATO products and obtain authorization codes online by completing a
registration form on the LEGATO web site. Web registration takes just a few minutes
and is available 24 hours a day, 7 days a week.
An authorization code that permanently enables the NetWorker license will be sent by
e-mail.
If you have any questions regarding software updates, contact LEGATO Licensing. For
contact information, see "Licensing and Registration" on page 13.
By Fax or E-mail
To register the software and obtain an authorization code by fax or e-mail:
1. Log in as root or as NetWorker administrator on the NetWorker server.
2. Start the NetWorker Administrator program:
nwadmin &
3. Complete your contact information:
a. From the Server menu, select Server Setup.
b. Complete the contact name, company, address, phone, and e-mail
information requested and click Apply.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
71
Chapter 6: Evaluating and Licensing NetWorker Software
4. Print the registration information sheet.
a. From the Server menu, select Registration.
a. From the View menu, select Tabular.
b. From the File menu, select Print.
5. Send your contact information to LEGATO Licensing by doing one of the
following:
• Fax the printed registration information sheet.
• E-mail the registration information.
For contact information, see "Licensing and Registration" on page 13.
An authorization code that permanently enables the updated NetWorker software will
be sent to you.
Task 3: Enter the Authorization Code
To complete the licensing process, you must enter the unique authorization code on the
NetWorker server within 45 days of entering the license enabler code.
To enter the authorization code:
1. Log in as root or as NetWorker administrator on the NetWorker server.
2. Start the NetWorker Administrator program:
nwadmin &
3. From the Server menu, select Registration.
4. In the Registration window, highlight the appropriate license.
5. In the Auth Code text box, enter the authorization code, and then click Apply.
If the authorization process is successful, the expiration date for the license displays
“Authorized - No expiration date.” If the authorization is not verified in this way,
contact LEGATO Support.
Important: To avoid an interruption in scheduled backups if you move the NetWorker
software from one computer to another, or to change the network address of a
computer after the software is installed, do one of the following:
• Contact LEGATO Licensing to obtain a new authorization code. LEGATO
requires the host ID of the original server as well as the new server. The host ID is
displayed in the server’s Registration window.
For a list of contact numbers, see "Licensing and Registration" on page 13.
• Install and configure the LEGATO License Manager software. For more
information on using the License Manager, see "Managing LEGATO Licenses" on
page 76 and refer to the LEGATO License Manager Installation and Administrator's
Guide.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
72
Chapter 6: Evaluating and Licensing NetWorker Software
NetWorker Licenses
There are four different levels, or editions, of base enabler:
•
•
•
•
NetWorker Workgroup Edition enables you to back up the server and up to seven
clients. NetWorker Workgroup Edition does not include support for additional
clients or optional software features, such as NetWorker Archive. If you decide at
a later date to purchase a higher level of NetWorker software, all of the data
backed up by NetWorker Workgroup Edition is recoverable by any level of
NetWorker software you purchase.
NetWorker Business Edition is the same as the Workgroup Edition, except that it
includes a license to use an autochanger (1-26 slots) as part of its base enabler,
allows backing up a two-node cluster client, and allows NDMP connections.
NetWorker Network Edition enables you to back up the server and as many client
workstations as the number of client connections purchased. You can upgrade
this edition to include support for additional clients and autochangers, as well as
optional software features.
NetWorker Power Edition is a server software product that has been specially
tuned to protect and provide backup for environments that support Very Large
Database (VLDB) or large filesystem applications (in the terabyte range). You can
also upgrade NetWorker Power Edition to include support for cluster servers and
clients.
Each of these editions permits you to use the software for a specified number of clients
and devices. Each of the four editions enable different degrees of parallelism and
support different add-on modules, including extra client connections, devices, or
features. For more information on NetWorker licenses, refer to the NetWorker
Administrator’s Guide.
Important: An HP Superdome computer requires a separate enabler for each partition
on which a NetWorker server or storage node runs.
Multiplatform Licensing
Multiplatform licensing is client connections that come with a NetWorker server
operating system that is used to allow the NetWorker server to back up clients of
different operating systems with a ClientPak license. For example, the client
connections accompanying a NetWorker server for Windows can be used only for
Windows client computers; similarly, the client connections that come with a
NetWorker server for Solaris can be used for Solaris clients only. With a ClientPak for
UNIX, other UNIX operating systems can be enabled for use with the NetWorker
Server for Solaris. The ClientPak for UNIX supports all UNIX operating systems;
therefore, the UNIX ClientPak is sufficient for all UNIX clients backed up by a UNIX
or Windows server.
Note: The NetWorker software treats Linux as a separate operating system, so a
ClientPak for Linux is necessary to back up Linux clients by either UNIX or Windows
servers.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
73
Chapter 6: Evaluating and Licensing NetWorker Software
Example: Multiplatform Licensing Schemes
A company was using a Linux server to back up Solaris, Linux, and Windows NT
clients. It needed two ClientPak licenses, one for Solaris and one for Windows. The
company added HP-UX and AIX clients, which required the addition of a ClientPak
license for UNIX. As the company grew and needed to add a server, it added a
Windows 2000 server, which backed up the Windows NT and subsequent Windows
2000 clients without requiring a ClientPak. The company also made the Solaris
computer a NetWorker server to back up the HP-UX, Solaris, and AIX clients, using a
single ClientPak for UNIX.
Update Enablers
To update existing NetWorker software to a major release (one that introduces
important new features), an update enabler is necessary. Update enablers are required
for any major NetWorker software upgrade from release 4.0 and later, including
NetWorker release 7.2. To use the LEGATO License Manager, the NetWorker server
must be release 5.0 or later. With a first-time purchase of NetWorker software, a
one-year update agreement may be included. After a year, an update enabler can be
acquired with a new update agreement purchase.
Required Update Enablers
Table 9 on page 74 lists the NetWorker releases that require update enablers.
Table 9. NetWorker Releases Requiring Update Enablers (Part 1 of 2)
Upgrade
from
to 5.0 to 5.5
to 5.5.x to 5.6
to 5.7 to 6.x to 7.1 to 7.2
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
yes
(UNIX (NT
only) only)
yes
yes
yes
yes
yes
(UNIX (NT
only) only)
yes
yes
yes
yes
yes
yes
5.7
yes
yes
yes
6.0
no
yes
yes
Any release
prior to 5.0
5.0
5.5
5.5.x
5.6
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
NA*
74
Chapter 6: Evaluating and Licensing NetWorker Software
Table 9. NetWorker Releases Requiring Update Enablers (Part 2 of 2)
Upgrade
from
to 5.0 to 5.5
to 5.5.x to 5.6
to 5.7 to 6.x to 7.1 to 7.2
6.x
yes
yes
* Release 5.6 is UNIX only, and Release 5.7 is Windows only.
Additional Licenses
This section describes a few of the additional licenses required to operate some of the
NetWorker features. For a complete list, contact a LEGATO sales representative.
Client Connection Licenses
Every computer to be backed up in a NetWorker datazone requires a client connection
license, even the NetWorker server. The client connection license may be one of the
licenses supplied with the base enabler or purchased separately. A cluster client or
NDMP data server requires a special type of client connection license, as described in
"Cluster Clients" or "NDMP Licensing" respectively, below.
Storage Nodes
Each storage node requires a storage node license in addition to its client connection
license. A dedicated storage node, which allows the storage node to back up only itself, is
licensed separately.
LEGATO NetWorker Application Modules
NetWorker Application Modules are licensed on the basis of one enabler per database
type host. For example, to back up the Oracle database on two hosts, two NetWorker
Module for Oracle enablers are required, even if the two hosts are backed up by the
same server. However, if multiple database instances are running on a NetWorker
client host, only one NetWorker Module enabler is required for that one host.
Cluster Clients
For each physical node in a cluster, you must purchase a Cluster Client Connection,
which takes the place of one standard client connection. To place a NetWorker server
in a cluster, you must have Power Edition. For more information on licensing
computers in a cluster, refer to the NetWorker Administrator’s Guide.
NDMP Licensing
NDMP licensing requires one NDMP Client Connection per NDMP data server. The
NDMP Client Connection is valid for any supported NDMP data server. The NDMP
data server does not require a standard client connection.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
75
Chapter 6: Evaluating and Licensing NetWorker Software
Managing LEGATO Licenses
The LEGATO License Manager provides centralized license management, allows the
maintenance of all enterprise NetWorker licenses from a single computer. With the
License Manager, you can move NetWorker software from one computer to another, or
change the IP address on an existing NetWorker server without having to reauthorize
the software. The License Manager can be installed as an option during NetWorker
software installation.
The general steps to begin implementing the License Manager are to:
1. Contact LEGATO Licensing to obtain bulk enabler codes. For contact information,
see "Licensing and Registration" on page 13.
2. Install the License Manager software.
3. Configure the License Manager and configure the NetWorker servers to access the
License Manager for their licenses.
For details on installing and using the License Manager, refer to the LEGATO License
Manager Installation and Administrator's Guide, 2nd Edition.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
76
Appendix A: Sample stinit.def File
For optimal tape device performance, and to ensure that all NetWorker tape operations
function properly, LEGATO recommends that you modify the stinit.def file in the /etc
directory, as appropriate for your device.
Note: The package that provides the stinit binary is mt-st.
Each stinit.def file definition is specific to the manufacturer and model of the tape
device being configured for NetWorker operations, and is based on the requirements
defined in the stinit(8) Linux man page. For further information about stinit(8), see
"Appendix B: stinit(8) Man Page" on page 80, and stinit(8), st(4), mt(1), and
drivers/scsi/README.st in the Linux kernel source tree.
Usage
The examples in this appendix are intended only to be used as guidelines and should
be installed as /etc/stinit.def after necessary modifications have been made for the tape
device model and manufacturer. Once installed, reboot the system to ensure that the
settings in this file will be used.
To ensure you have accurate and current stinit.def file information, refer to the tape
device manufacturer’s requirements for the specific device and model being used. In
addition, the LEGATO Compatibility Guides on the LEGATO web site provide stinit
file definition information to which you can refer.
Examples of the stinit File
The following definitions are a few examples for devices supported by the NetWorker
software, and are based on the instructions in the stinit(8) manual page released with
Linux 7.0 and later.
Device requirements might be different than the parameters specified in these
examples. Users can change these sample definitions to specify the manufacturer and
model fields in the /etc/stinit.def file to correspond to the actual tape device being
defined, and modify the suboptions as necessary.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
77
Appendix A: Sample stinit.def File
Note: The manufacturer, model, and revision strings can be obtained from the file
/proc/scsi/scsi by using the cat /proc/scsi/scsi command. Replace the XYZ and UVWx
strings that are displayed in the following examples with the manufacturer and model
of your drive.
Common definitions to all devices in the examples:
{buffer-writes read-ahead async-writes }
SONY AIT-3
manufacturer=SONY model = "SDX-700C" {
can-bsr scsi2logical drive-buffering
timeout=800
long-timeout=14400
mode1 blocksize=0 density=0x00
st.conf entry }
# as close as possible to
Noncompressing DAT (DDS-1)
manufacturer=XYZ model = “UVW1” {
scsi2logical=1 can-bsr can-partitions auto-lock
mode1 blocksize=0
mode2 blocksize=1024 }
Compressing DAT (DDS-1-DC or DDS-[234])
manufacturer=XYZ model = “UVW2” {
scsi2logical=1 can-bsr can-partitions auto-lock
mode1 blocksize=0 compression=1
mode2 blocksize=1024 compression=1
mode3 blocksize=0 compression=0
mode4 blocksize = 1024 compression=0 }
QIC-150 Drive
manufacturer=XYZ model=”UVW3” {
mode1
# blocksize=512 defined by drive }
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
78
Appendix A: Sample stinit.def File
QIC-320/525 Drive
manufacturer=XYZ model=”UVW4” {
defs-for-writes
mode1 blocksize=0 density=0x11
# QIC-320
mode2 blocksize=1024 density=0x11
# QIC-320
mode3 blocksize=512 density=0x10
# QIC-150 }
Exabyte 8505 and Other Similar 8 mm Helical Scan Drivers
manufacturer=XYZ model = “UVW5” {
scsi2logical=1 can-bsr auto-lock
mode1 blocksize=0 density=0x8c
# 8500 density, compressing
mode2 blocksize=0 density=0x15
# 8500 density, no compression
mode3 blocksize=0 density=0x90
# 8200 density, compressing
mode4 blocksize=0 density=0x14
# 8200 density, no compression }
Reel-to-Reel Tape with 6250/1600/800 bpi Densities
manufacturer=XYZ model = “UVW6” {
can-bsr two-fms
mode1 blocksize=0 density=3
# 6250 bpi
mode2 blocksize=0 density=11
# 1600 bpi
mode3 blocksize=0 density=1
#
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
800 bpi }
79
Appendix B: stinit(8) Man Page
This appendix provides the stinit(8) man page contents. The program and the manual
page are copyrighted by Kai Makisara, 1998-2001. They can be distributed according to
the GNU Copyleft. LEGATO expressly disclaims any rights in or responsibility for the
contents of this appendix. This man page may be obtained from
www.fifi.org/cgi-bin/man2html?stinit+8.
Synopsis
stinit [-f conf_file] [-h] [-p] [-r] [-v] [devices...]
Description
This manual page documents the tape control program stinit that can be used to
initialize SCSI tape drive modes at system startup, after loading the tape driver as
module, or after introducing a new device to the SCSI subsystem at runtime. The
initialization is performed by sending ioctl commands to the drive. The commands are
defined in a text file that is indexed using the inquiry data the drive returns
(manufacturer, device, revision). Values for all of the general and mode-specific SCSI
tape parameters up to Linux version 2.4.15 can be initialized.
Options
Table 10 on page 80 lists the options for the stinit(8) man page.
Table 10. stinit(8) Man Page Options
Option
Description (Part 1 of 2)
-f
Specifies the name of the text file containing the definitions for different
tape drive types. By default stinit tries to find the definition file stinit.def
or /etc/stinit.def (in this order).
-h
Print the usage information.
-p
The definition file is parsed but no tape drive initialization is attempted.
This option can be used for testing the integrity of a definition file after
changes have been made.
-r
Rewind every device being initialized.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
80
Appendix B: stinit(8) Man Page
Option
Description (Part 2 of 2)
-v
The more -v options (currently up to two), the more verbose output.
--version
Print the program version.
The Devices Being Initiated
If the program is started without arguments, it tries to find all accessible SCSI tape
devices and the device files for the different modes of the devices. The tape drives are
searched in the scanning order of the kernel, and searching stops at the first
nonexisting tape. All of the found devices are initialized if a matching description is
found from the parameter file. Note that a mode for a device is not initialized if the
corresponding device file is not found, even if a matching description for the mode
exists. The nonrewind device is preferred over the auto-rewind device for each mode.
If the directory /dev/tapes is found, the devfs filesystem is assumed. The configuration
file is a simple text file that contains descriptions of tape drives and the corresponding
initialization parameters. The parameter definition blocks are delimited by braces
[ { } ]. Specification of the drive description is restarted after each parameter definition
block.
The drive descriptions and the parameter definitions consist of name = value pairs. The
value is either a numeric parameter, a string with no blanks, or a quoted string. If
=value is omitted, the value "1" is used. If the number sign [#] is found in an input line,
the rest of the line is discarded. This allows use of comments in the definition file. The
following example contains definitions for one type of tape drives:
# The XY dat
manufacturer=XY-COMPANY model = "UVW DRIVE" {
scsi2logical=1 # Common definitions for all modes
can-bsr can-partitions auto-lock
# Definition of modes
mode1 blocksize=0 compression=1
mode2 blocksize=1024 compression=1
mode3 blocksize=0 compression=0
mode4 blocksize = 1024 compression=0 }
The devices are identified using zero or more of the following keywords
corresponding to the data the tape device returns in response to the SCSI inquiry
command. The matches are case-sensitive and performed up to the length defined in
the configuration file (permitting use of partial matches).
Table 11. Device Identification
Keyword
Description
manufacturer=
This keyword specifies the string that must match the vendor
identification returned by the device.
model=
This keyword defines the string that must match the product
identification returned by the device.
revision=
This keyword matched the string that must match the product
revision level returned by the device.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
81
Appendix B: stinit(8) Man Page
All of the matching initializations are collected in the order they are defined in the file.
This means that common parameters can be defined for all devices using zero
keywords for a definition block. Another consequence is that, for instance, some
parameters can be easily given different values for a specific firmware revision without
repeating the parameters common to all revisions.
The tape parameters are defined using the following keywords. More thorough
descriptions of the parameters can be found in the st(4) man page or in the
drivers/scsi/README.st file in the Linux kernel source tree. The keywords are matched
using only the first characters. The part of the keywords not used in matching is
enclosed in brackets. The numeric values may be specified either in decimal notation
or hexadecimal notation (using the prefix 0x).
Table 12. Tape Parameter Information
Value
Description (Part 1 of 2)
no-w[ait]
The immediate mode is used with commands like rewind if
value is non-zero (that is, the driver does not wait for the
command to finish).
mode=value
This keyword defines the string that must match the product
identification returned by the device.
disab[led]=value
This mode is disabled for this device if value is non-zero. Can
be used if some mode defined in a more general definition
should be disabled by a more specific definition for some
device (for example, for a device with buggy firmware level).
block[size]=value
The default tape block size is set to value bytes. The block
size zero means variable block mode.
dens[ity]=value
The tape density code is set to value.
buff[ering]=value
The buffered writes by the driver in fixed block mode are
enabled if value is non-zero.
async[-writes]=value
Asynchronous writes by the driver are enabled if value is
non-zero.
read[-ahead]=value
Read-ahead by the driver in fixed block mode is allowed if
value is non-zero.
two[-fms]=value
Two filemarks are written when a file being written to is
closed if value is non-zero. By default, one filemark is written.
comp[ression]=value
Compression of the data by the drive is enabled if value is
non-zero. Note that the tape driver can't enable compression
for all drives that can compress data. Note also that some
drives define compression using density codes.
auto[-lock]=value
Repositioning the tape when read-ahead is enabled if value is
non-zero.
noblk[limits]=value
The tape driver does not use the READ BLOCK LIMITS SCSI
command when the device is being opened if value is
non-zero. This is for the drives that do not support this SCSI
command.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
82
Appendix B: stinit(8) Man Page
Table 12. Tape Parameter Information
Value
Description (Part 2 of 2)
can-p[artitions]=value
The support for tape partitions is enabled if value is non-zero.
scsi2[logical]=value
Logical block addresses are used in the MTSEEK and
MTIOCPOS commands if value is non-zero. The default is to
use the device-specific addresses.
defs-for-w[rites]=value The parameters defining the tape format (density, block size)
are forced when writing starts at the beginning of a tape if
value is non-zero. The default is to change these parameters
each time the device is opened at the beginning of a tape (or
the mode is changed in the middle of a tape).
timeout
The normal timeout for the device is set to value seconds.
long-time[out]
The long timeout for the device is set to value seconds.
Return Value
The program exits with value of one if the command line is incorrect, the definition file
is not found, or the -p option is given and parsing the definition file fails. In all other
cases the return value is zero (that is, failing of initialization is not currently signaled
by the return value).
Restrictions
With the exception of the -p option, only the superuser can use the stinit program. This
is because the program uses ioctls allowed only for the superuser.
LEGATO NetWorker, Release 7.2, Linux Version
Installation Guide
83