Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-user:storage:usb-drives-quickstart [2020/06/13 20:50] – [Procedure] Added manually mount procedure at step 5. sopalajoarrierezdocs:guide-user:storage:usb-drives-quickstart [2020/09/23 22:11] – corrected typo in a command jhench
Line 1: Line 1:
 ====== Quick Start for Adding a USB drive ====== ====== Quick Start for Adding a USB drive ======
  
-Many useful OpenWrt utilities and packages rely on external storage to hold data files.  +**The Goal:** This guide describes how to add a single USB stick or drive to your OpenWrt device. The result will be a USB drive with an **ext4** file system and mounted at **/mnt/sdXX** (where //sdXX// is the name of the USB)
-This guide describes how to add a single USB stick or drive to your OpenWrt device. +
  
-**Note:** If you have a memory limited router (say with 4MBytes Flash internal storage)and want to be able to install more packagesyou should instead read the [[docs:guide-user:additional-software:extroot_configuration|Extroot Configuration]] page. +This is all you'll need for most purposeshoweverthere are plenty of options described below.
- +
-**Note:** For NTFS disks, refer to [[docs:guide-user:storage:writable_ntfs|Writable NTFS]]+
  
 +/* Moved NOTES down to the bottom... */
  
 ===== Requirements ===== ===== Requirements =====
Line 15: Line 13:
   * This procedure **WILL ERASE THE USB DRIVE** (unless you stop at step 5 and just want to mount a preformated drive). Copy any data you care about to another destination.    * This procedure **WILL ERASE THE USB DRIVE** (unless you stop at step 5 and just want to mount a preformated drive). Copy any data you care about to another destination. 
   * This quickstart requires you to [[docs:guide-quick-start:sshadministration | ssh into the router.]]   * This quickstart requires you to [[docs:guide-quick-start:sshadministration | ssh into the router.]]
- 
  
 ===== Procedure ===== ===== Procedure =====
Line 33: Line 30:
     brw-------    1 root     root        8,   1 Feb  4 14:06 /dev/sda1     brw-------    1 root     root        8,   1 Feb  4 14:06 /dev/sda1
  
-If you just want to temporarily (i.e: testing) mount the drive, you can simply: +/* Thanks for contributing the "temporary experiment" language *
- +/* I moved it down to preserve this as a no-options"Just Do This" guide*
-    mkfs /tmp/MyDrive +/*  -richb-hanover */
-    mount /dev/sda1 /tmp/MyDrive +
- +
-Note that, as of OpenWRT v18the Ext4 file system will be autodetected. +
-After finishing reading/writing the drive: +
- +
-    umount /tmp/MyDrive +
- +
-Note that you must umount the drive (or reboot) if you want to mount it using the below procedure, or the system will complain with "already mounted" message.+
  
 6. Make an ext4 filesystem on the USB device using the device name you just discovered. **Note:** Be certain you enter the proper device name - this step will completely erase the device. ++More...|This command creates an ext4 file system on the first partition of the first USB device - /dev/sda1.++ 6. Make an ext4 filesystem on the USB device using the device name you just discovered. **Note:** Be certain you enter the proper device name - this step will completely erase the device. ++More...|This command creates an ext4 file system on the first partition of the first USB device - /dev/sda1.++
Line 52: Line 41:
  
 8. Update the fstab config file to mount all drives at startup. ++More...|**/dev/sda** is mount[0], **/dev/sdb** is mount[1], etc. If you have more than one USB device attached, substitute the proper index (0 or 1 or ...) as needed. This command mounts all drives - named or anonymous.++ 8. Update the fstab config file to mount all drives at startup. ++More...|**/dev/sda** is mount[0], **/dev/sdb** is mount[1], etc. If you have more than one USB device attached, substitute the proper index (0 or 1 or ...) as needed. This command mounts all drives - named or anonymous.++
-<code> uci set fstab.@mount[0].enabled='1' && uci set fstab.@global[0].anon_mount='1' && uci commit</code>+<code>uci set fstab.@mount[0].enabled='1' && uci set fstab.@global[0].anon_mount='1' && uci commit fstab</code>
  
-9. Mount the device (now) and enable the fstab service so the device will be mounted after a reboot.  +9. Mount the device. ++More...|Automount is enabled on boot.++ 
-<code>/sbin/block mount && service fstab enable</code>+<code>/etc/init.d/fstab boot</code>
  
-10. **You're done!** This procedure mounts the drive at **/mnt/sdXX** (whatever the device name was.) The drive is ready to save data at that part of the filesystem. +10. **You're done!** This procedure has mounted the drive at **/mnt/sdXX** (whatever the device name was.) The drive is ready to save data at that part of the filesystem. 
  
  
 ===== More Details ===== ===== More Details =====
  
-If you want more information about this procedure:+More information about this procedure and about USB drives: 
   * You can change the mount point in the web interface, in **System** -> **Mount Points** menu.   * You can change the mount point in the web interface, in **System** -> **Mount Points** menu.
-  * See the [[docs:guide-user:storage:usb-drives| full USB Drive tutorial]]. +  * The [[docs:guide-user:storage:usb-drives| full USB Drive tutorial]] has much more about USB drives
-  * Check the Forum article for background information: [[https://forum.openwrt.org/t/more-on-usb-drive-installation/30695/2]] +  * If you have a memory limited router (say with 4MBytes Flash internal storage), and want to be able to install more packages, you should instead read the [[docs:guide-user:additional-software:extroot_configuration|Extroot Configuration]] page. 
-  * Look at the [[docs/guide-user/storage/fstab|fstab documentation]] to configure from the command line.+  * For NTFS disks, refer to [[docs:guide-user:storage:writable_ntfs|Writable NTFS]] 
 +  * Look at the [[docs/guide-user/storage/fstab|fstab documentation]] to configure from the command line 
 +  * This Forum article also has a lot of background information: [[https://forum.openwrt.org/t/more-on-usb-drive-installation/30695/2]] 
 +  * If you just want to temporarily mount the drive (say, for testing), you can simply enter: '' mkdir /tmp/MyDrive; mount /dev/sda1 /tmp/MyDrive'' Note that, as of OpenWRT v18, the Ext4 file system will be autodetectedAfter finishing the test reading/writing the drive: '' umount /tmp/MyDrive''  
  • Last modified: 2024/11/21 18:29
  • by palebloodsky