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.
Novell Support Link (NSL) is new to SUSE Linux Enterprise Server. 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 and use
if you do not need the respective filename. 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 has a variety of startup
options. You can see these options with supportconfig
-h
or use the man page. Generally
supportconfig is run without any options. The
following is a summary of some of the more common startup options:
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
Use the -u
and -r
options to upload
a supportconfig tarball with the associated service request number.
For example, if you have opened a service request with Novell and the
tracking number is 12345678901, run the following:
supportconfig -ur 12345678901
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