background image

36

|

Appendix B

SAMreport-Lite Error Messages

Error

Output Report Log

Error: Report log has been corrupted (-4) 

file line no 

(id 50)(minor -1) (Invalid key found, record lost)

Corrupt report log event found in a report log. 
May be associated with a vendor daemon 
crash.

Error: Internal Error (-7) 

file line no 

(id 54)(minor 0) 

feature key

Indicates an unexplained problem in 
SAM

report

-Lite

. This error should be reported 

to Autodesk

®

.

Error: A reportlog is missing (-9) 

file line no 

(id 40)(minor 0) 

feature key

Report log contains a gap of significant 
duration between an end (or lmswitchr) and 
the following start event.

Error: Reportlog is truncated (-11) 

file line no 

(id 48)(minor -5) (Vendor daemon crashed and 
restart)

Report log event fragment is seen immediately 
followed by a restart. The feature 
corresponding to the event fragment is 
undetermined. Usually caused by vendor 
daemon crash.

Error: Reportlog is truncated (-11) 

file line no 

(id 48)(minor -5) (Vendor daemon crashed and 
restart) 

feature key

Report log event fragment is seen immediately 
followed by a restart. The feature 
corresponding to the event fragment is shown. 
This event is unusable. Usually caused by 
vendor daemon crash.

Error: Reportlog is truncated (-11) 

file line no 

(id 42)(minor 0) 

feature key

Report log file ends abruptly. Probably caused 
by reading or copying the report log while the 
vendor daemon is running. Could also be the 
result of a vendor daemon crash with no 
subsequent restart.

Error: An error was found in the reportlog (-13) 

file line no 

(id 51)(minor -4) (Checkout occurred without 
checkin, recovery attempted) 

feature key

No matching checkin event found for a 
checkout event. Because the error is reported 
much later than the actual error occurred, the 
line number is not particularly relevant. 
Sometimes this error is reported in error.

Error: An error was found in the reportlog (-13) 

f

ile line no 

(id 37)(minor -7) (A data field is corrupted, record 
recovered, field recovery attempted) 

feature key 

Indicates corruption in one of the report event 
fields.

Error: end date may be using 2 digit year instead 
of 4 digits Error occurred: gsi.SAMreport-Lite 
.JrepException: Unable to generate report. 

This is an example of an error that occurs when 
a parameter or an argument is invalid and a 
report cannot be generated. The first line 
describes which parameter or argument is 
invalid.

Error: In 

file

 vendor changed from 

vendor_name1

(hostid1) to 

vendor_name2 

(hostid2).  

No further events will be read from this file.

This report log has been written by more than 
one vendor daemon or by a vendor daemon 
running on more than one hostid.

Summary of Contents for SAMREPORT-LITE 2005

Page 1: ...SAMreport Lite USER S GUIDE P p p February 2004...

Page 2: ...erwise ALL COPIES OF THE INFORMATION IF ALLOWED BY MACROVISION CORPORATION MUST DISPLAY THIS NOTICE OF COPYRIGHT AND OWNERSHIP IN FULL TRADEMARKS Globetrotter Macrovision FLEXlm FLEXbill Flexible Lice...

Page 3: ...w to Create and Set Up an Options File 4 How to Use SAMreport Lite 5 How to Upgrade to SAMreport 6 Chapter 2 Introduction 7 Intended Audience 8 About This Manual 8 What is License Management 8 What is...

Page 4: ...ata Filters 26 Reports and Time Zones 26 Setting Start and End Dates for a Report 27 Appendix A Enabling and Managing Report Logs 29 How to Turn on a Report Log 30 Size of the Report Log 31 Flushing D...

Page 5: ...ave any questions that are not addressed in this Quick Start section consult the appropriate sections in this User s Guide In this chapter How to Obtain a License File How to Install Java Runtime Envi...

Page 6: ...ch is located in the Ethernet Address field Note If your server has more than one Ethernet adapter select one that cor responds to a physical network adapter 4 Exit lmtools exe 5 Next you need to requ...

Page 7: ...JRE 1 4 1_01 and follow the on screen instructions How to Install SAMreport Lite To install SAMreport Lite 1 Insert the product CD into your CD ROM drive 2 On the CD Browser click Network Deployment...

Page 8: ...alled adskflex opt 2 In the adskflex opt file enter the following syntax on a single line REPORTLOG report_log_path REPORTLOG must be uppercase as shown In the REPORTLOG syntax means that entries to t...

Page 9: ...report output files You do not need to specify the file name extension the extension is auto matically added to the name you supply based on the output formats you select For example if you select HTM...

Page 10: ...l 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...

Page 11: ...ns introductory information about license management a description of SAMreport Lite and explanatory information about this guide In this chapter Intended Audience About This Manual What is License Ma...

Page 12: ...ecify input and output files and describes output formats Appendix A Enabling and Managing Report Logs provides guidelines for enabling and managing report logs Appendix B SAMreport Lite Error Message...

Page 13: ...d maintain a record of the activity of the vendor daemon Enabling and Managing Report Logs on page 29 describes how to start and manage report log files The SAMreport Lite report generator comes with...

Page 14: ...10...

Page 15: ...his chapter shows you how to generate a Usage Summary report using the SAMreport Lite user interface You ll find a detailed explanation of the report in Usage Summary Report on page 15 In this chapter...

Page 16: ...your system Double click the report log file You can repeat this process to select more than one report log from the browser After you select a report log the report log file name appears in the text...

Page 17: ...t Use these fields to limit the date range of data to include in a report To include data from the entire report log s in your report leave these fields blank See Setting Start and End Dates for a Rep...

Page 18: ...14...

Page 19: ...istics of each feature in the 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...

Page 20: ...est report log Uptime Duration in real clock time between the report start and end dates that a license server was up Vendor Vendor daemon name s Breakdown by Report breakdown categories if any Filter...

Page 21: ...of available hours of license usage License Requests total Total number of license requests used Number of licenses requests fulfilled que Number of license requests queued den Number of license requ...

Page 22: ...that the denials may have occurred when you only had 10 licenses available Licenses are reserved for particular users Even though all licenses for a feature are not checked out they are not available...

Page 23: ...e usage of each feature into use ful groupings according to your particular reporting requirements You may use the Summary choice lists in the SAMreport Lite main window which provide easy access to t...

Page 24: ...20...

Page 25: ...vendor daemon running on a single host Each redundant vendor daemon must write to its own report log In this chapter Specifying Input Report Logs Displaying Output to the Viewer Window Navigating the...

Page 26: ...f the Browse button Press Enter Repeat this process for each report log that you want to add Click the Browse button and use the report log file browser to select a report log from your system Double...

Page 27: ...pages or output formats of a report in one of three ways Click the page name in the left side of the window Click the Back and Forward buttons in the toolbar Select Next or Previous from the Page menu...

Page 28: ...nterchange Format RIF This format is a simple flexible plain text format that is designed to pass tabular information between the report generator and another program such as a spreadsheet Fields are...

Page 29: ...ent if the file contains rows from only one table If the rows entry is missing read all of the rows until the end of the file If there is more than one table in the RIF file the table specific portion...

Page 30: ...zone of the license server machine and stored in the report log in Greenwich Mean Time GMT also known as Universal Time UTC Therefore the data in a report log is insensitive to time zones and you can...

Page 31: ...t output can be set in text fields in the middle portion of the SAMreport Lite main window Times can be included If no start and end dates are set the report is generated with data from the entire rep...

Page 32: ...28...

Page 33: ...en by a single vendor daemon on a single host Vendor daemons running on more than one server must each write to their own report logs SAMreport Lite cannot produce reports from debug log files lmgrd s...

Page 34: ...endor daemons 1 Create an options file for the vendor daemon if one doesn t already exist The options file is a plain text file with any name we recommend an opt extension For example for a vendor dae...

Page 35: ...daemon To run a report with up to the minute usage information before running the report manually flush data from the buffer to the report log by causing the vendor daemon to reread its license file...

Page 36: ...in the report You may want to rotate a report log at a regular time interval such as weekly or monthly depending on how quickly the report log grows The rotation of a report log does not need to be ti...

Page 37: ...using SAMsuite 1 Start lmtools In the Service License File tab select the license server whose report log you want to rotate Click the Switch Report Log tab Type the Vendor Name and the New Report Loc...

Page 38: ...if possible Issuing an lmdown command while the server is shutting down can cause corruption Don t move copy or edit the report log file while the server is running Never configure more than one licen...

Page 39: ...35 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 B...

Page 40: ...uncated 11 file line no id 42 minor 0 feature key Report log file ends abruptly Probably caused by reading or copying the report log while the vendor daemon is running Could also be the result of a ve...

Page 41: ...eshold of 2000 has been reached No further errors will be reported Corruption Significant corruption in the input report log s has rendered parts of this report suspect Please contact your Autodesk de...

Page 42: ...38...

Page 43: ...ng report logs 21 R redundant servers report logs 22 report log file enable 30 from redundant servers 22 manage 31 size 31 time zones 26 using multiple 21 reports combining report logs 21 date formats...

Page 44: ......

Reviews: