Contents
Abstract
Once a problem arises, supportconfig can be used to
collect system information. Such information can be, for example, the
current kernel version being used, the hardware, RPM database, partitions
and others. The result is used to help the Novell Support Center find
your problem. The supportconfig command can be found
in the supportutils package which is installed
by default.
Novell Support Link (NSL) is new to SUSE Linux Enterprise Desktop. It is a tool that gathers system information and allows you to upload that information to another server for further analysis. Novell Support Center uses Novell Support Link to gather system information from problematic servers and sends the information to Novell's public FTP server. System information gathered includes: current kernel version being used, the hardware, RPM database, partitions, and more. The result is used to help the Novell Support Center resolve your open service request.
There are two ways to use Novell Support Link:
Use the YaST Support module.
Use the command line utility supportconfig.
The YaST Support module calls supportconfig to gather system information.
The following sections describe how to use supportconfig with YaST, with the command line and what other options you have.
To use YaST to gather your system information, proceed as follows:
Open the URL http://www.novell.com/center/eservice and create a service request number.
Start YaST.
Open the module.
Click on .
Select an option from the radio button list. If you want to test it first, use . Proceed with .
Enter your contact information. Use your service request number from Step 1 and enter it into the text field labeled . Proceed with .
The information gathering begins. After the process is finished, continue with .
Review the data collection. Continue with .
Save your tarball. If you want to upload to the Novell customer center, make sure is activated. Finish the operation with .
To use supportconfig from the commandline, proceed as follows:
Open a shell and become
root.
Run supportconfig without any options. This gathers the default system information.
Wait for the tool to complete the operation.
The default archive location is /var/log with the
filename format
nts_
HOST_DATE_TIME.tbz
The supportconfig utility is usually called without
any options. Display a list of all options with
supportconfig -h or refer to the man
page. The following list gives a brief overview of the more common
cases:
Use the minimal option (-m) to reduce the size of the
information being gathered:
supportconfig -m
Include additional contact information in the output (in one line):
supportconfig -E tux@example.org -N "Tux Penguin" -O "Penguin Inc." ...
While troubleshooting a problem, you may want to gather information only about the area of the problem you are currently working on. For example, if you have problems with LVM, and recently found the problem with the default supportconfig output. After making changes, you want to gather the current LVM information. The following would gather the minimum supportconfig information and LVM only.
supportconfig -i LVM
To see a complete feature list, run:
supportconfig -F
You can use the YaST Support module or the supportconfig command line utility to submit system information to Novell. When you experience a server issue and would like Novell's assistance, you will need to open a service request and submit your server information to Novell. Both YaST and command line methods are described.
Procedure 2.1. Submitting Information to Novell with YaST
Open the URL http://www.novell.com/center/eservice and create a service request number.
Write down your 11 digit service request number. The following examples will assume the service request number is 12345678901.
Click on in the YaST Support module window.
Select the radio button. Proceed with .
Enter your contact information, fill in and include Novell's upload target URL.
For the secure upload target, use: https://secure-www.novell.com/upload?appname=supportconfig&file={tarball}.
For the normal FTP upload target, use: ftp://ftp.novell.com/incoming.
Proceed with . Information gathering starts. After the process is finished, continue with .
Review the data collection and use to remove any files you want excluded from the tarball uploaded to Novell. Continue with .
By default, a copy of the tarball will be saved in
/root. Confirm you are using one of the Novell
upload targets described above and the is activated. Finish with
.
Click .
Procedure 2.2. Submitting Information to Novell with supportconfig
Open the URL http://www.novell.com/center/eservice and create a service request number.
Write down your 11 digit service request number. The following examples will assume the service request number is 12345678901.
Servers with Internet connectivity:
To use the default upload target, run:
supportconfig -ur 12345678901
For the secure upload target, use the following on one line:
supportconfig -r 12345678901 -U 'https://secure-www.novell.com/upload?appname=supportconfig&file={tarball}'Servers without Internet connectivity
Run the following:
supportconfig -r 12345678901
Manually upload the
/var/log/nts_SR12345678901*tbz tarball to
Novell's FTP server
(ftp://ftp.novell.com/incoming).
You can also attach the tarball to your service request using the service request URL: http://www.novell.com/center/eservice.
Once the tarball is in the ftp://ftp.novell.com/incoming directory, it becomes automatically attached to your service request.
Find more information about gathering system information in the following documents:
man supportconfig—The manpage of supportconfig
man supportconfig.conf—The manpage of the supportconfig configuration file
http://www.novell.com/communities/print/node/4097—A Basic Server Health Check with Supportconfig
http://www.novell.com/communities/print/node/4827—Create Your Own Supportconfig Plugin
http://www.novell.com/communities/print/node/4800—Creating a Central Supportconfig Repository