Legato License Manager Administrator`s Guide, Rel. 1.0

Legato License Manager
®
Administrator’s Guide
Release 1.0
© 2000, Legato Systems, Inc. All rights reserved.
Legato, the Legato logo, Legato NetWorker, ClientPak, Octopus, and SmartMedia are registered trademarks; and Celestra, Co-StandbyServer, eCluster,
GEMS, SnapShotServer, and StandbyServer are trademarks of Legato Systems, Inc. in the United States and/or other countries.
All other trademarks are the trademarks of their respective owners.
Legato License Manager Administrator’s Guide
August 2000
P/N e2-1953-01
THIS PRODUCT CONTAINS CERTAIN COMPUTER PROGRAMS AND OTHER PROPRIETARY MATERIAL, THE USE OF WHICH IS SUBJECT TO
THIS END-USER LICENSE AGREEMENT (THE "AGREEMENT"). DO NOT PROCEED WITH THE INSTALLATION OF THIS PRODUCT UNTIL YOU
(LATER DEFINED AS LICENSEE) HAVE READ THIS AGREEMENT AND AGREE TO BE BOUND BY AND BECOME A PARTY TO THIS AGREEMENT.
BY PROCEEDING WITH THE INSTALLATION OF THIS PRODUCT (OR AUTHORIZING ANY OTHER PERSON TO DO SO), YOU AND YOUR
COMPANY ACCEPT THIS AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, YOU MAY EXIT THE INSTALLATION
PROCESS AND RETURN THIS PRODUCT, ALL MEDIA AND DOCUMENTATION, AND PROOF OF PAYMENT, TO THE PLACE YOU OBTAINED
THEM FOR A FULL REFUND WITHIN TEN (10) DAYS OF FIRST ACQUIRING THIS PRODUCT. WRITTEN APPROVAL IS NOT A PREREQUISITE
TO THE VALIDITY OR ENFORCEABILITY OF THIS AGREEMENT 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 code provided to Licensee by Legato
for permanent authorization to use the Software. The Authorization Code
is provided to Licensee once the Enabler Code is registered with Legato.
1.2 Documentation: means any 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 Agreement, together with the associated
original electronic media and all accompanying manuals and other
documentation, and together with all enhancements, upgrades, and
extensions thereto 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.
Licensee further acknowledges and agrees that it shall have no rights with
respect to any of the foregoing rights other than the rights expressly set
forth in this Agreement.
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 Enabler Code is installed 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 Agreement, license (the "License") to (i) use the Software
installed in accordance with the Documentation and only on the licensed
computer solely for its own internal operations; and (ii) move the Software
temporarily in case of computer system malfunction. The License granted
under this Agreement 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. Where
the Software is provided to Licensee at no charge for evaluation purposes
only, the License granted is limited to a continuous thirty (30) day period,
commencing with the acceptance of this Agreement (the "Evaluation
Period"). At the conclusion of the Evaluation Period, Licensee agrees to
destroy the Software and certify its destruction to Legato, in writing,
within ten (10) days, or shall return the Software to Legato or purchase a
perpetual license.
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
on the licensed computer and is used in no other manner; or (ii) used for
archival purposes to back-up the licensed computers. 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, or otherwise use or allow others to use the Software or any
portion thereof to or for the benefit of third parties; (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 Agreement.
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
previous version of the same Software. The Update may only be used in
accordance with the provisions of this Agreement. The Update, together
with the original Software, constitute 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 enter into a longer-term license
agreement with Legato, Licensee shall obtain an appropriate Enabler and
Authorization Code in accordance with Section 2.2 above, upon payment
of applicable fees, which authorizes use of the Software after such
evaluation period, but only subject to all of the terms and conditions of this
Agreement. In the event Licensee determines not to enter into a licensing
transaction with Legato at the end of such thirty (30) day evaluation
period, then Licensee's rights under this Agreement shall terminate
automatically and Licensee shall promptly return to Legato or destroy all
copies of the Software and so certify to Legato.
4. MAINTENANCE AND SUPPORT
4.1 Legato has no obligation to provide support, maintenance, upgrades,
modifications, or new releases under this Agreement. Legato may provide
such services under separate agreement.
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 Software. 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.
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 Agreement shall
terminate immediately without notice.
6. TERM AND TERMINATION
6.1 Term. The term of this Agreement is perpetual unless terminated in
accordance with its provisions.
6.2 Termination. Legato may terminate this Agreement, without notice,
upon Licensee's breach of any of the provisions hereof.
6.3 Effect of Termination. Upon termination of this Agreement, 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 Agreement shall
survive termination.
7. DISCLAIMER AND LIMITATIONS
7.1 Warranty Disclaimer. EXCEPT FOR THE LIMITED WARRANTY
PROVIDED IN SECTION 5 ABOVE, LEGATO MAKES 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. ALL SOFTWARE IS
PROVIDED "AS IS" AND 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. This warranty
provides specific legal rights. Other rights vary from state to state.
Licensee acknowledges and agrees that Legato is not responsible for and
will have no liability for hardware, software, or other items or services
provided by persons other than Legato.
8. LIMITATION OF LIABILITY
8.1 Limitation of Liability. NOTWITHSTANDING ANYTHING ELSE IN
THIS AGREEMENT OR OTHERWISE, AND EXCEPT FOR BODILY
INJURY, LEGATO WILL IN NO EVENT BE LIABLE OR RESPONSIBLE
FOR OR OBLIGATED WITH RESPECT TO THE SUBJECT MATTER OF
THIS AGREEMENT UNDER ANY CONTRACT, NEGLIGENCE, STRICT
LIABILITY, OR OTHER LEGAL CONTRACTUAL 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 ANY MATTER
BEYOND ITS REASONABLE CONTROL. NOTWITHSTANDING
ANYTHING IN THIS AGREEMENT TO THE CONTRARY OR THE
FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITATION OF
LIABILITY OR LIMITED REMEDY, LEGATO'S ENTIRE AGGREGATE
LIABILITY ARISING FROM OR RELATING TO THIS AGREEMENT OR
THE SUBJECT MATTER HEREOF, UNDER ANY LEGAL THEORY
(WHETHER IN CONTRACT, TORT, INDEMNITY OR OTHERWISE)
SHALL BE LIMITED TO THE AMOUNTS RECEIVED BY LEGATO FOR
THE SOFTWARE DURING THE SIX (6) MONTH PERIOD PRIOR TO
THE DATE THE CLAIM AROSE FOR THE PARTICULAR LEGATO
SOFTWARE THAT CAUSED THE LIABILITY.
9. MISCELLANEOUS
9.1 Governing Law. This Agreement shall be governed by the laws of the
State of California, as applied to agreements entered into and to be
performed entirely within California between California residents,
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. This provision applies to Software
acquired directly or indirectly by or on behalf of any government. 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. Any use, modification, reproduction,
release, performance, display, or disclosure of the Software by any
government shall be governed solely by the terms of this Agreement and
shall be prohibited except to the extent expressly permitted by the terms of
this Agreement, and no license to the Software is granted to any
government requiring different terms.
9.3 U.S. Government Users. As defined in FAR section 2.101, DFAR section
252.227-7014(a)(1), DFAR section 252.227-7014(a)(5), or otherwise, all
software and accompanying documentation provided in connection with
this Agreement are "commercial items," "commercial computer software"
and/or "commercial computer software documentation." Consistent with
DFAR section 227.7202 and FAR section 12.212, any use, modification,
reproduction, release, performance, display, disclosure, or distribution
thereof by or for the U.S. Government shall be governed solely by the terms
of this Agreement and shall be prohibited except to the extent expressly
permitted by the terms of this Agreement. Licensee will ensure that each
copy used or possessed by or for the government is labeled to reflect the
foregoing.
9.4 Export and Import Controls. Regardless of any disclosure made by
Licensee to Legato of an ultimate destination of the Products, Licensee will
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.5 Assignment. This Agreement 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 Agreement upon notice to Licensee.
9.6 Sole Remedy and Allocation of Risk. Licensee's sole and exclusive
remedy is set forth in this Agreement. This Agreement defines a mutually
agreed-upon allocation of risk, and the License price reflects such
allocation of risk.
9.7 Equitable Relief. The parties agree that a breach of this Agreement
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.8 No Waiver. Failure by either party to enforce any provision of this
Agreement 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.9 Severability. If for any reason a court of competent jurisdiction finds
any provision of this Agreement, or portion thereof, to be unenforceable,
that provision of the Agreement will be enforced to the maximum extent
permissible so as to effect the intent of the parties, and the remainder of this
Agreement will continue in full force and effect.
10. ENTIRE AGREEMENT
10.1 This Agreement sets forth the entire understanding and agreement
between the parties and may be amended only in a writing signed by
authorized representatives of both parties. No vendor, distributor, dealer,
retailer, sales person, or other person is authorized by Legato to modify
this Agreement or to make any warranty, representation, or promise which
is different than, or in addition to, the warranties, representations, or
promises made in this Agreement.
Contents
Contents .................................................................................................................... 5.
Preface....................................................................................................................... 9.
Audience......................................................................................................................................... 9.
Legato Product Manuals and Documentation ................................................................................ 9.
Conventions.................................................................................................................................. 10.
Year 2000 Compliance ................................................................................................................. 10.
Information and Services .............................................................................................................. 11.
Technical Support......................................................................................................................... 11.
Customer Service ......................................................................................................................... 12.
Customer Feedback ..................................................................................................................... 12.
Chapter 1: Introduction.......................................................................................... 13.
Overview of Legato License Manager .......................................................................................... 13.
Products Supported by the License Manager ........................................................................ 14.
Types of Licences .................................................................................................................. 14.
Enterprise Licensing............................................................................................................... 14.
GEMS 1.3 and Legato License Manager ............................................................................... 14.
How to Set Up GEMS to Work With the License Manager.............................................. 15.
License Manager System Information .......................................................................................... 15.
Architecture and Operation .................................................................................................... 15.
License Manager Files and Filepaths .................................................................................... 16.
UNIX ................................................................................................................................ 16.
Windows NT® and Windows 2000® ............................................................................... 17.
If the License Manager Server Fails ...................................................................................... 17.
Planning for Failure of the License Manager Server ....................................................... 17.
Frequently Asked Questions............................................................................................ 17.
You Have Several Weeks to Restart the License Manager............................................. 18.
Backing Up the License Manager Using NetWorker.............................................................. 18.
Chapter 2: Installing Legato License Manager .................................................... 21.
Review the License Manager Release Supplement ..................................................................... 21.
Installing License Manager on UNIX ............................................................................................ 21.
How to Install on Solaris......................................................................................................... 21.
5
Contents
Deinstallation on Solaris......................................................................................................... 24.
How to Install on AIX.............................................................................................................. 25.
How to Install on HP-UX 10.x and 11.x.................................................................................. 25.
Deinstallation on HP-UX ........................................................................................................ 27.
Installation on Sequent........................................................................................................... 27.
Installation on SGI IRIX.......................................................................................................... 27.
Installation Using the GUI ................................................................................................ 27.
Installation Using the Command Line .............................................................................. 28.
Deinstalling from SGI IRIX............................................................................................... 29.
Installation on Compaq Tru64 UNIX (formerly Digital UNIX) ................................................. 29.
Install NetWorker Client ................................................................................................... 30.
Install the License Manager............................................................................................. 30.
How to Install on Linux ........................................................................................................... 31.
Deinstallation on Linux ........................................................................................................... 35.
Windows NT and Windows 2000 License Manager Installation ................................................... 35.
Installation .............................................................................................................................. 36.
Repair and/or Removal .......................................................................................................... 38.
How to Start and Stop the License Manager ................................................................................ 40.
UNIX....................................................................................................................................... 40.
To Start License Manager ............................................................................................... 40.
To Stop License Manager................................................................................................ 40.
Windows NT and Windows 2000 ........................................................................................... 40.
Windows NT .................................................................................................................... 40.
Windows 2000 ................................................................................................................. 41.
Disabling the License Manager .................................................................................................... 41.
How to Revert a NetWorker Server to Local Licensing ................................................................ 42.
Chapter 3: Creating and Maintaining Licenses ................................................... 43.
Using the License Manager .......................................................................................................... 43.
Installing and/or Moving Licenses into the License Manager Database ................................ 44.
To Install Large Numbers of Licenses ............................................................................. 44.
To Move a Single License ............................................................................................... 45.
How to Set Up NetWorker to Work with License Manager .................................................... 45.
How To Acquire Licenses from the License Manager............................................................ 46.
lgtolic Command Line Utility................................................................................................... 46.
Host IDs and NetWorker 6.x on Windows NT.................................................................. 46.
Synopsis .......................................................................................................................... 46.
6
Contents
Options ............................................................................................................................ 47.
Environment Variables..................................................................................................... 48.
Examples ......................................................................................................................... 48.
Diagnostics ...................................................................................................................... 50.
How To Set Up Allowances for a NetWorker Server in the License Manager Database....... 50.
Authorizing Licenses Over the Web ............................................................................................. 51.
Appendix A: Troubleshooting ............................................................................... 53.
Messages Generated by the License Manager ............................................................................ 53.
Add the license with the -c option before attempting to authorize it....................................... 53.
Attempting to remove more usage than possible (%d, %d) ................................................... 54.
Cannot add authorization code to evaluation licenses........................................................... 54.
Cannot add eval license to database--license type already exists......................................... 54.
Cannot alter expiration date on a license in a grace period ................................................... 54.
Cannot alter expiration date on a nonexistent license. .......................................................... 54.
Cannot get host IP address! ABORTING!.............................................................................. 55.
Cannot increment the usage for this particular license type .................................................. 55.
Cannot locate the license binding for appliance <hostname>:<appliance>).......................... 55.
Cannot overwrite existing authorization code ........................................................................ 55.
Cannot release usage for license not in use .......................................................................... 55.
Cannot release usage for non-existent license ...................................................................... 56.
Cannot release usage for non-existent license type. ............................................................. 56.
Cannot release %d usage counts .......................................................................................... 56.
Enabler code %s has not been located.................................................................................. 56.
Invalid enabler code specified................................................................................................ 56.
Invalid parameters specified within License API [<parameters>]........................................... 56.
License resource is corrupted ................................................................................................ 57.
Need a base enabler to authorize '%s' license ...................................................................... 57.
Registration information provided is incomplete .................................................................... 57.
Additional Messages .................................................................................................................... 57.
Archive support has not been properly enabled..................................................................... 57.
lgtolic: Remote system error. ................................................................................................. 57.
lgtolmd: You are not authorized to run this command............................................................ 58.
nsrlmc: RPC error, Program not registered (severity 4, number 15).
nsrlmc: lgtolmd did not respond. ............................................................................................ 58.
lgtolmd: SYSTEM notice, Resource file /nsr/lic/tmp/res.lck already in use; check for another
copy of lgtolmd already runnning. Error initializing resource file. ........................................... 59.
lgtolic: Program/version mismatch ......................................................................................... 59.
7
Contents
Server disabled; The evaluation enabler code for the <feature> expired. Install the permanent
enabler code. ......................................................................................................................... 60.
RAP error <error-code>: Enabler type is for a different platform ........................................... 60.
lost connection to server: Authentication error....................................................................... 60.
License enabler #<enabler-code> (<product or feature>) will expire in <n> day(s)............... 60.
The jukebox <jukebox> is not properly licensed. Make sure the jukebox is properly enabled and
authorized. ............................................................................................................................. 61.
The feature <feature> is not properly enabled ....................................................................... 61.
RPC error: Program not registered ........................................................................................ 61.
RPC error: RPC program or version mismatch...................................................................... 62.
Description of lgtolmd Daemon .................................................................................................... 63.
Synopsis................................................................................................................................. 63.
Description ............................................................................................................................. 63.
Options................................................................................................................................... 63.
Files........................................................................................................................................ 63.
Running lgtolmd in Debug Mode .................................................................................................. 63.
Running nsrd in Debug Mode ....................................................................................................... 64.
Old and New License Names ....................................................................................................... 65.
Glossary .................................................................................................................. 91.
Index ...................................................................................................................... 103.
8
Preface
The Legato® License Manager Administrator’s Guide contains information on how to
install, configure, and manage the Legato License Manager software to ensure that
Legato products installed on a network are properly licensed from a central server.
With Legato License Manager, your Legato product licenses can be managed from one
computer.
The License Manager is installed as part of Legato NetWorker® release 6.0 and later,
and also as part of other Legato products. If you want to install the License Manager
on a server without NetWorker, or if you declined to install the License Manager when
installing NetWorker and would like to install it now, refer to Chapter 2 for installation
instructions.
Because NetWorker retains licensing functionality, you do not have to move your
licenses immediately to the License Manager. However, using License Manager is
encouraged for managing your licenses, especially if you have more than one
NetWorker server installed in your organization, so you should make plans to migrate
your licenses at your earliest convenience.
For details on how to move licenses from a NetWorker server to the License Manager,
refer to “Installing and/or Moving Licenses into the License Manager Database” on
page 44.
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.
Legato Product Manuals and Documentation
Legato offers an extensive archive of product documentation at its web site
(www.legato.com). You can view the archive by product, title, version, and OS/platform.
Most of the documents are in Portable Document Format (PDF) that you can easily
view by downloading Adobe Acrobat® Reader, which is provided on your
Documentation Suite CD and is also available from the Legato web site. To install and
use the Adobe Acrobat Reader software on the platform of your choice, refer to the
instructions in the readme.txt file in the acroread directory on the Documentation Suite
CD-ROM, or refer to the Adobe web site at www.adobe.com.
9
Preface
Conventions
This manual uses the following typographic conventions and symbols to make
information easier to access and understand.
•
boldface – Indicates commands to be entered on the DOS or UNIX® command
line . For example:
The lgtolic command starts the command line interface for the License Manager.
•
italic – Used for directory pathnames, files, computer names, URLs, and new
terms defined in the glossary or within the chapter, and to emphasize words or
ideas. For example:
Messages are also written to /nsr/logs/daemon.log.
•
fixed-width – Used for examples and information displayed on the screen.
For example:
license rejected for client [client name]
•
Pull-down_menu>Command>Command – Depicts a path or an order to follow
for making selections in the GUI, if one is present. For example:
File>Save
•
fixed-width, boldface – Used in sample sessions to highlight user input,
such as commands and options, that you must type exactly as shown. For
example:
lgtolic -i
•
fixed-width, boldface italic – Used to highlight user input in which you
need to include a variable. For example:
lgtolic -s server_name -c enabler_code
•
Important: Indicates important information and cautionary notes that prevent
you from making a mistake.
Year 2000 Compliance
Legato License Manager supports dates in the year 2000 and beyond. For additional
information and details about related test cases, see the Year 2000 Compliance (Y2K)
section on the Legato web site at www. legato.com.
10
Preface
Information and Services
Legato offers a variety of services, including electronic and telephone support, that
provide company, product, and technical information.
Legato Service or
Resource
Company &
Technical Binary
Product
Training
Bulletins Patches Information Programs
www.legato.com
Yes
Yes
ftp.legato.com,
Internet address
137.69.200.1
(log in as anonymous)
Yes
Yes
Legato Inside Sales,
(408) 530-3000 or
[email protected]
Legato Education
Services,
(650) 812-6096 or
[email protected]
Yes
Yes
Yes
Yes
Note: For detailed information about our services, support policies, and software subscriptions,
please refer to the Legato Customer Service and Support Guide included in the media package.
Technical Support
The Support section of the Legato web site provides contact information, software
patches, technical documentation, and information about available support programs.
•
•
If you have an active support agreement, you may access TechDialog, the Legato
integrated product knowledge base. You may also contact Legato Technical
Support for help with Legato software issues.
If you do not have an active support agreement, contact LegatoCare to purchase
annual Software Update Subscriptions, Legato Technical Support services, or
per-update/per-incident support.
11
Preface
Customer Service
Legato provides a variety of ways for you to contact Customer Service. To register your
Legato products, go to the Legato licensing web site. To ask questions about licensing,
to transfer licenses, or to learn the status of your order, contact Legato using one of the
following methods.
Customer Service
Address
Legato licensing web site
license.legato.com
Telephone number
(650) 812-6000 (option 3)
Fax number
(650) 812-6220
E-mail
[email protected]
E-mail for order status
[email protected]
Note: You can now register and authorize your Legato products via the World Wide
Web. Legato's web authorization can be completed in just a few minutes and is
available 24 hours a day, seven days a week. To register and authorize Legato products
via the www, simply point your web browser to: http://license.legato.com, and
follow the step-by-step instructions.
Should you have any questions regarding your new software update please send an
email to Customer Service at [email protected]. You can also send a FAX to (650) 8126220, or call Legato's Customer Service Hotline at (650) 812-6000, selection 3.
Customer Feedback
The Legato License Manager team welcomes your comments and suggestions about
software features, the installation procedure, and documentation. Please send any
suggestions and comments to [email protected]. You will receive a notice confirming
receipt of your e-mail. Although we cannot respond personally to every request, we
consider all your comments and suggestions during product design.
Help us improve our documentation and be eligible to win a photo-holder mousepad
or other prize by completing a brief survey. Vistit the Legato web site at www.legato.com,
go the Manuals page, then look for the link to the Legato Documentation Survey.
12
Chapter 1: Introduction
This chapter contains an overview of the Legato License Manager and its components,
architecture, and operations.
Overview of Legato License Manager
The License Manager provides a central server location to manage all of your Legato
product licenses. Once the License Manager is installed and functional, you no longer
have to physically go to each of your NetWorker servers to perform license upgrades
and authorizations. The License Manager includes the following features:
•
•
•
•
•
•
•
•
The License Manager is supported on all platforms that support NetWorker 6.0
and later. For details, refer to the Legato Compatibility Guide, on the web at
www.legato.com.
The License Manager is provided as an installation option with NetWorker 6.0
and later, and as a required item with SmartMedia server.
It provides a central server for managing your licenses.
The License Manager provides flexibility to your NetWorker server setups by
allowing you to move servers within a domain, and also to decomission and
recommission a server with minimal disruption to the licensing process.
It can be used in place of the GEMS™ License Manager. For details, see “GEMS
1.3 and Legato License Manager” on page 14.
Only one installation of the License Manager is required on a network. However,
because it is an installation option with NetWorker, you may have the License
Manager installed on multiple NetWorker servers. To eliminate duplicate
installations, you can rename the License Manager executables on any NetWorker
server that will not be used as the License Manager server. For details, see
“Disabling the License Manager” on page 41.
Once a License Manager has been set up, use the nwadmin program to set up
your NetWorker servers so that they will contact the License Manager server for
their licenses. For details, see “Installing and/or Moving Licenses into the License
Manager Database” on page 44.
The License Manager does not validate licenses; it accepts all valid Legato licenses
and authorization codes. Validation occurs in the Legato application (such as
NetWorker), which determines whether a license of a specific type is required to
use the product or a specific feature of the product, and then requests such license
from the License Manager.
13
Chapter 1: Introduction
Products Supported by the License Manager
The License Manager works with any Legato product that has been designed to contact
it for licenses, including NetWorker and its ancillary functions like client, autochanger
and storage node support. Refer to the Legato License Manager Release Supplement on
your Documentation Suite CD-ROM, or on the Legato website at www.legato.com, for
the current set of products that work with the License Manager.
SmartMedia installs and uses its own version of License Manager. For more details on
using License Manager with SmartMedia, refer to the SmartMedia documentation,
available on the Legato website at www.legato.com.
NetWorker Modules for Oracle® and other database programs are supported by the
Legato License Manager. If bulk enablers are available, install bulk enablers on the
License Manager server. If bulk enablers are not available, you can install as many
single licenses as you need on the License Manager server, or license the NetWorker
Module locally on each NetWorker server.
Note: If you install your NetWorker Module license locally on a NetWorker server, then
all of the licenses used by that NetWorker server must be installed locally.
Types of Licences
This section describes different types of licenses that can be managed by the License
Manager. While the License Manager can manage single licenses, it will be most
effective when used with multiple-unit and/or bulk enabler licenses.
•
•
•
•
Base enabler license – License for the NetWorker server software. This license can
reside on the License Manager server or on the NetWorker server.
Single-unit license – License for a single application. This license can reside on the
License Manager server or on the NetWorker server. For example, a single-unit
license would allow you to license one NetWorker server, or one autochanger
module, and so on.
Multiple-unit license – Composite of bulk licenses that fulfills the needs of an
enterprise or large site running numerous Legato products.
Bulk enabler license – Single license, installed on the License Manager server, that
can be allocated to more than one Legato product (e.g., more than one NetWorker
server).
Enterprise Licensing
Legato customers can now use bulk enabler licenses with the License Manager to
enable multiple instances of a Legato product. For example, a bulk enabler code for 100
NetWorker servers can allow you to enable 100 NetWorker servers in one command
line operation. A single authorization code for the bulk enabler is all that is needed to
authorize the enablers permanently. For details, refer to “Installing and/or Moving
Licenses into the License Manager Database” on page 44.
GEMS 1.3 and Legato License Manager
The GEMS License Manager (GLM, part of GEMS 1.x) and the Legato License Manager
(LLM) cannot coexist on the same computer. However, you can disable the GLM on
your GEMS 1.3 GEMStation and use the LLM instead. This is recommended for
installations that will depend heavily on license management. For details, see the
GEMS 1.3 Release Supplement, located on the web .
14
Chapter 1: Introduction
Note: The LLM and GLM both support the concept of allowances, which provides a way
for the administrator to allocate a specific number of licenses to any particular
NetWorker server. However, the method of setting up allowances differs for the LLM.
For details, refer to “How To Set Up Allowances for a NetWorker Server in the License
Manager Database” on page 50.
How to Set Up GEMS to Work With the License Manager
To set up GEMS to work with the Legato License Manager that was installed with
NetWorker or to work by itself as a Legato License Manager server, follow these steps.
For the latest details, refer to the web-based GEMS Release Supplements at
www.legato.com.
The GEMS License Manager (GLM) and the Legato License Manager (LLM) cannot
operate simultaneously on the same computer. If you decide you want to use the LLM
instead of the GLM, follow these steps:
1. Shut down the GEMS licensing daemon (gemslmd), and rename the binary so that
it will not start when GEMS is restarted. On UNIX, gemslmd is in the following
path locations:
/[install path]/gems/bin (on UNIX)
%GEMS_HOME%\bin\gemslmd.exe (on Windows NT®)
2. Install the Legato licensing package (for details, see Chapter 2). Do not answer
“yes” to starting the daemons at the end of the installation.
3. Copy the GEMS license resource file from the following path:
/[installpath]/gems/res/gemslm.res
to the resource file for the LLM (one of the following):
(on UNIX)
[install_path]/nsr/lic/res/lgtolm.res
or
(on Windows NT)
[install_drive]:\nsr\lic\res\lgtolm.res
4. Start the Legato licensing daemon with the startup script for NetWorker on your
system.
License Manager System Information
Architecture and Operation
Figure 1 shows the typical interaction between the various daemons and binaries
involved in the license management process.
15
Chapter 1: Introduction
Figure 1. License Manager Architecture
NetWorker Server
License Manager Server
NetWorker Server
nsrlmc
lgtolmd
nsrlmc
nsr/lic/res/lgtolm.res
The license agent nsrlmc is run as needed by nsrd on each NetWorker server and
communicates with the daemon lgtolmd on the License Manager server. nsrlmc is
invoked by nsrd to:
•
•
Perform a periodic check between the external licenses obtained from the License
Manager and the License Manager’s internal accounting of license allocations.
This ensures that the information is synchronized.
Obtain a specific license type from the License Manager when needed.
nsrlmc is exclusively used by nsrd to obtain, update, and relinquish licenses from the
License Manager.
Each NetWorker server contains an entry, editable through the nwadmin program,
naming the License Manager server it should contact to get licenses. For details on
naming a License Manager for your NetWorker server, and migrating your NetWorker
licenses to the License Manager, see “How to Set Up NetWorker to Work with License
Manager” on page 45.
It is the responsibility of the application to request or give up licenses; the License
Manager does not do either without a request from the application. For details on
adding and removing a license to an application program, like NetWorker, see “How
To Acquire Licenses from the License Manager” on page 46.
License Manager Files and Filepaths
Installation places files in specific directories, depending on the server and the
operating system, either UNIX®, Windows NT®, or Windows 2000®.
UNIX
Executables are lgtolic and lgtolmd. Their locations vary depending on the operating
system. For the locations of the executable files, refer to Table 1 on page 41. The
following nonexecutable files are installed onUNIX servers:
•
•
/nsr/lic/res/lgtolm.res – The License Manager database, which contains attributes
describing the License Manager daemon’s license resources.
/nsr/lic/res/lictype.res – An internal file, not to be manually modified, moved, or
renamed.
16
Chapter 1: Introduction
•
/nsr/lic/logs/ lgtolmd.log – The License Manager log file, which contains diagnostic
and informational messages on the license daemon. For example, if a license has
expired, this information will be printed to this log, as well as to the console.
Windows NT® and Windows 2000®
Executables are lgtolic.exe and lgtolmd.exe. Refer to Table 1 on page 41 for the
locations of the executable files.
•
•
•
c:\Program Files\Legato\Lic\res\lgtolm.res – The License Manager database,
which contains attributes describing the License Manager daemon’s license
resources.
c:\Program Files\Legato\Lic\res\lictype.res – An internal file, not to be manually
modified, moved, or renamed.
c:\Program Files\Legato\Lic\logs\lgtolmd.log – The License Manager log file,
which contains diagnostic and informational messages on the license daemon.
For example, if a license has expired, this information will be printed to this log
as well as to the console.
If the License Manager Server Fails
It is important to understand the dynamics between your NetWorker servers and the
License Manager server, because the License Manager server can become the sole
source of licenses for your Legato Products. What if the License Manager ceases to
function? What should you do to prepare for this possibility, and will you still be able
to run backups if the License Manager becomes temporarily inoperative?
Planning for Failure of the License Manager Server
You can plan for the possibility of a failure at the License Manager server by setting up
an alternate License Manager server. Then, at each NetWorker server, run nwadmin
and name the alternate License Manager server in the same field where the primary
License Manager server is named. For details on naming a License Manager for your
NetWorker server, see “Installing and/or Moving Licenses into the License Manager
Database” on page 44.
Example:
If your primary License Manager server is named daisy, and your backup is named rose,
you would enter rose as an alternate License Manager server. Then, if daisy becomes
unavailable, the NetWorker server will automatically appeal to rose for licenses. You
will have to install licenses on rose to duplicate the licenses that you have installed on
daisy. Both License Manager servers should have similar sets of licenses, with different
enabler codes, and all licenses should be authorized. When a NetWorker synchronizes
with the new License Manager server, the nsrlmc program will ask for the same set of
licenses.
Frequently Asked Questions
1. Does NetWorker check the License Manager server regularly to discover if it is still
functioning?
Yes. NetWorker contacts License Manager every two hours to synchronize the
usage counts on the License Manager with the actual number of licenses allocated
17
Chapter 1: Introduction
to the NetWorker server. NetWorker also contacts the License Manager whenever
it needs a license. If the License Manager is unreachable, a message is logged in
daemon.log. NetWorker does not delete its external licenses.
2. If the License Manager ceases to function, are there periodic checks and attempts
to reacquire licenses when the License Manager server comes back up?
The NetWorker server contacts License Manager in three modes: on startup,
whenever it needs a license, and every two hours to synchronize usage counts on
the License Manager with the actual number of licenses allocated to the NetWorker
server. NetWorker always retries whenever it fails to contact the License Manager
server. The licenses are reallocated, if necessary, once contact with the License
Manager is reestablished.
3. If a License Manager application like NetWorker ceases to function, does the
License Manager server eventually free the licenses it has allocated to the
nonfunctional NetWorker server?
No. The License Manager does nothing until requested by the application to make
a change. If the application is down, the request cannot happen.
You Have Several Weeks to Restart the License Manager
When a NetWorker server gets its base enabler license from a license manager server,
that license is cached at the NetWorker server. It expires 45 days after receipt. The
NetWorker server will continue to do backups during those 45 days regardless of the
state of the License Manager server, provided that the NetWorker server:
•
•
•
remains up and running.
does not add new clients (in excess of the number of client licenses it has cached).
is not requested to back up other things for which it does not have cached
licenses.
If you remove a license which is cached on the NetWorker server, and the License
Manager server is not functioning, then you'll be inconvenienced. However, as long as
you're within the 45 day limit which started when the NetWorker server last updated
its license, your backups will execute normally.
If an external base enabler has expired, it is deleted. This can happen if, during the
nightly check of licenses that NetWorker performs, it cannot contact the License
Manager. However, an evaluation enabler should be automatically put in its place, so
you have 30 more days to get your License Manager server working. Meanwhile,
you’re not losing any functionality, because an evaluation license turns everything on.
Backing Up the License Manager Using NetWorker
The License Manager server must be a NetWorker Client. The License Manager
installation procedure includes installing the NetWorker Client software, and the
Client installation requests the name of a NetWorker server that will back up the
License Manager server. If you name a NetWorker server, say duster, then make sure to
configure duster to backup the License Manager server. If you don’t name a NetWorker
server during the Client installation, then any NetWorker server can back up the
License Manager, and you should ensure that at least one NetWorker server is
configured to back up the License Manager server.
18
Chapter 1: Introduction
Important: It is most important to make sure that the /nsr directory on the License
Manager server is backed up regularly. On Windows NT and Windows 2000, be sure
to back up the c:\Program Files\Legato\Lic\ directory and all of its contents.
Important: It is possible to run NetWorker and the License Manager on the same
computer. In this case, if there is a disaster recovery required on the NetWorker server,
the lictype.res file of the License manager is not restored, because the License Manager
files and directories are not considered part of NetWorker. After the disaster recovery
on the NetWorker server, you must explicity recover the License Manager as a client of
the NetWorker server.
19
Chapter 1: Introduction
20
Chapter 2: Installing Legato License Manager
This chapter describes how to install and configure the License Manager software on a
network server, including:
•
•
•
•
•
•
Reviewing the License Manager Release Supplement
Installing License Manager on UNIX
Installing License Manager On Windows NT and Windows 2000
Starting and stopping License Manager
Disabling a License Manager
Reverting to a Local License
After installing the License Manager software on a network server, be sure to start the
program, as detailed in this chapter. Then go to Chapter 3 for information on how to
install licenses into the License Manager database, and how to migrate existing licenses
from your NetWorker servers to the License Manager database.
Review the License Manager Release Supplement
Before you install the License Manager software, be sure to read the Legato License
Manager Release Supplement. This document may contain additional information
regarding installation and setup. You can access the release supplement in two ways:
•
•
From the Legato Documentation Suite CD-ROM. The files are in .pdf format. For
the path to the License Manager documentation, refer to the RoadMap document
available with the media kit.
From the Legato website at www.legato.com, under the Release Supplements
section of Technical Documentation. The website contains the most up-to-date
version of the Release Supplement.
Installing License Manager on UNIX
Have in mind the name of one or more NetWorker servers that you will assign to back
up the License Manager server.
How to Install on Solaris
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM. For details on the various prompts
you will see, refer to the Legato NetWorker Installation Guide Release 6.x, Solaris Version.
21
Chapter 2: Installing Legato License Manager
To install the License Manager on a system with a CD-ROM drive attached:
1. Ensure that you have root priveleges on the system where you want to install the
License Manager software.
2. Insert the NetWorker distribution CD-ROM into the drive.
3. Mount the CD-ROM drive.
4. Change directory on the CD-ROM to the location of the Solaris NetWorker
software, as defined in the Roadmap document in your Legato Software media kit.
Then run the “package add” command as shown in the example below.
prompt> pkgadd -d .
The following packages are available:
1
LGTOclnt
NetWorker for Solaris (Backup/Recover) Client
(sparc) rt_1999_3Q.Build.17
2
LGTOlicm
NetWorker for Solaris (Backup/Recover) Licensing Manager
(sparc) rt_1999_3Q.Build.17
5. Select the LGTOclnt option first, then the LGTOlicm option (options 1 and 2) as
shown in the following example.
Note: The client software is always required to be installed when installing the
License Manager. If the client software is already installed, you can specify just the
LGTOlicm option (2 in this example).
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1,2 [enter]
6. Answer further prompts as shown in bold.
Directory to use for client, licensing and server information [/nsr]?
[enter]
The nsrexecd program restricts access to a select set of NetWorker
servers.
Please enter the names of each computer running a NetWorker
server that will back up this computer, one name at a time.
If a
computer has more than one network interface, please enter each
interface's name (one at a time).
Note: To allow access to all NetWorker servers, press [enter] without typing new
input. Otherwise type the name of a NetWorker server to which you will allow access
and press [enter]. You’ll be prompted for the next server. Press [enter] without a
server name when done listing servers.
Enter the first NetWorker server's name [no more]: [enter]
Start NetWorker daemons at end of install [yes]? n [enter]
.
.
22
Chapter 2: Installing Legato License Manager
.
Note: If you are reinstalling the License Manager, or if you have installed NetWorker
previously and are adding the License Manager separately, you may see a list of files,
and the following prompt.
Do you want to install these conflicting files [y,n,?,q] y [enter]
.
.
.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation
of <LGTOclnt> [y,n,?] y [enter]
.
.
.
Directory to use for client, licensing and server
information [/nsr]? [enter]
Start NetWorker daemons at end of install [yes]? n [enter]
Using </usr> as the package base directory.
.
.
.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of
<LGTOlicm> [y,n,?] y [enter]
.
.
.
NetWorker successfully installed on `duster'!
Installation of <LGTOlicm> was successful.
.
.
.
Select package(s) you wish to process (or 'all' to process
23
Chapter 2: Installing Legato License Manager
all packages). (default: all) [?,??,q]: q
prompt>
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager see “How to Start and Stop the License Manager” on page 40.
Deinstallation on Solaris
To deinstall the License Manager software, use the pkgrm command as follows: Refer
to the man page for pkgrm for more details.
pkgrm
The following packages are available:
1 LGTOdrvrNetWorker for Solaris (Backup/Recover) Device
Drivers(sparc) dev.Build.889
.
.
.
4 LGTOlicmNetWorker for Solaris (Backup/Recover) Licensing
Manager (sparc) dev.Build.889
.
.
.
Select package(s) you wish to process (or ‘all’ to process all
packages). (default: all) [?,??,q]: 4
The following package is currently installed:
LGTOlicm NetWorker for Solaris (Backup/Recover) Licensing
Manager (sparc) dev.Build.889
Do you want to remove this package? y
## Removing installed package instance <LGTOlicm>
This package contains scripts which will be executed with superuser permission during the process of removing this package. Do
you want to continue with the removal of this package [y,n,?,q] y
## Verifying package dependencies.
## Processing package information.
## Executing preremove script.
NetWorker successfully removed from `passat'.
## Removing pathnames in class <none>
/usr/sbin/lgtolmd
/usr/sbin/lgtolic
/usr/nsr/lic/res/lictype.res
/nsr/lic/res/lictype.res
## Updating system information.
Removal of <LGTOlicm> was successful.
Note: Refer to the man page for pkgrm for more details.
24
Chapter 2: Installing Legato License Manager
How to Install on AIX
These instructions give a general outline for installing the Legato License Manager on
AIX. For details on the various prompts you will see, refer to the Legato NetWorker
Installation Guide Release 6.x, AIX Version.
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM.
To install License Manager on a system with a local CD-ROM drive attached:
1. Ensure that you have root priveleges on the system where you want to install the
License Manager software.
2. Insert the NetWorker distribution CD-ROM into the drive.
3. Mount the CD-ROM.
4. Create the directory tmp_extract in a local filesystem with enough free space for the
software extraction. Change to that directory by entering the following commands:
# mkdir /usr/tmp_extract
# cd /usr/tmp_extract
5. Enter the following command at the shell prompt to extract the software files from
the CD-ROM:
# tar xvpBf /cdrom/NETWORKER/AIX/NETWORKR.TAR
The NetWorker files are listed on the screen as the extraction proceeds. When the
extraction is complete, the shell prompt reappears.
6. Continue the installation. Use the following command at the shell prompt to install
the License Manager software on the server:
# ./nsr_ize -i -l
If you enter "all" when the install script prompts you for the name of the first
NetWorker server, this client computer will be eligible for backup by all NetWorker
servers in your network. If you specify one or more NetWorker servers, this
computer can be backed up only by any of the specified servers.
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
How to Install on HP-UX 10.x and 11.x
These instructions give a general outline for installing the License Manager on HP-UX.
For details on the various prompts you will see, refer to the Legato NetWorker
Installation Guide Release 6.x, HP-UX Version.
Install the License Manager software on HP-UX 10.x or 11.x using the swinstall utility.
You can run the swinstall utility in terminal format or from a GUI in X Windows. The
terminal format swinstall screens contain the same types of information as the GUI
windows. In either the GUI or the terminal format, you select the same choices. The
following procedure is for the GUI version of swinstall.
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM.
25
Chapter 2: Installing Legato License Manager
To install the License Manager software:
1. Ensure that you have root priveleges on the system where you want to install the
License Manager software.
2. Change directory to the location of the NetWorker software distribution files as
follows:
–
–
For installation from local or remote CD-ROM, mount the NetWorker CDROM, then change directories to where it is mounted.
For a downloaded web file, change to the directory where you extracted the
installation files from the download package.
3. To start the installation, enter the following command at the system prompt:
# swinstall
4. In the Specify Source window, do the following:
a.
Verify that the hostname displayed in the Source Host Name field is the
correct hostname for the computer where you want to install the License
Manager software.
b. Verify that the pathname in the Source Depot Path field is correct.
c. Click OK.
5. In the Software Selection window, if products available for installation are not
displayed (that is, if NetWorker is the only choice that appears) do the following to
cause the rest of the software to be displayed:
–
–
On HP-UX 10.10, click the Change Software View button and select Products
in the Software View dialog box.
On HP-UX 10.20, double-click the line displaying “NetWorker.” The other
packages you can install are now displayed in the Software Selection window.
6. Select the software (NW Client and License Manager) you want to install on this
computer from the list in the Software Selection window. Then select Mark For
Install from the Actions menu.
Note: For a License Manager server without NetWorker, select at least the NW
Client package and the License Manager software. If you are installing License
Manager on an existing NetWorker server, you probably already have the client
package installed.
7. Select Install (analysis) from the Actions menu to run an install analysis, then click
the Logfile button to check the log file for errors. If errors occur, correct the
problems before continuing.
8. Click OK in the Install Analysis window, then click Yes in the Confirmation dialog
box. The Install Window appears, showing the status of the installation. When the
installation is finished, the Status field displays the message “Completed.”
9. In the Install Window, click the Logfile button to check the log file for
error/warning messages generated during installation, and correct as needed.
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
26
Chapter 2: Installing Legato License Manager
Deinstallation on HP-UX
You can use the swremove program to remove the License Manager software. In the
program user interface, click on the software that you want to remove, and then click
Actions>Mark, and then Actions>Remove.
Installation on Sequent
These instructions give a general outline for installing the Legato License Manager on
Sequent. For details on the various prompts you will see, refer to the Legato NetWorker
for Sequent DYNIX/ptx Installation Guide, Release 6.x.
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM.
To install the License Manager on a system with a CD-ROM drive, follow these steps:
1. Ensure that you have root priveleges on the system where you want to install the
License Manager software.
2. Insert the NetWorker CD-ROM into the drive.
3. Mount the CD-ROM:
a.
If necessary, create a mount point for your CD-ROM using:
# mkdir /cdrom
b. Enter the following to mount the CD-ROM:
# mount -F cdfs /dev/dsk/cd0 /cdrom
4. Enter the pkgadd -d command at the system prompt:
# pkgadd -d /cdrom/NETWORKER/SEQUENT/NETWORKR.PKG
Note: Filenames may appear in upper or lower case, depending on the version of
the DYNIX/ptx operating system in use.
5. If you are installing the software on a License Manager Server without NetWorker,
be sure to select at least the LGTOclnt and LGTOlicm options. If you are installing
License Manager on an existing NetWorker server, you already have the client
software installed, and need only select the LGTOlicm option.
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
Installation on SGI IRIX
These instructions give a general outline for installing the Legato License Manager on
SGI IRIX. Instructions are given for both the GUI installation, and for the command
line installation. For details on the various prompts you will see, refer to the Legato
NetWorker Installation Guide, Release 6.x, IRIX Version.
Installation Using the GUI
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM.
27
Chapter 2: Installing Legato License Manager
To install the License Manager using the GUI:
1. Log in as root on the system where you want to install the NetWorker software.
2. Mount the distribution CD-ROM.
3. Enter the following command at the system prompt:
# ln -s /CDROM/NETWORKER/SGI/NETWORKR.TAR /tmp/sgi.tardist
4. Enter the following command to access the Software Manager window:
# tardist /tmp/sgi.tardist
The Software Manager window appears on the screen.
5. Select the Customize Installation option. Then double-click the NetWorker Backup
System Option. The window displays the following software components:
–
–
–
–
–
NetWorker Client Software for IRIX
NetWorker Man Pages for IRIX
NetWorker Server Software for IRIX
NetWorker Storage Node Software for IRIX
NetWorker License Manager for IRIX
The NetWorker Client and Man Pages are default options. If the client software has
not yet been installed, the NetWorker Client must be selected for you to install the
License Manager software.
6. Click the Start button.
7. Click the OK button when the dialog box indicates that the installation process is
complete.
8. Exit the Software Manager window.
9. The “Web Install” dialog box displays the following message:
Do you want to save this distribution for future installations,
or remove it? Select either option and continue.
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
Installation Using the Command Line
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM. To install the License Manager
using a command line terminal:
1. Log on as root on the system where you want to install the License Manager
software.
2. Insert the NetWorker CD-ROM into the CD-ROM drive
3. Mount the distribution CD-ROM drive.
28
Chapter 2: Installing Legato License Manager
4. Create a temporary directory (for example, /tmp/nsr_extract) and change to that
directory
# mkdir /tmp/nsr_extract
# cd /tmp/nsr_extract
5. Enter the following command at the system prompt to extract the software files
from the CD-ROM:
# tar xvf /CDROM/SGI/NETWORKER.TAR
6. Enter the following command to run the installation program. The Inst> prompt
will appear, indicating that the installation program is running:
# inst -f /tmp/nsr_extract
7. Enter the following commands to install the NetWorker client and the License
Manager software:
Inst> install networker5.sw.LGTOlicm
Inst> go
8. Type quit to exit the installation program when the process is complete.
Inst> quit
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
Deinstalling from SGI IRIX
You can use the following steps to remove the License Manager software installed with
either the GUI or the command line methods.
1. Start the installation program with none as the distribution:
# inst -f none
2. Enter the following command to remove the License Manager software:
Inst> remove networker5.sw.LGTOlicm
3. If you also want to remove the NetWorker client software, enter the following
command:
Inst> remove networker5.sw.LGTOclnt
4. Enter the go command to initiate the removal of the software selected in steps 2
and 3:
Inst> go
5. Exit the installation program.
Inst> quit
Installation on Compaq Tru64 UNIX (formerly Digital UNIX)
The NetWorker client must be installed before installing the License Manager. The
License Manager is then installed separately. Procedures for both follow.
29
Chapter 2: Installing Legato License Manager
Install NetWorker Client
To install the NetWorker client software, follow these steps:
1. Ensure that you have root priveleges on the system where you want to install the
NetWorker software.
2. Insert the NetWorker CD-ROM into the CD-ROM drive.
3. Mount the CD-ROM drive as follows:
# mount -r -t cdfs /dev/rz4c /mnt
where /mnt is the mount point and /dev/rz4c is the block device.
4. Check the contents of the CD-ROM for the COMPAQ and DOCS directories.
–
–
The COMPAQ directory contains the NetWorker and Acrobat Reader
installation files.
The DOCS directory contains the online documentation files.
5. Change to the COMPAQ directory as follows:
# cd /mnt/COMPAQ
6. Enter the following command to begin the installation:
# setld -l .
7. Select the subset for the NetWorker client, LGTOCLNT, and then follow the
instructions on the screen to complete the installation of the client.
Install the License Manager
On the system where you installed the NetWorker client:
1. While still root on the system where you installed the NetWorker client, change
directory to the COMPAQ/license directory as follows:
# cd /mnt/COMPAQ/license
2. Enter the following command to begin the installation of the License Manager, and
then respond to the prompts as shown:
# setld -l .
*** Enter subset selections ***
The following subsets are mandatory and will be installed
automatically unless you choose to exit without installing
any subsets:
* Legato License Manager
You may choose one of the following options:
1) ALL of the above
2) CANCEL selections and redisplay menus
3) EXIT without installing any subsets
Enter your choices or press RETURN to redisplay menus.
Choices (for example, 1 2 4-6): 1
You are installing the following mandatory subsets:
30
Chapter 2: Installing Legato License Manager
Legato License Manager
You are installing the following optional subsets:
Is this correct? (y/n): y
1 subset(s) will be installed.
Loading 1 of 1 subset(s)....
Legato License Manager requires NetWorker Client to be
installed. Please make sure that NetWorker Client is installed
before running Legato License Manager.
Legato License Manager
Copying from . (disk)
1 of 1 subset(s) installed successfully.
Configuring "Legato License Manager" (LGTOLIC100)
Installation is complete.
3. Change directory to root and unmount the CD-ROM drive as follows:
# cd /
# umount /mnt
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
How to Install on Linux
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM. For details on the various prompts
you will see, refer to the Legato NetWorker Installation Guide Release 6.x, Linux Version.
To install the License Manager on a system with a CD-ROM drive attached:
1. Ensure that you have root priveleges on the system where you want to install the
License Manager software.
2. Insert the NetWorker distribution CD-ROM into the drive.
3. Mount the CD-ROM drive.
4. Change directory on the CD-ROM to the location of the Linux NetWorker
software, as defined in the Roadmap document in your Legato Software media kit.
Then run the “NWinstall” command as shown in the example below.
prompt> ./NWinstall
NetWorker(TM) - Release 6.0.Build.69
Copyright (c) 1990-2000, Legato Systems, Inc. All rights
reserved. This product includes software developed by the
University of California, Berkeley and its contributors.
31
Chapter 2: Installing Legato License Manager
The following packages are available:
1
LGTOclnt
NetWorker for Linux (Backup/Recover) Client
2
LGTOdrvr
NetWorker for Linux (Backup/Recover) Driver
3
LGTOlicm
NetWorker for Linux (Backup/Recover) License
4
LGTOman
NetWorker for Linux (Backup/Recover) Man
5
LGTOnode
NetWorker for Linux (Backup/Recover) Node
6
LGTOserv
NetWorker for Linux (Backup/Recover) Server
Select package you wish to process ('all' to process all
packages or 'q' to quit). (default:all) [?,??,q]:
5. Select the LGTOclnt option first, then the LGTOlicm option (options 1 and 3) as
shown in the following example.
Note: The client software is always required to be installed when installing the
License Manager. If the client software is already installed, you can specify just the
LGTOlicm option (3 in this example). Press enter when indicated in bold.
Select package you wish to process ('all' to process all
packages or 'q' to quit). (default:all) [?,??,q]:1,3 [enter]
Installing Networker for Linux (Backup/Recover) Client ...
Enter path to package base directory[?,'q' to quit,
default(/usr)]: [enter]
Networker packages will be installed in
/usr
Press Enter key to continue ... [enter]
NetWorker(TM) - Release 6.0.Build.69
Copyright (c) 1990-2000, Legato Systems, Inc. All rights
reserved. This product includes software developed by the
University of California, Berkeley and its contributors.
To set up a NetWorker storage node, licensing manager or client,
you need to supply a directory for the nsrexecd state file.
Directory /nsr exists, it will be used as the default.
Below is a list of some of the filesystems, with their free space,
which you might consider:
32
Chapter 2: Installing Legato License Manager
/space
:1596054
/
: 629596
/usr
: 563303
6. Answer further prompts as shown in bold.
Directory to use for client, licensing and server information
[/nsr]? [enter]
The nsrexecd program restricts access to a select set of
NetWorker servers. Please enter the names of each computer
running a NetWorker server that will back up this computer, one
name at a time. If a computer has more than one network
interface, please enter each interface's name (one at a time).
Note: To allow access to all NetWorker servers, press [enter] without typing new
input. Otherwise type the name of a NetWorker server to which you will allow access
and press [enter]. You’ll be prompted for the next server. Press [enter] without a
server name when done listing servers.
Enter the first NetWorker server's name [no more]: [enter]
Allowing access to all NetWorker servers.
Start NetWorker daemons at end of install [yes]? n [enter]
.
.
.
NetWorker successfully installed on <your_computer>!
Installation of Client was successful on <your_computer>.
Press Enter key to continue ...[enter]
Installing Networker for Linux (Backup/Recover) License ...
Networker packages will be installed in
/usr
Press Enter key to continue ...[enter]
NetWorker(TM) - Release 6.0.Build.69
Copyright (c) 1990-2000, Legato Systems, Inc. All rights
reserved. This product includes software developed by the
University of California, Berkeley and its contributors.
To set up a NetWorker storage node, licensing manager or client,
you need to supply a directory for the nsrexecd state file.
33
Chapter 2: Installing Legato License Manager
Directory /nsr exists, it will be used as the default.
Below is a list of some of the filesystems, with their free space,
which you might consider:
/space
:1601402
/
: 629594
/usr
: 537751
Directory to use for client, licensing and server information
[/nsr]? [enter]
Start NetWorker daemons at end of install [yes]? n [enter]
.
.
.
NetWorker successfully installed on <your_computer>!
Installation of License was successful on <your_computer>
Press Enter key to continue ... [enter]
The following packages are available:
1
LGTOclnt
NetWorker for Linux (Backup/Recover) Client
2
LGTOdrvr
NetWorker for Linux (Backup/Recover) Driver
3
LGTOlicm
NetWorker for Linux (Backup/Recover) License
4
LGTOman
NetWorker for Linux (Backup/Recover) Man
5
LGTOnode
NetWorker for Linux (Backup/Recover) Node
6
LGTOserv
NetWorker for Linux (Backup/Recover) Server
Select package you wish to process ('all' to process all
packages or 'q' to quit). (default:all) [?,??,q]:q
prompt>
34
Chapter 2: Installing Legato License Manager
For information about the locations of files installed, see “License Manager Files and
Filepaths” on page 16. For information about starting and stopping the License
Manager see “How to Start and Stop the License Manager” on page 40.
Deinstallation on Linux
To deinstall the License Manager software, become root on your computer, change
directory to the sbin directory, and use the rpm commands as shown below:
1. First find the names of the Legato software installed.
[root@your_computer sbin]# rpm -qa | grep lgto
lgtoclnt-6.0-1
lgtolicm-6.0-1
2. Now remove the Legato packages.
[root@your_computer sbin]# rpm -e lgtolicm-6.0-1 lgtoclnt6.0-1
NetWorker successfully removed from
`your_computer.your_company.com'.
Removing /etc/rc.d/init.d/networker
Removing /etc/rc.d/rc3.d/S95networker
Removing /etc/rc.d/rc5.d/S95networker
Removing /etc/rc.d/rc0.d/K05networker
NetWorker successfully removed from
`your_computer.your_company.com'.
[root@your_computer sbin]#
[root@your_computer sbin]#
[root@your_computer sbin]# exit
Windows NT and Windows 2000 License Manager Installation
The License Manager is an installation option with Legato NetWorker, and requires
that you have the NetWorker installation CD-ROM. For information on the installation
options available with NetWorker, refer to the Legato NetWorker Installation Guide,
Release 6.x, Windows NT Version.
Important: The NetWorker Client software must first be installed before installing the
License Manager on Windows. Before you install the License Manager, it is
recommended that you upgrade your NetWorker Client software to the version on the
CD-ROM that contains the License Manager that you will install.
35
Chapter 2: Installing Legato License Manager
Installation
To install the License Manager software:
1. Change directory to the license directory on the distribution CD-ROM. Refer to the
Roadmap document in your media kit for the location of the license directory.
2. Run the setup.exe program to start the installation of the License Manager.
3. Click Next when the following screen appears:
4. Select the destination directory as follows:
–
–
To accept the default path, click Next. For both Windows NT and Windows
2000, the default path is c:\Program Files\Legato\Lic.
To select a different path, click Change.
36
Chapter 2: Installing Legato License Manager
5. When the following dialog box appears, click Install to begin the installation.
6. When the installation is finished, you’ll see the following screen. Click Finish to
exit the setup program.
License Manager is now installed as a service. After you start the service, you can issue
commands to the License Manager by running the lgtolic.exe program at c:\Program
Files\Legato\Lic\bin\lgtolic.exe . For details on the lgtolic command, see “lgtolic
Command Line Utility” on page 46.
For more information about the locations of files installed, see “License Manager Files
and Filepaths” on page 16. For information about starting and stopping the License
Manager, see “How to Start and Stop the License Manager” on page 40.
37
Chapter 2: Installing Legato License Manager
Repair and/or Removal
To reinstall (repair) or remove the License Manager on a Windows computer, start the
setup.exe program again.
1. Because the License Manager is already installed, you will get the option to repair
it, if it is not properly installed, or remove it. Click Next to continue.
2. To reinstall the software, select Repair. Otherwise, to remove the software select
remove. Then click Next.
38
Chapter 2: Installing Legato License Manager
3. If you’ve selected Remove, you get a choice of leaving the license database on the
disk and just removing the binaries, or removing everything. Make your selection
and then click Next.
4. After the software has been repaired or removed, click Finish to exit the installation
program.
39
Chapter 2: Installing Legato License Manager
How to Start and Stop the License Manager
There will be times when it may be useful to start and stop License Manager from the
command line and other operating system interfaces on UNIX, Windows NT, and
Windows 2000.
UNIX
To Start License Manager
Start the lgtolmd daemon on the License Manager server. Log on as root and execute
the following command:
/<filepath>/lgtolmd -p <prod_dir> -n <version>
where:
-<filepath>
Specifies the path to the lgtolmd binary on your system. Refer to the
man page for details. Refer to Table 1 on page 41 for the filepath of the
lgtolmd daemon on your system.
-p <prod_dir> Specifies the installation directory of the product that will be
interfacing with the license daemon. The currently supported entries
are
-n <version>
-p gems
for the GEMS default install directory /gems.
-p opt/SmartMedia
for the SmartMedia default install directory
/opt/SmartMedia on UNIX platforms.
-p nsr/lic
for the NetWorker default install directory
/nsr on UNIX platforms.
Specifies the version number. Some products use a unique version
number. Currently, SmartMedia uses version 2, while GEMS and
NetWorker use version 1.
Example:
The following command starts the License Manager on a Solaris UNIX computer on
the default NetWorker installation directory, using the version number 1 for
NetWorker.
/usr/sbin/lgtolmd -p nsr/lic -n 1
To Stop License Manager
Stop the lgtolmd daemon using the nsr_shutdown command
nsr_shutdown -a
or by using the kill command on the running lgtolmd process.
Windows NT and Windows 2000
The lgtolmd.exe program runs as a service on both Windows NT and Windows 2000.
Windows NT
To start the License Manager, click Start>Settings >Control Panel>Services and select
the License Manager service. Then click Start.
40
Chapter 2: Installing Legato License Manager
To stop the License Manager, click Start > Settings > Control Panel > Services and select
the License Manager service. Then click Stop. On the command line you can issue the
following command to stop the License Manager daemon:
net stop lgtolmd
Windows 2000
To start the License Manager, click Start>Programs >Administrative Tools>Services
and right-click onLegato License Manager. Then select Start.
To stop the License Manager, click Start>Programs >Administrative Tools>Services
and right-click Legato License Manager. Then select Stop. On the command line you
can issue the following command to stop the License Manager daemon:
net stop lgtolmd
Disabling the License Manager
Because the Legato License Manager is an installation option with NetWorker 6.x and
other Legato products, and because only one License Manager server is required on a
network, you might find that you have more License Manager servers operating than
you want. To remedy this, disable the License Manager daemons on the extra License
Manager servers by renaming their binaries, in the location shown in Table 1.
Table 1. Locations of the Legato License Manager Daemons
Operating System
Files to Rename
Widows NT and Windows 2000
c:\Program Files\Legato\Lic\bin\lgtolmd.exe
c:\Program Files\Legato\Lic\bin\lgtolic.exe
Solaris
/usr/sbin/lgtolmd
/usr/sbin/lgtolic
HP-UX
/opt/networker/bin/lgtolmd
/opt/networker/bin/lgtolic
AIX
/usr/bin/lgtolmd
/usr/bin/lgtolic
Compaq Tru64 UNIX
(formerly Digital UNIX)
/usr/opt/LGT100/lgtolmd
/usr/opt/LGT100/lgtolic
SGI Irix
/usr/etc/lgtolmd
/usr/etc/lgtolic
Sequent DYNIX/ptx
/usr/sbin/lgtolmd
/usr/sbin/lgtolic
Linux
/usr/sbin/lgtolmd
/usr/sbin/lgtolic
41
Chapter 2: Installing Legato License Manager
How to Revert a NetWorker Server to Local Licensing
Occasionally, you might want to retire a NetWorker server, or revert a NetWorker
Server to local licensing. The following example reverts a NetWorker server named
“bluenose.”
1. If NetWorker server bluenose has been using a license from the License Manager, an
external enabler will be listed in the nwadmin user interface. This enabler will be
listed with a name that starts with “GEMS-EXT.” If such an enabler exists, look at
the name attribute:
a. If the name attribut has just “bluenose:nsrd,” delete the usage.
b. Otherwise, if the name attribute shows other clients besides bluenose, then
decrement the count attribute count by one, and change the name attribute to
remove bluenose:nsrd from the list.
2. Add a new (local) base enabler to the NetWorker Server.
3. Delete the reference to the License Server in the Setup Server window of nwadmin.
Important: If you Delete the reference to the License Server before adding a new local
license (step 2) you will not be able to delete the GEMS_EXT license from the
NetWorker Server.
4. On the License Manager server, use nsradmin to remove the license resources that
were designated for “bluenose,” as follows:
nsradmin -s <license_manager_server> -p 390115 -v 1 <enter>
At the nsradmin prompt, make entries as follows:
nsradmin> types <enter>
Known types: GLM, GLM license, GLM license type, GLM usage;
nsradmin> p type:GLM usage <enter>
[Look for 'bluenose']
nsradmin> d type:GLM usage <enter>
[Then 'delete' any GLM usage for 'bluenose']
42
Chapter 3: Creating and Maintaining Licenses
If you have more than a few Legato products, the utility of the License Manager
becomes obvious, since it provides a central location for license management. Just one
License Manager server can manage all of the NetWorker and other Legato servers in
the corporate enterprise.
This chapter is organized as follows:
•
•
“Using the License Manager” on page 43. This details how to use the License
Manager.
“Authorizing Licenses Over the Web” on page 51. This describes a convenient
way to obtain authorization codes.
Using the License Manager
This section provides information on the following:
•
•
•
•
•
Installing and/or moving licenses into the License Manager database.
Setting up NetWorker to work with License Manager.
Acquiring Licenses from the License Manager.
Allocating a specific number of licenses to a NetWorker server.
Using the lgtolic command line utility to manage the License Manager database.
43
Chapter 3: Creating and Maintaining Licenses
Installing and/or Moving Licenses into the License Manager Database
The procedures are similar for migrating large numbers of licenses, or a single license.
Important: You should not have both local licenses and licenses imported from the
Legato License Manager on a single NetWorker server. Either all of the licenses must
be moved to the License Manager server and imported as needed, or you should not
configure the NetWorker server to use the License Manager.
If you have licenses for the same functionality on both your NetWorker server and on
and your License Manager server, and you then configure your NetWorker server to
use the License Manager without removing the local licenses, then you can expect the
following behavior:
If the local enabler was installed before the NW server was configured to use License
Manager, then the local enabler is used. Each time the NetWorker server looks for an
enabler, it looks at all enablers installed, and will use a local enabler if it finds it in the
list before encountering the first external enabler (i.e., one that is obtained from the
License Manager). However, once NetWorker finds the first external enabler, it will
ignore all local enablers.
To Install Large Numbers of Licenses
To install large numbers of licenses from an existing NetWorker server to the License
Manager server, follow these steps:
1. Purchase bulk enabler codes from Legato Systems. Enabler codes are special codes
provided by Legato that allow you to run your Legato software product. A bulk
enabler code allows running multiple instances of a Legato product using just one
code. Bulk enablers are available in values of 5, 25, and 100.
2. Use the lgtolic command with the -c option to install each of your bulk enablers in
the License Manager database. See “lgtolic Command Line Utility” on page 46 for
details.
3. Set up the NetWorker servers to use the License Manager. For details, see “How to
Set Up NetWorker to Work with License Manager” on page 45.
4. Run lgtolic -r to register each product. The default file register.txt should be created
in the directory where this command is run.
5. Run lgtolic -l and redirect the output to a file, such as enablers.txt.
6. Register and authorize your Legato software over the web at
http://license.legato.com, using the information in the enablers.txt and register.txt
files. For details, see “Authorizing Licenses Over the Web” on page 51. Alternately,
you can email the files register.txt and enablers.txt to [email protected] to obtain
authorization codes for the enablers.
7. Once you have received authorization codes from Legato, run lgtolic with the -u
enabler_code and -a authcode options to authorize each of the enablers with the
License Manager.
44
Chapter 3: Creating and Maintaining Licenses
To Move a Single License
To move a single license from a NetWorker server to the License Manager, follow these
steps:
1. Start the nwadmin program and write down the enabler code and authorization
code for the license you’re moving to the License Manager.
2. Use the lgtolic command with the -c option to install your enabler code in the
License Manager database. See “lgtolic Command Line Utility” on page 46 for
details.
3. Remove the enabler code from the NetWorker server.
4. Set up the NetWorker server to use the License Manager. For details, see “How to
Set Up NetWorker to Work with License Manager” on page 45.
5. Run lgtolic -r to register each product. The default file register.txt should be
created in the directory where this command is run.
6. Run lgtolic -l and redirect the output to a file, such as enablers.txt.
7. Email the files register.txt and enablers.txt to [email protected] to obtain a host
transfer affidavit for the enabler. Note: You can now register and authorize your
Legato software over the web, if that will be more convenient. See “Authorizing
Licenses Over the Web” on page 51 for details.
How to Set Up NetWorker to Work with License Manager
Install and authorize your licenses on the License Manager server, and then remove
local licenses from the NetWorker server. If you purchase a bulk enabler for as many
licenses as you need, you will only have to create and authorize one bulk enabler
license on the License Manager server. Refer to “Installing and/or Moving Licenses
into the License Manager Database” on page 44 for more information.
In order for NetWorker to work with the License Manager server, you need to add the
license server name in the “license server” field of the nwadmin Server Setup window.
On NetWorker for UNIX, run the Administrator program, nwadmin, on the
NetWorker server and click Server>Server Setup>View Details. Then enter the name of
the License Manager server. On NetWorker for Windows NT, run nwadmin on the
NetWorker server and select Options>Customize>Display Hidden Attributes. Then
enter the name of the Legato License Manager Server.
Even though you specify a license server, the local licenses on the NetWorker server
are not ignored. Therefore, for a given NetWorker server, you should import all
licenses from the License Manager ( and delete local licenses), or use the local licenses
on that server. You should not mix imported and local licenses.
Note: You can also use nsradmin from the command line on either UNIX or Windows
NT to specify the license server. On UNIX:
1. Start nsradmin on your NetWorker server as follows:
nsradmin -s <your_NetWorker_server> -c
2. In the opening screen, use the arrow keys to select Options, then press [enter].
3. In the options screen, select Hidden, then press [enter].
4. Press [Esc] to return to the opening screen.
45
Chapter 3: Creating and Maintaining Licenses
5. In the command line select Edit, then press [enter].
6. Use the down arrow key to move to the “license server:” field, then type in the
name of your Legato License Manager server, for example, flamingo.legato.com.
7. Press [Esc] to exit the editing mode.
8. Answer [Yes] to the “Save changes?” prompt.
9. Press Q to quit the program.
On Windows NT, start nsradmin in the same way. Visual mode is not supported.
How To Acquire Licenses from the License Manager
It is the responsibility of the Legato program (appliance) to request or give up licenses;
the License Manager does not do either without a request from the appliance. After
installing your licenses on the License Manager, you can cause NetWorker, for
instance, to acquire a license from the License Manager.
Assume the License Manager server is named daisy and the NetWorker server is named
saturn.
•
•
To add a license for saturn, such as for archive support, you would use nwadmin
on saturn and select Clients>Client Setup>Archive Services, then click Enabled
and click Apply. The nsrlmc program contacts lgtolmd on daisy and an available
license is automatically retrieved for use by saturn. The command lgtolic -l (see
“lgtolic Command Line Utility” on page 46) shows that in the License Manager
database the external archive services license is assigned to saturn.
To remove the archive services license from saturn, start nwadmin on saturn, and
select Clients>Client Setup>Archive Services, then click Disabled, and click
Apply. Then, still in nwadmin, click Server>Registration> and delete the
externally managed archive enabler, and click Apply. When nsrlmc performs its
periodic check, to compare the License Manager database with the licenses on
saturn, the database will be updated and at that point the lgtolic -l command will
show that the archive services license is no longer assigned to saturn. To force an
immediate synchronization of the License Manager database with saturn’s
licenses, in nwadmin, click Update Licenses, and then click Apply.
lgtolic Command Line Utility
Use the lgtolic command line utility to manipulate licenses in the License Manager
database. Also be sure to check the man page for this utility, lgtolic.8. The lgtolic
command line utility can be used to create licenses indicated by your enabler codes,
and to enter enabler and authorization codes for your NetWorker servers.
Host IDs and NetWorker 6.x on Windows NT
Host IDs for NetWorker 6.x on Windows NT are based on the Windows NT-generated
security identifier. If you would prefer to have your host IDs based on the IP address
of the NetWorker servers, as was the case for NetWorker 5.x and earlier, you can set up
a host ID file and direct your enablers to the host ID file using lgtolic with the -m
option.
Synopsis
lgtolic [-s “server”] -c enabler-code
lgtolic -i [-m hostfile-dir]
46
Chapter 3: Creating and Maintaining Licenses
lgtolic [-s “server”] -l
lgtolic [-s “server”] -r [-m hostfile-dir] [-f
lgtolic [-s “server”] -u enabler-code [-a
output-file]
auth-code]
lgtolic [-s “server”] -v enabler-code
Options
-s server
Specifies the hostname, Remote Procedure Call (RPC)
program number, and version for the license daemon
whose database you are targeting. License daemon
information is displayed in the following format:
“< hostname >:< rpc-number >:< version >”
Notes: Quotation marks are necessary around the
arguments for the -s option.
The current default for the hostname is localhost, the
default for the RPC program number is 390115, and the
default for the RPC version number is 2.
You can use environment variables to set the values for the
-s parameter (see “Environment Variables” on page 48). If
you do not specify the -s server option, lgtolic uses the
environment variable values , if these have been
specified; otherwise the default values that map to the
daemon used by the product shipped are used. If you set
environment variables for the arguments to the -s
parameter, then you don’t have to specify the -s
parameter when typing on the command line.
The following example uses the default hostname and
RPC program number, but it uses RPC version number 1
to list all licenses.
Without environment variables set:
lgtolic -s “::1” -l
With environment variables set:
lgtolic -l
To specify a license daemon located on an alternative
platform, use
lgtolic -s “<hostname>::1” -l
-c enabler-code
Creates the license indicated by the specified enabler
code.
-i
Prints out the hostid of the computer on which this
command is running.
-m hostfile-dir
Specifies the directory where the hostids file resides. If this
option is used, the program will use the list of hostids in
the hostids file that resides in this directory to generate a
composite hostid. This option is useful if the licensing
manager is installed on a cluster computer, or to force the
47
Chapter 3: Creating and Maintaining Licenses
hostid to be IP address-based instead of security ID-based
on a Windows NT computer. For NetWorker, the typical
directory for the hostids file is /nsr/res. For a License
Manager running on a computer that does not have the
NetWorker server installed, the typical path is /nsr/lic/res.
The format for the list of hostids in a hostids file is:
hostid1:hostid2:hostid3
where hostid is a hexadecimal string. This option must be
used to specify a hostid file.
-l
Lists all of the Legato product licenses currently stored
within the license resource database.
-r
Creates or modifies customer registration data stored
within the license resource database. The -f option
captures this customer registration data into a text file.
-f output-file
Captures customer registration data into the specified
output file. Once this text file is created, forward it to
Legato customer support to register your product. If the
-f output-file option is not specified, the -r option
encapsulates customer registration information into a
file named register.txt. Note: This option can only be used
in conjunction with the -r option.
-u enabler-code
Updates an installed license with the given enabler
specified at the command line.
-a auth-code
Authorizes a license with the specified authorization
code. You specify the license to be authorized by
specifying the -u option in conjunction with the -a
option.
-v enabler-code
Deciphers the specified enabler code. The generated
output includes information about the license name,
type, serial number, and count.
Environment Variables
The daemon information provided by the -s option can also be obtained by lgtolic from
environment variables, which you can set at the command line or in your .cshrc file or
.profile file:
LMD_HOSTNAME – The name of the host where the license daemon is running.
Default is localhost.
LMD_PROGNUM – The program number for the license daemon, which must be
390115.
LMD_VERSION – The version number for the license daemon. Default is 2.
Examples
The examples below use the following fictitious operating values:
enabler code
B2QRG6RC-KP1AXQ51-L3DN1EST, say a bulk enabler for
multiple NetWorker servers.
48
Chapter 3: Creating and Maintaining Licenses
auth code
a1426440
hostname
flamingo (License Manager is running on flamingo)
RPC Program Number
390115
version number
1
These examples assume that the environment variables for the -s parameter arguments
are not set. If the environment variables were set, then the -s parameter and operands
could be left out of the commands.
Default values for the -s parameter operands are used when these are not specified. The
RPC program number is therefore not entered. If flamingo were the local host, then the
hostname value could be left out as well, and the -s parameters could be expressed as
-s “::1”.
1. To create (input) an enabler code into the License Manager database:
lgtolic -s “flamingo::1” -c B2QRG6RC-KP1AXQ51-L3DN1EST
2. To list all of the Legato product licenses currently stored within the license
resource database:
lgtolic -s “flamingo::1” -l
3. To print registration information to a file, for an enabler code that is in the License
Manager database:
lgtolic -r
Follow the prompts to name the enabler code, hostid, and customer information.
The text file created can be faxed or emailed to Customer Service to obtain an
authorization code for the enabler.
The preceding example prints the information into a file named register.txt. To
print to a filename of your own choosing, like bobsregister.txt, use the -f parameter
and name the file to be created:
lgtolic -r -f bobsregister.txt
Again, follow the prompts to name the enabler code, hostid, and customer
information. The text file created can be faxed or emailed to Legato Customer
Service to obtain an authorization code for the enabler.
4. To update an enabler code with an authorization code (received from Legato
Customer Service):
lgtolic -s <server> -u <enablercode> -a <authcode>
To update our fictitious enabler with our fictitious authorization code:
lgtolic -s “flamingo::1” -u B2QRG6RC-KP1AXQ51-L3DN1EST -a
a1426440
5. To verify the validity of a license enabler:
lgtolic -s <server> -v <enabler>
If the enabler is not valid, it will be flagged as such.
6. To check the state of the license we just authorized:
lgtolic -s “flamingo::1” -l
49
Chapter 3: Creating and Maintaining Licenses
If the license has been authorized, it will show “never” for an expiration date. If
unauthorized, the expiration date will show the date on which the license will
cease to operate.
Diagnostics
The following messages from lgtolic have the associated meanings:
Program not registered
The lgtolmd daemon is not running.
Unknown host
Either the default hostname is invalid or the hostname
specified with the -s option is invalid.
For an expanded list of messages generated by lgtolic, see “Messages Generated by the
License Manager” on page 53.
How To Set Up Allowances for a NetWorker Server in the License Manager
Database
The Legato License Manager (LLM) and GEMS License Manager (GLM) both support
the concept of allowances, which provides a way for the administrator to allocate a
specific number of licenses to any particular NetWorker server. The allowances are
stored in the resource files as “GLM allowances.” To set allowances for a NetWorker
server in the LLM’s database, you must use the nsradmin program, which is available
only on UNIX workstations. The following example creates an allowance resource for
NetWorker on the machine named squash, limiting it’s connections (see the count
parameter) to zero.
1. Invoke nsradmin on the License Manager server:
nsradmin -s <LLM_servername> -p 390115 -v 1
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin>
2. At the nsradmin prompt, create the GLM allowance resource for NetWorker on
squash, limiting its client connections to 0:
nsradmin> create type:GLM allowance; name: stop squash;
license name: Client Connections; count: 0; appliances:
"squash:nsrd"
type: GLM allowance;
name: stop squash;
license name:"Client Connections;"
count: 0;
appliances:"squash:nsrd";
Create? y
created resource id 109.2.190.0.253.208.189.55.137.69.7.66(1)
nsradmin>
Note: double quotes are required around the appliances because the colon is a
keyword in nsradmin. The name of the appliance must match the name as it appears
in the nwadmin window when accesseing the Server. For example if the name appears
50
Chapter 3: Creating and Maintaining Licenses
as "mainserver.myco.org" then that exact string must appear in the appliances field:
"mainserver.myco.org:nsrd". It is advisable to enclose the license name in double
quotes also.
Note: the range for the count parameter is limited to the connections allowed by the
particular license named.
Note: the visual mode named by the script in this example is not supported when
setting allowances.
Authorizing Licenses Over the Web
You can now register and authorize your Legato products via the World Wide Web.
Legato's web authorization can be completed in just a few minutes and is available 24
hours a day, seven days a week. To register and authorize Legato products via the
www, simply point your web browser to: http://license.legato.com, and follow the
step-by-step instructions.
Should you have any questions regarding your new software update please send an
email to Customer Service at [email protected]. You can also send a FAX to (650) 8126220, or call Legato's Customer Service Hotline at (650) 812-6000, selection 3.
51
Chapter 3: Creating and Maintaining Licenses
52
Appendix A: Troubleshooting
This chapter contains information about messages, and common difficulties that can
arise and how to deal with them. In all cases when troubleshooting your Legato
License Manager, be sure to review the most current License Manager Release Supplement
on the web at www.legato.com.
Messages Generated by the License Manager
The following message texts can be displayed by the lgtolic command line utility, and
the lgtolmd daemon, both of which run on the License Manager server, and by the
nsrlmc application that is invoked by nsrd, as needed, on the NetWorker server. The
messages named in this section usually generate text that is written to the appropriate
log files. The locations of the lgtolmd logfile (lgtolmd.log) depends on the operating
system in use on the server: for UNIX - /nsr/lic/logs/ lgtolmd.log, for Windows NT c:\win32app\lic\logs\lgtolmd.log, for Windows 2000 - c:\Program
Files\nsr\lic\logs\lgtolmd.log.
The message types named for the messages in this section are defined as follows:
Informational
A message that provides information that is useful and does not
require you to take any action.
Warning
A message that provides details about a temporary problem that
either the software will attempt to resolve, or the software will
prompt the user to resolve.
Notification
A message that provides details about a user error that the user is
required to resolve.
Non Critical Error A message that provides details about errors that will not
interrupt software services, but should be resolved before they
become fatal errors.
Fatal Error
A message that provides details about errors that will cause the
software services to become disabled or dysfunctional.
Add the license with the -c option before attempting to authorize it
Message Source
lgtolic
Message Type
Notification
Problem
The license you are attempting to authorize is not yet in the
License Manager database.
53
Appendix A: Troubleshooting
Resolution
Use lgtolic with the -c option to add the license. See “lgtolic
Command Line Utility” on page 46.
Attempting to remove more usage than possible (%d, %d)
Message Source
nsrd, lgtolmd, lgtolic
Message Type
Notification
Problem
You are attempting to remove more license usage counts than are
available.
Resolution
Run the command again and specify less usage.
Cannot add authorization code to evaluation licenses.
Message Source
lgtolic
Message Type
Notification
Problem
You may be attempting to authorize an evaluation license, which
cannot be done.
Resolution
Purchase and install your valid product license; then try
authorizing the license again. See lgtolic with the -c, -u, and -a
parameters, on page 46.
Cannot add eval license to database--license type already exists
Message Source
lgtolic
Message Type
Notification
Problem
The evaluation enabler you are trying to add the the License
Manager database is already in the database for the server named.
Resolution
You should be able to run an evaluation copy of the Legato
product at this time. If the evaluation license has expired, contact
Legato Customer Service to obtain licenses.
Cannot alter expiration date on a license in a grace period
Message Source
lgtolic
Message Type
Notification
Problem
The grace period has already been invoked for this enabler.
Resolution
To extend the expiration date further, you must obtain an
authorization code and enter it with the lgtolic -u <enabler code>
-a <authcode> command. See “lgtolic Command Line Utility” on
page 46 for details.
Cannot alter expiration date on a nonexistent license.
Message Source
lgtolic
Message Type
Notification
Problem
You attempted to authorize a license that does not exist in the
License Manager’s database.
54
Appendix A: Troubleshooting
Resolution
Check to ensure that you have specified a valid enabler code for
the -u option on the lgtolic command line.
Cannot get host IP address! ABORTING!.
Message Source
lgtolic
Message Type
Fatal Error
Problem
The program could not find the specified server’s IP address. If
this message appears on a Windows NT computer, the program
was unable to locate the computer’s security ID.
Resolution
Check with the system administrator of the specified server.
Cannot increment the usage for this particular license type
Message Source
lgtolic
Message Type
Notification
Problem
The particular license type named cannot have its usage
increased. The maximum number of counts for this license type
are probably already in use.
Resolution
Add another bulk enabler for the type of license in question.
Cannot locate the license binding for appliance <hostname>:<appliance>)
Message Source
lgtolic
Message Type
Notification
Problem
Cannot find an allowance for the specified appliance.
Resolution
This is a Legato internal programming error. Please contact Legato
Technical Support.
Cannot overwrite existing authorization code
Message Source
lgtolic
Message Type
Notification
Problem
The specified enabler has already been authorized.
Resolution
Use lgtolic with the -l option to confirm that the enabler and
authorization code have already been stored withing the license
resource database. Use lgtolic with the -v option to verify the
enabler code. If necessary, obtain a new enabler code from
Customer Service.
Cannot release usage for license not in use
Message Source
lgtolic
Message Type
Information
Problem
The license named is not in use, and therefore usage cannot be
released.
Resolution
Check to see whether the license on the license server was in use.
55
Appendix A: Troubleshooting
Cannot release usage for non-existent license
Message Source
lgtolic
Message Type
Information
Problem
A license was deleted, on a server, that was not being used by any
appliance.
Resolution
NA
Cannot release usage for non-existent license type.
Message Source
lgtolic
Message Type
Information
Problem
A nonexistent license type was attempted to be deleted on a
Legato product server.
Resolution
NA
Cannot release %d usage counts
Message Source
lgtolic
Message Type
Notification
Problem
An attempt was made to delete more usages than were used for
the specified license.
Resolution
NA
Enabler code %s has not been located
Message Source
lgtolic
Message Type
Notification
Problem
The enabler code that you have attempted to perform an
operation on is not in the License Manager database.
Resolution
Ensure that you have entered the correct enabler code. If you have
the correct enabler code, then enter the code into the License
Manager database using lgtolic with the -c option. Then use
lgtolic with -u and -a to authorize the enabler.
Invalid enabler code specified
Message Source
lgtolic
Message Type
Notification
Problem
The enabler code was not entered properly.
Resolution
Ensure that you have typed the enabler code properly.
Invalid parameters specified within License API [<parameters>]
Message Source
Message Type
Notification
Problem
This is an internal Legato programming error.
56
Appendix A: Troubleshooting
Resolution
Contact Legato Technical Support
License resource is corrupted
Message Source
lgtolic, lgtolmd
Message Type
Fatal error
Problem
The License Manager database has been damaged.
Resolution
Use NetWorker to restore the most recent copy of the License
Manager database.
Need a base enabler to authorize '%s' license
Message Source
lgtolic
Message Type
Notification
Problem
The named license that was attempted to be authorized does not
have a base enabler.
Resolution
Get a base enabler and use lgtolic -c to enter it into the License
Manager database.
Registration information provided is incomplete
Message Source
lgtolic, MLM_catalog (SmartMedia)
Message Type
Notification
Problem
The registration information entered into the registration dialog
box was not complete.
Resolution
Try again, and be sure to complete all fields.
Additional Messages
The following messages have been seen with License Manager, though they are not
specific to License Manager.
Archive support has not been properly enabled.
When entering an archive enabler code via lgtolic in the following manner,
lgtolic -s "::1" -c some_valid_archive_enabler_code
In order to tell NetWorker that it needs to get an external archive enabler, set the Public
Archives attribute to yes: in the nwadmin program click enabled in the Public Archives
attribute of the server setup window, and click enabled for Archive services in the client
setup window.
lgtolic: Remote system error.
When the license daemon is not running, there are several activities that return this
error:
•
User tries to "create" an enabler
Example:
lgtolic -s "::1" -c 8A1QC1A3-GY60JJLB-HTSLM485
57
Appendix A: Troubleshooting
•
User tries to "verify" an enabler
Example:
lgtolic -s "::1" -v 8A1QC1A3-GY60JJLB-HTSLM485
•
User tries to "list" all of the product licenses currently stored within the license
resource database.
Example:
lgtolic -s "::1" -l
•
Daemon dumped core.
lgtolmd: You are not authorized to run this command
Message Source
lgtolmd
Message Type
Notification
Problem
You may have tried to start the lgtolmd daemon at the command
line on a UNIX computer, but you do not have sufficient
permissions.
Resolution
Use the provided startup scripts to start lgtolmd. Refer to “How
to Start and Stop the License Manager” on page 40 for details.
nsrlmc: RPC error, Program not registered (severity 4, number 15).
nsrlmc: lgtolmd did not respond.
Message Source
nsrlmc
Message Type
Notification
Problem
lgtolmd must be started before running nsrlmc. If lgtolmd is
running, you may have exceeded a resource limit.
Resolution:
The first error pertains to any nonrunning NetWorker daemon to
which an application is trying to connect. The log file provides
information about which daemon is down. It is possible that a
NetWorker daemon or the Legato license daemon is down. If the
daemon is a NetWorker daemon, check in the /nsr/cores/[daemon
name] directory to see if there is a newly created core file. If the
daemon is the Legato license daemon, as in this example, check in
the /nsr/lic/cores/lgtolmd directory on the computer where the
license daemon is installed to see if there is a newly created core
file. If there is a new core file, contact Legato Technical Support to
have the core file analyzed.
The last step is to restart the daemon(s) in question. Refer to the
appropriate product’s Administration Guide for information
about restarting the daemons. It is strongly recommended that
you use the product startup scripts to restart the main product
(such as NetWorker).
58
Appendix A: Troubleshooting
On Windows NT, to restart just the License Manager service click
Start>Settings>Control Panel>Services and select “Legato License Management
Service.”
On UNIX, to restart just the License Manager for NetWorker, login as root and enter the
following command:
/<filepath>/lgtolmd -p /nsr/lic -n 1
See Table 1 on page 41 for the filepath to your version of the lgtolmd daemon.
Important: Be very careful about manually starting daemons, because nsr_shutdown
and other shutdown scripts are very particular in the way the startup command is
formatted. In the above example, make sure there is a space between each of the
command line options and its parameter value. On Windows NT, it is inconvenient to
manually start the daemon(s) as a service, and not recommended—use the method
described above instead.
lgtolmd: SYSTEM notice, Resource file /nsr/lic/tmp/res.lck already in use; check
for another copy of lgtolmd already runnning. Error initializing resource file.
Message Source
lgtolmd
Message Type
Notification
Problem
Multiple (identical) instances of the license daemon are not
allowed. An instance of the license daemon is already running,
and therefore another cannot be started.
Resolution
This error pertains to to NetWorker daemons that have a locking
mechanism for the resource file to prevent multiple daemons from
starting, which includes nsrd. The applicable log file should
indicate which daemon has already been started—lgtolmd in this
case.
Check to see if there really is another copy of the daemon running.
Use the ps command on UNIX; on Windows NT, invoke the Task
Manager with the right mouse button on the status bar. If the
daemon is not running, remove the lock file (in the above example
it would be /nsr/lic/tmp/res.lck) and restart the product.
lgtolic: Program/version mismatch
Messsage Source
lgtolic
Message Type
Notification
Problem
This error pertains to any application that is attempting to contact
a Legato daemon with the wrong RPC version number.
Resolution
Run rpcinfo to check for the correct version number. Ensure that
the RPC number is correctly specified for your application (1 for
the License Manager). If this error is from running the lgtolic
command, see “lgtolic Command Line Utility” on page 46 for
applicable environment variables.
59
Appendix A: Troubleshooting
Server disabled; The evaluation enabler code for the <feature> expired. Install
the permanent enabler code.
Message Source
?
Message Source
Notification
Problem
The evaluation period for the feature has expired. If you received
this message after you entered the permanent enabler and
authorization codes:
•
•
•
The enabler code that you entered is no longer valid.
The enabler code that you entered is a "bulk" enabler code.
The nsr.res file is corrupted.
•
•
•
Use the nsrcap command to verify the enabler code.
Install license enablers to enable the feature.
If you are entering a "bulk" enabler code, use the lgtolic -c
command to add the license, not nsrcap.
Recover the nsr.res file from backup or clone volumes.
Resolution
•
RAP error <error-code>: Enabler type is for a different platform
Message Source
nsrcap
Message Type
Notification
Problem
This message appears when you enter:
•
•
•
•
An enabler code for the wrong platform using the NetWorker
Administrator program, nwadmin, nsradmin or nsrcap.
A "bulk" enabler code
ResolutionVerify that the enabler code that you are entering
is for the appropriate platform.
Contact Legato Customer Service to obtain the correct type of
enabler code. If you are entering a "bulk" enabler code, use
the lgtolic -c command to add the license.
lost connection to server: Authentication error
Message Source
nsradmin
Message Type
Notification
Problem
A License resource could not be created on the backup server.
Resolution
Make sure that both the GEMS licensing daemon (gemslmd) and
the Legato Licensing daemon (lgtolmd) are not running on the
same server.
License enabler #<enabler-code> (<product or feature>) will expire in <n> day(s)
Message Source
nsrd
Message Type
Notification
60
Appendix A: Troubleshooting
Problem
The specified enabler will expire in the specified number of days.
Resolution
Authorize the specified enabler code using the lgtolic -u -a
command. If you do not have an authorization code for this
enabler, contact Legato Customer Service.
The jukebox <jukebox> is not properly licensed. Make sure the jukebox is
properly enabled and authorized.
Message Type
Notification
Problem
The jukebox feature is not enabled. You might have run out of
"bulk" enabler counts.
Resolution
•
•
Enter the enabler code for the jukebox into the license
resource.
If you have run out of "bulk" enabler counts, contact Legato
Customer Service. Enable and authorize this enabler using
lgtolic.
The feature <feature> is not properly enabled
Message Type
Notification
Problem
This error indicates a licensing problem with the NetWorker
server software and must be resolved on the backup server before
you can use the specified feature. Following are thre possible
causes for this error:
•
•
•
•
The specified feature is not enabled.
The wrong operating system version of the enabler code for
the feature was used.
The enabler code for the feature is faulty.
You might have run out of "bulk" enabler counts.
Resolution
•
•
•
•
Use the nsrcap command to verify the enabler code.
Enable the feature.
If you do not have an enabler code for the appropriate
operating system, contact Legato Customer Service.
Use the evaluation enabler codes until permanent
enabler codes can be provided.
If you have run out of "bulk" enabler counts, contact
Legato Customer Service. Enable and authorize this
enabler using lgtolic.
RPC error: Program not registered
Message Type
Fatal Error
Problem
•
The requested program did not start on the remote system.
61
Appendix A: Troubleshooting
•
•
The lgtolic program could not be run because the licensing
service (lgtolmd) is not running.
The NetWorker resources file, nsr.res is corrupted.
Resolution
•
•
•
Start the remote service. If it has started, then stop it and
restart it. Before restarting the remote service, make sure that
the corresponding portmapper, rpcbind or nsrexecd services
are running.
Start the lgtolmd service and then run the lgtolic program.
Recover the nsr.res file.
RPC error: RPC program or version mismatch
Message Type
Notification
Problem
•
•
There is a mismatch between the version of the RPC service
requested by the client and the service available on the
server. This problem might be the result of an incorrect
"Name to Address" resolution.
There is a mismatch between the version of the RPC service
used by the Legato License Manager (lgtolmd) and the
services available on the server. The default RPC version for
lgtolmd is two (2).
Resolution
•
Use rpcinfo to verify that both the server and the clients are
running the same version of RPC. For operating systems that
do not include the rpcinfo utility it is provided on the Legato
product CD.
• Update the NetWorker software on the client or server.
• Verify that the "Name to Address" resolution is correct. Test
by running nslookup using the Fully Qualified Domain
Name of the computer. On Windows NT, this verification can
also be performed from the Network control panel.
• Specify the same version of RPC for lgtolmd that is used by
the other backup services on the backup server. This can be
specified by either:
– Entering the following command at the command line:
lgtolic -s <hostname>:<rpc_number>:<rpc_version>
Or
–
Setting the LMD_VERSION environment variable.
62
Appendix A: Troubleshooting
Description of lgtolmd Daemon
lgtolmd is the Legato License Manager Daemon.
Synopsis
lgtolmd -p product -n version
Description
The lgtolmd daemon is an RPC-based licensing service. This service allows
applications to store, and manipulate license data. The RPC program number
provided by lgtolmd is 390115. To support multiple instances of the protocol, the
version number is unique to each application. The required parameters are
determined by each product's installation script.
Options
-p product
Specify the product that will be interfacing with the
License daemon. The currently supported products
are gems (for GEMS default install directory /gems)
and opt/SmartMedia (for SmartMedia default install
directory /opt/SmartMedia) on UNIX platforms. For
NetWorker, nsr/lic (for NetWorker default install
directory /nsr) on UNIX platforms.
-n version
Specify the version number. Some products use a
unique version number. Currently, SmartMedia uses
version 2 and GEMS Storage Reporter uses version 3.
Both GEMS and NetWorker use version 1. The future
plan is to have all Legato products use the same license
manager, i.e., version number 1.
/[product]/res/lgtolm.res
Attributes describing the license daemon's license
resources. This file should not be manually removed
or modified in any way.
/[product]/res/lictype.res
For internal use only. This file should not be manually
removed or modified in any way.
Files
/[product]/logs/lgtolmd.log Log file for diagnostic and informational messages on
the license daemon. For example, if a license has
expired, this information will be printed to this log as
well as to the console.
The actual locations of the lgtolmd.log file depends on
the operating system in use on the server:
for UNIX - /nsr/lic/logs/ lgtolmd.log, for Windows NT c:\win32app\lic\logs\lgtolmd.log, for Windows 2000 c:\Program Files\nsr\lic\logs\lgtolmd.log.
Running lgtolmd in Debug Mode
In case there are difficulties with lgtolmd you can use the the debug mode to elicit
information when starting the command.
63
Appendix A: Troubleshooting
For example, if lgtolmd (the license daemon) is already running and you try to start or
restart it again, you can use the various levels of the debug switch (-D1, -D2, -D3),
which vary in the amount of text produced, to see what the difficulty is. You can
reroute the output to a file if needed.
% /usr/sbin/lgtolmd -D1 -p /nsr/lic -n 1 &
01/12/00 07:43:09 lgtolmd: Locale "C" found.
01/12/00 07:43:09 lgtolmd: Lang Subdir is "c".
01/12/00 07:43:09 lgtolmd: Message catalog "/nsr/lic.cat" NOT
found.
01/12/00 07:43:09 lgtolmd: path: /nsr/lic
[1] 1846
%01/12/00 07:43:09 lgtolmd: SYSTEM notice, Resource file
//nsr/lic/tmp/res.lck already in use;
check for another copy of lgtolmd already running (severity
1, number 0)
01/12/00 07:43:09 lgtolmd: error initializing resource file.
or
% /usr/sbin/lgtolmd -D2 -p /nsr/lic -n 1 &
01/12/00 07:44:29 lgtolmd: Locale "C" found.
01/12/00 07:44:29 lgtolmd: Lang Subdir is "c".
01/12/00 07:44:29 lgtolmd: Message catalog "/nsr/lic.cat" NOT
found.
01/12/00 07:44:29 lgtolmd: path: /nsr/lic
01/12/00 07:44:29 lgtolmd: find_64bit_func(): This system has
64-bit file system calls.
01/12/00 07:44:29 lgtolmd: Origin is /usr/sbin/
01/12/00 07:44:29 lgtolmd: SYSTEM notice, Resource file
//nsr/lic/tmp/res.lck already in use;
check for another copy of lgtolmd already running (severity
1, number 0)
01/12/00 07:44:29 lgtolmd: error initializing resource file.
Running nsrd in Debug Mode
Running nsrd with the -D2 option causes nsrlmc to run with the -D2 option each time
it is started. When nsrlmc is run with the -D2 option, it prints details into the log file
specified in the command line, such as /nsr/logs/daemon.log.debug, on the types of
licenses requested, and the results of each request. The command must redirect output
to a specified log file.
Syntax for the UNIX cshell, and for Windows NT, is the same, except that Windows NT
uses backslashes:
UNIX:
nsrd -D2 > & /nsr/logs/daemon.log.debug & [enter]
64
Appendix A: Troubleshooting
Windows NT:
nsrd -D2 > & \nsr\logs\daemon.log.debug & [enter]
Old and New License Names
There are two ways to view license names:
•
•
from the command line, using lgtolic -l
through the nwadmin GUI, or the GEMS Console GUI
Most product license names have been updated for NetWorker 6.0, in order to make
them more representative. However, depending on the product that is maintaining the
license data, license names can be reported in either the new or the old format. Table 2
shows the situations under which new and old license names are reported.
Table 2. How New and Old License Names are Reported
Product Maintaining License Data
Accessed by
License Name
Reported
Legato License Manager
lgtolic -l
New Names
GEMS License Manager
GEMS Console
Old Names
NetWorker 6.0
nwadmin
New Names
NetWorker 5.5
nwadmin
Old Names
Refer to Table 3 on page 66 and Table 4 on page 87 for the complete lists of new and old
license names.
65
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2008
Autochanger Module, 8 slots/1
AutoChanger/8 slots
#2013
Autochanger Module, 16 slots/1
AutoChanger/16 slots
#2009
Autochanger Module, 32 slots/1
AutoChanger/32 slots
#2014
Autochanger Module, 64 slots/1
AutoChanger/64 slots
#2043:
Autochanger Module, 128 slots/1
AutoChanger/128 slots
#2044:
Autochanger Module, 256 slots/1
AutoChanger/256 slots
#2046:
Autochanger Modules, Unlimited
Slots/1
AutoChanger/unlimited slots
#2072:
Autochanger Module, 8 slots/1
AutoChanger/8 slots
#2073:
Autochanger Module, 16 slots/1
AutoChanger/16 slots
#2074:
Autochanger Module, 32 slots/1
AutoChanger/32 slots
#2075:
Autochanger Module, 64 slots/1
AutoChanger/64 slots
#2076:
Autochanger Module, 128 slots/1
AutoChanger/128 slots
#2077:
Autochanger Module, 256 slots/1
AutoChanger/256 slots
#2078:
Autochanger Modules, Unlimited
Slots/1
AutoChanger/unlimited slots
#2021:
NetWorker Client Connections/5
5 Clients
#2022:
NetWorker Client Connections/25
25 Clients
#2023:
NetWorker Client Connections/100
100 Clients
#2027:
Workstation Clients/5
5 Workstation Clients
#2028:
Workstation Clients/25
25 Workstation Clients
#2029:
Workstation Clients/100
100 Workstation Clients
#2032:
NDMP Client Connections/1
1 NDMP Connections For Celestra
#2033:
NDMP Client Connections/5
5 NDMP Connections For Celestra
#2034:
NDMP Client Connections/25
25 NDMP Connections For Celestra
#2035:
NDMP Client Connections/100
100 NDMP Connections For Celestra
66
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2036:
NDMP Client Connections/Unlimited
Unlimited NDMP Connections For
Celestra
#2030:
NetWorker Archive Module/1
Archive support
#2031:
HSM for UNIX/1
HSM support
#2038:
HSM for UNIX/1
HSM support
#2050:
NetWorker for Frameworks/1
Framework modules
#2025:
NetWorker SNMP Module/1
NetWorker SNMP support
#2042:
Silo for Windows or UNIX, 1
slots/8147417
Silo/64 slots
#2040:
Silo for Windows or UNIX, 1
slots/8147929
Silo/128 slots
#2047:
Silo for Windows or UNIX, 1
slots/8148441
Silo/256 slots
#2048:
Silo for Windows or UNIX, 1
slots/8148953
Silo/512 slots
#2041:
Silo for Windows or UNIX, Unlimited
Slots/1
Silo/unlimited slots
#2045:
High Speed Device Support/1
High Speed Device Support
#5045:
High Speed Device Support/1
High Speed Device Support
#2080:
Storage Node for Windows or UNIX/1 Remote Storage Node
#2081:
Storage Node for Windows or UNIX/1 Remote Storage Node
#2083:
Storage Node for Windows or UNIX/1 Remote Storage Node
#5080:
Storage Node for Windows or UNIX/1 Remote Storage Node
#5081:
Storage Node for Windows or UNIX/1 Remote Storage Node
#5083:
Storage Node for Windows or UNIX/1 Remote Storage Node
#2980:
Storage Node for Windows or UNIX/1 Remote Storage Node
#2981:
Storage Node for Windows or UNIX/1 Remote Storage Node
#5980:
Storage Node for Windows or UNIX/1 Remote Storage Node
#5981:
Storage Node for Windows or UNIX/1 Remote Storage Node
#3318:
Storage Node for Windows or UNIX/1 Remote Storage Node
67
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
#3319:
Storage Node for Windows or UNIX/1 Remote Storage Node
#3320:
Storage Node for Windows or UNIX/1 Remote Storage Node
#3300:
ClientPak for UNIX/1
ClientPak for UNIX
#3321:
ClientPak for LINUX/1
ClientPak for LINUX
#3302:
ClientPak for PC Desktops/1
ClientPak for PC Desktops
#2037:
ClientPak for Network Appliance/1
ClientPak for Network Appliance
#3303:
ClientPak for NetWare/1
ClientPak for Netware
#3304:
ClientPak for Windows/1
ClientPak for Windows NT
#3308:
ClientPak for Windows/1
ClientPak for Windows NT
#3305:
ClientPak for Macintosh/1
ClientPak for Macintosh
#2039:
Enterprise/1
Enterprise
#2401:
NetWorker, Network Edition/1
NetWorker, Network Edition/10
#24013UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#24021UG:
NetWorker for Windows, Network
Edition/1
TurboPak
#24024UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#24026UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2402:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2404:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/1
#2406:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/4
#5402:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#54022UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#54024UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
Old Product License Names
68
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#54026UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#5402UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#2410:
NetWorker Client Connections/10
10 Clients
#2411:
NetWorker Client Connections/50
50 Clients
#2412:
Concurrent Devices/1
Concurrent Devices
#2420:
NetWorker for Windows, Network
Edition/1
TurboPak
#2451:
NetWorker Module for Oracle, UNIX
Client/1
BusinesSuite Module for Oracle
#2452:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2453:
NetWorker Module for Sybase, UNIX
Client/1
BusinesSuite Module for Sybase
#2454:
NetWorker Module for Microsoft SQL NetWorker Module for Microsoft SQL
Server/1
Server
#2455:
NetWorker Module for Microsoft Exchange Server/1
NetWorker Module for Microsoft Exchange Server
#2456:
NetWorker Module for SAP R/3 Microsoft SQL Server/1
NetWorker Module for SAP R/3 Microsoft SQL Server
#2457:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#2458:
NetWorker Module for Lotus
cc:Mail/1
NetWorker Module for Lotus cc:Mail
#2459:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2460:
NetWorker Module for Microsoft
Mail/1
NetWorker Module for Microsoft Mail
#2461:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2495:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#8945:
Professional Services Toolkit/1
Professional Services Toolkit
69
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#8947:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2494:
NetWorker Module for DB2/1
NetWorker Module for DB2
#2194:
NetWorker Module for DB2/1
NetWorker Module for DB2
#2017:
NetWorker Module for EMC Symmetrix for Oracle/1
Legato NetWorker for EMC Symmetrix
for Oracle
#2019:
NetWorker NetWorker for EMC Symmetrix, SAP R/3 for Oracle/1
NetWorker NetWorker for EMC Symmetrix, SAP R/3 for Oracle
#2154:
NetWorker Module for Oracle/1
Legato NetWorker Module for Oracle
#2155:
NetWorker Module for Oracle/1
Legato NetWorker Module for Oracle
#2647:
Shared Autochanger for Windows/1
Autochanger Sharing for NT
#2648:
Shared Autochanger for UNIX/1
Autochanger Sharing for UNIX
#2500:
NetWorker, Network Edition/1
NetWorker, Network Edition/1
#2501:
NetWorker, Network Edition/1
NetWorker, Network Edition/10
#25014UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2502:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#25021UG:
NetWorker for Windows, Network
Edition/1
TurboPak
#25024UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#25026UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2504:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/1
#2506:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/4
#5502:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#55022UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
70
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#55024UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#55026UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#5502UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#2520:
NetWorker for Windows, Network
Edition/1
TurboPak
#2551:
NetWorker Module for Oracle, UNIX
Client/1
BusinesSuite Module for Oracle
#2552:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2553:
NetWorker Module for Sybase, UNIX
Client/1
BusinesSuite Module for Sybase
#2554:
NetWorker Module for Microsoft SQL NetWorker Module for Microsoft SQL
Server/1
Server
#2555:
NetWorker Module for Microsoft Exchange Server/1
NetWorker Module for Microsoft Exchange Server
#2556:
NetWorker Module for SAP R/3 Microsoft SQL Server/1
NetWorker Module for SAP R/3 Microsoft SQL Server
#2557:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#2558:
NetWorker Module for Lotus
cc:Mail/1
NetWorker Module for Lotus cc:Mail
#2559:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2560:
NetWorker Module for Microsoft
Mail/1
NetWorker Module for Microsoft Mail
#2561:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2595:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#8977:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
71
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2601:
NetWorker, Network Edition/1
NetWorker, Network Edition/10
#2602:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#26013UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#26021UG:
NetWorker for Windows, Network
Edition/1
TurboPak
#26024UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#26026UG:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2604:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/1
#2606:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/4
#5602:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#56022UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#56024UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#56026UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#5602UG:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#2106:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/4
#2102:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#5102:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#2610:
NetWorker Client Connections/10
10 Clients
#2611:
NetWorker Client Connections/50
50 Clients
#2612:
Concurrent Devices/1
Concurrent Devices
72
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2620:
NetWorker for Windows, Network
Edition/1
TurboPak
#2650:
NetWorker Module for Oracle, Unix
Client/1
NetWorker Module for Oracle
#2651:
NetWorker Module for Oracle, UNIX
Client/1
BusinesSuite Module for Oracle
#2679:
NetWorker Module for Oracle, UNIX
Client/1
BusinesSuite Module for Oracle
#2652:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2653:
NetWorker Module for Sybase, UNIX
Client/1
BusinesSuite Module for Sybase
#2654:
NetWorker Module for Microsoft SQL NetWorker Module for Microsoft SQL
Server/1
Server
#2655:
NetWorker Module for Microsoft Exchange Server/1
NetWorker Module for Microsoft Exchange Server
#2656:
NetWorker Module for SAP R/3 Microsoft SQL Server/1
NetWorker Module for SAP R/3 Microsoft SQL Server
#2657:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#2658:
NetWorker Module for Lotus
cc:Mail/1
NetWorker Module for Lotus cc:Mail
#2659:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2660:
NetWorker Module for Microsoft
Mail/1
NetWorker Module for Microsoft Mail
#2661:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2665:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2695:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#8965:
Professional Services Toolkit/1
Professional Services Toolkit
73
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#8967:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2151:
NetWorker Module for Oracle, UNIX
Client/1
BusinesSuite Module for Oracle
#2152:
NetWorker Module for Informix,
UNIX Client/1
BusinesSuite Module for Informix
#2153:
NetWorker Module for Sybase, UNIX
Client/1
BusinesSuite Module for Sybase
#2161:
NetWorker Module for SAP R/3 on
Oracle, UNIX Client/1
BusinesSuite Module for SAP R/3 Oracle
#2195:
NetWorker Module for Lotus Notes,
UNIX Client/1
BusinesSuite Module for Lotus Notes
#2202:
NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2202-6U: NetWorker for UNIX, Network Edition/1
NetWorker, Turbo/10
#2206:
NetWorker for UNIX, Workgroup Edition/1
NetWorker, Turbo/4
#5202:
NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#5202-2U: NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#5202-6U: NetWorker for UNIX, Power Edition/1 NetWorker Extended/10
#2132:
Cluster Client Connections/1
1 Cluster Clients
#2133:
Cluster Client Connections/5
5 Cluster Clients
#2134:
Cluster Client Connections/25
25 Cluster Clients
#2135:
Cluster Client Connections/100
100 Cluster Clients
#2110:
NT Cluster Clients/1
1 NT Cluster Clients
#2111:
NT Cluster Clients/5
5 NT Cluster Clients
#2112:
NT Cluster Clients/25
25 NT Cluster Clients
#2113:
NT Cluster Clients/100
100 NT Cluster Clients
#2114:
UNIX Cluster Clients/1
1 UNIX Cluster Clients
#2115:
UNIX Cluster Clients/5
5 UNIX Cluster Clients
74
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2116:
UNIX Cluster Clients/25
25 UNIX Cluster Clients
#2117:
UNIX Cluster Clients/100
100 UNIX Cluster Clients
#2816:
Autochanger Module, 6 slots/1
AutoChanger/6 slots
#2807:
Autochanger Module, 7 slots/1
AutoChanger/7 slots
#2813:
Autochanger Module, 16 slots/1
AutoChanger/16 slots
#2814:
Autochanger Module, 64 slots/1
AutoChanger/64 slots
#2815:
Autochanger Modules, Unlimited
Slots/1
AutoChanger/unlimited slots
#2901:
NetWorker, Network Edition/1
NetWorker, Network Edition/10
#2904:
NetWorker for Windows, Workgroup
Edition/1
NetWorker, Turbo/1
#2902:
NetWorker for Windows, Network
Edition/1
NetWorker, Turbo/10
#2903:
NetWorker for Windows, Network
Edition/1
NetWorker, Turbo/10
#2906:
NetWorker for Windows, Workgroup
Edition/1
NetWorker, Turbo/4
#2907:
NetWorker for Windows, Workgroup
Edition/1
NetWorker, Turbo/4
#5902:
NetWorker for Windows, Power Edition/1
NetWorker Extended/10
#5903:
NetWorker for Windows, Power Edition/1
NetWorker Extended/10
#5902-2U: NetWorker for Windows, Power Edition/1
NetWorker Extended/10
#5902-4U: NetWorker for Windows, Power Edition/1
NetWorker Extended/10
#5902-6U: NetWorker for Windows, Power Edition/1
NetWorker Extended/10
#29014UG:
NetWorker for Windows, Network
Edition/1
NetWorker, Turbo/10
#29019UG:
NetWorker, Network Edition/1
NetWorker, Network Edition/10
75
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#29021UG:
NetWorker for Windows, Network
Edition/1
TurboPak
#29024UG:
NetWorker for Windows, Network
Edition/1
NetWorker, Turbo/10
#29026UG:
NetWorker for Windows, Network
Edition/1
NetWorker, Turbo/10
#29049UG:
NetWorker for Windows, Workgroup
Edition/1
NetWorker, Turbo/1
#2920:
NetWorker for Windows, Network
Edition/1
TurboPak
#2930:
NetWorker Archive Module/1
Archive support
#2927:
Workstation Clients/5
5 Workstation Clients
#2928:
Workstation Clients/25
25 Workstation Clients
#2929:
Workstation Clients/100
100 Workstation Clients
#2916:
Autochanger Module, 6 slots/1
AutoChanger/6 slots
#2907:
Autochanger Module, 7 slots/1
AutoChanger/7 slots
#2908:
Autochanger Module, 8 slots/1
AutoChanger/8 slots
#2913:
Autochanger Module, 16 slots/1
AutoChanger/16 slots
#2909:
Autochanger Module, 32 slots/1
AutoChanger/32 slots
#2914:
Autochanger Module, 64 slots/1
AutoChanger/64 slots
#2943:
Autochanger Module, 128 slots/1
AutoChanger/128 slots
#2944:
Autochanger Module, 256 slots/1
AutoChanger/256 slots
#2945:
High Speed Device Support/1
High Speed Device Support
#2915:
Autochanger Modules, Unlimited
Slots/1
AutoChanger/unlimited slots
#2946:
Autochanger Modules, Unlimited
Slots/1
AutoChanger/unlimited slots
#2940:
Silo for Windows or UNIX, 1
slots/8253913
Silo/128 slots
#2947:
Silo for Windows or UNIX, 1
slots/8254425
Silo/256 slots
76
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2948:
Silo for Windows or UNIX, 1
slots/8254937
Silo/512 slots
#2941:
Silo for Windows or UNIX, Unlimited
Slots/1
Silo/unlimited slots
#2925:
NetWorker SNMP Module/1
NetWorker SNMP support
#2939:
Enterprise/1
Enterprise
#2950:
NetWorker Module for Oracle, NT Cli- NetWorker Module for Oracle
ent/1
#2951:
NetWorker Module for Oracle, Windows Client/1
BusinesSuite Module for Oracle
#2952:
NetWorker Module for Informix, Windows Client/1
BusinesSuite Module for Informix
#2953:
NetWorker Module for Sybase, Windows Client/1
BusinesSuite Module for Sybase
#2954:
NetWorker Module for Microsoft SQL NetWorker Module for Microsoft SQL
Server/1
Server
#2955:
NetWorker Module for Microsoft Exchange Server/1
NetWorker Module for Microsoft Exchange Server
#2956:
NetWorker Module for SAP R/3 Microsoft SQL Server/1
NetWorker Module for SAP R/3 Microsoft SQL Server
#2957:
NetWorker Module for Lotus Notes,
Windows Client/1
BusinesSuite Module for Lotus Notes
#2958:
NetWorker Module for Lotus
cc:Mail/1
NetWorker Module for Lotus cc:Mail
#2959:
NetWorker Module for Informix, Windows Client/1
BusinesSuite Module for Informix
#2960:
NetWorker Module for Microsoft
Mail/1
NetWorker Module for Microsoft Mail
#2961:
NetWorker Module for SAP R/3 on
Oracle, Windows Client/1
BusinesSuite Module for SAP R/3 Oracle
#2919:
STAGE3 Module/1
STAGE3 Module
#2969:
NetWorker Module for Informix, Windows Client/1
BusinesSuite Module for Informix
77
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2965:
NetWorker Module for SAP R/3 on
Oracle, Windows Client/1
BusinesSuite Module for SAP R/3 Oracle
#2995:
NetWorker Module for Lotus Notes,
Windows Client/1
BusinesSuite Module for Lotus Notes
#2979:
NetWorker Module for Oracle, Windows Client/1
BusinesSuite Module for Oracle
#2330:
NLM NetWorker SingleServer/1
NLM NetWorker SingleServer
#2331:
NLM NetWorker SingleServer/1
NLM NetWorker SingleServer
#2710:
NetWorker for NetWare, Workgroup
Edition/1
NetWorker, Network Edition/1
#2706:
NetWorker for NetWare, Workgroup
Edition/1
NetWorker, Network Edition/4
#2702:
NetWorker for NetWare, Network Edi- NetWorker, Turbo/10
tion/1
#27026UG:
NetWorker for NetWare, Network Edi- NetWorker, Turbo/10
tion/1
#2704:
NetWorker for NetWare, Workgroup
Edition/1
#27014UG:
NetWorker for NetWare, Network Edi- NetWorker, Turbo/10
tion/1
#27019UG:
NetWorker for NetWare, Network Edi- NetWorker, Network Edition/10
tion/1
#27024UG:
NetWorker for NetWare, Network Edi- NetWorker, Turbo/10
tion/1
#27049UG:
NetWorker for NetWare, Workgroup
Edition/1
NetWorker, Turbo/1
#2720:
TurboPak for NetWare
TurboPak
#2730:
Archive support for NetWare/1
Archive support
#2721:
Client Connections for NetWare/5
5 Clients (NetWare server)
#2722:
Client Connections for NetWare/25
25 Clients (NetWare server)
#2723:
Client Connections for NetWare/100
100 Clients (NetWare server)
#2216:
AutoChanger for NetWare, 6 slots/1
AutoChanger/6 slots
NetWorker, Turbo/1
78
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2207:
AutoChanger for NetWare, 7 slots/1
AutoChanger/7 slots
#2208:
AutoChanger for NetWare, 8 slots/1
AutoChanger/8 slots
#2213:
AutoChanger for NetWare, 16 slots/1
AutoChanger/16 slots
#2209:
AutoChanger for NetWare, 32 slots/1
AutoChanger/32 slots
#2214:
AutoChanger for NetWare, 64 slots/1
AutoChanger/64 slots
#2243:
AutoChanger for NetWare, 128 slots/1 AutoChanger/128 slots
#2244:
AutoChanger for NetWare, 256 slots/1 AutoChanger/256 slots
#2215:
AutoChanger for NetWare, Unlimited
Slots/1
AutoChanger/unlimited slots
#2246:
AutoChanger for NetWare, Unlimited
Slots/1
AutoChanger/unlimited slots
#2219:
AutoChanger for NetWare, Unlimited
Slots/1
AutoChanger/unlimited slots
#2708:
AutoChanger for NetWare, 8 slots/1
AutoChanger/8 slots
#2713:
AutoChanger for NetWare, 16 slots/1
AutoChanger/16 slots
#2709:
AutoChanger for NetWare, 32 slots/1
AutoChanger/32 slots
#2714:
AutoChanger for NetWare, 64 slots/1
AutoChanger/64 slots
#2743:
AutoChanger for NetWare, 128 slots/1 AutoChanger/128 slots
#2744:
AutoChanger for NetWare, 256 slots/1 AutoChanger/256 slots
#2746:
AutoChanger for NetWare, Unlimited
Slots/1
AutoChanger/unlimited slots
#2719:
AutoChanger for NetWare, Unlimited
Slots/1
AutoChanger/unlimited slots
#7000:
GEMS Director with 12 GEMS Connec- GEMStation/12
tions/1
#7025:
GEMS Director with 12 GEMS Connec- GEMStation/12
tions/1
#7050:
GEMS Connections for UNIX/1
1 GEMS Managed Nodes (Unix)
#7075:
GEMS Connections for Windows/1
1 GEMS Managed Nodes (NT/NetWare)
#7001:
GEMS Connections for UNIX/5
5 GEMS Managed Nodes (Unix)
79
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7002:
GEMS Connections for UNIX/25
25 GEMS Managed Nodes (Unix)
#7003:
GEMS Connections for UNIX/Unlim- Unlimited GEMS Managed Nodes
ited
(Unix)
#7011:
GEMS Connections for Windows/5
5 GEMS Managed Nodes (NT/NetWare)
#7012:
GEMS Connections for Windows/25
25 GEMS Managed Nodes (NT/NetWare)
#7013:
GEMS Connections for Windows/Un- Unlimited GEMS Managed Nodes
limited
(NT/NetWare)
#7101:
NetWorker for UNIX, Workgroup Edition/5
NetWorker, Turbo/4
#7102:
NetWorker for UNIX, Workgroup Edition/25
NetWorker, Turbo/4
#7103:
NetWorker for UNIX, Workgroup Edition/100
NetWorker, Turbo/4
#7104:
NetWorker for UNIX, Workgroup Edition/Unlimited
NetWorker, Turbo/4
#7111:
NetWorker for UNIX, Network Edition/5
NetWorker, Turbo/10
#7112:
NetWorker for UNIX, Network Edition/25
NetWorker, Turbo/10
#7113:
NetWorker for UNIX, Network Edition/100
NetWorker, Turbo/10
#7114:
NetWorker for UNIX, Power Edition/Unlimited
NetWorker Extended/10
#7121:
NetWorker for UNIX, Power Edition/5 NetWorker Extended/10
#7122:
NetWorker for UNIX, Power Edition/25
NetWorker Extended/10
#7123:
NetWorker for UNIX, Power Edition/100
NetWorker Extended/10
#7124:
NetWorker for UNIX, Power Edition/Unlimited
NetWorker Extended/10
#7201:
NetWorker for Windows, Workgroup
Edition/5
NetWorker, Turbo/4
80
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7202:
NetWorker for Windows, Workgroup
Edition/25
NetWorker, Turbo/4
#7203:
NetWorker for Windows, Workgroup
Edition/100
NetWorker, Turbo/4
#7204:
NetWorker for Windows, Workgroup
Edition/Unlimited
NetWorker, Turbo/4
#7211:
NetWorker for Windows, Network
Edition/5
NetWorker, Turbo/10
#7212:
NetWorker for Windows, Network
Edition/25
NetWorker, Turbo/10
#7213:
NetWorker for Windows, Network
Edition/100
NetWorker, Turbo/10
#7214:
NetWorker for Windows, Power Edition/Unlimited
NetWorker Extended/10
#7221:
NetWorker for Windows, Power Edition/5
NetWorker Extended/10
#7222:
NetWorker for Windows, Power Edition/25
NetWorker Extended/10
#7223:
NetWorker for Windows, Power Edition/100
NetWorker Extended/10
#7224:
NetWorker for Windows, Power Edition/Unlimited
NetWorker Extended/10
#7311:
Autochanger Modules, 8 slots/5
AutoChanger/8 slots
#7312:
Autochanger Modules, 8 slots/25
AutoChanger/8 slots
#7313:
Autochanger Modules, 8 slots/100
AutoChanger/8 slots
#7314:
Autochanger Modules, 8 slots/Unlimited
AutoChanger/8 slots
#7321:
Autochanger Modules, 16 slots/5
AutoChanger/16 slots
#7322:
Autochanger Modules, 16 slots/25
AutoChanger/16 slots
#7323:
Autochanger Modules, 16 slots/100
AutoChanger/16 slots
#7324:
Autochanger Modules, 16 slots/Unlimited
AutoChanger/16 slots
#7331:
Autochanger Modules, 32 slots/5
AutoChanger/32 slots
81
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7332:
Autochanger Modules, 32 slots/25
AutoChanger/32 slots
#7333:
Autochanger Modules, 32 slots/100
AutoChanger/32 slots
#7334:
Autochanger Modules, 32 slots/Unlimited
AutoChanger/32 slots
#7341:
Autochanger Modules, 64 slots/5
AutoChanger/64 slots
#7342:
Autochanger Modules, 64 slots/25
AutoChanger/64 slots
#7343:
Autochanger Modules, 64 slots/100
AutoChanger/64 slots
#7344:
Autochanger Modules, 64 slots/Unlimited
AutoChanger/64 slots
#7351:
Autochanger Modules, 128 slots/5
AutoChanger/128 slots
#7352:
Autochanger Modules, 128 slots/25
AutoChanger/128 slots
#7353:
Autochanger Modules, 128 slots/100
AutoChanger/128 slots
#7354:
Autochanger Modules, 128 slots/Unlimited
AutoChanger/128 slots
#7361:
Autochanger Modules, 256 slots/5
AutoChanger/256 slots
#7362:
Autochanger Modules, 256 slots/25
AutoChanger/256 slots
#7363:
Autochanger Modules, 256 slots/100
AutoChanger/256 slots
#7364:
Autochanger Modules, 256 slots/Unlimited
AutoChanger/256 slots
#7371:
Autochanger Modules, Unlimited
Slots/5
AutoChanger/unlimited slots
#7372:
Autochanger Modules, Unlimited
Slots/25
AutoChanger/unlimited slots
#7373:
Autochanger Modules, Unlimited
Slots/100
AutoChanger/unlimited slots
#7374:
Autochanger Module, Unlimited
Slots/Unlimited
AutoChanger/unlimited slots
#7381:
NetWorker SNMP Modules/5
NetWorker SNMP support
#7382:
NetWorker SNMP Modules/25
NetWorker SNMP support
#7383:
NetWorker SNMP Modules/100
NetWorker SNMP support
#7384:
NetWorker SNMP Module/Unlimited
NetWorker SNMP support
82
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7385:
NetWorker Archive Modules/5
Archive support
#7386:
NetWorker Archive Modules/25
Archive support
#7387:
NetWorker Archive Modules/100
Archive support
#7388:
NetWorker Archive Modules/Unlimit- Archive support
ed
#7391:
NetWorker Client Connections/500
500 Clients
#7392:
NetWorker Client Connections/1000
1000 Clients
#7393:
NetWorker Client Connections/Unlimited
Unlimited Clients
#7401:
Storage Nodes for Windows or
UNIX/5
Remote Storage Node
#7402:
Storage Nodes for Windows or
UNIX/25
Remote Storage Node
#7403:
Storage Nodes for Windows or
UNIX/100
Remote Storage Node
#7404:
Storage Nodes for Windows or
UNIX/Unlimited
Remote Storage Node
#7411:
Storage Nodes for Windows or
UNIX/5
Remote Storage Node
#7412:
Storage Nodes for Windows or
UNIX/25
Remote Storage Node
#7413:
Storage Nodes for Windows or
UNIX/100
Remote Storage Node
#7414:
Storage Nodes for Windows or
UNIX/Unlimited
Remote Storage Node
#7405:
Storage Nodes for Windows or
UNIX/5
Remote Storage Node
#7406:
Storage Nodes for Windows or
UNIX/25
Remote Storage Node
#7415:
Storage Nodes for Windows or
UNIX/5
Remote Storage Node
#7416:
Storage Nodes for Windows or
UNIX/25
Remote Storage Node
83
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7511:
ClientPaks for UNIX/5
ClientPak for UNIX
#7512:
ClientPaks for UNIX/25
ClientPak for UNIX
#7513:
ClientPaks for UNIX/100
ClientPak for UNIX
#7514:
ClientPaks for UNIX/Unlimited
ClientPak for UNIX
#7516:
ClientPaks for LINUX/5
ClientPak for LINUX
#7517:
ClientPaks for LINUX/25
ClientPak for LINUX
#7518:
ClientPaks for LINUX/100
ClientPak for LINUX
#7519:
ClientPaks for LINUX/Unlimited
ClientPak for LINUX
#7521:
ClientPaks for PC Desktops/5
ClientPak for PC Desktops
#7522:
ClientPaks for PC Desktops/25
ClientPak for PC Desktops
#7523:
ClientPaks for PC Desktops/100
ClientPak for PC Desktops
#7524:
ClientPaks for PC Desktops/Unlimited
ClientPak for PC Desktops
#7531:
ClientPaks for Network Appliance/5
ClientPak for Network Appliance
#7532:
ClientPaks for Network Appliance/25
ClientPak for Network Appliance
#7533:
ClientPaks for Network Appliance/100
ClientPak for Network Appliance
#7534:
ClientPaks for Network Appliance/Unlimited
ClientPak for Network Appliance
#7531:
ClientPaks for NetWare/5
ClientPak for Netware
#7532:
ClientPaks for NetWare/25
ClientPak for Netware
#7533:
ClientPaks for NetWare/100
ClientPak for Netware
#7534:
ClientPaks for NetWare/Unlimited
ClientPak for Netware
#7541:
ClientPaks for Windows/5
ClientPak for Windows NT
#7542:
ClientPaks for Windows/25
ClientPak for Windows NT
#7543:
ClientPaks for Windows/100
ClientPak for Windows NT
#7544:
ClientPaks for Windows/Unlimited
ClientPak for Windows NT
#7551:
ClientPaks for Macintosh/5
ClientPak for Macintosh
84
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#7552:
ClientPaks for Macintosh/25
ClientPak for Macintosh
#7553:
ClientPaks for Macintosh/100
ClientPak for Macintosh
#7554:
ClientPaks for Macintosh/Unlimited
ClientPak for Macintosh
#3311:
ClientPak for MPE/iX/1
ClientPak for MPE
#3312:
ClientPak for MPE/iX/1
ClientPak for MPE
#3313:
ClientPak for MPE/iX/1
ClientPak for MPE
#7561:
Enterprise/5
Enterprise
#7562:
Enterprise/25
Enterprise
#7563:
Enterprise/100
Enterprise
#7564:
Enterprise/0
Enterprise
#2090:
GEMS SmartMedia Server for Windows or UNIX/1
SmartMedia Server Edition/1000
#2091:
GEMS SmartMedia Connection for
Windows or UNIX/1
SmartMedia Managed Nodes/1
#2064:
GEMS SmartMedia Connection for
Windows or UNIX/10
SmartMedia Managed Nodes/10
#2065:
GEMS SmartMedia Connection for
Windows or UNIX/100
SmartMedia Managed Nodes/100
#2063:
GEMS SmartMedia Connection for
Windows or NIX/Unlimited
SmartMedia Managed Nodes/unlimited
#2067:
GEMS SmartMedia Connection for
Windows or UNIX/1
SmartMedia Managed Nodes/1
#2060:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/100
es (per 1,000 volumes)/1
#2062:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/500
es (per 1,000 volumes)/1
#2092:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/1000
es (per 1,000 volumes)/1
#2093:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/unes/Unlimited
limited
#2068:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/100
es (per 1,000 volumes)/1
85
Appendix A: Troubleshooting
Table 3. New and Old Product License Names
Part
Number
New Product License Names
Old Product License Names
#2069:
GEMS SmartMedia Managed Cartridg- SmartMedia Managed Volumes/500
es (per 1,000 volumes)/1
#4001:
NetWorker Remote Server/1
NetWorker Remote/0
#4002:
NetWorker Remote Client Connections/50
NetWorker Remote Client/50
#4003:
NetWorker Remote Add-on/1
NetWorker Remote Add-on/2
#4004:
NetWorker Remote Add-on/1
NetWorker Remote Add-on/3
#4005:
NetWorker Remote Client Connections/25
NetWorker Remote Client/25
#4006:
NetWorker Remote Client Connections/100
NetWorker Remote Client/100
#4007:
NetWorker Remote Client Connections/500
NetWorker Remote Client/500
#4008:
NetWorker Remote Client Connections/1000
NetWorker Remote Client/1000
#4009:
NetWorker Remote Client Connections/5000
NetWorker Remote Client/5000
#7024:
NetWorker Recovery Manager Client
Connections/1
NetWorker Recovery Manager ARM
Client Connections/1
#7029:
NetWorker Recovery Manager Client
Connections/5
NetWorker Recovery Manager ARM
Client Connections/5
#7030:
NetWorker Recovery Manager Client
Connections/25
NetWorker Recovery Manager ARM
Client Connections/25
#7031:
NetWorker Recovery Manager Client
Connections/100
NetWorker Recovery Manager ARM
Client Connections/100
86
Appendix A: Troubleshooting
Table 4. Unchanged Product License Names
Part
Number
New Product License Names
Old Product License Names
#2000:
NetWorker, Network Edition/1
NetWorker, Network Edition/1
#2001:
Enabler type 108/1
Enabler type 108/1
#2024:
Enabler type 108/2
Enabler type 108/2
#x2016:
Update/2
Update/2
#6950:
Open File Connection/1
Open File Connection/1
#6951:
Open File Connection/5
Open File Connection/5
#6952:
Open File Connection/25
Open File Connection/25
#6953:
Open File Connection/100
Open File Connection/100
#6954:
Open File Connection/Unlimited
Open File Connection/unlimited
#2801:
SCO NetWorker/10
SCO NetWorker/10
#2802:
SCO NetWorker Advanced/10
SCO NetWorker Advanced/10
#2821:
5 Clients for SCO
5 Clients for SCO
#2810:
10 Clients for SCO
10 Clients for SCO
#2822:
25 Clients for SCO
25 Clients for SCO
#2811:
50 Clients for SCO
50 Clients for SCO
#2823:
100 Clients for SCO
100 Clients for SCO
#2812:
SCO Concurrent Devices
SCO Concurrent Devices
#2820:
SCO TurboPak
SCO TurboPak
#2830:
SCO Archive support
SCO Archive support
#2910:
NetWorker, Network Edition/1
NetWorker, Network Edition/1
#2921:
5 Clients (NT server)
5 Clients (NT server)
#2922:
25 Clients (NT server)
25 Clients (NT server)
#2923:
100 Clients (NT server)
100 Clients (NT server)
#2335:
NetWorker Extended/25
NetWorker Extended/25
#2345:
NetWorker Extended/25
NetWorker Extended/25
#2336:
NetWorker Extended/100
NetWorker Extended/100
#2346:
NetWorker Extended/100
NetWorker Extended/100
87
Appendix A: Troubleshooting
Table 4. Unchanged Product License Names
Part
Number
New Product License Names
Old Product License Names
#2337:
NetWorker Extended/250
NetWorker Extended/250
#2347:
NetWorker Extended/250
NetWorker Extended/250
#2338:
NetWorker Extended/500
NetWorker Extended/500
#2348:
NetWorker Extended/500
NetWorker Extended/500
#2339:
NetWorker Extended/1000
NetWorker Extended/1000
#2349:
NetWorker Extended/1000
NetWorker Extended/1000
#2340:
NetWorker Extended/5000
NetWorker Extended/5000
#2727:
5 PC/Desktop Clients
5 PC/Desktop Clients
#2728:
25 PC/Desktop Clients
25 PC/Desktop Clients
#2729:
100 PC/Desktop Clients
100 PC/Desktop Clients
#2350:
1 Additional NetWare Users
1 Additional NetWare Users
#2351:
1 Additional NetWare Users
1 Additional NetWare Users
#2352:
1 Additional NetWare Users
1 Additional NetWare Users
#2353:
1 Additional NetWare Users
1 Additional NetWare Users
#2354:
1 Additional NetWare Users
1 Additional NetWare Users
#2355:
1 Additional NetWare Users
1 Additional NetWare Users
#2356:
1 Additional NetWare Users
1 Additional NetWare Users
#2357:
1 Additional NetWare Users
1 Additional NetWare Users
#2358:
1 Additional NetWare Users
1 Additional NetWare Users
#2359:
1 Additional NetWare Users
1 Additional NetWare Users
#2360:
1 Additional NetWare Users
1 Additional NetWare Users
#2361:
1 Additional NetWare Users
1 Additional NetWare Users
#2362:
1 Additional NetWare Users
1 Additional NetWare Users
#2363:
1 Additional NetWare Users
1 Additional NetWare Users
#5301:
Staccato
Staccato
#2066:
SmartMedia Base Lite/65535
SmartMedia Base Lite/65535
#9110:
SmartMedia ELA/Unlimited
SmartMedia ELA/unlimited
88
Appendix A: Troubleshooting
Table 4. Unchanged Product License Names
Part
Number
New Product License Names
Old Product License Names
#2070:
SmartMedia Attached Libraries/1
SmartMedia Attached Libraries/1
#2071:
SmartMedia Attached Libraries/Unlimited
SmartMedia Attached Libraries/unlimited
#2094:
SmartMedia Dynamic Drive Sharing/1 SmartMedia Dynamic Drive Sharing/1
#9402:
Enabler type 108/2
Enabler type 108/2
#9401:
NetWorker Remote Enterprise/1
NetWorker Remote Enterprise/1
#7004:
GEMS Reporter Base/1
GEMS Reporter Base/1
#7014:
GEMS Reporter Connections/1
GEMS Reporter Connections/1
#7015:
GEMS Reporter Connections/5
GEMS Reporter Connections/5
#7016:
GEMS Reporter Connections/25
GEMS Reporter Connections/25
#7017:
GEMS Reporter Connections/100
GEMS Reporter Connections/100
#7018:
GEMS Reporter Connections/Unlimit- GEMS Reporter Connections/unlimited
ed
#7022:
NetWorker Recovery Manager Base/1
NetWorker Recovery Manager Base/1
#7023:
NetWorker Recovery Manager Client
Connections/1
NetWorker Recovery Manager Client
Connections/1
#7026:
NetWorker Recovery Manager Client
Connections/5
NetWorker Recovery Manager Client
Connections/5
#7027:
NetWorker Recovery Manager Client
Connections/25
NetWorker Recovery Manager Client
Connections/25
#7028:
NetWorker Recovery Manager Client
Connections/100
NetWorker Recovery Manager Client
Connections/100
89
Appendix A: Troubleshooting
90
Glossary
This glossary provides definitions for terms used in this guide.
active group
A NetWorker backup group that has its autostart
attribute enabled.
administrator
The person normally responsible for installing,
configuring, and maintaining NetWorker.
Administrators
group
A Windows NT and Windows 2000 user group whose
members have all the rights and abilities of users in
other groups, plus the ability to create and manage all
the users and groups in the domain. Only members of
the Administrators group can modify Windows NT
and Windows 2000 operating system files, maintain
the built-in groups, and grant additional rights to
groups.
agent
The term used by Solaris to denote a cluster server.
Also known as a logical server (Compaq), package
(HP-UX), and virtual server (Microsoft).
annotation
A comment that you associate with an archive save
set, to help identify that data later. Annotations are
stored in the media index for ease of searching and are
limited to 1024 characters.
Application
Specific Module
(ASM)
A program that, when used in a directive, specifies the
way that a set of files or directories is to be backed up
and recovered. For example, compressasm is a
NetWorker directive used to compress and
decompress files.
archive
The process by which NetWorker backs up directories
or files to an archive volume and then grooms them to
free disk space. When data is archived, it is written to
one or more storage volumes and then marked so that
it is never subject to automatic recycling. You can
delete the archived files from the client, thus freeing
disk space. See also grooming.
91
Glossary
archive clone pool
A pool composed exclusively of archive clone save
sets.
archive pool
A volume pool composed exclusively of archive save
sets. Archived save sets are in a different format than
regular backup save sets, and must be maintained on
separate media.
archive volume
A tape or other storage medium used to store
NetWorker archive data, as opposed to a backup
volume or migration store.
attribute
A feature of a resource. It is a service or information
that the resource provides.
authorization
code
A code that is unique to your network that unlocks the
software for permanent use.
autochanger
A mechanism that uses a robotic arm to move media
among various components located in a device,
including slots, media drives, media access ports, and
transports. Autochangers automate media loading
and mounting functions during backup and recovery.
The term autochanger refers to a variety of robotic
libraries, including jukebox, carousel, library, near-line
storage, datawheel, and autoloader.
auto media
management
A feature that enables the storage device controlled by
the NetWorker server to automatically label, mount,
and overwrite a volume it considers unlabeled.
Volumes that are eligible for reuse are also
automatically recycled.
backup
The writing of saved data to a volume.
backup cycle
The period of time from one level full backup to the
next level full backup.
backup group
See group.
backup level
See level.
Backup Operators
group
A group of Windows NT or Windows 2000 users who
can log on to a domain from a workstation or a server,
back it up, and restore the data. Backup Operators can
also shut down servers or workstations.
backup volume
A tape or other storage medium used to store
NetWorker backup data, as opposed to an archive
volume or migration store.
base enabler code
See enabler code.
92
Glossary
bootstrap
A save set that is essential for the NetWorker disaster
recovery procedures. The bootstrap is composed of
three components that reside on the NetWorker
server: the media database, the resource database, and
a server index.
browse policy
A policy that determines how long entries for your
backup data remain in the client file index.
bulk enabler
An enbler code inteded to be installed on the Legato
License Manager server, for dispensation to
NetWorker servers on request from the NetWorker
server.
carousel
A tray or tape cartridge that holds multiple backup
volumes.
client
A computer that accesses the NetWorker server to
back up or recover files. Clients may be workstations,
computers, or fileservers.
client file index
A database of information maintained by the
NetWorker server that tracks every database object,
file, or filesystem backed up. The NetWorker server
maintains a single client index file for each client
computer.
client-initiated
backup
See manual backup.
clone
The NetWorker process used to make an exact copy of
saved data (save sets). You can clone individual save
sets or the entire contents of a backup volume.
Cloning is different from a simple copy operation
carried out on an operating system or hardware
device. It is indexed and tracked by NetWorker in both
the client file index and the media data.
clone volume
A duplicated volume. Three types of clone volumes
are tracked: backup clone, migration clone, and
archive clone. Save sets of different types (for
example, archive and migration) cannot be intermixed
on the same clone volume.
cluster
1. A group of independent network sectors that
operate and appear to clients as if they were a single
unit.
2. A group of disk sectors. The operating system
assigns a unique number to each cluster and then
keeps track of files according to which clusters they
use.
cluster-aware
Recognizing a cluster environment.
93
Glossary
cluster client
A NetWorker client that is either a physical cluster
client or a virtual (logical) cluster client.
cluster host
1. (UNIX) A machine (node) in the cluster
environment.
2. (Windows NT/Windows 2000) The node associated
with a cluster resource that owns the resource; another
name for resource owner.
cluster mode
Describes a program element working as part of a
cluster; currently, the NetWorker.cluster.svr file
specifies the cluster mode to the NetWorker server.
cluster node
A physical machine in the cluster environment. Also
known as a node or physical host.
cluster resource
The shared or managed resource that is registered
with a cluster manager. Some platforms or products
use the term service rather than resource.
cluster server
A shared resource or virtual machine that contains the
NetWorker server resources (indexes, /nsr directories,
and tape devices). The NetWorker server is associated
with (and known by) the cluster hostname rather than
with the physical machine on which it is hosted. Also
known as an agent (Solaris), a logical server
(Compaq), package (HP-UX), and virtual server
(Microsoft).
cluster-unaware
Not recognizing a cluster environment.
daemon
A program that lies dormant waiting for a specified
condition to occur.
device
A storage unit that reads from and writes to storage
volumes (see volume). A storage unit can be a tape
device, optical drive, autochanger, or file connected to
the server or storage node.
DFS component
An abbreviation for Distributed File System root or
child node. DFS is a Microsoft add-on for Windows
NT 4.0 Server (Alpha or Intel) or Windows 2000 that
allows you to create a logical directory of shared
directories, spanning multiple machines across a
network.
directed recover
A method of recovery that recovers data that
originated on one client computer and re-creates it on
another client computer.
directive
An instruction that directs the NetWorker software to
take special actions on a given set of files for a
specified client during a backup.
94
Glossary
DMAPI
An acronym for Data Management Application
Programming Interface. The term refers to the
interface defined by the XDSM Specification. See also
XDSM.
enabler code
A special code provided by Legato that activates the
software. The enabler code that unlocks the base
features for software you purchased is referred to as a
base enabler. Enabler codes for additional features or
products (for example, autochanger support) are
referred to as add-on enablers.
expiration date
The date when the volume changes from
“read/write” to “read-only.”
failover
In a cluster network, the process of relocating a
resource to its redundant or backup component, either
because of a hardware or software failure or for
administrative purposes.
file index
See client file index.
filesystem
1. A file tree that is on a specific disk partition or other
mount point.
2. The entire set of all files.
3. A method of storing files.
fingerprint
A fingerprint file is what is left on the file system after
a file has been migrated by the XDSM HSM
application.
firewall
A system designed to prevent unauthorized access to
or from a private network. All messages entering or
leaving the intranet pass through the firewall, which
examines each message and blocks those that do not
meet the specified security criteria. There are several
types of firewall techniques: the NetWorker software
supports client backups from computers that are
protected by packet filtering.
full
See level.
grooming
The NetWorker process of removing the original files
from a local disk after a successful archive operation.
group
A client or group of clients configured to start backing
up files to the NetWorker server at a designated time
of day.
95
Glossary
highly available
system
A system that allows the application services to
continue despite a hardware or software failure. Each
cluster node has its own IP address. Each cluster node
also has private (local) resources or disks that are
available only to that machine.
high water mark
The percentage of disk space filled that, when
reached, automatically starts the migration process.
HSM
An abbreviation for Hierarchical Storage
Management, which is a data management strategy
that moves data from one storage medium to another.
The hierarchy usually moves data from more
expensive media with faster access to less expensive
media with slower access. See also XDSM HSM.
inactivity timeout
An attribute that indicates the number of minutes
NetWorker waits before determining that a client is
unavailable for backup.
incremental
See level.
jukebox
See autochanger.
LCP
An abbreviation for library control program, a
program that the NetWorker GEMS SmartMedia
software uses to control robotic libraries.
level
A measurement that determines how much data
NetWorker saves during a scheduled or manual
backup.
A full (f) backup backs up all files, regardless of
whether they have changed. Levels one through nine
[1-9] back up files that have changed since the last
lower numbered backup level. An incremental (incr)
backup backs up only files that have changed since the
last backup.
level [1 - 9]
See level.
local cluster client
A NetWorker client that is not permanently bound to a
physical machine, but is instead managed by a cluster
manager. It can be bound to more than one physical
machine in the cluster and can own its own data disks.
It is also referred to as a logical or virtual client.
local host
The node on which the client or server program is
running.
logical server
The term used by Compaq to denote a cluster server.
Also known as an agent (Solaris), package (HP-UX),
and virtual server (Microsoft).
96
Glossary
low water mark
The percentage of disk space filled that, when
reached, automatically stops the migration process.
LUS
An acronym for Legato User SCSI. The LUS driver is
used by Legato software products as a proprietary
device driver that sends arbitrary SCSI commands to
an autochanger.
manual backup
A backup that a user requests from the client’s save
program. The user specifies participating files,
filesystems, and directories. A manual backup does
not generate a bootstrap save set.
media
The physical storage medium to which backup data is
written. NetWorker supports tape, magnetic or optical
disk, and filesystems as backup media. See also
volume.
media database
A database that contains indexed entries about the
storage volume location and the life cycle status of all
data and volumes managed by the NetWorker server.
See also volume.
migration
The process of moving data from a local filesystem to
storage media in the migration store to free up disk
space on the local drive.
migration client
A filesystem on a network containing data that needs
to be migrated. A migration client may consist of
multiple filesystems or volumes. One or all volumes
can be under migration control. The migration client
must also be configured as a NetWorker backup client
and receive migration services from a migration
server.
migration clone
pool
A collection of storage media to which clones of
migration save sets are written. See also clone volume.
migration pool
A collection of storage media to which migration save
sets are written. A migration pool contains data
written in a different format than a backup or archive
pool.
migration server
A NetWorker backup server that has either the
symbolic link or DMAPI-compliant NetWorker XDSM
HSM software enabled. The migration server provides
migration services to clients on a network.
migration store
A storage device attached to the migration server that
contains volumes from the migration pool.
migration volume
The storage media that belongs to a migration pool
and contains migration save sets.
97
Glossary
multiplexing
A NetWorker feature that permits data from more
than one save set to be written to one storage volume
on different storage devices.
NetWorker client
See client.
NetWorker server
See server.
NetWorker
storage node
See storage node.
NFS client
A computer that can access files on an network file
system (NFS) server.
NFS server
A computer that contains exported filesystems that
network file system (NFS) clients can access.
notification
A message generated and sent to the NetWorker
administrator about important NetWorker events.
online indexes
The databases located on the NetWorker server that
contain all the information pertaining to the client
backups (client file index) and backup volumes
(media database).
operator
The person who monitors the server status, loads
backup volumes into the server devices, and
otherwise executes the day-to-day NetWorker tasks.
override
A NetWorker feature that allows you to configure a
different backup level for a specific date listed in a
Schedule resource.
packet filtering
A method of firewall protection that looks at each
packet entering or leaving the network and accepts or
rejects it based on user-defined rules. See also firewall.
parallelism
A NetWorker feature that enables the NetWorker
server to either back up save sets from several clients
or many save sets from one client at the same time.
Parallelism is also available during recovers.
package
The term used by HP-UX to denote a cluster server.
Also known as an agent (Solaris), logical server
(Compaq), and virtual server (Microsoft).
pathname
A set of instructions to the operating system for
accessing a file. An absolute pathname tells how to find
a file beginning at the root directory and working
down the directory tree. A relative pathname tells how
to find the file starting where you are now.
98
Glossary
physical cluster
client
A NetWorker client that is bound to a physical
machine in the cluster and can represent its own
resources (private or local). It can also be called the
physical client.
physical host
Any one of the nodes (or machines) that forms the
cluster.
pool
A feature that enables you to sort backup data to
selected volumes. A pool contains a collection of
backup volumes to which specific data has been
backed up.
purging
The process of deleting all entries for files on the
volume from the client file index, but allowing entries
for the save sets to remain in the media database.
recall
The process of copying a file from storage media in the
migration store back to its original location on the
migration client filesystem.
recover
A recovery method that re-creates an image of the
client filesystems and database on the NetWorker
server.
recyclable volume
A volume whose data has passed both its browse and
retention policies and is now available for relabeling
and use by a NetWorker server or storage node.
Registry
A database of configuration information central to
Windows NT and Windows 2000 operations. It
centralizes all Windows settings and provides security
and control over system, security, and user account
settings.
remote device
A storage device that is attached to a NetWorker
storage node.
resource
A component of the NetWorker software that
describes the NetWorker server and its clients.
Devices, schedules, clients, groups, and policies are
examples of NetWorker resources. Each resource
contains a list of attributes, defining the parameters to
use for the specific NetWorker resource.
resource owner
The cluster (logical, not physical) host that owns the
resource. If a resource (for example, a shared disk) is
not owned by any virtual host it is assumed to be
owned by the local host (physical node) that hosts the
resource.
retention policy
A policy that determines how long save set entries are
retained in the NetWorker server’s media database.
99
Glossary
retrieve
The process of locating and copying back files and
directories that NetWorker has archived.
root
1. (UNIX only) The UNIX superuser account (with
username “root” and user ID). By extension, the
privileged system-maintenance login on any
operating system.
2. (Windows NT/Windows 2000 and UNIX) The top
node of the system directory structure, the home
directory of the root user.
save set
A group of files or a filesystem from a single client
computer backed up onto storage media.
save set
consolidation
The process that merges an incremental backup with
the last full backup of a save set to create a new
backup. See also level.
save set ID
An internal identification number that NetWorker
assigns to a save set.
save set recover
The recovery of specified save sets to the NetWorker
server.
save set status
The NetWorker attribute that indicates whether a
given save set is restorable, recoverable, or recyclable.
The save set status also indicates whether the save set
has been successfully backed up.
savestream
The data and save set information being written to a
storage volume during a backup. A savestream
originates from a single save set.
server
The computer on a network that runs the NetWorker
server software, contains the online indexes, and
provides backup and recovery services to the clients
and storage nodes on the same network.
server index
A file that lists all the server files that were backed up
during a scheduled backup.
shared disk
The storage disk that is connected between multiple
nodes in the cluster.
shell prompt
A cue for input in a shell window where you enter a
command.
silo
A repository for holding hundreds or thousands of
volumes. Silo volumes are identified by barcodes, not
by slot numbers.
skip
A backup level in which designated files are not
backed up. Also see level.
100
Glossary
SMS
An abbreviation for System Management Server,
which is a Microsoft-based software installation
system that allows the wide-scale, automatic
installation of software products on clients from a
single remote server.
SNMP
An abbreviation for simple network management
protocol, which is a protocol that defines the
communication between a manager (sometimes called
a Monitor or Management Station) and an object (the
item being managed). NetWorker uses SNMP to send
messages to the administrator about NetWorker
events.
staging
The process of moving data from one storage medium
to another less costly medium, and later removing the
data from its original location.
stand-alone
In a cluster environment, if the NetWorker.clustersvr
file is missing at the binary location, the NetWorker
server will start in non-cluster mode, also called
stand-alone mode. The stand-alone mode is
sometimes referred to as the server backing up itself.
stand-alone
device
A storage device that contains a single drive for
backing up data.
storage device
The hardware that reads and writes data during
backup, recovery, or other NetWorker operations.
storage node
A storage device physically attached to another
computer whose backup operations are administered
from the controlling NetWorker server.
versions
The date-stamped collection of available backups for
any single file.
volume
A physical unit of media, such as magnetic tape,
optical disk, or disk file.
virtual cluster
client
A NetWorker client that is not permanently bound to a
physical machine, but is instead managed by a cluster
manager. It can be bound to more than one physical
machine in the cluster and can own its own data disks.
It is also referred to as logical cluster client or virtual
client.
volume
A unit of storage media, such as a magnetic tape,
optical disk, or file. A storage device reads from and
writes to volumes, which can be physical units (for
example, a labeled tape cartridge) or logical units (for
example, optical media can store multiple volumes on
a single physical platter).
101
Glossary
volume ID
The internal identification assigned to a backup
volume by NetWorker.
volume name
The name you assign to a backup volume when it is
labeled.
volume pool
See pool.
virtual server
The term used by Microsoft to denote a cluster server.
Also known as an agent (Solaris), logical server
(Compaq), and package (HP-UX).
XDSM
An abbreviation for X/Open Data Storage
Management.
XDSM HSM
A software product that automatically moves data
between a local filesystem and other storage media.
The XDSM designation indicates that this version of
the HSM software conforms to XDSM standards. See
also migration.
102
Index
A
Adobe Acrobat
9
on solaris
Allowances 15
authorize and register your Legato software
over the web 51
L
B
backing up the License manager server
base enabler license
defined 14
18
C
customer
feedback
12
D
disabling the License Manager 41
documentation
Adobe Acrobat 9
check the latest before installing 21
formatting conventions 10
how to get the latest release supplement
on the product CD 9
on the web 9
download
Adobe Acrobat 9
21, 31
21
lgtolic
edits License Manager database on UNIX
16
edits License Manager database on Windows
NT 17
location of on UNIX 41
lgtolmd
License Manager daemon on UNIX 40
License Manager daemon on Windows NT
17, 40
location of on UNIX 41
runs on the License Manager server 16
License Manager
and GEMS 14
backing up 18
disabling 41
overview 13
setting up NetWorker to work with 45
starting and stopping on UNIX 40
starting and stopping on Windows NT 40
system information 16
N
nsrlmc runs on NetWorker server 16
nwadmin allows naming License Manager
server 16, 45
F
feedback
customer 12
firewall support 95, 98
formatting conventions 10
P
packet-filtering, firewalls
G
R
GEMS and the Legato License Manager
14
register
and authorize your Legato software
over the web 46
Release Supplement contains additions to
documentation 21
I
installation
on AIX 25
on Compaq Tru64 UNIX
on HP-UX 25
on Sequent 27
on SGI 27
95, 98
29
S
services
103
Index
T-Y
information 11
Setting up NetWorker to work with License
Manager 45
single-unit license 14
start and stop
License Manager on NT 40
License Manager on UNIX 40
support
services 11
system information 16
T
typefaces and symbols explained
10
Y
year 2000 compliance
10
104