Managing Report Logs

Autodesk SAMreport-Lite

 
Managing Report Logs
Expand All
Expand all collapsed sections.
Collapse All
Collapse all expanded sections.
 
 
 

Remember that you can produce a report from multiple report logs as long as each report log is written by a single vendor daemon running on a single machine. (Vendor daemons running on more than one redundant server must write to their own report logs.) Therefore, to keep the size of report logs manageable, you should regularly close out a current report log and begin to write to a new one. This process is known as rotating report logs. A recommended method for rotating report logs is provided later in this section.

You may want to automate the process of managing each license server's report logs. The following steps can be performed on a regular basis:

  1. Rotate a report log. To avoid corruption in your report logs, it is recommended that you rotate your logs with the FLEXnet utility, lmswitchr (found in the lmtools interface).
  2. Update the vendor daemon's options file(s).
  3. Move the older report log to a designated location.
  4. Archive (and probably compress) a report log when it is no longer needed to run reports.

You must rotate a report log at the following times:

  • If you move the license server to a new machine.

    If SAMreport-Lite detects that the license server HostID changes in a report log used to generate a report, it will stop processing the report log and include only the data preceding the HostID change in the report.

  • If a vendor daemon name changes.

    If SAMreport-Lite detects that the vendor daemon name changes in the report log used to generate a report, it will stop processing the report log and include only the data preceding the vendor daemon name change 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 tied to the interval over which you run your reports—remember that you can run a report on multiple report logs and that you can filter report data with designated start and end dates. You may also want to rotate report logs when the license limit for a feature changes, but alternatively, you can also set start and end date filters to isolate usage for given license limits.

NoteYou can corrupt a report log by rotating it incorrectly. A report log must begin with a header that is written by the vendor daemon. Without this header, the report log is corrupted. The data in the report log is unusable and unsalvagable from the start of the report log until the first time in that report log that the license server is restarted.

The report log will have no header and will be corrupted if you manually copy an active report log to a new file name, delete the original active report log, and keep the vendor daemon writing to the original active report log file name.