Bonsai!

I recently rediscovered a hidden qconf option. I remember talking with the engineer when he implemented the option years ago, but because it was never documented, I forgot that it existed. A recent customer eval reminded me that it's there, and I think it's one worth sharing.

The hidden option is qconf -bonsai. It is a human-readable equivalent of qconf -sstree, which if you've looked at you'll know isn't even remotely human-readable. It prints the current share tree configuration using spacing to represent hierarchy.

Let's look at an example. This is the output from qconf -sstree for my home test cluster:

# qconf -sstree
id=0
name=Root
type=0
shares=1
childnodes=1
id=1
name=sge
type=0
shares=1000
childnodes=2,3
id=2
name=root
type=0
shares=400
childnodes=NONE
id=3
name=default
type=0
shares=200
childnodes=NONE

This is the output from qconf -bonsai for the same cluster:

# qconf -bonsai
Root=1
   sge=1000
      root=400
      default=200

Now, as for why it's an undocumented feature, I suspect it's historical. It was originally added on a whim by one of the engineers and was just never fully embraced. I remember there being talk about changing the name of the switch and making it a documented feature, but I suspect that plan just got lost in the shuffle.

Comments:

The -bonsai option has since been officially exposed as -stree. -bonsai is still there, though.

Posted by Daniel Templeton on July 19, 2009 at 11:19 PM PDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

templedf

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today