Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
Applies to Subscription Management Tool 11.3

6 SMT Reports

This chapter introduces reports based on the SMT and Novell Customer Center data. The reports contain statistics of all the registered machines, products used and all active, expiring or missing subscriptions.

Note
Note: Assignment of Reports

If you are using more than one SMT server in your environment, generated reports may not represent all of the SMT servers or machines in your environment. For the complete statistics of all your registered machines, refer to the information in the Novell Customer Center.

6.1 Report Schedule and Recipients

Generated SMT reports can be sent to a defined list of e-mail addresses periodically. To create or edit this list, and to set the frequency of the reports, use the YaST SMT Configuration module. How to configure this list is described in Section 2.4, “Setting E-mail Addresses to Receive Reports with YaST”. Configuration of the report schedule is described in Section 2.5, “Setting the SMT Job Schedule with YaST”.

The list can also be edited manually in the reportEmail option of the /etc/smt.conf configuration file. For more information about editing the list of addresses directly, see Section 7.2.1.6, “[REPORT] Section of /etc/smt.conf”. To set the frequency of reports manually, you can directly edit the smt-gen-report lines of the crontab in /etc/cron.d/novell.com-smt. For more information about the crontab format, see man 5 crontab.

Reports, including those created as a scheduled SMT job, are created by the smt-report command. This command has various parameters. To edit parameters used with scheduled commands, edit the /etc/smt.d/smt-cron.conf configuration file. For more information, see Section 7.2.2, “/etc/smt.d/smt-cron.conf”.

6.2 Types of SMT Reports

Two types of reports can be created with the smt-report command:

--local

If the --local option is used, the created report is based solely on local SMT data.

--ncc

If the --ncc option is used, the created report is based on Novell Customer Center data.

If neither --local nor --ncc is used, the type of report is determined by forwardRegistration in the /etc/smt.conf configuration file. If the option is set to true, the report is based on Novell Customer Center data. If it is set to false, the report is based on local SMT data.

If you are creating a report based on local SMT data and you do not want local data to be synchronized with the Novell Customer Center at all, use the --nonccsync option together with --local option.

6.3 Report Output Formats and Targets

SMT reports can be printed to the standard output, exported to one or multiple files (in CSV format) as well as mailed to the defined list of e-mail addresses. Use the following options for the smt-report command:

--quiet or -q

Suppress output to STDOUT and run smt-report in quiet mode.

--file or -F

Export report to one or several files. By default, the report will be written to a single file, rendered as tables. Optionally, the filename or whole path may be specified after the parameter: --file filename. If no filename is specified, a default filename containing a timestamp is used. However, SMT will not check if the file or files already exist.

In CSV (Comma-Separated Value) mode the report will be written to multiple files, therefore the specified filename will expand to [path/]filename-reportname.extension for every report.

--csv or -c

The report will be exported to multiple files in CSV format. The first line of each *.csv file consists of the column names, the data starts on line two. It is recommended to use the --csv parameter together with the --file parameter. If the specified filename contains a .csv extension, the report format will be CSV (as if the --csv parameter was used).

--mail or -m

Activate mailing of the report to the addresses configured with the YaST SMT Configuration module and written in /etc/smt.conf. The report will be rendered as tables.

--attach or -a

Attach the report to the mails in CSV format. This option should only be used together with the --mail option.

--pdf

The report will be exported to multiple files in pdf format.

--xml

The report will be exported to multiple files in xml format.

Note
Note: Disabling Sending Attachments

If you want to disable sending CSV attachments with report mails, edit the /etc/smt.d/smt-cron.conf configuration file as follows: remove the --attach option from the REPORT_PARAMS value. The default line reads: REPORT_PARAMS="--mail --attach -L /var/log/smt-report.log". To disable CSV attachments, change it to: REPORT_PARAMS="--mail -L /var/log/smt-report.log".

If you have disabled CSV attachments but need them occasionally, you can send them manually with the smt-report --mail --attach -L /var/log/smt-report.log command.

Print this page