6 SMT Reports

6.1 Report Schedule and Recipients
6.2 Report Output Formats and Targets

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

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 SUSE 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 Report Output Formats and Targets #

SMT reports can be printed to the standard output, exported to one or multiple files (in CSV format) and 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 file name or whole path may be specified after the parameter: --file filename. If no file name is specified, a default file name containing a time stamp 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 file name 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, then the data starts on line two. It is recommended to use the --csv parameter together with the --file parameter. If the specified file name 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: 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