##This is theTroubleshooting page for some component
##This page should probably be called ComponentName/Troubleshooting
##Please add errors and solutions as show below.

<<TableOfContents(3)>>

== What To Do When Encountering Errors Running Gazebo Simulator ==

If you encounter an error running gazebo related software, please attempt the following steps first:
  * Check [[http://answers.ros.org/questions/scope:all/sort:activity-desc/query:gazebo/page:1/|Answers for Gazebo related topics]] and see if there's any useful debugging information.
  * If the error appear ticket-worthy, please see below:
   * If the error appears to be ROS related (i.e. [[gazebo|Gazebo ROS API]], [[gazebo_plugins]], [[https://code.ros.org/svn/ros-pkg/stacks/simulator_gazebo/trunk/gazebo/src/|gazebo plugins for ROS]]), please login to your profile on [[https://code.ros.org/trac/ros-pkg/|ros-pkg trac]] and [[https://code.ros.org/trac/ros-pkg/newticket|file a new ticket]].
   * If the error appears to be PR2 related (i.e. related to [[pr2_gazebo_plugins|PR2 Gazebo plugins]], [[pr2_gazebo|PR2 simulation]]), please login to your profile on [[https://code.ros.org/trac/wg-ros-pkg/|wg-ros-pkg trac]] and [[https://code.ros.org/trac/wg-ros-pkg/newticket|file a new ticket]].
   * If the error appears to be unrelated to ROS or PR2, please report new issues on [[https://bitbucket.org/osrf/gazebo/issues/new|Gazebo trac on Bitbucket]].

When filing a ticket or asking a question on answers.ros.org, please include the following information if possible:
  * OS you are using (e.g. Ubuntu Precise 64bit), kernel version (execute `uname -a`) if you are on a linux system.
  * Graphics card and graphics card driver version.
  * Please include the version of simulator_gazebo you are running by executing:
  {{{
cat `rosstack find simulator_gazebo`/CMakeLists.txt
   }}} and look for the version number inside `rosbuild_make_distribution(X.X.X)`.
  * To help potential answering party trace and debug the issue, please include any additional information such as:
    * Post any console outputs related to the error (be generous in copying and pasting what might be relevant to the problem).
    * Obtain a gdb backtrace for the segmentation fault.
      * See [[https://code.ros.org/svn/ros-pkg/stacks/simulator_gazebo/trunk/gazebo_worlds/launch/debug.launch|this example launch file for starting gazebo with gdb]].
      * See [[https://www.google.com/search?q=gdb+tutorial|gdb tutorials]]
    * In general, a way for potential reviewers to reproduce the problem will be helpful.

Thanks!

Lastly, here are some of the [[simulator_gazebo/Troubleshooting/common_diamondback_errors|common errors in older releases of simulator_gazebo prior to Electric]].