Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 1 | OCFS2 filesystem |
| 2 | ================== |
| 3 | OCFS2 is a general purpose extent based shared disk cluster file |
| 4 | system with many similarities to ext3. It supports 64 bit inode |
| 5 | numbers, and has automatically extending metadata groups which may |
| 6 | also make it attractive for non-clustered use. |
| 7 | |
| 8 | You'll want to install the ocfs2-tools package in order to at least |
| 9 | get "mount.ocfs2" and "ocfs2_hb_ctl". |
| 10 | |
| 11 | Project web page: http://oss.oracle.com/projects/ocfs2 |
| 12 | Tools web page: http://oss.oracle.com/projects/ocfs2-tools |
| 13 | OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/ |
| 14 | |
| 15 | All code copyright 2005 Oracle except when otherwise noted. |
| 16 | |
| 17 | CREDITS: |
| 18 | Lots of code taken from ext3 and other projects. |
| 19 | |
| 20 | Authors in alphabetical order: |
| 21 | Joel Becker <joel.becker@oracle.com> |
| 22 | Zach Brown <zach.brown@oracle.com> |
Sunil Mushran | 7ab8f52 | 2009-11-02 13:38:10 -0800 | [diff] [blame] | 23 | Mark Fasheh <mfasheh@suse.com> |
Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 24 | Kurt Hackel <kurt.hackel@oracle.com> |
Sunil Mushran | 7ab8f52 | 2009-11-02 13:38:10 -0800 | [diff] [blame] | 25 | Tao Ma <tao.ma@oracle.com> |
Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 26 | Sunil Mushran <sunil.mushran@oracle.com> |
| 27 | Manish Singh <manish.singh@oracle.com> |
Sunil Mushran | 7ab8f52 | 2009-11-02 13:38:10 -0800 | [diff] [blame] | 28 | Tiger Yang <tiger.yang@oracle.com> |
Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 29 | |
| 30 | Caveats |
| 31 | ======= |
| 32 | Features which OCFS2 does not support yet: |
Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 33 | - Directory change notification (F_NOTIFY) |
| 34 | - Distributed Caching (F_SETLEASE/F_GETLEASE/break_lease) |
Mark Fasheh | ccd979b | 2005-12-15 14:31:24 -0800 | [diff] [blame] | 35 | |
| 36 | Mount options |
| 37 | ============= |
| 38 | |
| 39 | OCFS2 supports the following mount options: |
| 40 | (*) == default |
| 41 | |
| 42 | barrier=1 This enables/disables barriers. barrier=0 disables it, |
| 43 | barrier=1 enables it. |
| 44 | errors=remount-ro(*) Remount the filesystem read-only on an error. |
| 45 | errors=panic Panic and halt the machine if an error occurs. |
| 46 | intr (*) Allow signals to interrupt cluster operations. |
| 47 | nointr Do not allow signals to interrupt cluster |
| 48 | operations. |
Tiger Yang | e2b0c21 | 2011-03-02 19:32:09 +0800 | [diff] [blame^] | 49 | noatime Do not update access time. |
| 50 | relatime(*) Update atime if the previous atime is older than |
| 51 | mtime or ctime |
| 52 | strictatime Always update atime, but the minimum update interval |
| 53 | is specified by atime_quantum. |
Tiger Yang | bcd5625 | 2006-12-05 10:09:17 +0800 | [diff] [blame] | 54 | atime_quantum=60(*) OCFS2 will not update atime unless this number |
| 55 | of seconds has passed since the last update. |
Tiger Yang | e2b0c21 | 2011-03-02 19:32:09 +0800 | [diff] [blame^] | 56 | Set to zero to always update atime. This option need |
| 57 | work with strictatime. |
Mark Fasheh | 10b0845 | 2007-08-23 11:17:55 -0700 | [diff] [blame] | 58 | data=ordered (*) All data are forced directly out to the main file |
| 59 | system prior to its metadata being committed to the |
| 60 | journal. |
| 61 | data=writeback Data ordering is not preserved, data may be written |
| 62 | into the main file system after its metadata has been |
| 63 | committed to the journal. |
| 64 | preferred_slot=0(*) During mount, try to use this filesystem slot first. If |
| 65 | it is in use by another node, the first empty one found |
| 66 | will be chosen. Invalid values will be ignored. |
Mark Fasheh | d147b3d | 2007-11-07 14:40:36 -0800 | [diff] [blame] | 67 | commit=nrsec (*) Ocfs2 can be told to sync all its data and metadata |
| 68 | every 'nrsec' seconds. The default value is 5 seconds. |
| 69 | This means that if you lose your power, you will lose |
| 70 | as much as the latest 5 seconds of work (your |
| 71 | filesystem will not be damaged though, thanks to the |
| 72 | journaling). This default value (or any low value) |
| 73 | will hurt performance, but it's good for data-safety. |
| 74 | Setting it to 0 will have the same effect as leaving |
| 75 | it at the default (5 seconds). |
| 76 | Setting it to very large values will improve |
| 77 | performance. |
Sunil Mushran | 2fbe8d1 | 2007-12-20 14:58:11 -0800 | [diff] [blame] | 78 | localalloc=8(*) Allows custom localalloc size in MB. If the value is too |
| 79 | large, the fs will silently revert it to the default. |
Mark Fasheh | 53fc622 | 2007-12-20 16:49:04 -0800 | [diff] [blame] | 80 | localflocks This disables cluster aware flock. |
Joel Becker | 12462f1 | 2008-09-03 20:03:40 -0700 | [diff] [blame] | 81 | inode64 Indicates that Ocfs2 is allowed to create inodes at |
| 82 | any location in the filesystem, including those which |
| 83 | will result in inode numbers occupying more than 32 |
| 84 | bits of significance. |
Mark Fasheh | 696b55d | 2008-10-07 11:09:24 -0700 | [diff] [blame] | 85 | user_xattr (*) Enables Extended User Attributes. |
| 86 | nouser_xattr Disables Extended User Attributes. |
Tiger Yang | a68979b | 2008-11-14 11:17:52 +0800 | [diff] [blame] | 87 | acl Enables POSIX Access Control Lists support. |
| 88 | noacl (*) Disables POSIX Access Control Lists support. |
Lucas De Marchi | 25985ed | 2011-03-30 22:57:33 -0300 | [diff] [blame] | 89 | resv_level=2 (*) Set how aggressive allocation reservations will be. |
Mark Fasheh | d02f00c | 2009-12-07 13:10:48 -0800 | [diff] [blame] | 90 | Valid values are between 0 (reservations off) to 8 |
| 91 | (maximum space for reservations). |
Mark Fasheh | 83f9231 | 2010-04-05 18:17:16 -0700 | [diff] [blame] | 92 | dir_resv_level= (*) By default, directory reservations will scale with file |
| 93 | reservations - users should rarely need to change this |
| 94 | value. If allocation reservations are turned off, this |
| 95 | option will have no effect. |
Tristan Ye | 7bdb0d1 | 2010-10-11 16:46:39 +0800 | [diff] [blame] | 96 | coherency=full (*) Disallow concurrent O_DIRECT writes, cluster inode |
| 97 | lock will be taken to force other nodes drop cache, |
| 98 | therefore full cluster coherency is guaranteed even |
| 99 | for O_DIRECT writes. |
| 100 | coherency=buffered Allow concurrent O_DIRECT writes without EX lock among |
| 101 | nodes, which gains high performance at risk of getting |
| 102 | stale data on other nodes. |