1. Read this document.  Oh, I see you are doing it!  Great!
2. Make sure you have permission to submit CLs to the Chromium OS gerrit repositories.
3. Install helpful extensions.

What should I do when I report for duty?

1. Sign on to irc.freenode.net / #chromium-os, and introduce yourself as an on-duty sheriff.
2. Pull up the public and internal (overview) Chrome OS buildbot waterfalls.  If the status is out of date, update it.
3. Take a look at the Test Dashboard for our Build Verification Tests. Try to triage any failures; do the same with autotest failure emails you receive during your shift. See the section titled "How should I handle BVT failures?", below for more details.
4. Read the email from yesterday’s Sheriffs and/or look at the Chromium OS sheriff log, and familiarize yourself with the TreeCloser issues they cite.
5. Proactively ensure that the tree will never be unattended by checking that your co-sheriff will be able to cover you during any meetings you have during the day.  If needed, rope someone else on IRC into covering.
6. Be prepared to get in touch with Chrome sheriffs in case chrome build is misbehaving. See their sheriff names published at http://build.chromium.org/p/chromium/console

What should I do as I prepare to end my shift?

Ahh, the tree is green.  I can go back to my work, right?

Postmortem?  What is that, and why do we do it?

I am a noob, starting my shadowing shift.  What do I need to do?

How do I find out about build failures?

How do I deal with build failures?

How do I access builder machines?

How can I revert a broken commit?

If you've found a commit that broke the build, you can revert it using these steps:

1. Find the Gerrit link for the change in question
• Gerrit lists recently merged changes. View the change in question.
• In some cases (like the PFQ), you can see links to the CL that made it into the build straight from the waterfall. We’re working making this even better.
2. Click the “Revert Change” button and fill in the dialog box.
1. The dialog box includes some stock info, but you should add on to it. e.g. append a sentence such as: This broke the tree (xxx package on xxx bot).
3. You are not done.  This has created an Open change for _you_ go find and submit it.
• Add the author of the change as a reviewer of the revert, but push without an LGTM from the reviewer (just approve yourself and push).

How do I investigate VMTest failures?

If there is a failure in the VMTest stage, first click on the stdio link and scan the output. There may be a legitimate failure in one of the test stages. 

Frequently however there will be a message like this:

login_CryptohomeMounted            [  FAILED  ]
login_CryptohomeMounted              FAIL: Unhandled JSONInterfaceError: Automation call {'username': 'performancetestaccount@gmail.com', 'password': 'perfsmurf', 'command': 'Login'} received empty response.  Perhaps the browser crashed.

In this case chrome failed to login for any of the 3 reasons: 1) could not find network, 2) could not get online, 3) could not show webui login prompt. Look for chrome log in /var/log/chrome/chrome, or find someone who works on UI.

And/or the following output:

Crashes detected during testing:
----------------------------------------------------------
chrome sig 11
  login_CryptohomeMounted

If there is a crash, proceed to the next section, "How to find test results/crash reports"?

How to find test results/crash reports?

The complete results from VMTest runs are available on googlestorage, by clicking the [ Artifacts ] link in-line on the waterfall display in the report section:

 

From there, you should see a file named chrome.*.dmp.txt that contains the crash log. Example

If you see a stack trace here, search for issues with a similar call stack and add the google storage link, or file a new issue.

How do I extract stack traces manually?

Normally, you should never need to extract stack traces manually, because they will be included in the Artifacts link, as described above. However, if you need to, here's how:

1. Download and extract the test_results.tgz file from the artifact (above), and find the breakpad .dmp file.
2. Find the build associated with your crash and download the file debug.tgz
1. Generally the debug.tgz in the artifacts should be sufficient
2. For official builds, see go/chromeos-images
3. TODO: examples of how to find this for cautotest and trybot(?) failures
3. Untar (tar xzf) this in a directory under the chroot, e.g. ~/chromeos/src/scripts/debug
4. From inside the chroot, run the following: minidump_stackwalk [filename].dmp debug/breakpad > stack.txt 2>/dev/null
5. stack.txt should now contain a call stack!

If you successfully retrieve a stack trace, search for issues with a similar call stack and add the google storage link, or file a new issue.

Note that in addition to breakpad dmp files, the test_results.tgz also has raw linux core files. These can be loaded into gdb and can often produce better stack traces than minidump_stackwalk (eg. expanding all inlined frames).

When should I reopen the tree?

• If the build was broken, but a fix has now been checked in, reopen the tree. (There's no need to wait for the tree to cycle green: If the build fails, you can just close the tree again.)
  
• If the buildbot ran into an intermittent issue, but should run cleanly the next time, reopen the tree.

• If the build was broken, and a fix has not been checked in, we should leave the tree closed.
  
• If it's not possible to browse the web with the current build, and a fix has not been checked in, we should leave the tree closed.
  

INFO: Waiting for uploads...

INFO: RunCommand: ['/b/build_internal/scripts/slave-internal/autotest_rpc/autotest_rpc_client.py', 'master2', 'RunSuite', '-i', 'x86-alex-release/R19-2007.0.0-a1-b1822', '-s', 'bvt', '-b', 'x86-alex', '-p', 'bvt']
try_new_image                        [ PASSED ]
build_RootFilesystemSize             [ PASSED ]

Example of fail output

platform_ToolchainOptions            [ FAILED ]
platform_ToolchainOptions              FAIL: The following tests failed. If you expected the test to pass you may have stale binary prebuilts which are causing the failure. Try clearing binary prebuilts and rebuilding by  running: ./setup_board --board=... --force
platform_FilePerms                   [ PASSED ]

How can I pin Chrome to an older version?

• First, send an email to the chromeos-tpms@ internal mailing list letting them know that you are pinning Chrome to an older version.
• Next, determine what git push brought in the broken version of Chrome, using the tools at your disposal: the waterfall, git log, and your brain.  Identify the git hash associated with that push, and the Chrome version that came before that push.  Let's assume that the following is what you were looking for in git log:

• The above is the push from chrome-bot marking chromeos-chrome-14.0.790.0_rc-r1 as stable, moving from the previous version chromeos-chrome-14.0.789.0_rc-r1.  Note the latter version as well as the git hash associated with the above push.

• Create a branch in the ~/chromiumos/src/third_party/chromiumos-overlay project for this change:

• Edit the file at ./profiles/targets/chromeos/package.mask so that the following lines appear (stick it at the end if there isn't an existing one):

• Now you must retrieve the ebuild for this Chrome version from before the offending push:

• Most importantly, you need to comment out the line in profiles/targets/chromeos/package.mask (notice the addition of a single #, emboldened for clarity):