Friday 9 May 2008

How error messages are important...

First of all, don't laugh

I had recently tested an app that I wanted to use for my testing purposes. I must add that this app has a Very well and Hard working Support Team. There was a bug which prevented using it in the right way. With help of the support with correcting the app and testing of it on my side, the bug was finally solved.

Back to the story:
This app had an option to establish connection with some bug trackers and report bugs there. But when I added my connection details to configuration and accepted, thre was an error displayed (with the same login data each time !!!) and connection didn't work:

"Can't Connect: Mantis returned an recognized response"
or
" Can't Connect: Wrong usermane or password"
or
" Can't Connect: Connection reset by peer" (here is the short wersion, I don't remember all text displayed there)

Don't you think that it is confusing? Three messages but nothing was changed in config!!! Like random ones.

Nobody knew what caused such errors. After I contacted support, I was asked to add an account in mantis for them. It occured that they can connect and report bugs without any problem, so it had to be something on my side.
I tried disabling security (firewall, antyviral software), starting with clean startup (without any third party apps. Problem still occured.
Next I tried to launch the app on other machine, still the same.
I was so desperate
But Hey!!! Why the support could connect? even one of my QA friends could!!!
Next thing I did was installing another instance of Mantis on my machine and connect to it from localhost, all things were default. And It WORKED!!! Connection worked also from other machine to mine (after opening port in firewall)

But it couldn't be firewall issue becouse the company mantis was visible from all internet by web browser, and the app used the same port to communicate with it.

Resolution:
I compared the default account, the support's one and mine... The problem was, that in profile there were by default disabled options, which I had turned on in mine.

But the error messages did not say that, nor the manual.

I think that even errors Should (!!!) say what's wrong.
And I personally Hate errors like " Unrecognized error (press abort, retry, continue, cancel, ok etc...)

Testing is LIFE...

Addition... now the bug is fixed, and even manual is updated with issue of default options in mantis. There are some new bugs to be fixed, and new bugs to be found... but that is theme for another story...