How to Provide Information About Your System

Essential Reading for all New Members of the Fora.

How to Provide Information About Your System

Postby toracat » 2010/11/02 15:13:20

When asking questions on a forum, mailing list, or IRC, it is important to provide correct and complete information about your system. Good general guidance can be found in the Readme First post in this forum, and in the classic guide "How To Ask Questions The Smart Way" by open source developer and philosopher Eric S. Raymond.

To aid in the process a script getinfo.sh has been developed to collect system information for a variety of classes of questions.

You can fetch the file with wget, or open the link above, select the text and copy/paste the script to a file, for example "getinfo.sh" with
Code: Select all
cat - > getinfo.sh  # Note: Ctrl-D is EOF
or right-click and do "Save Link As ..." to save it to a local directory.

Change the permissions to make it executable and run it:
Code: Select all
chmod +x getinfo.sh
./getinfo.sh

Alternatively, enable the ELRepo repository and
Code: Select all
yum install getinfo
to install the script to /usr/local/bin/ with proper permissions.

The script will save information to a temporary file which can be posted in-line, or for longer files saved to a site such as pastebin.centos.org. The forum attachment function is permanently broken, so please do not try to "Attach file" to the post.

All options can be run as a normal user but fdisk information can only be provided if run as root. You should check the contents of the output file to ensure it does not contain any sensitive information such as public IP addresses or hostnames.

1. Basic info - appropriate for any and all CentOS questions. - getinfo.sh basic

2. Disk/filesystem problem - Basic + full disk info - requires the user to become root to run as this really needs "fdisk -l". - getinfo.sh disk

3. Hardware/driver/kernel problem - Basic + hardware and kernel info. - getinfo.sh driver

4. Network problem - Basic + full network info. - getinfo.sh network

5. Package problems with yum, rpm, and repos - Basic + rpm, yum, kernel. - getinfo.sh package

6. The kitchen sink - combines all of the above. Run as either root or non-root, but won't get fdisk info unless root. - getinfo.sh all (the default)

If necessary obfuscate sensitive information before posting. For example:

Code: Select all
   146.xxx.xxx.41 or myhost.mydomain.net

Note that it is not necessary to hide network information for private subnets often assigned by DHCP servers using NAT in ranges:

Code: Select all
10.0.0.0 – 10.255.255.255
172.16.0.0 – 172.31.255.255
192.168.0.0 – 192.168.255.255


Other tools for gathering more detailed system information include dmidecode and sos, available in the CentOS core repos. Providing appropriate information will help you get a prompt and accurate answer, and will help other forum members to efficiently answer your questions.
User avatar
toracat
Forum Moderator
 
Posts: 6694
Joined: 2006/09/03 16:37:24
Location: California, US

Return to CentOS 6 - FAQ & Readme First

Who is online

Users browsing this forum: No registered users and 0 guests