Sysadmin:Troubleshooting

From Earlham CS Department
Jump to navigation Jump to search

Here's some bullet points everyone should know as an admin. These are a few things to do when you run into errors (in roughly this order, though that may vary and not all of these are applicable to all situations):

  • Try again. Sometimes it's a fluke.
  • Check for related information - e.g. can I ping google.com? If not, check for network issues.
  • Read the man page or help text for the command.
  • Read the official documentation for the command. The blog post you found that had good SEO may be helpful but it is almost certainly not as complete as the documentation from the actual developers/maintainers.
  • Check the CS wiki. Search, and make sure to click "Everything" on the search results page to make sure pages filed under "Sysadmin:" are visible.
  • Try an identical/similar command on a different machine to see if you get the same behavior.
  • Check the Internet. The various Stack Exchange Q&A communities - e.g. Stack Overflow, Server Fault - often return specific information, as do forums related to the topic. (Please don't do this one first)
  • Post to the whole group Slack so many people can see it.