summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorAmar Tumballi <amarts@redhat.com>2012-06-01 10:30:34 +0530
committerVijay Bellur <vijay@gluster.com>2012-06-04 03:49:23 -0700
commit281c79c3766ca6a912e419d0cde24d1b8c457cbe (patch)
tree37e043f7af648310ac09b42d8a9d180080c72cc3 /doc
parentf037fe9143706375bea140b61fd87d13e5b2b961 (diff)
doc: added release-notes directory
Change-Id: Idd45c0fe6a0615a3204aad216002894746cea03c Signed-off-by: Amar Tumballi <amarts@redhat.com> Reviewed-on: http://review.gluster.com/3501 Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Vijay Bellur <vijay@gluster.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/release-notes/en-US/Author_Group.xml17
-rw-r--r--doc/release-notes/en-US/Book_Info.xml28
-rw-r--r--doc/release-notes/en-US/Chapter.xml33
-rw-r--r--doc/release-notes/en-US/Download_Install.xml107
-rw-r--r--doc/release-notes/en-US/Key_Features.xml72
-rw-r--r--doc/release-notes/en-US/Known_Issues.xml164
-rw-r--r--doc/release-notes/en-US/Preface.xml24
-rw-r--r--doc/release-notes/en-US/Product_Documentation.xml12
-rw-r--r--doc/release-notes/en-US/Product_Support.xml12
-rw-r--r--doc/release-notes/en-US/Release_Notes.ent4
-rw-r--r--doc/release-notes/en-US/Release_Notes.xml17
-rw-r--r--doc/release-notes/en-US/Revision_History.xml27
-rw-r--r--doc/release-notes/en-US/Whats_New.xml90
-rw-r--r--doc/release-notes/en-US/gfs_introduction.xml54
-rw-r--r--doc/release-notes/en-US/images/640px-GlusterFS_3.2_Architecture.pngbin0 -> 97477 bytes
-rw-r--r--doc/release-notes/en-US/images/icon.svg19
-rw-r--r--doc/release-notes/publican.cfg12
17 files changed, 692 insertions, 0 deletions
diff --git a/doc/release-notes/en-US/Author_Group.xml b/doc/release-notes/en-US/Author_Group.xml
new file mode 100644
index 00000000000..43a491ea9c8
--- /dev/null
+++ b/doc/release-notes/en-US/Author_Group.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Administration_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+ <author>
+ <firstname>GlusterFS</firstname>
+ <surname>Developers</surname>
+ <affiliation>
+ <orgname>Red Hat</orgname>
+ <orgdiv>Storage</orgdiv>
+ </affiliation>
+ <email>gluster-devel@nongnu.org</email>
+ </author>
+</authorgroup>
+
diff --git a/doc/release-notes/en-US/Book_Info.xml b/doc/release-notes/en-US/Book_Info.xml
new file mode 100644
index 00000000000..d3bbb9f68e6
--- /dev/null
+++ b/doc/release-notes/en-US/Book_Info.xml
@@ -0,0 +1,28 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<bookinfo id="book-Release_Notes-Release_Notes">
+ <title>Release Notes</title>
+ <subtitle>Release Notes for GlusterFS<remark> 3.3.0 </remark></subtitle>
+ <productname>GlusterFS</productname>
+ <productnumber>3.3</productnumber>
+ <edition>1</edition>
+ <pubsnumber>1</pubsnumber>
+ <abstract>
+ <para>
+ This Release Notes introduces GlusterFS and provides information including key features and managing the software.
+ </para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG"/>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Common_Content/Legal_Notice.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Author_Group.xml"/>
+</bookinfo>
diff --git a/doc/release-notes/en-US/Chapter.xml b/doc/release-notes/en-US/Chapter.xml
new file mode 100644
index 00000000000..8a2957971af
--- /dev/null
+++ b/doc/release-notes/en-US/Chapter.xml
@@ -0,0 +1,33 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Test_Chapter">
+ <title>Test Chapter</title>
+ <para>
+ This is a test paragraph
+ </para>
+ <section id="sect-Release_Notes-Test_Chapter-Test_Section_1">
+ <title>Test Section 1</title>
+ <para>
+ This is a test paragraph in a section
+ </para>
+ </section>
+
+ <section id="sect-Release_Notes-Test_Chapter-Test_Section_2">
+ <title>Test Section 2</title>
+ <para>
+ This is a test paragraph in Section 2
+ <orderedlist>
+ <listitem>
+ <para>
+ listitem text
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+
+</chapter>
+
diff --git a/doc/release-notes/en-US/Download_Install.xml b/doc/release-notes/en-US/Download_Install.xml
new file mode 100644
index 00000000000..10bc5663b6f
--- /dev/null
+++ b/doc/release-notes/en-US/Download_Install.xml
@@ -0,0 +1,107 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Launch">
+ <title>Downloading and Installing GlusterFS </title>
+ <para>You can download and install the GlusterFS 3.3.0 or upgrade to latest version
+ </para>
+ <section id="sect-Release_Notes-Download_and_Install-Test_Section_1">
+ <title>Downloading GlusterFS 3.3 </title>
+ <para>You can download the latest software to each server in your cluster from <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/ "/>.
+ </para>
+ </section>
+ <section id="sect-Release_Notes-Download_and_Install-Test_Section_2">
+ <title>New Installation </title>
+ <para>
+The installation process for GlusterFS server is available at:
+
+ <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.2/Documentation/IG/html/chap-Installation_Guide-Installing.html"/>
+ </para>
+ </section>
+ <section>
+ <title>Compatibility </title>
+ <para>Release 3.3 of GlusterFS is not compatible with 2.0.x, 3.0.x, 3.1.x, and 3.2.x releases of GlusterFS.
+</para>
+ </section>
+ <section>
+ <title>Upgrade </title>
+ <para>Red Hat recommends that you back up your data before upgrading to GlusterFS 3.3.
+</para>
+ <note>
+ <para>Configurations generated outside the scope of gluster CLI are neither recommended nor
+supported by Red Hat.
+</para>
+ </note>
+ <section>
+ <title>Upgrade from GlusterFS v3.2.x or 3.1.x to GlusterFS v3.3 </title>
+ <para>In an environment with replicated bricks it is recommended that you upgrade a single storage server,
+confirm stability, and then upgrade the replica.
+</para>
+ <para>Use the same installation method for the upgrade as the original glusterfs installation.
+</para>
+ <para><emphasis role="bold">Using RPMs on RHEL, CentOS, Fedora</emphasis></para>
+ <orderedlist>
+ <listitem>
+ <para>Download the 3.3 RPMs from the following location:
+</para>
+ <para><emphasis role="bold">RHEL:</emphasis> <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/RHEL/ "/></para>
+ <para><emphasis role="bold">Fedora:</emphasis> <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/Fedora/ "/></para>
+ </listitem>
+ <listitem>
+ <para>Run rpm using the following command:
+</para>
+ <para><command># rpm -U glusterfs*</command>
+</para>
+ </listitem>
+ </orderedlist>
+ <para><emphasis role="bold">Using dpkg on Debian, Ubuntu</emphasis>
+</para>
+ <orderedlist>
+ <listitem>
+ <para>Download the 3.3 packages from
+</para>
+ <para><emphasis role="bold">Debian:</emphasis> <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/Debian/ "/></para>
+ <para><emphasis role="bold">Ubuntu:</emphasis> <ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/Ubuntu/ "/></para>
+ </listitem>
+ <listitem>
+ <para>Run dpkg using the following command:
+</para>
+ <para><command># dpkg -i glusterfs* </command></para>
+ </listitem>
+ </orderedlist>
+ <para><emphasis role="bold">Building from source </emphasis></para>
+ <orderedlist>
+ <listitem>
+ <para>Download the 3.3 source code from
+</para>
+ <para><ulink url="http://download.gluster.com/pub/gluster/glusterfs/3.0/3.3.0/glusterf3-3.0.tar.gz"/></para>
+ </listitem>
+ <listitem>
+ <para>Unpack and install GlusterFS using the following commands:
+</para>
+ <screen># gunzip glusterfs-3.3.0.tar.gz
+# tar xvf glusterfs-3.3.0.tar
+# cd glusterfs-3.3.0
+# ./configure
+# make
+# make install</screen>
+ </listitem>
+ <listitem>
+ <para>Stop and start GlusterFS using the following commands, this step will disconnect Gluster Native
+clients.
+</para>
+ <para><command># killall glusterfsd </command></para>
+ <para><command># killall glusterfs </command></para>
+ <para><command># killall glusterd </command></para>
+ </listitem>
+ <listitem>
+ <para>Start GlusterFS using the following command:
+</para>
+ <para><command># /etc/init.d/glusterd start </command></para>
+ </listitem>
+ </orderedlist>
+ </section>
+ </section>
+</chapter>
diff --git a/doc/release-notes/en-US/Key_Features.xml b/doc/release-notes/en-US/Key_Features.xml
new file mode 100644
index 00000000000..4e11bec8429
--- /dev/null
+++ b/doc/release-notes/en-US/Key_Features.xml
@@ -0,0 +1,72 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Key_Features">
+ <title>Key Features</title>
+ <para>This section describes the key features available in Red Hat Storage. The following is a list of feature highlights of this new version of the Red Hat Storage software: </para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">High Availability</emphasis></para>
+ <para>The Red Hat Storage provides both synchronous and asynchronous n-way file replication to assure data availability:</para>
+ <para><itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">Synchronous replication</emphasis> provides redundancy and protection within a single data center or multiple data centers and availability zones in a region.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Asynchronous geo-replication</emphasis>- Red Hat Storage supports Geo-Rep long distance replication. Customers can configure storage server nodes and Red Hat Storage to asynchronously replicate data
+over vast geographical distances.
+.</para>
+ </listitem>
+ </itemizedlist></para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Deploy in Minutes</emphasis></para>
+ <para>The Red Hat Storage S can be deployed in minutes, providing one of the fastest ways to create an on-demand, high-performance, petabyte-scale storage environment. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">No Application Rewrites</emphasis></para>
+ <para>Red Hat Storage Appliance provides full support for the semantics of a normal Linux file system like ext4 so there is no need to rewrite applications when moving data to the cloud as with cloud-based object storage. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Flexibility</emphasis>
+</para>
+ <para>Runs in userspace, eliminating the need for complex
+kernel patches or dependencies.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Scalability</emphasis>
+</para>
+ <para>Elastic volume management enables storage volumes
+to be abstracted from the hardware so data and hardware can be managed independently. Storage can be
+added while data continues to be available, with no
+application interruption. Volumes can grow across
+machines in the system and can be migrated within the
+system to rebalance capacity. Storage server nodes
+can be added on the fly.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Simple Management</emphasis>
+</para>
+ <para>Simple, single command for storage management. It also includes performance monitoring and analysis tools like Top and Profile. Top provides visibility into the workload pattern and Profile provides performance
+statistics over a user-defined
+time period for metrics including latency and amount of
+data read or written.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">No Metadata Server </emphasis></para>
+ <para>Rather than using a centralized or
+distributed metadata server, Red Hat Storage software
+ uses an elastic hashing algorithm to locate
+data in the storage pool removing this common source
+of I/O bottlenecks and vulnerability to failure. Data
+access is fully parallelized and performance scales
+linearly.
+</para>
+ </listitem>
+ </itemizedlist>
+</chapter>
diff --git a/doc/release-notes/en-US/Known_Issues.xml b/doc/release-notes/en-US/Known_Issues.xml
new file mode 100644
index 00000000000..834ed53363c
--- /dev/null
+++ b/doc/release-notes/en-US/Known_Issues.xml
@@ -0,0 +1,164 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Known_Issues">
+ <title>Known Issues</title>
+ <para>
+ The following are the known issues:
+
+ </para>
+ <para><itemizedlist>
+ <listitem>
+ <para>Issues related to Distributed Replicated Volumes:
+</para>
+ <itemizedlist>
+ <listitem>
+ <para>When process has done <emphasis role="italic">
+ <emphasis role="italic">
+ <command>cd</command>
+ </emphasis>
+ </emphasis> into a directory, stat of deleted file recreates it (directory self-
+heal not triggered).
+</para>
+ <para>In GlusterFS replicated setup, if you are inside a directory (for example, <filename>Test</filename> directory) of
+replicated volume. From another node, you will delete a file inside <filename>Test</filename> directory. Then if you
+perform <command>stat</command> operation on the same file name, the file will be automatically created. (that is, a
+proper directory self-heal is not triggered when process has done <command>cd</command> into a path).
+</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Issues related to Distributed Volumes:
+</para>
+ <itemizedlist>
+ <listitem>
+ <para>Rebalance does not happen if bricks are down.
+
+</para>
+ <para>Currently while running rebalance, make sure all the bricks are in operating or connected state.
+
+</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>glusterfsd - Error return code is not proper after daemonizing the process.
+</para>
+ <para>Due to this, scripts that mount glusterfs or start glusterfs process must not depend on its return
+value.
+</para>
+ </listitem>
+ <listitem>
+ <para>After <command># gluster volume replace-brick <replaceable>VOLNAME Brick New-Brick</replaceable> commit</command> command
+is issued, the file system operations on that particular volume, which are in transit will fail.
+</para>
+ </listitem>
+ <listitem>
+ <para>Command <command># gluster volume replace-brick ...</command> will fail in a RDMA set up.
+</para>
+ </listitem>
+ <listitem>
+ <para>If files and directories have different GFIDs on different backends, GlusterFS client may hang or
+display errors.
+</para>
+ <para><emphasis role="bold">Work Around</emphasis>: The workaround for this issue is explained at <ulink url="http://gluster.org/pipermail/gluster-users/2011-July/008215.html"/>
+.
+</para>
+ </listitem>
+ <listitem>
+ <para>Issues related to Directory Quota:
+</para>
+ <itemizedlist>
+ <listitem>
+ <para>Some writes can appear to pass even though the quota limit is exceeded (write returns
+success). This is because they could be cached in write-behind. However disk-space would
+not exceed the quota limit, since when writes to backend happen, quota does not allow
+them. Hence it is advised that applications should check for return value of close call.
+</para>
+ </listitem>
+ <listitem>
+ <para>If a user has done <command>cd</command> into a directory on which the administrator is setting the limit, even
+ though the command succeeds and the new limit value will be applicable to all the users
+except for those users’ who has done <command>cd</command> in to that particular directory. The old limit value
+ will be applicable until the user has <command>cd</command> out of that directory.
+</para>
+ </listitem>
+ <listitem>
+ <para>Rename operation (that is, removing oldpath and creating newpath) requires additional disk
+space equal to file size. This is because, during rename, it subtracts the size on oldpath after
+rename operation is performed, but it checks whether quota limit is exceeded on parents of
+newfile before rename operation.
+</para>
+ </listitem>
+ <listitem>
+ <para>With striped volumes, Quota feature is not available.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Issues related to POSIX ACLs:
+</para>
+ <itemizedlist>
+ <listitem>
+ <para>Even though POSIX ACLs are set on the file or directory, the <computeroutput>+</computeroutput> (plus) sign in the file
+ permissions will not be displayed. This is for performance optimization and will be fixed in a
+ future release.
+</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>
+ <para>When glusterfs is mounted with <command>-o acl</command>, directory read performance can be bad. Commands
+like recursive directory listing can be slower than normal.
+</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>
+ <para>When POSIX ACLs are set and multiple NFS clients are used, there could be inconsistency in
+the way ACLs are applied due to attribute caching in NFS. For a consistent view of POSIX ACLs
+in a multiple client setup, use <command>-o noac</command> option on NFS mount to switch off attribute caching.
+ This could have a performance impact on operations involving attributes.
+</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>If you have enabled Gluster NLM, you cannot mount kernel NFS client on your storage nodes.
+
+</para>
+ </listitem>
+ <listitem condition="gfs">
+ <para>Error with lost and found directory while using multiple disks.</para>
+ <para><emphasis role="bold">Work Around</emphasis>: You must ensure that the brick directories are one of the extra directories in the back-end mount point. For Example, if <filename>/dev/sda1</filename> is mounted on <filename>/export1</filename>, use <filename>/export1/volume</filename> as the glusterfs&apos;s export directory. </para>
+ </listitem>
+ <listitem>
+ <para>Due to enhancements in Graphs, you may experience excessive memory usage with this release.
+
+</para>
+ </listitem>
+ <listitem>
+ <para>After you restart the NFS server, the unlock within the grace-period may fail and previously held locks may not be reclaimed.
+
+</para>
+ </listitem>
+ <listitem>
+ <para>After a rebalancing a volume, if you run <command>rm -rf</command> command at the mount point to remove all contents of the current working directory recursively without prompting, you may get &quot;Directory not Empty&quot; error message.
+
+</para>
+ </listitem>
+ <listitem>
+ <para>The following is a known missing (minor) feature:
+</para>
+ <itemizedlist>
+ <listitem>
+ <para>locks - <emphasis role="italic">mandatory</emphasis> locking is not supported.
+</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist></para>
+</chapter>
diff --git a/doc/release-notes/en-US/Preface.xml b/doc/release-notes/en-US/Preface.xml
new file mode 100644
index 00000000000..597dc5da08a
--- /dev/null
+++ b/doc/release-notes/en-US/Preface.xml
@@ -0,0 +1,24 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-Release_Notes-Preface">
+ <title>Preface</title>
+ <para>This guide describes how to configure, operate, and manage Gluster File System (GlusterFS).</para>
+ <section>
+ <title>Audience</title>
+ <para>This guide is intended for Systems Administrators interested in configuring and managing GlusterFS.</para>
+ <para>This guide assumes that you are familiar with the Linux operating system, concepts of File System, GlusterFS concepts, and GlusterFS Installation</para>
+ </section>
+ <section>
+ <title>License</title>
+ <para>The License information is available at <ulink url="http://www.redhat.com/licenses/rhel_rha_eula.html"/>.</para>
+ </section>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Common_Content/Conventions.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Feedback.xml">
+ <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Common_Content/Feedback.xml"/>
+ </xi:fallback>
+ </xi:include>
+</preface>
diff --git a/doc/release-notes/en-US/Product_Documentation.xml b/doc/release-notes/en-US/Product_Documentation.xml
new file mode 100644
index 00000000000..77329ab0192
--- /dev/null
+++ b/doc/release-notes/en-US/Product_Documentation.xml
@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Product_Documentation">
+ <title>Product Documentation</title>
+ <para>Product documentation of GlusterFS
+
+ is available at <ulink url="http://www.gluster.org/community/documentation/index.php/Main_Page"/> .
+</para>
+</chapter>
diff --git a/doc/release-notes/en-US/Product_Support.xml b/doc/release-notes/en-US/Product_Support.xml
new file mode 100644
index 00000000000..ab44e518208
--- /dev/null
+++ b/doc/release-notes/en-US/Product_Support.xml
@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Release_Notes-Product_Support">
+ <title>Product Support</title>
+ <para>
+
+ You can reach support at <ulink url="http://www.redhat.com/support"/>.
+</para>
+</chapter>
diff --git a/doc/release-notes/en-US/Release_Notes.ent b/doc/release-notes/en-US/Release_Notes.ent
new file mode 100644
index 00000000000..9275f166d51
--- /dev/null
+++ b/doc/release-notes/en-US/Release_Notes.ent
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "Documentation">
+<!ENTITY BOOKID "Release_Notes">
+<!ENTITY YEAR "2012">
+<!ENTITY HOLDER "Red Hat Inc">
diff --git a/doc/release-notes/en-US/Release_Notes.xml b/doc/release-notes/en-US/Release_Notes.xml
new file mode 100644
index 00000000000..d23fb4d7f2f
--- /dev/null
+++ b/doc/release-notes/en-US/Release_Notes.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="gfs_introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Whats_New.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Download_Install.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Known_Issues.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Product_Support.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Product_Documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</book>
+
diff --git a/doc/release-notes/en-US/Revision_History.xml b/doc/release-notes/en-US/Revision_History.xml
new file mode 100644
index 00000000000..f473d0a299c
--- /dev/null
+++ b/doc/release-notes/en-US/Revision_History.xml
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-Release_Notes-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber> 1-0</revnumber>
+ <date>Mon Apr 9 2012</date>
+ <author>
+ <firstname>Divya </firstname>
+ <surname>Muntimadugu</surname>
+ <email>divya@redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Draft</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
diff --git a/doc/release-notes/en-US/Whats_New.xml b/doc/release-notes/en-US/Whats_New.xml
new file mode 100644
index 00000000000..c320c1aa3ec
--- /dev/null
+++ b/doc/release-notes/en-US/Whats_New.xml
@@ -0,0 +1,90 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-2.0_Release_Notes-Whats_New">
+ <title>What is New in this Release?</title>
+ <para>This section describes the key features available in GlusterFS. The following is a list of feature highlights of this new version of the GlusterFS software: </para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">Unified File and Object Storage</emphasis></para>
+ <para>Unified File and Object Storage (UFO) unifies NAS and object storage technology. It provides a system for data storage that enables users to access the same data, both as an object and as a file, thus simplifying management and controlling storage costs.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Replicate Improvements (Pro-active Self-heal)</emphasis></para>
+ <para>In replicate module, previously you had to manually trigger a self-heal when a brick goes offline and comes back online, to bring all the replicas in sync. Now the pro-active self-heal daemon runs in the background, diagnoses issues and automatically initiates self-healing when the brick comes on-line. You can view the list of files that need healing, the list of files which are recently healed, list of files which are in split-brain state, and you can manually trigger self-heal on the entire volume or only on the files which need healing. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Network Lock Manager</emphasis>
+</para>
+ <para>GlusterFS 3.3 includes network lock manager (NLM) v4. NLM is a standard and an extension to NFSv3 which allows NFSv3 clients to lock on files across the network. NLM is required to make applications running on top of NFSv3 mount points to use the standard fcntl() (POSIX) and flock() (BSD) lock system calls to synchronize access across clients.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Volume Statedump</emphasis>
+</para>
+ <para>Statedump is a mechanism through which you can get details of all internal variables and state of the glusterfs process at the time of issuing the command.You can perform statedumps of the brick processes and nfs server process of a volume using the statedump command. The statedump information is useful while debugging.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Volume Status and Brick Information</emphasis>
+</para>
+ <para>You can display the status information about a specific volume, brick or all volumes, as needed. Volume status information includes memory usage, memory pool details of the bricks, inode tables of the volume, pending calls of the volume and other statistics. This information can be used to understand the current status of the brick, nfs processes, and overall file
+system. Status information can also be used to monitor and debug the volume information. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Geo-replication Enhancements </emphasis></para>
+ <para>Now you can configure a secure slave using SSH so that master is granted a restricted access. You need not specify configuration parameters regarding the slave on the master-side configuration. You can also rotate the log file of a particular master-slave session, all sessions of a mater volume, and all geo-replication sessions, as needed. You can also set ignore-deletes option to 1 so that the file deleted on master will not trigger a delete operation on the slave. Hence, the slave will remain as a superset of the master and can be used to recover the master in case of crash and/or accidental delete.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Mount Server Fail-over </emphasis></para>
+ <para>Now there is an option to add backup volfile server while mounting fuse client. When the first volfile server fails, then the server specified in backupvolfile-server option is used as volfile server to mount the client. You can also specify the number of attempts to fetch while mounting glusterFS server. This option is useful when you mount a server with multiple IPs.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Debugging Locks</emphasis></para>
+ <para>You can use statedump command to list the locks held on files. The statedump output also provides information on each lock with its range, basename, PID of the application holding the lock, and so on. You can analyze and know which locks are valid and relevant at a point of time. After ensuring that the no application is using the file, you can clear the lock using the clear lock command.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Change in Working Directory </emphasis></para>
+ <para>The working directory of glusterd is changed to <emphasis role="italic">/var/lib/glusterd </emphasis>from <emphasis role="italic">/etc/glusterd</emphasis>.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Hadoop Compatible Storage </emphasis></para>
+ <para>GlusterFS provides compatibility for Apache Hadoop and it uses the standard file system APIs available in Hadoop to provide a new storage option for Hadoop deployments. Existing MapReduce based applications can use GlusterFS seamlessly. This new functionality opens up data within Hadoop deployments to any file-based or object-based application.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Granual Locking for Large Files </emphasis></para>
+ <para>Enables using GlusterFS as a backing store for preserving large files like virtual machine images. Granualar locking enables internal file operations (like self-heal) without blocking user level file operations. The latency for user I/O is reduced during self-heal operation.
+</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Configuration Enhancements</emphasis></para>
+ <para><itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">Remove Brick Enhancements</emphasis></para>
+ <para>Previously, remove-bick command was used to remove a brick that is inaccessible due to hardware or network failure. And as a clean-up operation to remove dead server details from the volume configuration. Now remove-brick command can migrate data to existing bricks before deleting given brick.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Rebalance Enhancements </emphasis></para>
+ <para>GlusterFS 3.3 supports open file rebalance and files that have hardlinks. Rebalance has been enchanced to be more efficient with respect to network usage, completion time, and amount of data movement and starts migration of data immediately without waiting for directory layout to be fixed.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Dynamic Alteration of Volume Type </emphasis></para>
+ <para>You can now the change type of the volume from Distributed volume to Distributed Replicated Volume when performing add-brick and remove-brick operation. You must specify the replica count paramenter to increase the number of replicas to change it to distributed replicated volume.<note>
+ <para>Currently, changing of <emphasis role="italic">stripe</emphasis> count while changing volume configurations is not supported.</para>
+ </note></para>
+ </listitem>
+ </itemizedlist></para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Read-only Volume </emphasis></para>
+ <para>GlusterFS 3.3 enables you to mount volumes as read-only. While mounting the client, you can mount it as read-only for the volumes and you can also make the entire volume as read-only for all the clients (including NFS clients) using volume set option.
+</para>
+ </listitem>
+ </itemizedlist>
+</chapter>
diff --git a/doc/release-notes/en-US/gfs_introduction.xml b/doc/release-notes/en-US/gfs_introduction.xml
new file mode 100644
index 00000000000..5fd88730556
--- /dev/null
+++ b/doc/release-notes/en-US/gfs_introduction.xml
@@ -0,0 +1,54 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd" []>
+<chapter>
+ <title>Introducing Gluster File System</title>
+ <para>GlusterFS is an open source, clustered file system capable of scaling to several petabytes and handling thousands of clients. GlusterFS can be flexibly combined with commodity physical, virtual, and cloud resources to deliver highly available and performant enterprise storage at a fraction of the cost of traditional solutions.</para>
+ <para>GlusterFS clusters together storage building blocks over Infiniband RDMA and/or TCP/IP interconnect, aggregating disk and memory resources and managing data in a single global namespace. GlusterFS is based on a stackable user space design, delivering exceptional performance for diverse workloads.
+</para>
+ <figure>
+ <title>Virtualized Cloud Environments</title>
+ <mediaobject>
+ <textobject>
+ <phrase>Virtualized Cloud Environments</phrase>
+ </textobject>
+ <imageobject>
+ <imagedata align="center" fileref="images/640px-GlusterFS_3.2_Architecture.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>GlusterFS is designed for today&apos;s high-performance, virtualized cloud environments. Unlike traditional data centers, cloud environments require multi-tenancy along with the ability to grow or shrink resources on demand. Enterprises can scale capacity, performance, and availability on demand, with no vendor lock-in, across on-premise, public cloud, and hybrid environments. </para>
+ <para>GlusterFS is in production at thousands of enterprises spanning media, healthcare, government, education, web 2.0, and financial services. The following table lists the commercial offerings and its documentation location:
+</para>
+ <informaltable frame="all">
+ <tgroup cols="2">
+ <colspec colname="c1" colwidth="16%"/>
+ <colspec colname="c2" colwidth="84%"/>
+ <thead>
+ <row>
+ <entry>Product</entry>
+ <entry>Documentation Location</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Red Hat Storage Software Appliance</entry>
+ <entry>
+ <ulink url="http://docs.redhat.com/docs/en-US/Red_Hat_Storage_Software_Appliance/index.html"/>
+ </entry>
+ </row>
+ <row>
+ <entry>Red Hat Virtual Storage Appliance</entry>
+ <entry>
+ <ulink url="http://docs.redhat.com/docs/en-US/Red_Hat_Virtual_Storage_Appliance/index.html"/>
+ </entry>
+ </row>
+ <row>
+ <entry>Red Hat Storage </entry>
+ <entry>
+ <ulink url="http://docs.redhat.com/docs/en-US/Red_Hat_Storage/index.html"/>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+</chapter>
diff --git a/doc/release-notes/en-US/images/640px-GlusterFS_3.2_Architecture.png b/doc/release-notes/en-US/images/640px-GlusterFS_3.2_Architecture.png
new file mode 100644
index 00000000000..95f89ec8286
--- /dev/null
+++ b/doc/release-notes/en-US/images/640px-GlusterFS_3.2_Architecture.png
Binary files differ
diff --git a/doc/release-notes/en-US/images/icon.svg b/doc/release-notes/en-US/images/icon.svg
new file mode 100644
index 00000000000..b2f16d0f61d
--- /dev/null
+++ b/doc/release-notes/en-US/images/icon.svg
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.0" width="32" height="32" id="svg3017">
+ <defs id="defs3019">
+ <linearGradient id="linearGradient2381">
+ <stop id="stop2383" style="stop-color:#ffffff;stop-opacity:1" offset="0"/>
+ <stop id="stop2385" style="stop-color:#ffffff;stop-opacity:0" offset="1"/>
+ </linearGradient>
+ <linearGradient x1="296.4996" y1="188.81061" x2="317.32471" y2="209.69398" id="linearGradient2371" xlink:href="#linearGradient2381" gradientUnits="userSpaceOnUse" gradientTransform="matrix(0.90776,0,0,0.90776,24.35648,49.24131)"/>
+ </defs>
+ <g transform="matrix(0.437808,-0.437808,0.437808,0.437808,-220.8237,43.55311)" id="g5089">
+ <path d="m 8.4382985,-6.28125 c -0.6073916,0 -4.3132985,5.94886271 -4.3132985,8.25 l 0,26.71875 c 0,0.846384 0.5818159,1.125 1.15625,1.125 l 25.5625,0 c 0.632342,0 1.125001,-0.492658 1.125,-1.125 l 0,-5.21875 0.28125,0 c 0.49684,0 0.906249,-0.409411 0.90625,-0.90625 l 0,-27.9375 c 0,-0.4968398 -0.40941,-0.90625 -0.90625,-0.90625 l -23.8117015,0 z" transform="translate(282.8327,227.1903)" id="path5091" style="fill:#5c5c4f;stroke:#000000;stroke-width:3.23021388;stroke-miterlimit:4;stroke-dasharray:none"/>
+ <rect width="27.85074" height="29.369793" rx="1.1414107" ry="1.1414107" x="286.96509" y="227.63805" id="rect5093" style="fill:#032c87"/>
+ <path d="m 288.43262,225.43675 25.2418,0 0,29.3698 -26.37615,0.0241 1.13435,-29.39394 z" id="rect5095" style="fill:#ffffff"/>
+ <path d="m 302.44536,251.73726 c 1.38691,7.85917 -0.69311,11.28365 -0.69311,11.28365 2.24384,-1.60762 3.96426,-3.47694 4.90522,-5.736 0.96708,2.19264 1.83294,4.42866 4.27443,5.98941 0,0 -1.59504,-7.2004 -1.71143,-11.53706 l -6.77511,0 z" id="path5097" style="fill:#a70000;fill-opacity:1;stroke-width:2"/>
+ <rect width="25.241802" height="29.736675" rx="0.89682275" ry="0.89682275" x="290.73544" y="220.92249" id="rect5099" style="fill:#809cc9"/>
+ <path d="m 576.47347,725.93939 6.37084,0.41502 0.4069,29.51809 c -1.89202,-1.31785 -6.85427,-3.7608 -8.26232,-1.68101 l 0,-26.76752 c 0,-0.82246 0.66212,-1.48458 1.48458,-1.48458 z" transform="matrix(0.499065,-0.866565,0,1,0,0)" id="rect5101" style="fill:#4573b3;fill-opacity:1"/>
+ <path d="m 293.2599,221.89363 20.73918,0 c 0.45101,0 0.8141,0.3631 0.8141,0.81411 0.21547,6.32836 -19.36824,21.7635 -22.36739,17.59717 l 0,-17.59717 c 0,-0.45101 0.3631,-0.81411 0.81411,-0.81411 z" id="path5103" style="opacity:0.65536726;fill:url(#linearGradient2371);fill-opacity:1"/>
+ </g>
+</svg>
diff --git a/doc/release-notes/publican.cfg b/doc/release-notes/publican.cfg
new file mode 100644
index 00000000000..8afb0d03b19
--- /dev/null
+++ b/doc/release-notes/publican.cfg
@@ -0,0 +1,12 @@
+# Config::Simple 4.59
+# Thu Apr 5 16:25:43 2012
+
+xml_lang: "en-US"
+type: Book
+brand: Gluster_Brand
+prod_url: http://www.gluster.org
+doc_url: http://www.gluster.com/community/documentation/index.php/Main_Page
+condition: gfs
+show_remarks: 1
+
+