Red Hat's Global Support Services is pleased to announce the introduction of Red Hat Access in Red Hat Enterprise Linux. With Red Hat Access, delivered through the Red Hat Support Tool, customers can find help, get answers, and utilize diagnostic services using exclusive Red Hat knowledge, resources, and functionality, all within a Linux terminal.
Subscribers who install this tool will enjoy the following Red Hat Access services from the Red Hat Enterprise Linux terminal:
- Create, manage, update, and attach files to Red Hat support cases
- Conveniently access exclusive Red Hat knowledge and solutions
- Search error codes, messages, etc., and view related knowledge from the Red Hat Customer Portal
- Use diagnostic services to analyze log files
- Easily extract backtraces from kernel core files
- Red Hat Access: Knowledge
- Red Hat Access: Support
- Red Hat Access: Diagnose
The Red Hat Support Tool for Red Hat Enterprise Linux is installed by running the following command.
yum install redhat-support-tool
The Red Hat Support Tool,
redhat-support-tool, is both a shell and a single-execution program. The Red Hat Support Tool does not require a graphical interface as it is entirely text based. It can be run over SSH or from any terminal.
The program, by default, will launch into the shell mode where the commands (e.g.,
search, etc.) can be called. All commands that are available in the shell mode are also available in single-execution mode (e.g.,
redhat-support-tool btextract /path/to/vmcore).
There are some useful convenience features available in the shell mode such as tab command completion and using the '!' to call programs in the parent shell.
Red Hat Support Tool in Shell Mode
Red Hat Support Tool in Non-Interactive Mode
Videos that demonstrate both the usage and features of the Red Hat Support Tool are listed below.
First Use: installation, searching the knowledgebase, and navigating articles.
Configuration Options: incuding proxy configuration, and interactive versus non-interactive mode.
Diagnostic Services: advanced diagnostic services with commands like 'diagnose', 'analyze', and 'btextract'.
Support Engagement: engage Red Hat Support via the command line, including how to attach files like SOS reports to cases, how to open cases, and check on a case's status.
The Red Hat Support Tool will self configure when it is launched the first time. Minimally, the Red Hat Support Tool needs a Red Hat login so that it can securely (via HTTPS) use Red Hat Access services. Users have the option to either persist their login information in a configuration file (
$HOME/.redhat-support-tool/redhat-support-tool.conf) or supply it each time the tool is invoked.
All of the Red Hat Support Tool's configuration options can all be viewed by executing the command
config --help. These configuration options are set by typing the
config <option name> <option value> command. A picture demonstrating this is here.
Importantly, the Red Hat Support Tool has full proxy support for sites that require a proxy server access to the Internet. The tool can also be configured to use a proxy server with a password if necessary.
Configuration options can also be set globally by the root user so that they are available for all users on a system. A simple use case where a system-wide configuration setting makes sense is proxy information. In this use case, a root user will launch the Red Hat Support Tool and type
config --global proxy_url http://proxy.example.com. The proxy information will be saved by the tool to
/etc/redhat-support-tool.conf. Ordinary users of the Red Hat Support Tool on that system will inherit this proxy information into their configurations and will not need to supply this information. A picture demonstrating this scenario is here.
Automatic Configuration at First Launch
All Available Configuration Options
Example: Globally Set a Site's Proxy Server
The Red Hat Support Tool provides help for each command. The
help command with no options will list all available commands and a brief description of each. Additional help is available on each specific command by typing
help <command> as shown here
Help on all Available Commands
Help on a Specific Command
Red Hat Access: Knowledge
The Red Hat Support Tool allows subscribers to both search for and view the same knowledge content found in the Red Hat Customer Portal
in a terminal and in the same manner that man pages are normally viewed. The screenshot below demonstrates what the Red Hat Customer Portal Knowledge Article numbered 66281 looks like when viewed in the Red Hat Support Tool.
Search for Knowledge
A keyword search of the Knowledgebase is performed with the
search command. Users can enter error codes, lines from a log file, or any set of keywords to produce a relevant query. The tool will search the Red Hat Knowledgebase and present the results in a list with the most relevant results first. Pagination through the remaining results is possible when the result set is greater than what can be rendered in a terminal window and is demonstrated below.
The screenshot below demonstrates a keyword search, selection of a Knowledge Article, and the subsequent menu where it is possible to view specific sections or to view the document in its entirety.
The Red Hat Support Tool supports a variety of mechanism to view knowledge. It is possible to directly access knowledge if the identifier is known through the
kb command. The following example demonstrates how to view knowledge non-interactively. With this approach it is possible to pipe the output to other programs like
more for advanced use cases.
Red Hat Access: Support
The Red Hat Support Tool allows subscribers to easily to view, update, attach files to support cases. The following screenshots demonstrate how to manage support cases with the tool.
The screenshot below demonstrates the use of the
listcases command with an optional filter to show
closed support cases. There are other filter options (e.g., filter by case group and keyword) which can be seen by viewing help on the
listcases command (i.e.,
List all Support Cases in an Account
From the list of available support cases, make a selection to either manage or view the various attributes of a support case. The screenshot below displays a subsequent menu where it is possible to update the support case's state, attach a file, add a comment, view the discussion, and various other actions.
Support Case Menu Actions
The Red Hat Support Tool makes it easy to attach a file to a support case. It is possible to attach a file through the case menu (shown below) or via the
Attach a File to a Support Case
There are various ways to manage a support case, including non-interactive. The example below demonstrates how to close a support case non-interactively.
Close a Support Case
Open a Support Case and Attach a SoS Report
Support-case creation with the Red Hat Support Tool is a recommended way to engage Red Hat support services. When a support case is created using the tool, the tool will give the option to optionally collect an SoS report or attach any file that may be relevant to the issue. The tool simplifies the process of attaching these files because it automates the work of collection and attachment to the support case.
The example below demonstrates how to use the Red Hat Support Tool to create a support case and automatically attach an SoS report. In the example below, the the product and version are set as arguments to the
opencase command. These arguments were set for brevity and are not necessary. If they are not supplied as arguments the tool will present a pick list of products and associated versions.
The screenshot below demonstrates that an SoS report was successfully attached to the newly created support case in the Red Hat Customer Portal's support case view.
Red Hat Access: Diagnose
The Red Hat Support tool has a variety of commands available to assist with problem determination. These commands are
Simplified Backtrace Extraction from a Kernel Core File
Kernel backtraces provide extremely useful information for the problem determination of a kernel crash. If a system is properly configured to collect a kernel core file, then the Red Hat Support tool can be used to easily extract a backtrace and either perform on-site diagnostics or open a support case so that a Red Hat support engineer can assist with resolution. When engagement with Red Hat support is required, it is often quicker to open a support case with the actual backtrace as opposed to attaching a kernel core file because core files are often very large.
To perform an analysis of a kernel core file, the associated debug symbols for that specific kernel build are required. The Red Hat Support Tool will automatically inspect the supplied kernel core file and download the appropriate debug symbols from the Red Hat Customer Portal. The tool will then present the user with the some common crash commands, the option to supply custom commands, the option to diagnose the output, and the option to open a support case with a backtrace attached. The screenshot below demonstrates how to perform analysis on a kernel core file.
To perform an onsite analysis of the kernel core file, simply select Diagnose from the menu as shown below.
Kernel debug symbols are, by default, unpacked into
/var/lib/redhat-support-tool/debugkernels. The tool provides two additional commands for managing the debug symbols cached in
/var, which are
listkerneldebugs. These commands are shown below.
Diagnose a File, Error Code, or a String
In addition to standard keyword-based searching (i.e., the
search command), the Red Hat Support Tool allows users to leverage Red Hat Access Diagnostic services. Red Hat Access Diagnostic services services go above and beyond traditional keyword based searching and perform additional analysis to correlate the most relevant knowledge to the given input.
diagnose command in the Red Hat Support Tool is the gateway to Red Hat Access Diagnostic services. It accepts either file input or command line text. The example below demonstrates the use of the
diagnose command on
Analyze a Tomcat, JBoss, or Python Log File
The Red Hat Support Tool has specialized filtering for the analysis of logs from both Java and Python programs. The
analyze command will accept the path to a log file as input and will look for interesting problem symptoms within the file. The tool will then present these symptoms to the user in a pick list so that they can be both viewed and diagnosed individually. This can produce more relevant results from Red Hat Access Diagnostic services as opposed to sending up an entire log file.
The screenshot below demonstrates the
analyze command processing a JBoss server log file. The Red Hat Support Tool will process the log file and present interesting problem symptoms for the user to review in a pick list.