1. Manuals
  2. Brands
  3. Macrovision Corporation Manuals
  4. Software
  5. SAMREPORT-LITE 2005
  6. Manual

Macrovision Corporation SAMREPORT-LITE 2005 Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

SAMreport-Lite
™
P p p
U
'
G
SER
S
UIDE
February 2004

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SAMREPORT-LITE 2005 and is the answer not in the manual?

Questions and answers

Related Manuals for Macrovision Corporation SAMREPORT-LITE 2005

Summary of Contents for Macrovision Corporation SAMREPORT-LITE 2005

  • Page 1 SAMreport-Lite ™ P p p ’ UIDE February 2004...
  • Page 2 UTODESK RADEMARKS RADEMARKS Autodesk, and AutoCAD are registered Globetrotter, Macrovision, FLEXlm, FLEXbill, trademarks of Autodesk, Inc., in the U.S.A. Flexible License Manager, and GTlicensing and/or other countries. are registered trademarks or trademarks of Macrovision Corporation. All other brand and product names...

  • Page 3: Table Of Contents

    Contents Chapter 1 Quick Start to SAMreport-Lite . How to Obtain a License File . How to Install Java Runtime Environment How to Install SAMreport-Lite . How to Create and Set Up an Options File . How to Use SAMreport-Lite. How to Upgrade to SAMreport Chapter 2 Introduction .
  • Page 4 Chapter 5 Report Input and Output . . 21 Specifying Input Report Logs . Displaying Output to the Viewer Window . Navigating the SAMreport-Lite Viewer Window . Selecting Output Type and Output File Names . Output Formats . Data Filters. Reports and Time Zones Setting Start and End Dates for a Report Appendix A Enabling and Managing Report Logs.

  • Page 5: Quick Start To Samreport-Lite

    Quick Start to SAMreport-Lite This section gives you step-by-step instructions for In this chapter ■ How to Obtain a License File installing SAMreport-Lite on your system. If you have ■ How to Install Java Runtime any questions that are not addressed in this Quick Start Environment section, consult the appropriate sections in this User’s ■...

  • Page 6: How To Obtain A License File

    To obtain a license file On the server where you plan to manage licenses and report on them, on the Start menu, click All Programs (or Programs) ➤ Autodesk ➤ Network License Manager ➤ LMTOOLS. In LMTOOLS, click the System Settings tab.

  • Page 7: How To Install Java Runtime Environment

    To install Java Runtime Environment SAMreport-Lite requires Java Runtime Environment 1.4.1_01. Insert the Autodesk product CD into your CD-ROM drive. On the CD Browser, click the Network Deployment tab. On the Network Deployment tab, in Step 4, Install Supplemental Tools, click SAMreport-Lite 3.2.

  • Page 8: How To Create And Set Up An Options File

    Note Complete instructions for setting up an Options file are located in the Autodesk Network Licensing Guide. You can access the guide from your product’s CD Browser or in the Help system. To create and set up an Options file In a text editor, create a file called adskflex.opt.

  • Page 9: How To Use Samreport-Lite

    How to Use SAMreport-Lite To use SAMreport-Lite to generate a report On the Start menu (Windows), click Start ➤ All Programs (or Programs) ➤ SAMreport ➤ SAMreport. In the SAMreport-Lite window, click the Browse button. In the Report Log dialog box, locate and specify your report log file. By default, the Report Log dialog box lists only files named with a .rl file name extension.

  • Page 10: How To Upgrade To Samreport

    How to Upgrade to SAMreport The full-featured SAMreport product provides additional types of reports and options, and includes additional features such as command line batch pro- cessing. Upgrading to the full version of SAMreport does not require a new installation, just a new license file. To learn about the full-featured version of SAMreport, go to the Macrovision Corporation website at: www.macrovision.com Chapter 1 Quick Start to SAMreport-Lite...

  • Page 11: Introduction

    Introduction This chapter contains introductory information about In this chapter ■ Intended Audience license management, a description of SAMreport-Lite ■ About This Manual and explanatory information about this guide. ■ What is License Management? ■ What is SAMreport-Lite?

  • Page 12: Chapter 2 Introduction

    Intended Audience ™ SAMreport-Lite and this manual are intended for use by system administra- ® tors, system analysts, and managers who use FLEXlm license management to produce usage reports for your software. About This Manual This manual is divided into five chapters and two appendixes: ■...

  • Page 13: What Is Samreport-Lite

    What is SAMreport-Lite? SAMreport-Lite, a member of the GLOBEtrotter family of Software Asset Management (SAM) Solutions, is a report generator that helps you monitor the usage of applications that use FLEXlm. SAMreport-Lite complements FLEXlm by providing a graphical user interface (GUI) from which to run usage reports.

  • Page 15: Basics Of Generating A Report

    Basics of Generating a Report This chapter shows you how to generate a Usage In this chapter ■ Generate a Usage Summary Summary report using the SAMreport-Lite user interface. Report You’ll find a detailed explanation of the report in “Usage Summary Report”...

  • Page 16: Chapter 3 Basics Of Generating A Report

    Generate a Usage Summary Report ™ Using SAMreport-Lite, you can generate a network license-usage report, ® ® called Usage Summary, for Autodesk software that uses FLEXlm licensing technology. To generate a Usage Summary report from the SAMreport-Lite interface Start SAMreport-Lite.
  • Page 17 ■ Type the path and file name base in the text field to the right of the Output File button. If no path is specified, the files are written to the current working directory. ■ Click the Output File button to open a file selection browser. Find and double-click the directory in which you want to save the output file.

  • Page 19: Usage Summary Report

    Usage Summary Report A Usage Summary report produces textual output that In this chapter ■ Output Arrangement and summarizes the usage statistics of each feature in the Detail report log(s). The output of a Usage Summary report can be saved to files in HTML, text, or RIF format. The header of a Usage Summary report provides a summary of information about the report log and the parameters of the report:...
  • Page 20 FLEXIm License Usage Report date time Produced by SAMreport-Lite Version Input Report Log: List of input report log(s) Output File Name: Name of report output file Report Log(s) Start: Earliest start date in any report log Report Log(s) End: Latest end date in any report log Report Start Date: Date to begin report—either a filter start date or the starting date of the earliest report log...
  • Page 21 A Usage Summary report with default settings contains one line per feature and 11 columns per line. From left to right in the report, the columns are: Category Column Description Heading Available Maximum number of available licenses. Includes overdraft licenses. hours Number of available hours of license usage.
  • Page 22 Possible explanations for denials in reports where the maximum available number of licenses were never used include: ■ The number of available licenses changed during the report period. For example, you start your report log when you have 10 licenses of FeatureA, then a few months later, still writing to the same report log, you add 10 more FeatureA licenses.

  • Page 23: Output Arrangement And Detail

    Output Arrangement and Detail The Usage Summary report shows license usage by feature. To create a report that shows more detail about the nature of license usage, you can use a combination of: ■ Summary period ■ Breakdown category ■ Sort order specification ■...

  • Page 25: Report Input And Output

    Report Input and Output You can create reports using one or more report logs In this chapter ■ Specifying Input Report Logs from one or more FLEXlm vendor daemons, as long as ■ Displaying Output to the each report log is written by a single vendor daemon Viewer Window running on a single host.

  • Page 26: Specifying Input Report Logs

    Specifying Input Report Logs ® The only valid input files are FLEXlm report logs. These report logs may have been produced by redundant license servers or distributed license servers, or they may simply be archived report logs from one or more license servers. Report logs must be accessible to SAMreport-Lite™...

  • Page 27: Navigating The Samreport-Lite Viewer Window

    Navigating the SAMreport-Lite Viewer Window The SAMreport-Lite Viewer window is divided into two sections. A list of the titles of individual pages of a report or a list of output formats is displayed in the left side of the SAMreport-Lite Viewer. A textual page of a report is displayed in the right side of the Viewer.

  • Page 28: Output Formats

    The appropriate file name extension is automatically appended to a file name base, depending on the files’s output format: Output Format File Name Extension HTML .html Text .txt Report Interchange Format .rif See a description of RIF in “Output Formats” on page 24.” SAMreport-Lite will not warn you if the output file that you are defining already exists and that you are about to overwrite it.
  • Page 29 Format Specification: #BEGIN HEADER header lines #END HEADER #cols [#rows] name of dataset // These lines contain column labels // info for the first [rows] // table. If you break down data by more than one category in a Usage Summary report written in RIF, each of the categories is presented in its own column.

  • Page 30: Data Filters

    Data Filters Some of the information contained in the report log is subject to filtering. Two filters can be specified for a Usage Summary report—feature and user. Multiple filter categories for one report are applied with a Boolean AND operation—all the specified conditions must be satisfied. If a report is filtered on user==User1 and feature==Feature2, the resulting report contains usage of Feature2 by User1.

  • Page 31: Setting Start And End Dates For A Report

    Possible causes for the times in reports that are different than you expect are: ■ The time zone on the license server machine is set incorrectly. If the time zone is not set correctly, and the system clock has been set to show local time, an error is introduced into the UTC timestamps recorded in the report log.

  • Page 33: Appendix A Enabling And Managing Report Logs

    Enabling and Managing Report Logs In order to use SAMreport-Lite you need one or more In this appendix ■ How to Turn on a Report Log report log files that are accessible to SAMreport-Lite. ■ Size of the Report Log Each report log must be written by a single vendor ■...

  • Page 34: How To Turn On A Report Log

    The options file is a plain text file with any name (we recommend an extension). .opt For example, for a vendor daemon called vend, the options file could be: C:\Program Files\Autodesk Network License Manager\vend.opt In the options file, enter a line of the following form: REPORTLOG +path\ReportLogFileName Note...

  • Page 35: Size Of The Report Log

    Restart the license server. When you change or create an options file, you must restart the license server in order for those changes to take effect. Rereading the license file is not sufficient. Size of the Report Log A good estimate of the size of your report logs (from FLEXlm pre-v5 vendor daemons) is 100 bytes per checkout or checkin, or about 20-25% bigger than the portion of the debug log pertaining to that vendor daemon.
  • Page 36 Rotate a report log. To avoid corruption in your report logs, we recom- mend that you rotate your logs with the FLEXlm utility, lmswitchr (found in the interface). lmtools Update the vendor daemon’s options file(s). Move the older report log to a designated location. Archive (and probably compress) a report log when it is no longer needed to run reports.

  • Page 37: Finding The Version Of The Vendor Daemon And Lmswitchr

    Finding the Version of the Vendor Daemon and lmswitchr How you are able to rotate report logs depends on the version of the vendor daemon and that you use. The batch option in lmswitchr -switchlog SAMsuite uses lmswitchr Find the version of the vendor daemon. To find the version of a vendor daemon, start lmtools , the FLEXlm utility.

  • Page 38: Avoiding Corruption In Report Logs

    Avoiding Corruption in Report Logs FLEXlm has been improved from version to version to make report logging more robust. Nevertheless, particularly in older versions of the vendor daemon, corruption can occur in the report log. Follow these guidelines to avoid corrupt report log files: ■...

  • Page 39: Appendix B Samreport-Lite Error Messages

    SAMreport-Lite Error Messages The following runtime error messages may be written to the Status History tab of the SAMreport-Lite interface or to a terminal window:...
  • Page 40 (id 54)(minor 0) feature key SAMreport-Lite . This error should be reported ™ ® to Autodesk Error: A reportlog is missing (-9) file line no Report log contains a gap of significant (id 40)(minor 0) feature key duration between an end (or lmswitchr) and the following start event.
  • Page 41 Output Report Log Error reporting threshold of 2000 has been reached. Corruption: Significant corruption in the input No further errors will be reported. report log(s) has rendered parts of this report suspect. Please contact your Autodesk dealer or reseller. Output Report Log...

  • Page 43: Index

    Index reports combining report logs combining report logs date formats errors/warnings start and end dates using multiple report logs date formats, for reports rotate report log enable a report log size of report log formats, date time zones manage report log merging report logs redundant servers report logs...

Table of Contents