Troubleshooting

This section contains some common problems you might encounter with SUSE Manager, and solutions to resolving them.

Before you begin troubleshooting, you might want to produce some reports from your system to help you understand what is going on.

Producing Reports

The spacewalk-report command is used to produce a variety of reports for system administrators. These reports can be helpful for taking inventory of your entitlements, subscribed systems, users, and organizations. Using reports is often simpler than gathering information manually from the SUSE Manager Web UI, especially if you have many systems under management.

spacewalk-reports Package

To use spacewalk-report, you must have the spacewalk-reports package installed.

spacewalk-report allows administrators to organize and display reports about content, systems, and user resources across SUSE Manager. Using spacewalk-report, you can receive reports on:

System Inventory: lists all of the systems registered to SUSE Manager.
Entitlements: lists all organizations on SUSE Manager, sorted by system or channel entitlements.
Patches: lists all the patches relevant to the registered systems and sorts patches by severity, as well as the systems that apply to a particular patch.
Users: lists all the users registered to SUSE Manager and any systems associated with a particular user.

To get the report in CSV format, run the following at the command line of your SUSE Manager Server.

spacewalk-report <report_name>

The following reports are available:

Table 1. `spacewalk-report` Reports
Report	Invoked as	Description
Channel Packages	`channel-packages`	List of packages in a channel.
Channel Report	`channels`	Detailed report of a given channel.
Cloned Channel Report	`cloned-channels`	Detailed report of cloned channels.
Custom Info	`custom-info`	System custom information.
Entitlements	`entitlements`	Lists all organizations on SUSE Manager with their system or channel entitlements.
Patches in Channels	`errata-channels`	Lists of patches in channels.
Patches Details	`errata-list`	Lists all patches that affect systems registered to SUSE Manager.
All patches	`errata-list-all`	Complete list of all patches.
Patches for Systems	`errata-systems`	Lists applicable patches and any registered systems that are affected.
Host Guests	`host-guests`	List of host-guests mapping.
Inactive Systems	`inactive-systems`	List of inactive systems.
System Inventory	`inventory`	List of systems registered to the server, together with hardware and software information.
Kickstart Trees	`kickstartable-trees`	List of kickstartable trees.
All Upgradable Versions	`packages-updates-all`	List of all newer package versions that can be upgraded.
Newest Upgradable Version	`packages-updates-newest`	List of only newest package versions that can be upgraded.
Result of SCAP	`scap-scan`	Result of OpenSCAP sccdf eval.
Result of SCAP	`scap-scan-results`	Result of OpenSCAP sccdf eval, in a different format.
System Data	`splice-export`	System data needed for splice integration.
System Groups	`system-groups`	List of system groups.
Activation Keys for System Groups	`system-groups-keys`	List of activation keys for system groups.
Systems in System Groups	`system-groups-systems`	List of systems in system groups.
System Groups Users	`system-groups-users`	Report of system groups users.
Installed Packages	`system-packages-installed`	List of packages installed on systems.
Users in the System	`users`	Lists all users registered to SUSE Manager.
Systems administered	`users-systems`	List of systems that individual users can administer.

For more information about an individual report, run spacewalk-report with the option --info or --list-fields-info and the report name. The description and list of possible fields in the report will be shown.

For further information on program invocations and options, see the spacewalk-report(8) man page as well as the --helpparameter of the spacewalk-report.