|
|
| Line 1: |
Line 1: |
| − | {{Top}}
| |
| | | | |
| − | <big>The Hubitat Diagnostic Tool is a built-in application of every Hubitat Elevation hub, which runs independently of the main platform and provides owners with helpful tools to restore the hub platform, set the date and time, reboot, safely shutdown, temporarily disable apps, drivers or devices that may be causing issues, or to reset the hub. While several of these functions are accessible through the hub user interface, they are duplicated here in situations where accessing the hub user interface isn't possible.</big> | + | <big>'''We're moving!''' Please visit http://docs2.hubitat.com for the latest documentation.</big> |
| | | | |
| − | ===<big>Accessing the Hubitat Diagnostic Tool</big>===
| + | <big> |
| − | | + | This document is available at: http://docs2.hubitat.com/en/user-interface/advanced-features/hubitat-diagnostic-tool |
| − | #<big>Navigate to '''http://[Your Hub IP]:8081/''' and you will see the Hubitat Diagnostic Tool* main page.</big>
| + | </big> |
| − | #*<big>'''NOTE''': Replace [Your Hub IP] with the IP address of your hub</big>
| |
| − | #*<big>'''NOTE''': You must use the IP address. A hostname will not work.</big>
| |
| − | #<big>Choose the option you require. If you are not already logged in, you will be prompted to log in.</big>[[File:Diagnostic Tool 1.0.81.png|none|thumb|1043x1043px|link=https://docs.hubitat.com/images/e/ea/Diagnostic_Tool_1.0.81.png
| |
| − | ]]
| |
| − | #*<big>'''IMPORTANT''': For your privacy protection, the login is set to timeout periodically. If you see '''Error 401''' displayed, please '''Log Out''' of the Diagnostic Tool, then close all your browser's windows and log back in using the hub's MAC address. The password is the MAC address which you can find by going to '''Settings''' in your Hubitat Web Interface and choosing [[Hub Details]]. If you are unable to access your hub from the Hubitat Web Interface, you can find the MAC address printed on a sticker on the bottom of your hub.</big>[[File:Diag Tool Login v2.png|none|thumb|378x378px|link=https://docs.hubitat.com/images/5/50/Diag_Tool_Login_v2.png
| |
| − | ]][[File:Hub Diag Tool Login v2.png|none|thumb|378x378px|link=https://docs.hubitat.com/images/1/16/Hub_Diag_Tool_Login_v2.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Restore Previous Version</big>===
| |
| − | <big>Returns the hub platform to the previous version with the existing database intact. If you experience issues with your hub and suspect a recent update, this is the first step to test for issues related to a recent release.</big>
| |
| − | [[File:Diag Tool-Restore Previous v2.png|none|thumb|383x383px|link=https://docs.hubitat.com/images/5/5f/Diag_Tool-Restore_Previous_v2.png
| |
| − | ]]
| |
| − | [[File:Roll Back to Previous v2.png|none|thumb|414x414px|link=https://docs.hubitat.com/images/9/9b/Roll_Back_to_Previous_v2.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Set Hub Date and Time</big>===
| |
| − | <big>If you are unable to [[Hub Details|synchronize the hub date and time]] with your browser from the hub user interface, you can do it from the diagnostic tool.</big>
| |
| − | [[File:Diag tool-Set date and time.png|none|thumb|391x391px|link=https://docs.hubitat.com/images/6/6a/Diag_tool-Set_date_and_time.png
| |
| − | ]]
| |
| − | | |
| − | #<big>Press the '''Update Time''' button to set your hub time, to be in sync with your browser time.</big>
| |
| − | #<big>Select the '''refresh''' button to see the change.</big>[[File:Date and time on hub.png|none|thumb|423x423px|link=https://docs.hubitat.com/images/5/58/Date_and_time_on_hub.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Reboot Hub</big>===
| |
| − | <big>If the Hubitat Web Interface is unresponsive, you can try rebooting from the diagnostic tool.</big>
| |
| − | [[File:Diag tool-Reboot Hub.png|none|thumb|391x391px|link=https://docs.hubitat.com/images/c/cc/Diag_tool-Reboot_Hub.png
| |
| − | ]]
| |
| − | [[File:Reboot hub confirmation.png|none|thumb|373x373px|link=https://docs.hubitat.com/images/a/ac/Reboot_hub_confirmation.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Shutdown Hub</big>===
| |
| − | <big>If the Hubitat Web Interface is unresponsive, you can try shutting down your hub from the diagnostic tool.</big>
| |
| − | | |
| − | <big>'''IMPORTANT''': Make sure the light on the front of your hub is <span style="color: red;;">'''Red'''</span>, and then unplug your hub from its power source for a '''minimum of 30 seconds''' before plugging it back in. To avoid stressing the micro USB connection, it is recommended that power be removed from the hub by unplugging the power adapter from the outlet instead of the hub.</big>
| |
| − | [[File:Diag tool-Shutdown hub.png|none|thumb|391x391px|link=https://docs.hubitat.com/images/0/00/Diag_tool-Shutdown_hub.png
| |
| − | ]]
| |
| − | [[File:Shutdown hub confirmation.png|none|thumb|376x376px|link=https://docs.hubitat.com/images/5/5f/Shutdown_hub_confirmation.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Safe Mode</big>===
| |
| − | <big>If you find yourself in the situation where an app such as a Rule Machine rule has been mistakenly built in a way that creates a loop and cannot be deleted from the Hubitat Web Interface, the hub may be restarted into Safe Mode. This disables User and Built-In apps and devices, the scheduler is halted, the listener for LAN messages is stopped, connection to the Hubitat cloud is disabled, the UPnP listener is halted, and all Zigbee and Z-Wave devices are disabled.</big>
| |
| − | [[File:Enable Safe Mode.png|none|thumb|393x393px|link=https://docs.hubitat.com/images/2/2f/Enable_Safe_Mode.png
| |
| − | ]]
| |
| − | [[File:Restart in Safe Mode.png|none|thumb|449x449px|link=https://docs.hubitat.com/images/e/ea/Restart_in_Safe_Mode.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Soft Reset</big>===
| |
| − | <big>A soft reset will remove the main hub's database, allowing users to restore a previous backup. This process does not reset the Zigbee or Z-Wave radios. You could restore a backup after performing a soft reset, so you can continue to control your existing devices. See the '''[[Soft Reset]]''' documentation for more detail.</big>
| |
| − | [[File:Diag Tool-Soft Reset v2.png|none|thumb|383x383px|link=https://docs.hubitat.com/images/a/ac/Diag_Tool-Soft_Reset_v2.png
| |
| − | ]]
| |
| − | [[File:Soft reset confirmation.png|none|thumb|495x495px|link=https://docs.hubitat.com/images/1/11/Soft_reset_confirmation.png
| |
| − | ]]
| |
| − | | |
| − | ===<big>Download Backups</big>===
| |
| − | <big>If the hub user interface is not accessible, you may download previous backups stored on the hub for restore following a '''[[Soft Reset]]''' of the hub.</big>
| |
| − | [[File:Diag Tool 1.0.81 Download Backups v2.png|none|thumb|397x397px|link=https://docs.hubitat.com/images/2/21/Diag_Tool_1.0.81_Download_Backups_v2.png]]
| |
| − | | |
| − | ===Missing Diagnostic Tool===
| |
| − | <big>The following two steps are required if you you do not have the newest '''Hubitat Diagnostic Tool''' installed, or otherwise don't see the '''Download Backups''' option when accessing it from port 8081.</big>
| |
| − | | |
| − | #<big>Navigate to '''http://[Your Hub IP]/hub/cloud/updateDiagnosticTool''' and it will install the latest Hubitat Diagnostic Tool.</big>
| |
| − | #*<big>'''NOTE''': Replace [Your Hub IP] with the IP address of your hub.</big>
| |
| − | #<big>Proceed to '''http://[Your Hub IP]:8081''' and then continue following the steps in this document.</big>
| |
