[Ocfs2-commits] mfasheh commits r1342 - trunk

[svn-commits at oss.oracle.com]

Author: mfasheh
Date: 2004-08-09 17:55:53 -0500 (Mon, 09 Aug 2004)
New Revision: 1342

Modified:
   trunk/README
Log:
* new readme for beta 4



Modified: trunk/README
===================================================================
--- trunk/README	2004-08-09 22:39:15 UTC (rev 1341)
+++ trunk/README	2004-08-09 22:55:53 UTC (rev 1342)
@@ -22,17 +22,39 @@
  * Keep the same performance for Oracle data files as OCFS1.
  * CDSL for node specific files
 
- Some features are planned for the production release but are missing
- in this beta:
+ Some standard tools (fsck, tunefs) are planned for the production
+ release but are missing in this beta.
 
- * Migration from OCFS1 file systems and back
- * Fsck and other standard OCFS tools
+WHAT'S NEW SINCE BETA 3
+ Too much to list. For a full description of everything that's change in OCFS2 
+ from OCFS1 please see
+ http://oss.oracle.com/projects/ocfs2/dist/documentation/ocfs2-whats-new.txt
 
+ Highlights since Beta 3 include: 
+
+ * Huge performance increases. The number of performance fixes is too
+   many to list here.
+ * Disk format now supports multiple block sizes. Cluster size
+   support has not changed.
+ * Directory meta data has completely changed. Our directories look
+   much like Ext2/3 directories now. This gives us a very large
+   performance boost and reuses code (ext3) which has been extensively
+   tested.
+ * Inode meta data reorganized to be more efficient with respect to 
+   space usage.
+ * Many posix fixes, including posix style inode persistent numbers,
+   posix style delete, link (2) and many more.
+ * Raise the limit of # nodes to 256
+
 INSTALLING OCFS2
  WARNING: you WILL have to reformat all beta OCFS2 file systems when
  the production version of OCFS2 is released. No other migration path
  (from Beta file systems) will be provided.
 
+ WARNING: OCFS2 Beta 4 will not be able to mount older OCFS2 beta file
+ systems due to some extensive on disk changes we made to improve
+ performance and reliability.
+
  Step 1: Download and install OCFS2 and OCFS-tools
 
  To install you need to download the OCFS2 Beta RPMS for your system
@@ -51,37 +73,31 @@
  Install the packages using your package manager. The OCFS2 packages
  are designed to co-exist with an existing OCFS1 installation.
 
- Step 2: Create / Convert a file system
+ Step 2: Create a file system
 
- Two options are provided at this time to get an OCFS2 file system.
-
- Regardless of which option you choose, you will no longer be able to
- mount the OCFS2 file system with OCFS1. A back wards migration path will be
- provided at a later date.
-
- The examples below assume you want an OCFS2 file system on
+ The example below assumes you want an OCFS2 file system on
  "/dev/sdb1" and are mounting it at "/ocfs2". Replace those values with
  your own.
 
- Creating a new OCFS2 file system is nearly exactly like creating an
- OCFS1 file system, except you should run "mkfs.ocfs2" instead of
- "mkfs.ocfs". Also, if you're planning to run Oracle in a shared home
- configuration, we recommend you use a block size of 4K, rather than the
- 128K we recommend for OCFS1. An example follows:
+ Creating a new OCFS2 file system is as easy as running the
+ "mkfs.ocfs2" program. As a default it picks a block size of 4K and a
+ cluster size of 4K. You can specify your own options to override the
+ defaults. If you're planning to run Oracle in a shared home
+ configuration, we recommend you use a cluster size between 4K and
+ 16K.
 
-    $ mkfs.ocfs2 -b 4 -L ocfs2_test -m /ocfs2 /dev/sdb1
+    $ mkfs.ocfs2 /dev/sdb1
 
- If you have an existing OCFS1 file system which you'd like to convert
- to OCFS2 (this will preserve your data), you can use the '-c 2' option
- to the tuneocfs binary to upgrade the file system version. Make sure
- that the OCFS1 file system was cleanly unmounted from ALL nodes, then
- run the following command:
+ Step 3: Load the module
 
-    $ tuneocfs -c 2 /dev/sdb1
+ As with OCFS1 we provide a loader script to load the ocfs2 module:
 
- Again, you will NOT be able to convert your file system back to OCFS1
- after either of these two options.
+    $ load_ocfs2
 
+ Step 4: Mount the file system
+
+    $ mount -t ocfs2 /dev/sdb1 /ocfs2
+
 REPORTING BUGS
  To report OCFS2 bugs, please use bugzilla:
 
@@ -89,6 +105,13 @@
 
  Please try to be as verbose in bug reports as possible.
 
+KNOWN ISSUES
+ This is a short list of the issues which we feel people are most
+ likely to hit when using OCFS2 Beta 4. Of course, if you do hit them,
+ please feel free to update it in bugzilla with more information.
+
+ Bugzilla IDs: 118, 119, 120, 121
+
 MAILING LISTS
  Please join the OCFS2 mailing lists at: