When in interactive mode, the configuration options can be listed by entering the command co nfi g --hel p:
~]# red hat-suppo rt-to o l
Welcome to the Red Hat Support Tool.
Command (? for help): co nfi g --hel p
Usage: config [options] config.option <new option value>
Use the 'config' command to set or get configuration file values.
Options:
-h, --help show this help message and exit
-g, --global Save configuration option in /etc/redhat-support-tool.conf.
-u, --unset Unset configuration option.
The configuration file options which can be set are:
user : The Red Hat Customer Portal user.
password : The Red Hat Customer Portal password.
debug : CRITICAL, ERROR, WARNING, INFO, or DEBUG url : The support services URL.
Default=https://api.access.redhat.com proxy_url : A proxy server URL.
proxy_user: A proxy server user.
proxy_password: A password for the proxy server user.
ssl_ca : Path to certificate authorities to trust during communication.
kern_debug_dir: Path to the directory where kernel debug symbols should be downloaded and cached.
Default=/var/lib/redhat-support-tool/debugkernels Examples:
- config user
- config user my-rhn-username - config --unset user
Pro ced u re 6 .1. Reg ist erin g t h e Red Hat Su p p o rt T o o l Usin g In t eract ive Mo d e To register the Red Hat Support Tool to the customer portal using interactive mode, proceed as follows:
1. Start the tool by entering the following command:
~]# red hat-suppo rt-to o l
2. Enter your Red Hat Customer Portal user name:
Command (? for help): co nfi g user username
To save your user name to the global configuration file, add the -g option.
3. Enter your Red Hat Customer Portal password:
Command (? for help): co nfi g passwo rd Please enter the password for username:
6.4 .1. Saving Set t ings t o t he Configurat ion Files
The Red Hat Su p p o rt T o o l, unless otherwise directed, stores values and options locally in the home directory of the current user, using the ~ /. red hat-suppo to o l /red hat-suppo rt-to o l . co nf configuration file. If required, it is recommended rt-to save passwords rt-to this file because it is only readable by that particular user. When the tool starts, it will read values from the global
configuration file /etc/red hat-suppo rt-to o l . co nf and from the local configuration file. Locally stored values and options take precedence over globally stored settings.
Warning
It is recommended n o t to save passwords in the global /etc/red hat-suppo
rt-to o l . co nf configuration file because the password is just base6 4 encoded and can easily be decoded. In addition, the file is world readable.
To save a value or option to the global configuration file, add the -g , --g l o bal option as follows:
Command (? for help): co nfi g setting -g value
Note
In order to be able to save settings globally, using the -g , --g l o bal option, the Red Hat Su p p o rt T o o l must be run as ro o t because normal users do not have the permissions required to write to /etc/red hat-suppo rt-to o l . co nf.
To remove a value or option from the local configuration file, add the -u, --unset option as follows:
Command (? for help): co nfi g setting -u value
This will clear, unset, the parameter from the tool and fall back to the equivalent setting in the global configuration file, if available.
Note
When running as an unprivileged user, values stored in the global configuration file cannot be removed using the -u, --unset option, but they can be cleared, unset, from the current running instance of the tool by using the -g , --g l o bal option simultaneously with the -u, --unset option. If running as ro o t, values and options can be removed from the global configuration file using -g , --g l o bal simultaneously with the -u, --unset option.
6.5. Opening and Updat ing Support Cases Using Int eract ive Mode
Pro ced u re 6 .2. O p en in g a New Su p p o rt Case Usin g In t eract ive Mo d e To open a new support case using interactive mode, proceed as follows:
1. Start the tool by entering the following command:
~]# red hat-suppo rt-to o l
2. Enter the o pencase command:
Command (? for help): o pencase
3. Follow the on screen prompts to select a product and then a version.
4. Enter a summary of the case.
5. Enter a description of the case and press C trl+D on an empty line when complete.
6. Select a severity of the case.
7. Optionally chose to see if there is a solution to this problem before opening a support case.
8. Confirm you would still like to open the support case.
Support case 0123456789 has successfully been opened 9. Optionally chose to attach an SOS report.
10. Optionally chose to attach a file.
Pro ced u re 6 .3. Viewin g an d Up d at in g an Exist in g Su p p o rt Case Usin g In t eract ive Mo d e To view and update an existing support case using interactive mode, proceed as follows:
1. Start the tool by entering the following command:
~]# red hat-suppo rt-to o l 2. Enter the g etcase command:
Command (? for help): g etcase case-number
Where case-number is the number of the case you want to view and update.
3. Follow the on screen prompts to view the case, modify or add comments, and get or add attachments.
Pro ced u re 6 .4 . Mo d if yin g an Exist in g Su p p o rt Case Usin g In t eract ive Mo d e
To modify the attributes of an existing support case using interactive mode, proceed as follows:
1. Start the tool by entering the following command:
~]# red hat-suppo rt-to o l 2. Enter the mo d i fycase command:
Command (? for help): mo d i fycase case-number
Where case-number is the number of the case you want to view and update.
3. The modify selection list appears:
Type the number of the attribute to modify or 'e' to return to the previous menu.
1 Modify Type 2 Modify Severity 3 Modify Status
4 Modify Alternative-ID 5 Modify Product
6 Modify Version End of options.
Follow the on screen prompts to modify one or more of the options.
4. For example, to modify the status, enter 3:
Selection: 3
1 Waiting on Customer 2 Waiting on Red Hat 3 Closed Please select a status (or 'q' to exit):
6.6. Viewing Support Cases on t he Command Line
Viewing the contents of a case on the command line provides a quick and easy way to apply solutions from the command line.
To view an existing support case on the command line, enter a command as follows:
~]# red hat-suppo rt-to o l g etcase case-number
Where case-number is the number of the case you want to download.
6.7. Addit ional Resources
The Red Hat Knowledgebase article Red Hat Support Tool has additional information, examples, and video tutorials.