Difference between revisions of "Care and Maintenance"

From Hubitat Documentation
Jump to: navigation, search
Line 14: Line 14:
 
#<big>Accept the Terms of Service.</big>
 
#<big>Accept the Terms of Service.</big>
 
#:[[File:Agree to TOS before update.png|434x434px|link=https://docs.hubitat.com/images/b/b9/Agree_to_TOS_before_update.png ]]
 
#:[[File:Agree to TOS before update.png|434x434px|link=https://docs.hubitat.com/images/b/b9/Agree_to_TOS_before_update.png ]]
#<big>Your hub will go through the installation process automatically. This process may take several minutes. When the install is complete, your hub will restart.</big>[[File:Hub update downloading.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/90/Hub_update_downloading.png ]][[File:Hub update verifying.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/2d/Hub_update_verifying.png ]][[File:Hub update extracting.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/8/8f/Hub_update_extracting.png ]][[File:Hub update applying.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/e/eb/Hub_update_applying.png ]][[File:Hub starting up.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/24/Hub_starting_up.png]]
+
#<big>Your hub will go through the installation process automatically. This process may take several minutes. When the install is complete, your hub will restart.</big>[[File:Hub update downloading.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/90/Hub_update_downloading.png |alt=The hub will first download the hub platform update.]][[File:Hub update verifying.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/2d/Hub_update_verifying.png |alt=After the hub platform update is downloaded, it will be verified]][[File:Hub update extracting.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/8/8f/Hub_update_extracting.png |alt=When the hub update has been successfully verified, it will begin extracting in preparation for the update]][[File:Hub update applying.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/e/eb/Hub_update_applying.png |alt=The hub update is applied in the final stage of the process]][[File:Hub starting up.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/24/Hub_starting_up.png|alt=When the hub platform update has been successfully applied, the hub will automatically restart.]]
  
 
===<big>How to Shut Down Your Hub</big>===
 
===<big>How to Shut Down Your Hub</big>===
Line 21: Line 21:
 
#<big>Go to the '''Settings''' page of your hub.</big>
 
#<big>Go to the '''Settings''' page of your hub.</big>
 
#<big>Select '''Shutdown Hub'''.</big>
 
#<big>Select '''Shutdown Hub'''.</big>
#:[[File:Shutdown hub v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/08/Shutdown_hub_v3.png ]]
+
#:[[File:Shutdown hub v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/0/08/Shutdown_hub_v3.png |alt=To safely shutdown your hub, press the "Shutdown hub" card found on the settings page of your hub.]]
 
#<big>Wait until the LED on your hub turns '''<span style="color: red;;">Red</span>'''. It is now safe to unplug your hub. To restart your hub, simply plug it back in and wait for the LED to turn '''<span style="color: green;;">Green.</span>'''</big>
 
#<big>Wait until the LED on your hub turns '''<span style="color: red;;">Red</span>'''. It is now safe to unplug your hub. To restart your hub, simply plug it back in and wait for the LED to turn '''<span style="color: green;;">Green.</span>'''</big>
  
Line 29: Line 29:
 
#<big>Go to the '''Settings''' page of your hub.</big>
 
#<big>Go to the '''Settings''' page of your hub.</big>
 
#<big>Choose '''Reboot Hub'''.</big>
 
#<big>Choose '''Reboot Hub'''.</big>
#:[[File:Reboot hub v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/e/ea/Reboot_hub_v3.png ]]
+
#:[[File:Reboot hub v3.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/e/ea/Reboot_hub_v3.png |alt=To reboot your hub, press the "Reboot hub" card found on the Settings page of your hub.]]
 
#<big>You will be asked to confirm the reboot. The hub will then automatically cycle through its rebooting process. After a few minutes, hit refresh on your browser and you'll be back in business.</big>
 
#<big>You will be asked to confirm the reboot. The hub will then automatically cycle through its rebooting process. After a few minutes, hit refresh on your browser and you'll be back in business.</big>
  
Line 38: Line 38:
  
 
#<big>Select '''Settings''' in the sidebar of your hub.</big>
 
#<big>Select '''Settings''' in the sidebar of your hub.</big>
#<big>Press the '''Backup and Restore''' card.</big>[[File:Backup and Restore card 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/fd/Backup_and_Restore_card_3.0.png ]]
+
#<big>Press the '''Backup and Restore''' card.</big>[[File:Backup and Restore card 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/fd/Backup_and_Restore_card_3.0.png |alt=To begin backup of your hub database, press the "Backup and Restore" card found on the Settings page of your hub.]]
#<big>Select the '''Download''' button under the '''Create New Backup and Download Manually''' section (you can also download any of the automatic backups that have been stored). The backup will be saved on your computer, which can be uploaded later to restore your hub to a previous state if you desire.</big>[[File:Backup manually and download auto backup.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c2/Backup_manually_and_download_auto_backup.png ]]
+
#<big>Select the '''Download''' button under the '''Create New Backup and Download Manually''' section (you can also download any of the automatic backups that have been stored). The backup will be saved on your computer, which can be uploaded later to restore your hub to a previous state if you desire.</big>[[File:Backup manually and download auto backup.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/c/c2/Backup_manually_and_download_auto_backup.png |alt=On the right of the "Restore" button in the list of hub backups stored, either on the hub itself if in the Hubbitat cloud if you have a Hub Protect subscription, there is a download button. Pressing this button will download the stored backup to your computer from either the hub or the cloud, respectively. Pressing the Download button on the left of the Backup and Restore window will manually download the lasted hub database to a backup file on your computer.]]
#<big>You may set the time for when database maintenance and backup to take place</big>.[[File:Set local backup time and frequency.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/2f/Set_local_backup_time_and_frequency.png ]]
+
#<big>You may set the time for when database maintenance and backup to take place</big>.[[File:Set local backup time and frequency.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/2/2f/Set_local_backup_time_and_frequency.png |alt=You can change the default Database cleanup and backup time from 2:15am to whenever you prefer. You can also set the backup frequency, if perhaps you feel "Daily" is too frequent for backup.]]
  
#<big>You may also set the frequency for automatic backups.</big>[[File:Local backup frequency options.png|none|thumb|329x329px|link=https://docs.hubitat.com/images/c/c6/Local_backup_frequency_options.png ]]
+
#<big>You may also set the frequency for automatic backups.</big>[[File:Local backup frequency options.png|none|thumb|329x329px|link=https://docs.hubitat.com/images/c/c6/Local_backup_frequency_options.png |alt=The choices for how frequent the backup should occur include, "Daily", "Every other day", "Every three days", "Every five days", "Weekly", "Every two weeks", "Every three weeks", "Every four weeks", or you may choose "Disabled" and automatic backup of your hub database will not occur at all.]]
  
 
===<big>How to restore from backup</big>===
 
===<big>How to restore from backup</big>===
Line 48: Line 48:
  
 
#<big>Select '''Settings''' in the sidebar of your hub.</big>
 
#<big>Select '''Settings''' in the sidebar of your hub.</big>
#<big>Press the '''Backup and Restore''' card.</big>[[File:Backup and Restore card 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/fd/Backup_and_Restore_card_3.0.png ]]
+
#<big>Press the '''Backup and Restore''' card.</big>[[File:Backup and Restore card 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/f/fd/Backup_and_Restore_card_3.0.png |alt=To begin a restore of your hub database, press the "Backup and Restore" card found on the Settings page of your hub.]]
#<big>If you want to restore from one of the automatic backup files, select the '''Restore''' button for the database backup you want to restore to your hub.</big>[[File:Restore from backup on hub 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/5/57/Restore_from_backup_on_hub_3.0.png ]]
+
#<big>If you want to restore from one of the automatic backup files, select the '''Restore''' button for the database backup you want to restore to your hub.</big>[[File:Restore from backup on hub 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/5/57/Restore_from_backup_on_hub_3.0.png |alt=On the right side, in the list of hub backups stored, either on the hub itself if in the Hubbitat cloud if you have a Hub Protect subscription, there is a "Restore" button for each available Hub database backup. Pressing one of them will automatically restore that database snapshot, and your hub will revert to the state if was in at the time of that backup.]]
#<big>If you want to restore the hub database from a backup file saved on your computer, select the '''Restore File''' button and choose the backup file you want to use.</big>[[File:Restore from locally saved backup 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/98/Restore_from_locally_saved_backup_3.0.png ]]
+
#<big>If you want to restore the hub database from a backup file saved on your computer, select the '''Restore File''' button and choose the backup file you want to use.</big>[[File:Restore from locally saved backup 3.0.png|none|thumb|600x600px|link=https://docs.hubitat.com/images/9/98/Restore_from_locally_saved_backup_3.0.png |alt=If you have a database backup file stored locally on your computer, you can press the "Choose file button" on the left side of the Backup and Restore page to select the file, the press the "Restore file" button be begin restoring you hub database to the state it was in when the backup file you have selected was saved. ]]
 
#<big>Confirm the restore selection, and your Hubitat Elevation hub will return to the previously saved state.</big>__FORCETOC__
 
#<big>Confirm the restore selection, and your Hubitat Elevation hub will return to the previously saved state.</big>__FORCETOC__

Revision as of 21:06, 1 April 2021

Go to the top of the page

It is important to remember that your Hubitat Elevation hub is a computer and should be treated as such. This means you must shut down your hub down safely using Shutdown Hub from the Settings page, keep it updated with the latest platform updates, and store backups locally on a regular basis.

Because of our belief in local processing and maintaining your personal privacy, Hubitat Elevation does not push updates onto your hub. It is strongly recommended you regularly update your hub with the latest software so you will always have the latest features and security protection.

How to update your hub

  1. If a notification is shown in the message center, check to see if a platform update is available for your hub.
    The message center at the top right of your browser window will indicate if a hub update is available.
  2. Select Settings in the sidebar of your hub and press the Check for Updates card.
    Even if the system messages doesn't show an indication, you can check for the most recently available hub platform update by pressing the "Check for Updates" card on the Settings page of your hub.
  3. It's recommended that you first download a backup of your current database before updating the hub.
    • NOTE: It is not mandatory that you update your hub. The choice is yours alone. If you choose to update, you can view the release notes in the update window or at a later time by visiting the Platform Release Notes.
      If an update is available, you will be presented with the currently installed hub platform version, the new version that is now available, and release notes. Pressing the "Update Hub" button in this window will start the update. However, it is recommended that you first press the "Download Latest Backup" button just to the right of the "Update Hub" button. This will ensure that you have a local backup of your hub database readily available if anything should not function as expected during or following the hub platform update.
  4. Accept the Terms of Service.
    Agree to TOS before update.png
  5. Your hub will go through the installation process automatically. This process may take several minutes. When the install is complete, your hub will restart.
    The hub will first download the hub platform update.
    After the hub platform update is downloaded, it will be verified
    When the hub update has been successfully verified, it will begin extracting in preparation for the update
    The hub update is applied in the final stage of the process
    When the hub platform update has been successfully applied, the hub will automatically restart.

How to Shut Down Your Hub

Occasionally you may want to move your hub or power it down. It is important to shut it down properly to keep it running smoothly when you power it back up. Here’s how:

  1. Go to the Settings page of your hub.
  2. Select Shutdown Hub.
    To safely shutdown your hub, press the "Shutdown hub" card found on the settings page of your hub.
  3. Wait until the LED on your hub turns Red. It is now safe to unplug your hub. To restart your hub, simply plug it back in and wait for the LED to turn Green.

How to Reboot Your Hub

If your hub is not performing as expected, there's a good chance that a reboot may be required. To reboot properly:

  1. Go to the Settings page of your hub.
  2. Choose Reboot Hub.
    To reboot your hub, press the "Reboot hub" card found on the Settings page of your hub.
  3. You will be asked to confirm the reboot. The hub will then automatically cycle through its rebooting process. After a few minutes, hit refresh on your browser and you'll be back in business.

Backup your hub

Your Hubitat Elevation hub automatically generates a backup every day at 2:15am by default, in your local time zone. These backups are stored on the hub for 5 days. After making changes to your hub (adding devices, automations, etc.), it is a good idea to save a manual backup to your computer or the cloud.

  • NOTE: You may backup and restore files from a local disk anytime, but manual and automatic backup to the Hubitat cloud, including restore from cloud backup and Z-Wave radio migration requires a Hub Protect subscription.
  1. Select Settings in the sidebar of your hub.
  2. Press the Backup and Restore card.
    To begin backup of your hub database, press the "Backup and Restore" card found on the Settings page of your hub.
  3. Select the Download button under the Create New Backup and Download Manually section (you can also download any of the automatic backups that have been stored). The backup will be saved on your computer, which can be uploaded later to restore your hub to a previous state if you desire.
    On the right of the "Restore" button in the list of hub backups stored, either on the hub itself if in the Hubbitat cloud if you have a Hub Protect subscription, there is a download button. Pressing this button will download the stored backup to your computer from either the hub or the cloud, respectively. Pressing the Download button on the left of the Backup and Restore window will manually download the lasted hub database to a backup file on your computer.
  4. You may set the time for when database maintenance and backup to take place.
    You can change the default Database cleanup and backup time from 2:15am to whenever you prefer. You can also set the backup frequency, if perhaps you feel "Daily" is too frequent for backup.
  1. You may also set the frequency for automatic backups.
    The choices for how frequent the backup should occur include, "Daily", "Every other day", "Every three days", "Every five days", "Weekly", "Every two weeks", "Every three weeks", "Every four weeks", or you may choose "Disabled" and automatic backup of your hub database will not occur at all.

How to restore from backup

If you have made changes to your hub and want to go back to a previous saved backup, Hubitat Elevation makes it easy.

  1. Select Settings in the sidebar of your hub.
  2. Press the Backup and Restore card.
    To begin a restore of your hub database, press the "Backup and Restore" card found on the Settings page of your hub.
  3. If you want to restore from one of the automatic backup files, select the Restore button for the database backup you want to restore to your hub.
    On the right side, in the list of hub backups stored, either on the hub itself if in the Hubbitat cloud if you have a Hub Protect subscription, there is a "Restore" button for each available Hub database backup. Pressing one of them will automatically restore that database snapshot, and your hub will revert to the state if was in at the time of that backup.
  4. If you want to restore the hub database from a backup file saved on your computer, select the Restore File button and choose the backup file you want to use.
    If you have a database backup file stored locally on your computer, you can press the "Choose file button" on the left side of the Backup and Restore page to select the file, the press the "Restore file" button be begin restoring you hub database to the state it was in when the backup file you have selected was saved.
  5. Confirm the restore selection, and your Hubitat Elevation hub will return to the previously saved state.