Required Data: IO issues on Linux

Issue

  • I have found evidences of IO issues with the FileSystem where Jenkins Home is hosted.

Required Data IO issues

This article describes how to collect the minimum required information for troubleshooting IO issues.

If the required data is bigger than 20 MB you will not be able to use ZenDesk to upload all the information. On this case we would like to encourage you to use our upload service in order to attach all the required information.

Environment

Required Data check list

  • Support bundle
  • Output of the script testIO.sh
  • Description of the File System

Support Bundle

A support bundle from the problematic instance ideally when the issue is happening or in the worst case right after the issue is exposed. Please, follow the KB below in case you don’t know how to generate a support bundle.

Output of the script testIO.sh

Download the testIO.sh.

The testIO.sh script will need to be made executable by running:
chmod +x testIO.sh.

Get the IOTest.log by running the testIO.sh script as:

sh testIO.sh <FOLDER> [TIMES] [PERIOD]

As an example: sh testIO.sh /var/lib/jenkins_home 2

The testIO.sh script will execute Write and Write/Read test a number of [TIMES] times every [PERIOD].

To find the expected values for this script, see: IO Troubleshooting on Linux.

Description of the File System

  • Output from df -H for the Host File System.
  • In the case your JENKINS_HOME is mounted on a Share File System, please let as know its technology (NFS, EFS, etc.) and it version (NFSv3, etc.).
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.