Merge commit 'refs/top-bases/linux-have-spl-debug' into linux-have-spl-debug
This commit is contained in:
Brian Behlendorf
commit
e21dce75ca
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