aboutsummaryrefslogblamecommitdiffstats
path: root/doc/packages-update.md
blob: b3acf893af56256ecf95bcaf92d8a6ad424862f8 (plain) (tree)
1
2
3
4
5
6
7
8

                    
                                             
 
                                                                               
                                                            
 


                                                                   
                                                                           



                                                                       
                                                                       
                                                                        

                                                                           










                                                                            




                                                                              


                                                                     



                                                                          



                              
                                       


        
                                                    
                                           
                                                                 
                                             
                                                       
                                                                         
   
                                               
Manage system update
====================

[⬅️ Go back to main README](../README.md)

> ℹ️ **Info**: This script can not be used on its own but requires the base
> installation. See [main README](../README.md) for details.

Description
-----------

In rare cases RouterOS fails to properly downlaod package on update
(`/system/package/update/install`), resulting in borked system with missing
packages. This script tries to avoid this situation by doing some basic
verification.

But it provides some extra functionality:

* upload backup to Mikrotik cloud if [backup-cloud](backup-cloud.md) is
  installed
* send backup via e-mail if [backup-email](backup-email.md) is installed
* save configuration to fallback partition if
  [backup-partition](backup-partition.md) is installed
* upload backup to server if [backup-upload](backup-upload.md) is installed
* schedule reboot at night

Requirements and installation
-----------------------------

Just install the script:

    $ScriptInstallUpdate packages-update;

It is automatically run by [check-routeros-update](check-routeros-update.md)
if available.

Configuration
-------------

The configuration goes to `global-config-overlay`, this is the only parameter:

* `PackagesUpdateDeferReboot`: defer the reboot for night (between 3 AM
  and 5 AM)

By modifying the scheduler's `start-time` you can force the reboot at
different time.

> ℹ️ **Info**: Copy relevant configuration from
> [`global-config`](../global-config.rsc) (the one without `-overlay`) to
> your local `global-config-overlay` and modify it to your specific needs.

Usage and invocation
--------------------

Alternatively run it manually:

    /system/script/run packages-update;

See also
--------

* [Upload backup to Mikrotik cloud](backup-cloud.md)
* [Send backup via e-mail](backup-email.md)
* [Save configuration to fallback partition](backup-partition.md)
* [Upload backup to server](backup-upload.md)
* [Notify on RouterOS update](check-routeros-update.md)
* [Automatically upgrade firmware and reboot](firmware-upgrade-reboot.md)

---
[⬅️ Go back to main README](../README.md)  
[⬆️ Go back to top](#top)