By templedf on Oct 01, 2008
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.