Added logging and documentation

Log a puppet debug message when we have to retry the ssh connection
to device.
Removed an accidental return statement after a "raise".
Added some documentation saything the the update_status? method will throw exception
when the firmware update is in failed state