Skip to content
This repository was archived by the owner on Nov 21, 2018. It is now read-only.

Commit b6ad660

Browse files
author
E. Dunham
committed
Clarify the troubleshooting instructions
1 parent 384b969 commit b6ad660

File tree

1 file changed

+22
-8
lines changed

1 file changed

+22
-8
lines changed

README.md

+22-8
Original file line numberDiff line numberDiff line change
@@ -66,16 +66,30 @@ Pull requests to simplify this workflow are welcome.
6666
# It's broken!
6767

6868
Sometimes the queue gets stuck. The most obvious symptom is if a PR takes
69-
substantially longer than usual to build.
69+
substantially longer than usual to build.
7070

71-
First, check Homu's queue [here](http://buildbot.rust-lang.org/homu/queue/rust).
72-
If Homu hasn't seen the PR, one can repeat the `r+`. If that doesn't work,
73-
restart Homu on the buildmaster.
71+
1) Does Homu know about the PR?
72+
73+
See whether the PR shows up in [Homu's queue](http://buildbot.rust-lang.org/homu/queue/rust).
74+
75+
If the PR is missing from the queue, one can repeat the `r+`. If that doesn't
76+
make it show up after a few minutes, restart Homu on the buildmaster.
77+
78+
2) Did Homu tell Buildbot about the PR?
7479

7580
If the PR is listed as "pending" in the Homu queue, check for pending jobs on
76-
[the grid](http://buildbot.rust-lang.org/grid?branch=auto&width=10). If there
77-
are no pending jobs in the grid, kick Homu by having someone with permissions
78-
on the repo say "@bors: retry force" on the PR that's stuck.
81+
[the grid](http://buildbot.rust-lang.org/grid?branch=auto&width=10).
82+
83+
If there are no pending jobs in the grid, have Homu repeat the request to
84+
Buildbot by having someone with the right permissions say `@bors: retry force`
85+
on the PR that's stuck.
86+
87+
Occasionally, a try build on which `retry force` didn't work will succeed after
88+
[resetting state](https://github.com/rust-lang/rust/pull/30845#issuecomment-171712657)
89+
and bumping the priority with a comment like `@bors r- try- r=nmatsakis
90+
retry force p=1 abc123`
91+
92+
3) Is Buildbot running the PR?
7993

8094
If the grid is aware of the jobs, check for lost buildslaves. When a builder
8195
gets lost, its name will be purple and its status will include "slave lost".
@@ -85,7 +99,7 @@ it needs to be restarted.
8599
If the above steps fail, restart the Buildbot process on the production
86100
buildmaster.
87101

88-
## Homu is broken!
102+
## Homu is dead!
89103

90104
If the Homu status page linked above won't load, something is wrong with Homu.
91105

0 commit comments

Comments
 (0)