Changes

From SME Server
Jump to navigationJump to search
5,722 bytes added ,  14:29, 8 March 2016
m
Gave better formatting to echo output in script.
Line 1: Line 1:  
===USB Disks===
 
===USB Disks===
{{Incomplete}}
+
{{Warning box|NTFS partitions are supported if you install ntfs-3g and ntfsprogs, please use either fat32/vfat or ext2/ext3/ext4}}
 
  −
 
  −
{{Warning box|NTFS partitions are not supported, please use either fat32/vfat or ext2/ext3}}
  −
 
  −
SME will automatically mount connected USB disk drives into the /media folder.
  −
Auto-mounting will be performed based on the specific USB port used to connect your drives unless you use another method to specify mount points.
  −
 
  −
This means that if you insert USB drive 'A', it should auto-mount to /media/usbdisk.  If you now dismount this disk and mount drive 'B' in the same USB port, it, too, will auto-mount to /media/usbdisk.  Additionally, if you connect drive 'A' to another USB port, it may auto-mount to /media/usbdisk1.
  −
 
  −
The easiest way to avoid this behavior is to provide a label for each of your USB drives, and specify the desired mount point in /etc/fstab based on the drive label.
   
====Supported FileSystems====
 
====Supported FileSystems====
=====ext2/ext3=====
+
=====ext2/ext3/ext4=====
 
<ol>
 
<ol>
 
<li> recommended for USB drives intended for use only on SME
 
<li> recommended for USB drives intended for use only on SME
Line 22: Line 12:  
  dumpe2fs -h /dev/sdc1
 
  dumpe2fs -h /dev/sdc1
 
</li></ol>
 
</li></ol>
 +
 +
=====NTFS=====
 +
You can format and use the NTFS if you install from [[epel]] ntfs-3g and ntfsprogs
 +
See the complete features of [https://en.wikipedia.org/wiki/NTFS-3G ntfs-3g]
 +
yum install ntfs-3g ntfsprogs --enablerepo=epel
    
=====fat32/vfat=====
 
=====fat32/vfat=====
Line 27: Line 22:  
</li><li> supported natively by Windows
 
</li><li> supported natively by Windows
 
</li><li> (2^32)-1 byte ( 4GB - 1 byte) maximum file size
 
</li><li> (2^32)-1 byte ( 4GB - 1 byte) maximum file size
</li><li> Windows 2000 ''format'' and Windows XP Setup's ''format'' will not create a fat32 volume larger than 32 GB
+
</li><li>Requires occasional defragmentation for optimal speed
 
</li><li> Maximum disk size dependent on cluster size.  32KB Clusters would allow a disk of approximately 8TB</li></ol>
 
</li><li> Maximum disk size dependent on cluster size.  32KB Clusters would allow a disk of approximately 8TB</li></ol>
    
====Identifying your USB drive====
 
====Identifying your USB drive====
 +
See [[USBDisks#USB_on_SME_8|USB_on_SME_8]] for SME 8 servers.
 +
 
After connecting your USB drive, execute the command
 
After connecting your USB drive, execute the command
 
  mount
 
  mount
Line 47: Line 44:     
====Formatting your USB drive====
 
====Formatting your USB drive====
=====ext3=====
+
=====ext2/ext3/ext4=====
 
<ol></li><li>Copied with slight changes from [[Affa#Alternatively_setup_a_USB_drive]]
 
<ol></li><li>Copied with slight changes from [[Affa#Alternatively_setup_a_USB_drive]]
 
</li><li>Connect a USB hard disk to the USB Bus. Now you must determine what device the kernel has assigned to the drive. View the /var/log/message and search for ''Initializing USB Mass Storage driver''. A few lines below you'll find the name of the device. In this example it is ''sdc''. Replace ''/dev/sdc'' by ''your device'' in following instructions.
 
</li><li>Connect a USB hard disk to the USB Bus. Now you must determine what device the kernel has assigned to the drive. View the /var/log/message and search for ''Initializing USB Mass Storage driver''. A few lines below you'll find the name of the device. In this example it is ''sdc''. Replace ''/dev/sdc'' by ''your device'' in following instructions.
 
Use the fdisk program to create a linux partition
 
Use the fdisk program to create a linux partition
 
  fdisk /dev/sdc
 
  fdisk /dev/sdc
You'll most likely find an existing vfat dos partition, which you have to delete first. In the following we assume, that you have created a single partition ''/dev/sdc1''.
+
You'll most likely find an existing vfat dos partition, which you have to delete first. Refer to http://wiki.contribs.org/AddExtraHardDisk#Partitioning_the_disk for steps to create a partition. In the following we assume, that you have created a single partition ''/dev/sdc1''.
 
</li><li>Now format the drive with an ext3 filesystem
 
</li><li>Now format the drive with an ext3 filesystem
  mkfs.ext3 -L MyLabel /dev/sdc1
+
  mkfs ext3 -L MyLabel /dev/sdc1
 +
</li><li>or format the drive with an ext4 filesystem
 +
mkfs ext4 -L MyLabel /dev/sdc1
 
</li><li>Make the mount point
 
</li><li>Make the mount point
  mkdir -p /mnt/affadevice
+
  mkdir -p /media/usbdevice
 
</li><li>Customize /etc/fstab as shown here: [[USBDisks#Customizing_fstab|Customizing fstab]]
 
</li><li>Customize /etc/fstab as shown here: [[USBDisks#Customizing_fstab|Customizing fstab]]
 
</li><li>Mount the drive
 
</li><li>Mount the drive
 
mount reads /etc/fstab to look for instructions on what to do if not specifically told on the command line.  After updating /etc/fstab as recommended, you can "mount" your USB disk reliably by specifying either the target directory:
 
mount reads /etc/fstab to look for instructions on what to do if not specifically told on the command line.  After updating /etc/fstab as recommended, you can "mount" your USB disk reliably by specifying either the target directory:
  mount /mnt/affadevice
+
  mount /media/usbdevice
 
or the disk label:
 
or the disk label:
 
  mount LABEL=MyLabel
 
  mount LABEL=MyLabel
</li><li>Crosscheck your work using the df command
+
</li><li>Crosscheck your work using  
df</li></ol>
+
df -h
 +
</li></ol>
 +
 
 +
=====fat32/vfat=====
 +
You can format your drive from your SME server using
 +
mkfs.vfat -n MyLabel /dev/sdd1
 +
Since this command will '''destroy irretrievably''' all information on the specified device (/dev/sdd1 in this case), be very sure you know exactly which device is the drive you want to format!
   −
=====vfat=====
+
=====NTFS=====
It's probably easier to format your vfat drive on your windows system.  You *must* have one, or you wouldn't be using this format... Be however aware of the 32GB limit when formatting from WIN2K or XP using MS native formatting tools.  For additional information, check: http://www.ridgecrop.demon.co.uk/index.htm?fat32format.htm
     −
If that sounds unhelpful, you could try ('''warning, untested!'''):
+
You can format and use the NTFS if you install from [[epel]] ntfs-3g and ntfsprogs
  mkfs.vfat -n MyLabel /dev/sdd1
+
  yum install ntfs-3g ntfsprogs --enablerepo=epel
 +
 
 +
then
 +
  mkfs.ntfs -n MyLabel /dev/sdd1
 +
Since this command will '''destroy irretrievably''' all information on the specified device (/dev/sdd1 in this case), be very sure you know exactly which device is the drive you want to format!
    
====labeling your USB drive====
 
====labeling your USB drive====
=====ext3=====
+
Only required if you didn't label your drive using the previous section.
 +
 
 +
=====ext2/ext3/ext4=====
 
  e2label /dev/sdd1 MyLabel
 
  e2label /dev/sdd1 MyLabel
=====vfat=====
+
 
Linux uses 'mtools' to manage FAT, FAT32, and VFAT partitions.  'mtools' uses drive letters to access devices.  These drive letters must be defined in /etc/mtools.conf before any of the mtools will work.  You can create a definition for your USB drive using a command like this one (be sure to replace /dev/sdd1 with the device name identified above for your USB drive!):
+
=====fat32/vfat=====
 +
'''mtools'''
 +
 
 +
SME includes 'mtools' which can be used to manage FAT, FAT32, and VFAT partitions.   
 +
 
 +
'mtools' uses drive letters instead of device names to access devices.  These drive letters must be defined in /etc/mtools.conf before any of the mtools will work.   
 +
 
 +
You can add your USB drive to /etc/mtools.conf using a command like the one shown below. However,
 +
* be sure to replace /dev/sdd1 with the device name identified above for your USB drive
 +
* be aware that the assigned device may change each time you reconnect your drive or reboot!
 
  echo 'drive e: file="/dev/sdd1"' >> /etc/mtools.conf
 
  echo 'drive e: file="/dev/sdd1"' >> /etc/mtools.conf
   −
Once you have created the drive letter in mtools.conf you can view or edit the disk label using the following commands.
+
Once you have created the drive letter in mtools.conf you can view or edit the disk label using the following commands:
 +
* Show the current label:
 +
mlabel -s e:
 +
* Clear the volume label:
 +
mlabel -c e:
 +
* Assign a new volume label:
 +
mlabel e:MyLabel
 +
 
 +
'''dosfslabel'''
 +
 
 +
SME also includes <code>dosfslabel</code> which appears to be related to labeling "dos" drives.
 +
dosfslabel /dev/sdd1
 +
produces the following output:
 +
Warning: FAT32 support is still ALPHA.
 +
MyLabel
   −
Show the current label:
+
While it is safe to use <code>dosfslabel</code> to check the label on a drive, you should not use it to create or change the label on any drive that contains data you care about.
mlabel -s e:
+
 
 +
====Dual Partitions====
 +
A method to use both ext3 and vfat<br>
 +
eg. an ext3 partition the size of your server, for an rsync backup.<br>
 +
the rest as vfat for easier portability
   −
Clear the volume label:
+
Plug in your drive or check it is unmounted
mlabel -c e:
     −
Assign a new volume label:
+
fdisk /dev/sdd
  mlabel e:MyLabel
+
p - print existing partitions
 +
d - delete partitions
 +
n - create new partitions
 +
p (primary), 1, +160G (the size you want)
 +
n - create 2nd partition
 +
p (primary), 2, return (rest of the disk)
 +
p - print and check
 +
w - write
 +
 +
mkfs.ext3 -L MaxExt3 /dev/sdd1
 +
  mkfs.vfat -n MaxVfat /dev/sdd2
    
====Customizing fstab====
 
====Customizing fstab====
 +
 
Add the following line to the /etc/fstab
 
Add the following line to the /etc/fstab
  LABEL=MyLabel /mnt/affadevice ext3 defaults
+
  LABEL=MyLabel /media/affadevice ext3 defaults
    
* Replace 'ext3' with 'vfat' if your drive is formatted as fat32/vfat.
 
* Replace 'ext3' with 'vfat' if your drive is formatted as fat32/vfat.
* Replace /mnt/affadevice with the folder in which you want your USB drive mounted (here and in all "mount" commands)
+
* Replace 'ext3' with 'ext4' if your drive is formatted as ext4.
 +
* Replace /media/affadevice with the folder in which you want your USB drive mounted (here and in all "mount" commands)
 +
* Make sure that the mount directory (/media/affadevice in this example) exists and is empty!  Linux will not mount a drive in a directory that is not empty.
 +
* Add multiple entries as described in [[USBDisks#The_Solution]] to meet your specific requirements.
 +
 
 +
Or for ntfs
 +
/dev/NTFS-partition /media/affadevice ntfs-3g defaults   0      0
    
====Mount your disk automatically at boot-up====
 
====Mount your disk automatically at boot-up====
Line 107: Line 160:     
Once the script exists you can add additional mount commands by editing S95mount_USB using:
 
Once the script exists you can add additional mount commands by editing S95mount_USB using:
  pico -w /etc/e-smith/events/local/S95mount_USB
+
  nano -w /etc/e-smith/events/local/S95mount_USB
    
The 'local' event will run each time your server boots up.  If you connect or disconnect a drive and need to re-mount it you can re-run your auto-mount commands using:
 
The 'local' event will run each time your server boots up.  If you connect or disconnect a drive and need to re-mount it you can re-run your auto-mount commands using:
 
  signal-event local
 
  signal-event local
 +
 +
====Mount your disks automatically when connected====
 +
{{incomplete}}
 +
|Please edit this section to specify how to get SME to automatically mount USB drives when they are connected
 +
====Format limitations when linking disk to an ibay====
 +
If you wish to mount an external USB drive, and then add a link in a ibay to that drive, then in order to change ownership and have write access you must format the drive as ext3 only. Refer this forum thread for info
 +
http://forums.contribs.org/index.php?topic=40240.new;topicseen#new
    
====More Information====
 
====More Information====
* There is a contrib for managing USB disks: http://forums.contribs.org/index.php?topic=35466.0
+
* There is a contrib for managing USB disks:<br>http://forums.contribs.org/index.php?topic=35466.0
* Here is a link to the Microsoft KB article on fat volume size limits: <br>http://support.microsoft.com/kb/314463<br>Summary: 32GB limit during XP Setup, 8 Terabyte otherwise
+
* There is evidence that some external USB enclosures are incompatible with SME:<br> http://forums.contribs.org/index.php?topic=39114.msg178646#msg178646
* Here is a link to an old MS technote about fat32 limits with 'format' under Win2K: <br>http://www.microsoft.com/technet/prodtechnol/windows2000serv/reskit/prork/prdf_fls_pxjh.mspx?mfr=true<br>Summary: ''format'' under Windows 2000 has a 32GB limitation.
+
* Darrell May's HowTo on scrubbing and re-formatting a USB disk:<br> http://distro.ibiblio.org/pub/linux/distributions/smeserver/contribs/dmay/smeserver/7.x/smeserver-usb-disk-howto.htm
* Here is a link to some more info about fat32 along with a downloadable program for formatting large disks if you are having problems<br>http://www.ridgecrop.demon.co.uk/index.htm?fat32format.htm
+
 
 +
====USB on SME 8====
 +
Things change on SME 8
 +
: It's difficult to work out what your device name is ie /dev/sda1 
 +
: The mount point isn't automatically added in /etc/fstab
 +
 
 +
We use hal for the first and manually create and mount for the second
 +
 
 +
=====Find the Drive Name=====
 +
To find  the device name, label, filesystem and the uid
 +
Create the file hal-find-by-property.sh
 +
 
 +
nano hal-find-by-property.sh
 +
 
 +
paste the text below into the file and save it.
 +
 
 +
#! /bin/bash
 +
hal-find-by-property --key volume.fsusage --string filesystem |
 +
while read udi ; do
 +
    # ignore optical discs
 +
    if test [[ "$(hal-get-property --udi $udi --key volume.is_disc)" == "false" ]]; then
 +
        dev=$(hal-get-property --udi $udi --key block.device)
 +
        fs=$(hal-get-property --udi $udi --key volume.fstype)
 +
        lb=$(hal-get-property --udi $udi --key volume.label)
 +
        echo device: $dev", label: "$lb", file system: "$fs", uid: "$udi
 +
    fi
 +
done
 +
 
 +
Make the file executable.
 +
chmod +x hal-find-by-property.sh
 +
 
 +
Run the file with the USB drive attached and read the output of the file from the terminal.
 +
sh hal-find-by-property.sh
 +
 
 +
The output will tell you the device, volume label, file system type, and the uid. If this is a new drive you have to run fdisk to create a partition and format the drive before you can mount it.
 +
=====Run fdisk on the Drive=====
 +
 
 +
To create a partition with fdisk, use the device output from the hal-find-by-property.sh script as the argument to the fdisk command. If the output from hal-find-by-property.sh is /dev/sdb1 the fdisk command will be
 +
fdisk /dev/sdb1
 +
 
 +
You can list the partitions on the disk by entering the p command when prompted. It's a good idea to see what partitions exist before you start. If the drive is pre-formatted for fat or ntfs it's good practice to delete the factory partitions.
 +
 
 +
If this is a new drive, you will need to create a new primary partition. Do this by entering an n at the prompt followed by p for primary. Enter a partition number of 1. fdisk will then ask for the first and last sector. If you are formatting a new disk, hit enter at both questions. This will use the entire disk. When the process ends, hit p to verify you have the disk setup like you want it. Once you are happy with the partition table, hit w to write the partition table and exit fdisk.
 +
 
 +
=====Format The Drive=====
 +
 
 +
You now need to format the drive. To format the drive with an ext3 filesystem located at /dev/sdb1 and give it a label of usbdrive, issue the following command:
 +
mkfs.ext3 -L usbdrive /dev/sdb1
 +
 
 +
=====Mount The Drive=====
 +
 
 +
Finally you mount the drive. As mentioned before, the mount point has to exist before you issue the mount command. A typical place for USB drives to be mounted is /media. If there is already a mount point in /media you can check it by listing the directory contents of media.  
 +
ll /media
 +
 
 +
Once you have a suitable location, make sure nothing is mounted there by issuing the mount command from the terminal with no arguments. If you wanted to mount the drive /dev/sdb1 at /media/usbdrive, you would issue the following command
 +
 
 +
mount /dev/sdb1 /media/usbdrive
 +
ls -lh /media/usbdrive/
 +
 
 +
=====UnMount the Drive=====
 +
 
 +
Unmount the drive before unplugging it with
 +
umount /dev/sdb1
    +
Note:  When configuring a USB drive to be used by the built in [[SME_Server:Documentation:Administration_Manual:Chapter10|Workstation Backup To USB]] you must ensure that the drive is not mounted automatically.  When configuring the Workstation Backup, it will look for unmounted removable drives and allow you to select what you want.  If the drive is already mounted when you configure it then you will get an error saying "No Removable disk available".
    +
The same applies for the [[SME_Server:Documentation:Administration_Manual:Chapter6#Option_8:_Perform_backup_to_USB_device|Console Backup to USB]]
    
----
 
----
 
[[Category:Howto]]
 
[[Category:Howto]]
 +
[[Category:Administration:Storage]]
95

edits

Navigation menu