Troubleshooting my Configuration Management installation

My new assignment had me searching for troubleshooting information and I hit the jackpot

Have you ever solved a particularly nasty bug or fixed a problem while writing an email to a co-worker about the problem? Merlin Mann of 43folders has a great post describing how to Solve problems by writing a note to yourself. Basically, as Merlin says, “concentrate on coolly describing exactly what you want to accomplish as well as what happens when you try the approach that hasn’t been working for you.”

As a writer, I can identify with this way to communicate a problem because it always helps me to record my thoughts in writing. Time and time again I have stored drafts of an email to my fellow information architect about a DITA catalog issue or other such minor problems where I figured out the solution while drafting the email. Usually by removing myself from the frustration and breaking down the problem into searchable bits, I remember something critical or I discover the missing piece of information that was blocking my progress.

Austin Powers I’ve also read that pair programmers will position a cardboard cutout in their workspace so that they can describe a problem to the cardboard cutout in such a way that the answer reveals itself. This paper calls it a Sidebrain: a sidekick for the programmer’s brain, hee hee. We used to have an Austin Powers cardboard cutout, but he didn’t seem insightful enough for me to try this approach.

I can laugh at this tonight, but today I learned the hard way that there is a big difference between troubleshooting installing the CCM (Change and Configuration Management) solution and installing the CM (Configuration Management) product. That one little C adds a layer of complexity that I just wasn’t ready to work with today. I am installing the Configuration Management as a baby step to understanding all the interdependencies with the CCM solution. Even still, the email I wrote out trying to describe my problem about CM (while the recipient thought I was talking about CCM) helped to clarify the mystery of the extraneous C. My Google searches at BMC led me to a wonderful Diagnostic and Troubleshooting Guide that had the exact troubleshooting information I needed for why my Configuration Management Tuner won’t start, and I wanted to share it here in case it helps someone else.

One comment

  • January 26, 2010 - 4:57 pm | Permalink

    I have done this so many times – write for help and solve the problem on my own! I credit my mom for this. She never helped me with any school problems or life problems! (She was a school teacher.) When I came to her with my questions, she’d ask, “explain a bit about your problem.” I’d do so… and I would always stumble upon the answer in the process. She never had to do a thing.

    I did this several times on the Lone Writer SIG discussion list. I finally wrote a mail to the list thanking them for their invisible help! Often when I write these never-sent mails, I think of the recipient. I imagine they are in the room with me, and I explain the problem in detail. I also imagined a former boss looking over my shoulder and asking questions. (His questions were excellent.) The visualization of someone to talk to is the key for me (I think).

  • Leave a Reply