Chapter 2. Gathering System Information for Support

Contents

2.1. Novell Support Link Overview
2.2. Using Supportconfig
2.3. Submitting Information to Novell
2.4. For More Information

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.

2.1. Novell Support Link Overview

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:

  1. Use the YaST Support module.

  2. Use the command line utility supportconfig.

The YaST Support module calls supportconfig to gather system information.

2.2. Using Supportconfig

The following sections describe how to use supportconfig with YaST, with the command line and what other options you have.

2.2.1. Using YaST to Collect Information

To use YaST to gather your system information, proceed as follows:

  1. Open the URL http://www.novell.com/center/eservice and create a service request number.

  2. Start YaST.

  3. Open the Support module.

  4. Click on Create report tarball.

  5. Select an option from the radio button list. If you want to test it first, use Only gather a minimum amount of info. Proceed with Next.

  6. Enter your contact information. Use your service request number from Step 1 and enter it into the text field labeled Novell 11 digit service request number. Proceed with Next.

  7. The information gathering begins. After the process is finished, continue with Next.

  8. Review the data collection and use Remove from Data if you do not need the respective filename. Continue with Next.

  9. Save your tarball. If you want to upload to the Novell customer center, make sure Upload log files tarball into URL is activated. Finish the operation with Next.

2.2.2. Using Supportconfig Directly to Collect Information

To use supportconfig from the commandline, proceed as follows:

  1. Open a shell and become root.

  2. Run supportconfig without any options. This gathers the default system information.

  3. Wait for the tool to complete the operation.

  4. The default archive location is /var/log with the filename format nts_HOST_DATE_TIME.tbz

2.2.3. Common Supportconfig Options

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

2.3. Submitting Information to Novell

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

  1. Open the URL http://www.novell.com/center/eservice and create a service request number.

  2. Write down your 11 digit service request number. The following examples will assume the service request number is 12345678901.

  3. Click on Create report tarball in the YaST Support module window.

  4. Select the Use custom radio button. Proceed with Next.

  5. Enter your contact information, fill in Novell 11 digit service request number and include Novell's upload target URL.

    Proceed with Next. Information gathering starts. After the process is finished, continue with Next.

  6. Review the data collection and use Remove from Data to remove any files you want excluded from the tarball uploaded to Novell. Continue with Next.

  7. 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 Upload log files tarball into URL is activated. Finish with Next.

  8. Click Finish.

Procedure 2.2. Submitting Information to Novell with supportconfig

  1. Open the URL http://www.novell.com/center/eservice and create a service request number.

  2. Write down your 11 digit service request number. The following examples will assume the service request number is 12345678901.

  3. Servers with Internet connectivity:

    1. To use the default upload target, run:

      supportconfig -ur 12345678901
    2. 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}'
  4. Servers without Internet connectivity

    1. Run the following:

      supportconfig -r 12345678901
    2. Manually upload the /var/log/nts_SR12345678901*tbz tarball to Novell's FTP server (ftp://ftp.novell.com/incoming).

    3. You can also attach the tarball to your service request using the service request URL: http://www.novell.com/center/eservice.

  5. Once the tarball is in the ftp://ftp.novell.com/incoming directory, it becomes automatically attached to your service request.

2.4. For More Information

Find more information about gathering system information in the following documents: