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
© Copyright 2026 Paperzz