Tool

jrecord's picture
tool
Reads:

184925

Score:
3.733335
3.7
30
 
Comments:

34

supportconfig for Linux

Author Info

25 March 2013 - 9:53am
Submitted by: jrecord

Author Blog
Author Profile

Tags

Tags Map
download url: 
http://download.opensuse.org/repositories/Novell:/NTS/SLE_11_SP2/noarch/
license: 
GPLv2
home page url: 
http://en.opensuse.org/Supportutils

Description

The updateSupportutils command compares the current versions of supportutils and its plugins to those installed on your server. Those that are outdated or missing are automatically downloaded and installed. Only those plugins that apply to your server are installed. The command supports creating a weekly or monthly cron entry to automatically check and update the supportutils package and its plugins. Click here to see a list of the current supportutils and plugin packages. The updateSupportutils command help screen follows:

################################################################
# Supportutils Auto Update Client
################################################################

Usage: updateSupportutils [OPTION]

Description
  Makes sure the supportutils and supportutils plugin packages are
  installed and current.

Options
  -m  Install a monthly cron for updateSupportutils
  -w  Install a weekly cron for updateSupportutils
  -d  Delete all installed cron entries for updateSupportutils
  -l  List all cron entries for updateSupportutils
  -u  Force RPM update on applicable packages
  -p  Exclude supportutils plugin packages
  -v  Verbose mode
  -h  This screen

Note: Detailed system information and logs are collected and organized in a manner that helps reduce service request resolution times. Private system information can be disclosed when using this tool. If this is a concern, please prune private data from the log files. Several startup options are available to exclude more sensitive information. Refer to the supportconfig(8) man page to see these options.

Update Instructions

Run updateSupportutils as root.

If you do not already have the supportutils-plugin-updater package installed, refer to the Installation Instructions below. If your server does not have network connectivity to http://download.opensuse.org, then install using the Option B (Manual) method.

Installation Instructions

Option A (Automated)

  1. Download the supportutils-plugin-updater
  2. Login as root
  3. Install the updater package
    # rpm -Uvh supportutils-plugin-updater-*.noarch.rpm
  4. Run updateSupportutils as root
    # updateSupportutils

Option B (Manual)

  1. Download the supportutils and any applicable supportutils plugin packages for your server. Click here for the SLES10 repository.
  2. Login as root
  3. Install the supportutils-X.XX-XX.XX.noarch.rpm
    # rpm -Uvh supportutils-X.XX-XX.XX.noarch.rpm
  4. Install the supportutils-plugin-*-X.X-X.X.norarch.rpm packages you want
    # rpm -Uvh supportutils-plugin-*-X.X-X.X.norarch.rpm

Using Supportconfig

To upload a supportconfig to Novell, run supportconfig -ur $srnum; where $srnum is your 11 digit service request number. You can also just run supportconfig for local use. By default, supportconfig saves its information in /var/log/nts_hostname_date_time.tbz.

Reporting Bugs

Updates to Supportconfig Version 2.25-370:

  • Added OES override for -i includes
  • Added ip6tables to network.txt
  • Optmized SLP findsrvtypes
  • plugins removed from timed_log_cmd
  • added -w to supportconfig(8)
  • added VAR_OPTION_WAIT_TRACE to supportconfig.conf(5)
  • added wait trace verbose logging when using -w
  • added /etc/logrotate.d/* to etc.txt
  • uses curl instead of ftp for ftp uploads

Updates to Supportconfig Version 2.25-359:

  • Fixed a missing messages.txt

Updates to Supportconfig Version 2.25-358:

  • Fixed an invalid logger call when plugins time out
  • The OES functions run only if OES is installed
  • Added Novell Proxy Management with OPTION_PROXY for novell-proxymgmt.txt
  • Added /sys/kernel/mm/transparent_hugepage/* to memory.txt
  • Added nsswitch.conf to sssd.txt
AttachmentSize
supportutils-plugin-updater-1.0-25.1.noarch.rpm7.28 KB
supportutils-1.20-73.1.noarch.rpm113.36 KB



Related Articles


User Comments

jeffry's picture

Why not include it?

Submitted by jeffry on 1 May 2008 - 12:51pm.

Would be nice if this could be included in the normal OES/Linux software selection and the rug channels...

jrecord's picture

Including the suportconfig

Submitted by jrecord on 1 May 2008 - 3:28pm.

We are working at including the supportconfig in the distribution. There is a lot involved in adding it, in addition to getting approval. Thanks for the suggestion!

jrecord's picture

Adding supportutils

Submitted by jrecord on 5 November 2008 - 1:33pm.

supportutils is included in the base install for SLE11.

WalterH's picture

Sysstat package

Submitted by WalterH on 12 May 2008 - 8:37am.

It seems that supportconfig needs the sysstat package to include some CPU statistics. But there is no warning if sysstat is not installed.

Walter

jrecord's picture

Sysstat package

Submitted by jrecord on 13 May 2008 - 3:36pm.

Supportconfig will use iostat, mpstat and sar if the sysstat package is installed, otherwise it skips that data. Supportconfig is intended to have as little dependencies as possible. This way it gathers what information it can, regardless of the packages installed.

djh0653's picture

How about an option to show

Submitted by djh0653 on 10 June 2008 - 11:57am.

How about an option to show the differences in a current config file from a "baseline" config file.

jrecord's picture

Baseline diff

Submitted by jrecord on 11 June 2008 - 3:01pm.

I've thought about this before, but there are already some excellent tools to compare files (kdiff3, vimdiff, kompare). So, I really haven't felt a need to go beyond what is already there.

mkoeppl's picture

File System List a way to long

Submitted by mkoeppl on 23 July 2008 - 8:06am.

Great tool but
it seems that it always scans the whole / in the File System List Section. This is pretty useless for troubleshooting a fileserver.
The option -L seems to be always set.

jrecord's picture

File System List too long

Submitted by jrecord on 28 July 2008 - 8:47am.

This option is not set by default, and must have been changed.

The following switches will enable a full file listing: -ALe -or- /etc/supportconfig.conf has been modified with either of the following:
ADD_OPTION_FSLIST=1
ADD_OPTION_EDIR_SEARCH=1

You can force supportconfig to run with it's default settings using -D, which will not set ADD_OPTION_FSLIST.

anonymous's picture

download.opensuse.org is offline

Submitted by anonymous (not verified) on 10 October 2008 - 8:59am.

As of today, October 10. The link to download.opensuse.org appears to be down.

ssalgy's picture

Thanks for the heads-up!

Submitted by ssalgy on 10 October 2008 - 10:36am.

We contacted them, and they said they are having outages that should be solved by tomorrow. Sorry for the inconvenience!

paulparker's picture

script include option send report to SUPPORT ?

Submitted by paulparker on 25 December 2008 - 2:38am.

AS NON Technical user several times tried send tarball error data to SUPPORT only to find it changes in size...

Asked to send the Support Utilities - Supportconfig
Script Version: 2.25-82
Script Date: 2008 12 04

The tarball reports created when logged in as SU

The Siebel eService am logged in as username, not SU.

When loading the tar file from /var/log

it appears to be 889.9 KB

However after load it shows as 65 (bytes ?? ) and they can not read it.

IF am wrongly sending it as user-self and NOT SU, how do I change it so can load them or send them as SU not username ?

jrecord's picture

report to SUPPORT

Submitted by jrecord on 2 January 2009 - 2:55pm.

You have mentioned several issues. I'm not exactly sure what your question is. However, I will answer the question about root verses non-root user. The supportconfig script forces you to run as root. If you use startup options to upload to support, that too will be as the root user, but the tarball will be uploaded using the anonymous user on the ftp server. Hope that helps.

konsultor's picture

install automatically, too

Submitted by konsultor on 27 February 2009 - 1:22pm.

There's no mention above about the option to install on download automatically. The file ends up in /sbin with root as owner, but I found it and ran it with sudo.

Also not mentioned is the option for a command line entry that tells the app to ftp the tarball. The instruction shows up at the end of the test. If you enter the command to ftp, it performs the entire test again--not very efficient. Could supportconfig check for the presence of a recent tarball to ftp before making another?

jrecord's picture

Supportconfig Direction

Submitted by jrecord on 27 February 2009 - 3:01pm.

The supportutils package is not included in the SLE10 distribution, but will be included for SLE11. We are currently looking at possibly adding it to SLE10 SP3, which would make it installable from yast. I presume this is what you mean by "automatic" install on download.

The whole point is to gather current information. I could add an option to upload a specific tar ball, but then again you could just ftp the file yourself. So the only time supportconfig cares about uploading, is after it's gathered the current information.

You could use the -d and -f options in connection with one another. -d will gather the information and not compress it. The -f will then compress that directory into a tar ball. If you combine -f with -u, it would compress the nts_* directory created by -d and upload it to the upload target. Refer to supportconfig(8).

MystikWeb's picture

More Upload Options

Submitted by MystikWeb on 29 June 2010 - 9:44pm.

Hey there,

Was just wondering if there is planned options for some more upload options? We are upgrading our server, and we are not placing FTP services on it, so we cannot FTP the files to a central store in readiness for raising any SR's

Is it possible to get the software extended to add SCP or RSYNC support? or is only FTP and http methods supported?

jrecord's picture

RE: More Upload Options

Submitted by jrecord on 30 June 2010 - 8:29am.

supportconfig currently supports http,https,scp and ftp, see supportconfig(8). I will consider adding rsync. For example,

supportconfig -U 'scp://user@server.domain.com/directory/to/upload' will upload the tarball using scp and the specified user login. If the server is a trusted host, no password will be requested. Otherwise, you're prompted for the password.

MystikWeb's picture

File System List Woes

Submitted by MystikWeb on 20 July 2010 - 7:20pm.

I cannot turn this option off. Tried the -x FSLIST flag with the command line, tried the -D, and its still performing the file system list....

how can I turn this off???

I have a couple of servers which have smb mounts to other servers and its genreating gb text files.

how can I force it to STOP scanning file system list.....

Using supportutils-1.20-15.1

jrecord's picture

RE: File System List Woes

Submitted by jrecord on 21 July 2010 - 7:29am.

Sounds /sbin/supportconfig has been modified. It should contain ADD_OPTION_FSLIST=0
and not ADD_OPTION_FSLIST=1. You should also run rpm -V supportutils to see if the files have been modified. If that doesn't help, report a bug against supportconfig in bugzilla.novell.com and attached a supportconfig to it so I can take a look.

dgersic's picture

eDirectory / LDAP bug report

Submitted by dgersic on 26 October 2010 - 6:13am.

When supportconfig is collecting eDirectory information, it attempts to bind to each configured instance's LDAP interface. But it looks like it is assuming that LDAP will be listening on either localhost or 0.0.0.0.

Novell eDirectory... Please Wait... 6 ldap_bind: Can't contact LDAP server
5 ldap_bind: Can't contact LDAP server
4 ldap_bind: Can't contact LDAP server
3 ldap_bind: Can't contact LDAP server
2 ldap_bind: Can't contact LDAP server
1 ldap_bind: Can't contact LDAP server
Done

While the default for eDirectory is to listen on 0.0.0.0, in a multi-instance configuration this doesn't work. eDirectory can be configured (ldapinterfaces attribute) to listen only on a specified IP address and port so that the instances don't conflict with each other. It would be nice if supportconfig could identify this and act appropriately.

jrecord's picture

RE: eDirectory / LDAP bug report

Submitted by jrecord on 27 October 2010 - 9:29am.

A bug report has been opened. I will be looking into this issue.

lauranoel's picture

Hmm nice find =)

Submitted by lauranoel on 27 January 2011 - 6:42pm.

Hmm nice find =)

emarquezarreaza's picture

File not found basic-health-check.txt

Submitted by emarquezarreaza on 16 March 2011 - 10:45am.

Can someone post an example basic-health-check.txt ? I don't seem to find it in my SUSE box :S

ejma:~ # schealth
###############################################
Supportconfig Health Check Report Tool v1.00-5
Date Checked: 03/16/11 16:31:44
###############################################

Health Check Files [ ERROR ]
ERROR: File not found, /root/basic-health-check.txt

###############################################
Status: ERROR
Checked: /root/basic-health-check.txt
Report: /root/basic-health-report.txt
###############################################

Thanks

jrecord's picture

RE: File not found basic-health-check.txt

Submitted by jrecord on 17 March 2011 - 8:52am.

The basic-health-check.txt needs to be in the current directory to work. If you run a supportconfig, extract it, and look in the directory, the schealth output will be basic-health-report.txt. It looks like this:
##################################################################
Supportconfig Health Check Report Tool v1.00-5
Date Checked: 03/17/11 09:45:56
##################################################################

Health Check Files [ Green ]
Processes Waiting for Run Queue [ Green ]
Kernel Taint Status [ Green ]
CPU Utilization [ Green ]
Interrupts Per Second [ Green ]
Context Switches Per Second [ Green ]
Free Memory and Disk Swapping [ Green ]
Used Disk Space [ Green ]
Uninterruptible Processes [ Green ]
Zombie Processes [ Green ]

##################################################################
Status: Healthy
Checked: /mnt/nts_node_110317_0922/basic-health-check.txt
Report: /mnt/nts_node_110317_0922/basic-health-report.txt
##################################################################

emarquezarreaza's picture

RE: File not found basic-health-check.txt

Submitted by emarquezarreaza on 17 March 2011 - 12:14pm.

I have installed supportutils-1.01-45.13.4.noarch.rpm on a SELS 10 SP2

I executed the command:
ejma:~ # supportconfig

Support Utilities - Supportconfig
Script Version: 2.25-136
Script Date: 2009 08 07
=============================================================================

Gathering system information

Basic Server Health Check... Done
RPM Database... Done
Basic Environment... Done
Basic Health Report... Done
System Modules... Done
Memory Details... Done
Disk I/O... Done
System Logs... Done

ejma:~ # ls -l /var/log/nts*
-rw------- 1 root root 33 Mar 16 10:49 /var/log/nts_ejma_110316_1044.tbz.md5
-rw------- 1 root root 930068 Mar 16 10:49 /var/log/nts_ejma_110316_1044.tbz

Can you please printout your basic-health-check.txt ?
# cat /mnt/nts_node_110317_0922/basic-health-check.txt

Thanks

jrecord's picture

RE: File not found basic-health-check.txt

Submitted by jrecord on 17 March 2011 - 1:55pm.

I printed my output above in my post. The archive is tarred and compressed. Run the following:
1. cd /var/log
2. tar jxvf nts_ejma_110316_1044.tbz
3. cd nts_ejma_110316_1044
4. cat basic-health-check.txt

NOTE: You are running a old version of supportconfig. Please update per the instructions above and retest.

emarquezarreaza's picture

RE: File not found basic-health-check.txt

Submitted by emarquezarreaza on 18 March 2011 - 11:19am.

Perfect, that did the trick ;-) Many thanks

RoyGarson's picture

No time for coffee!

Submitted by RoyGarson on 19 April 2011 - 11:37pm.

Sweet! You certainly manage to get these fixed fast!

paulparker's picture

is in sled 11

Submitted by paulparker on 15 July 2011 - 12:48am.

supportconfig, chkbin, schealth

These seem now part of supportutils in sle11 :-)

BTW self is one of the "Technically Challenged" !

localhost:/home/paulparker # zypper se supportconfig
Refreshing service 'nu_novell_com'.
Loading repository data...
Reading installed packages...
No packages found.

localhost:/home/paulparker # zypper se supportutils
Refreshing service 'nu_novell_com'.
Loading repository data...
Reading installed packages...

S | Name | Summary | Type
--+----------------------+----------------------------------+-----------
i | sledsp1-supportutils | Security update for supportutils | patch
i | supportutils | Support Troubleshooting Tools | package
| supportutils | Support Troubleshooting Tools | srcpackage
localhost:/home/paulparker #

http://www.novell.com/documentation/sled11/sled11_...

In this document find : Administration Guide
open, then find : Support and Common Tasks
open, then find : Gathering System Information for Support
open, then find : Using Supportconfig

Current details from my system:

localhost:/home/paulparker # zypper info supportutils
Refreshing service 'nu_novell_com'.
Loading repository data...
Reading installed packages...

Information for package supportutils:

Repository: SLED11-SP1-Updates
Name: supportutils
Version: 1.20-0.10.1
Arch: noarch
Vendor: SUSE LINUX Products GmbH, Nuernberg, Germany
Support Level: Level 3
Installed: Yes
Status: up-to-date
Installed Size: 198.0 KiB
Summary: Support Troubleshooting Tools
Description:
A package containing troubleshooting tools. This package contains the
following: supportconfig, chkbin, schealth
localhost:/home/paulparker #
localhost:/home/paulparker # supportconfig --help

=============================================================================
Support Utilities - Supportconfig
Script Version: 2.25-237
Script Date: 2010 10 25
=============================================================================

----deleted----
localhost:/home/paulparker # chkbin --help

####################################################################
Binary Check Tool, v1.01-25
Date: 07/15/11, 17:21:21
Kernel: 2.6.32.36-0.5-default, Hardware: x86_64
####################################################################
----deleted----
localhost:/home/paulparker # schealth --help
----deleted----
####################################################
Supportconfig Health Check Report Tool v1.00-5
Date Checked: 07/15/11 17:22:01
####################################################
----deleted----

Paul.

jrecord's picture

SLE11

Submitted by jrecord on 15 July 2011 - 7:50am.

That is the current distributed version. I will be starting the patch process soon to update all the distributions with the current supportutils package available on Cool Solutions.

dbawork's picture

Nice tool

Submitted by dbawork on 30 January 2012 - 1:09am.

This is very useful tool for data collection. we have found this very useful for database administration, when database hits with problem of operating system we use this tool for data collection.

lbartlett's picture

Access to older tool versions

Submitted by lbartlett on 26 April 2012 - 3:50am.

Some servers don't like newer version, they don't output correctly. Once uninstalling older version can't go back. Can we have a ZIP download that includes older versions?

Example, update.txt:

echo $$ > /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.pid
/usr/lib/zypp/zypp-query-pool products >> /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.out 2>&1
echo $? > /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.returncode
if [ -e /var/log/nts_SERVER1_120426_1150/updates.txt ]; then
sed -i -e "$(grep -n /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.out /var/log/nts_SERVER1_120426_1150/updates.txt | cut -d: -f1)r /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.out" /var/log/nts_SERVER1_120426_1150/updates.txt 2>/dev/null
sed -i -e "/$(basename /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.out)/d" /var/log/nts_SERVER1_120426_1150/updates.txt 2>/dev/null
rm -f /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE.out
fi
rm -f /var/log/nts_SERVER1_120426_1150/updates.txt.zypp-query-pool.1335434122.SEMAPHORE

mcando's picture

Proxy auth?

Submitted by mcando on 3 April 2013 - 5:43pm.

Is proxy authentication supported? Our server is behind a squid proxy with eDirectory authentication.

jrecord's picture

RE: Proxy auth

Submitted by jrecord on 5 April 2013 - 3:24pm.

No, just run supportconfig with the -r and it will save locally. Copy the supportconfig off and upload it manually to ftp.novell.com or anywhere else.

© 2013 Novell