Manual:Store - prior to v6.20 release
Applies to RouterOS: v3, v4+, v5, <v6.19
Store manages storage devices used by RouterOS various facilities. Disk management in v6.20 and later is done by Disk menu
Currently Store can be used for:
- Webproxy
- User Manager
- the Dude
This is especially useful for RouterBOARD devices with SD/CF slots - as the built-in storage is quite small, an external drive comes in very handy when you want a big User Manager database.
You can add as many external or secondary drives as you want, and select any number of them for each of the mentioned feature use. For example User Manager could be used on 3 disks, one of them would be the active database, and the rest would be backups. You can then add a fourth disk, copy the active data to it - unplug it - and move to another server, to keep using the actual database.
This means migration and backup made easy!
Note: For proper operation router needs to be rebooted after adding or removing external storage.
Creating a Store instance
[normis@demo.mt.lv] /store> print Flags: X - disabled, A - active # NAME TYPE DISK STATUS 0 A web-proxy1 web-proxy system active [normis@demo.mt.lv] /store> add activate comment copy-from disabled name disk type [normis@demo.mt.lv] /store> add name=webproxy_backup disk=disk1 type=web-proxy activate=no
This will add a new storage place for Webproxy on disk1, and will set it as inactive.
Activate new store instance to save proxy cache on secondary disk (other proxy settings configured separately from /ip proxy menu),
[normis@demo.mt.lv] > store activate webproxy-backup
E.g. RB1000 with populated CF Card slot and User Manager, one can add the CF card for use by User manager to store all it's data as follows
/store add disk=CF1 type=user-manager activate=yes
Store management
Sub-menu: /store
Properties
Property | Description |
---|---|
activate (yes | no; Default: no) | Whether to activate this store as primary. |
comment (string; Default: ) | Short description of an item. |
disabled (yes | no; Default: no) | Whether to disable store. |
disk (string; Default: ) | Name of the disk (from /store disk menu) used by this store. |
name (string; Default: ) | Descriptive name of the store |
type (user-manager | web-proxy; Default: ) | Configured type of the store. Two options are available, either store is used by web-proxy or by user-manager. |
Read-only Properties
Property | Description |
---|---|
status (backup | active | invalid) | Current status of the store. Shows whether store is used as backup,active or some of the config is invalid. |
Menu specific commands
Property | Description |
---|---|
activate (<store_name>) | Makes specified store as active if previously was in backup state. |
Disk management
Sub-menu: /store disk
Read-only Properties
Property | Description |
---|---|
free-space (integer [KiB]) | Shows the free space left on the disk. |
name (string) | Name of the disk |
status (strung) | Shows the current status of the disk, can be ready, formating etc. |
system (yes | no) | Shows whether disk is used as system drive |
total-space (integer [KiB]) | Shows total available disk space |
Menu specific commands
Property | Description |
---|---|
check-drive (<drive_name>) | Check the drive for errors. |
clean-drive (<drive_name>) | Clean the drive |
format-drive (<drive_name>) | Format the file system in usable by RouterOS file system. |
Note: Before using drive as a storage device it must be formatted. Before doing so, make sure that all sensitive data is backed up.