Merge commit 'refs/top-bases/linux-user-util' into linux-user-util
This commit is contained in:
Brian Behlendorf
commit
5ff61a53e0
95
README
95
README
|
|
@ -1,95 +0,0 @@
|
|||
============================ ZFS QUICK START ============================
|
||||
|
||||
1) Build the SPL (Solaris Porting Layer) and install it. This package
|
||||
provides several Solaris APIs used by ZFS and is a required dependency.
|
||||
Before building ZFS build this package and install the resulting rpms.
|
||||
|
||||
> tar -xzf spl-x.y.z.tgz
|
||||
> cd spl-x.y.z
|
||||
> ./configure --with-linux=<kernel src>
|
||||
> make
|
||||
> make rpm
|
||||
|
||||
> sudo rpm -Uvh *.<arch>.rpm
|
||||
Preparing... ########################################### [100%]
|
||||
1:spl ########################################### [ 33%]
|
||||
2:spl-modules-devel ########################################### [ 67%]
|
||||
3:spl-modules ########################################### [100%]
|
||||
|
||||
|
||||
2) Build ZFS and install it. This package provides the native port of
|
||||
ZFS for Linux including all kernel modules and command line utilities.
|
||||
Note it is important that you have installed spl-module-devel package
|
||||
from step 1) before attempting to build ZFS.
|
||||
|
||||
> tar -xzf zfs-x.y.z.tgz
|
||||
> cd zfs-x.y.z
|
||||
> ./configure --with-linux=<kernel src>
|
||||
> make
|
||||
> make rpm
|
||||
|
||||
> sudo rpm -Uvh *.<arch>.rpm
|
||||
Preparing... ########################################### [100%]
|
||||
1:zfs ########################################### [ 20%]
|
||||
2:zfs-test ########################################### [ 40%]
|
||||
3:zfs-modules-devel ########################################### [ 60%]
|
||||
4:zfs-modules ########################################### [ 80%]
|
||||
|
||||
|
||||
3) Enjoy ZFS on Linux! Currently only the ZVOL is fully functional
|
||||
but work on the ZPL is underway. Why is just having the ZVOL still
|
||||
useful you ask? Well here's an example of what you can do today using
|
||||
just the ZVOL:
|
||||
|
||||
> # Create the 'tank' zpool containing a raidz vdev spread over 4 devices.
|
||||
> zpool create tank raidz /dev/sdb /dev/sdc /dev/sdd /dev/sde
|
||||
> zpool list
|
||||
NAME SIZE USED AVAIL CAP HEALTH ALTROOT
|
||||
tank 1.81T 132K 1.81T 0% ONLINE -
|
||||
|
||||
> # Create a 100G block device named 'fish' in the 'tank' zpool.
|
||||
> zfs create -V 100G tank/fish
|
||||
> zfs list
|
||||
NAME USED AVAIL REFER MOUNTPOINT
|
||||
tank 100G 1.24T 26.9K /tank
|
||||
tank/fish 100G 1.33T 23.9K -
|
||||
|
||||
> # Partition 'tank/fish' as if it were a normal block device.
|
||||
> sfdisk /dev/tank/fish << EOF
|
||||
0,
|
||||
EOF
|
||||
> sfdisk -l /dev/tank/fish
|
||||
|
||||
Disk /dev/tank/fish: 208050 cylinders, 16 heads, 63 sectors/track
|
||||
Units = cylinders of 516096 bytes, blocks of 1024 bytes, counting from 0
|
||||
|
||||
Device Boot Start End #cyls #blocks Id System
|
||||
/dev/tank/fish1 0+ 208049 208050- 104857199+ 83 Linux
|
||||
/dev/tank/fish2 0 - 0 0 0 Empty
|
||||
/dev/tank/fish3 0 - 0 0 0 Empty
|
||||
/dev/tank/fish4 0 - 0 0 0 Empty
|
||||
|
||||
> # Format the new /dev/tank/fish1 partition with ext2 and mount it.
|
||||
> mkfs.ext2 -q /dev/tank/fish1
|
||||
> mkdir -p /mnt/tank/fish1
|
||||
> mount /dev/tank/fish1 /mnt/tank/fish1
|
||||
> ls /mnt/tank/fish1
|
||||
lost+found
|
||||
|
||||
> # Take a snapshot of the pristine ext2 filesystem and mount it read-only.
|
||||
> zfs snapshot tank/fish@pristine
|
||||
> mkdir /mnt/tank/fish@pristine1
|
||||
> mount /dev/tank/fish@pristine1 /mnt/tank/fish@pristine1
|
||||
> ls /mnt/tank/fish\@pristine1
|
||||
lost+found
|
||||
|
||||
> # Changes made to tank/fish1 do not appear in tank/fish@pristine1
|
||||
> touch /mnt/tank/fish1/foo
|
||||
> ls /mnt/tank/fish1/
|
||||
foo lost+found
|
||||
> ls /mnt/tank/fish\@pristine1
|
||||
lost+found
|
||||
|
||||
|
||||
Enjoy,
|
||||
Brian Behlendorf <behlendorf1@llnl.gov>
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
Native ZFS for Linux! ZFS is an advanced file system and volume manager
|
||||
which was originally developed for Solaris. It has been successfully
|
||||
ported to FreeBSD and now there is a functional Linux ZFS kernel port
|
||||
too. The port currently includes a fully functional and stable SPA, DMU,
|
||||
and ZVOL with a ZFS Posix Layer (ZPL) on the way!
|
||||
|
||||
Documentation for building, configuring, and using ZFS can be found at:
|
||||
<http://wiki.github.com/behlendorf/zfs/>
|
||||
Loading…
Reference in New Issue