Gluster_FS_Release_Notes_3.1.3

Document Sample
Gluster_FS_Release_Notes_3.1.3 Powered By Docstoc
					                      Gluster File System
                           Release Notes




Version: 3.1.3
Release: March 2011
         ds




                                                       License
         Gluster 3.1.3 is licensed under the GNU Affero General Public License.

         Preamble to the GNU Affero General Public License

         The GNU Affero General Public License is a free, copyleft license for software and other kinds of
         works, specifically designed to ensure cooperation with the community in the case of network server
         software.

         The licenses for most software and other practical works are designed to take away your freedom to
         share and change the works. By contrast, our General Public Licenses are intended to guarantee your
         freedom to share and change all versions of a program--to make sure it remains free software for all
         its users.

         When we speak of free software, we are referring to freedom, not price. Our General Public Licenses
         are designed to make sure that you have the freedom to distribute copies of free software (and
         charge for them if you wish), that you receive source code or can get it if you want it, that you can
         change the software or use pieces of it in new free programs, and that you know you can do these
         things.

         Developers that use our General Public Licenses protect your rights with two steps: (1) assert
         copyright on the software, and (2) offer you this License which gives you legal permission to copy,
         distribute and/or modify the software.

         A secondary benefit of defending all users' freedom is that improvements made in alternate versions
         of the program, if they receive widespread use, become available for other developers to
         incorporate. Many developers of free software are heartened and encouraged by the resulting
         cooperation. However, in the case of software used on network servers, this result may fail to come
         about. The GNU General Public License permits making a modified version and letting the public
         access it on a server without ever releasing its source code to the public.

         The GNU Affero General Public License is designed specifically to ensure that, in such cases, the
         modified source code becomes available to the community. It requires the operator of a network
         server to provide the source code of the modified version running there to the users of that server.
         Therefore, public use of a modified version, on a publicly accessible server, gives the public access
         to the source code of the modified version.

         An older license, called the Affero General Public License and published by Affero, was designed to
         accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has
         released a new version of the Affero GPL which permits relicensing under this license.
         The precise terms and conditions for copying, distribution and modification are available
         here.




Gluster File System                              Release_Notes_3.1.3_01_C                                         Pg No. 2
         ds




                                                        Table of Contents
         1.    Overview ........................................................................................................... 4
                 1.1. Product Background .................................................................................... 4
                 1.2. Product License.......................................................................................... 4
                 1.3. Product Support ......................................................................................... 4
                 1.4. Copyright/Trademarks ................................................................................. 4
                 1.5. Providing Feedback ..................................................................................... 4
                 1.6. Disclaimer ................................................................................................ 5
         2.    What is New in this Release ..................................................................................... 6
                 2.1. New NFS Options ........................................................................................ 6
                 2.2. Sharing Volume through RDMA and TCP/IP Simultaneously ..................................... 7
                 2.3. Option to turn-off volume being exported by NFS ................................................ 7
         3.    Dropped Features ................................................................................................. 8
         4.    System Requirements ............................................................................................ 9
                 4.1. Storage Severs ........................................................................................... 9
                 4.2. Networking Requirements ............................................................................. 9
                 4.3. Operating System Requirements ..................................................................... 9
                 4.4. File System Requirements ............................................................................. 9
         5.    Downloading and Installing GlusterFS 3.1.3 ................................................................. 10
                 5.1. Downloading GlusterFS 3.1.3 ......................................................................... 10
                 5.2. New Installation ........................................................................................ 10
                 5.3. Compatibility ........................................................................................... 10
                 5.4. Upgrade .................................................................................................. 10
         6.    Issues Resolved in GlusterFS 3.1.3 ............................................................................ 11
         7.    Known Issues ...................................................................................................... 12
         8.    Documentation ................................................................................................... 13
         9.    Appendix – Bugs Fixed ........................................................................................... 14




Gluster File System                                      Release_Notes_3.1.3_01_C                                                   Pg No. 3
         ds




         1. Overview
         This Release Notes includes the following sections for the 3.1.3 release of the GlusterFS:
              What is New in this Release
              Dropped Features
              System Requirements
              Downloading and Installing GlusterFS 3.1.3
              Issues Resolved in GlusterFS 3.1.3
              Known Issues
         Note: It is recommended that one thoroughly review this release note prior to the installation or
         upgrade of this product.

         1.1. Product Background
         GlusterFS is an open source, clustered file system capable of scaling to several petabytes and
         handling thousands of clients. GlusterFS clusters together storage building blocks over Infiniband
         RDMA 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 and can deliver exceptional
         performance for diverse workloads.
         The GlusterFS modular architecture allows administrators to stack modules to match user
         requirements, as needed. For example, administrators can use GlusterFS to quickly configure a
         standalone server system and later expand the system as needs grow.

         1.2. Product License
         Gluster 3.1.3 is licensed under the GNU Affero General Public License. The license for GlusterFS
         3.1.3 can be viewed at:
         http://www.gluster.com/community/documentation/index.php/Gluster_3.1:_Understanding_the_Gl
         usterFS_License .

         1.3. Product Support
         GlusterFS is offered on an annual subscription basis. Subscriptions are priced per storage server with
         no limit on attached storage capacity. Gluster also offers several professional services options to
         augment annual subscriptions. Details of Gluster support offerings are available at:
         http://www.gluster.com/services/edition-subscriptions/ .

         1.4. Copyright/Trademarks
         Gluster, the Gluster logo and GlusterFS are all trademarks of Gluster, Inc. All other trademarks,
         registered trademarks, and product names may be trademarks of their respective owners.

         1.5. Providing Feedback
         Gluster encourages you to provide feedback and file defects related to the product, as appropriate.




Gluster File System                                Release_Notes_3.1.3_01_C                                       Pg No. 4
         ds


         Feedback
         Gluster advises you to provide feedback using the Gluster Community.
         Filing Defects
         You can file a product defect using the Gluster Bug Tracker. Use the following values when filing a
         defect:
              Product: GlusterFS
              Component: glusterd
              Version: 3.1.3

         1.6. Disclaimer
         Gluster v3.1.3 software is provided AS IS. There is NO WARRANTY, to the extent permitted by law.
         Gluster Inc. is in no way responsible for any loss of data or services.




Gluster File System                             Release_Notes_3.1.3_01_C                                       Pg No. 5
         ds




         2. What is New in this Release
         The following are the new features and enhancements in GlusterFS 3.1.3 release:

         2.1. New NFS Options
         The following new NFS options are added:

                      NFS Option                             Description                             Default
                                                                                                      Value
           nfs.volume-access         Set the access type for the specified sub-volume.              read-
           <read-only | read-                                                                       write
           write>
           nfs.trusted-write <on |   If there is an UNSTABLE write from the client, STABLE flag     Off
           off>                      will be returned to force the client to not to send a COMMIT
                                     request.
                                     In some environments, combined with a replicated
                                     GlusterFS setup, this option can improve write
                                     performance. This flag allows users to trust Gluster
                                     replication logic to sync data to the disks and recover when
                                     required. COMMIT requests if received will be handled in a
                                     default manner by fsyncing. STABLE writes are still handled
                                     in a sync manner.
           nfs.trusted-sync <on |    All writes and COMMIT requests are treated as async. This      Off
           off>                      implies that no write requests are guaranteed to be on
                                     server disks when the write reply is received at the NFS
                                     client. Trusted sync includes trusted-write behavior.
           nfs.export-dir            By default, all sub-volumes of NFS are exported as             Enabled
                                     individual exports. Now, this option allows you to export      for all
                                     only the specified subdirectory or subdirectories in the       sub
                                     volume. This option can also be used in conjunction with       directori
                                     nfs3.export-volumes option to restrict exports only to the     es
                                     subdirectories specified through this option. You must
                                     provide an absolute path.
           nfs.export-dirs <on |     By default, all sub-volumes of NFS are exported as             On
           off>                      individual exports. Now, this option allows you to export
                                     specified subdirectory or subdirectories in the volume.
                                     Enabling this option allows any directory on a volume to be
                                     exported separately.
           nfs.export-volumes <on    Enable/Disable exporting entire volumes, instead if used in    On
           | off>                    conjunction with nfs3.export-dir, can allow setting up
                                     only subdirectories as exports.
           nfs.rpc-auth-unix <on |   Enable/Disable the AUTH_UNIX authentication type. You          On
           off>                      must enable this option for better interoperability.
                                     However, you can disable it if required.
           nfs.rpc-auth-null <on |   Enable/Disable the AUTH_NULL authentication type. You          On
           off>                      must always enable this option.
           nfs.rpc-auth-allow <IP-   Allow a comma separated list of addresses and/or               Reject
           Addresses>                hostnames to connect to the server. By default, all clients    All
                                     are disallowed. This allows you to define a general rule for
                                     all exported volumes.




Gluster File System                             Release_Notes_3.1.3_01_C                                        Pg No. 6
         ds


                      NFS Option                               Description                             Default
                                                                                                        Value
           nfs.rpc-auth-reject <IP-   Reject a comma separated list of addresses and/or                Reject
           Addresses>                 hostnames from connecting to the server. By default, all         All
                                      connections are disallowed. This allows you to define a
                                      general rule for all exported volumes.
           nfs.ports-insecure <on |   Allow client connections from unprivileged ports. By default     Off
           off>                       only privileged ports are allowed. This is a global setting in
                                      case insecure ports are to be enabled for all exports using a
                                      single option.
           nfs.addr-namelookup        Turn-off name lookup for incoming client connections using       On
           <on | off>                 this option. In some setups, the name server can take too
                                      long to reply to DNS queries resulting in timeouts of mount
                                      requests. Use this option to turn off name lookups during
                                      address authentication. Note, turning this off will prevent
                                      you from using hostnames in rpc-auth.addr.* filters.
           nfs.enable-ino32 <on |     For NFS clients or apps that do not support 64-bit inode         Off
           off>                       numbers, use this option to make NFS return 32-bit inode
                                      numbers instead. Disabled by default so NFS returns 64-bit
                                      inode numbers by default.
           nfs.register-with-         For systems that need to run multiple NFS servers, you need      On
           portmap <on | off>         to prevent more than one from registering with portmap
                                      service. Use this option to turn off portmap registration for
                                      Gluster NFS.
           nfs.port <PORT-            Use this option on systems that need Gluster NFS to be           38465-
           NUMBER>                    associated with a non-default port number.                       38467
           nfs.disable <on | off>     Turn-off volume being exported by NFS                            Off

         2.2. Sharing Volume through RDMA and TCP/IP Simultaneously
         You can create and share volumes with both RDMA and TCP/IP transport type. The set transport type
         of the volume can be viewed by issuing gluster volume info command.

         2.3. Option to turn-off volume being exported by NFS
         You can turn-off volume being exported by NFS option by issuing gluster volume set
         <VOLNAME> nfs.disable on command.




Gluster File System                              Release_Notes_3.1.3_01_C                                        Pg No. 7
         ds




         3. Dropped Features
         No feature is dropped from this release.




Gluster File System                             Release_Notes_3.1.3_01_C   Pg No. 8
         ds




         4. System Requirements
         4.1. Storage Severs
         Gluster supports the following storage servers:
              Intel/AMD x86 64-bit processor
              Disk: 8GB minimum using direct-attached-storage, RAID, Amazon EBS, and FC/Infiniband/iSCSI
              SAN disk backend using SATA/SAS/FC disks
              Memory: 1GB minimum

         4.2. Networking Requirements
         Gluster supports the following networks:
              Gigabit Ethernet
              10 Gigabit Ethernet
              InfiniBand
                     OFED 1.5 or later

         4.3. Operating System Requirements
           Operating System                      Architecture               Modes
           CentOS => 5.1                         x86_64                     Client & Server

         GlusterFS may work with other common Linux distribution like RHEL 5.1 or higher, Ubuntu 8.04 or
         higher, and Fedora 11, but has not been tested extensively.

         4.4. File System Requirements
         Gluster recommends Ext4 (for Linux kernel 2.6.31 or higher) and Ext3 (for all earlier versions) when
         formatting the disk sub-subsystem. Any other POSIX compliant disk file system, such as XFS or ZFS
         may also work, but has not been tested widely.




Gluster File System                              Release_Notes_3.1.3_01_C                                       Pg No. 9
         ds




         5. Downloading and Installing GlusterFS 3.1.3
         You can download and install the GlusterFS 3.1.3 or upgrade to latest version.

         5.1. Downloading GlusterFS 3.1.3
         You can download the latest software to each server in your cluster from here.

         5.2. New Installation
         The installation process for GlusterFS server is available at:
         http://www.gluster.com/community/documentation/index.php/Gluster_3.1:_Installing_GlusterFS_S
         erver.

         5.3. Compatibility
         Release 3.1.3 of GlusterFS is compatible with 3.1.2 or lower releases of GlusterFS.
         Release 3.1.3 of GlusterFS is not compatible with 2.0.x and 3.0.x releases of GlusterFS.

         5.4. Upgrade
         Gluster recommends that you back up your data before upgrading to GlusterFS 3.1.3


         For detailed instructions on upgrading from 3.0.x to 3.1, see
         http://www.gluster.com/community/documentation/index.php/Gluster_3.0_to_3.1_Upgrade_Guide

         For instructions on upgrading from 3.1.1 to 3.1.3, see
         http://www.gluster.com/community/documentation/index.php/Gluster_3.1_to_3.1.1_Upgrade_Guid
         e
         NOTE: Configurations generated outside the scope of gluster CLI are neither recommended nor
         supported by Gluster.




Gluster File System                               Release_Notes_3.1.3_01_C                              Pg No. 10
         ds




         6. Issues Resolved in GlusterFS 3.1.3
         The following are the major bugs resolved in the Gluster FS 3.1.3:
              Bug 1453: Fixed the issue of hanging mount point in case of invalid host name is given during
              mount command.
              Bug 1991: Fixed the issue generated during self-heal of directories, or rebalance of layout
              happening on distributed volumes. The extended attributes are now copied/healed
              appropriately.
              Bug 2064: Fixed the issue of NFS options being removed in /etc/glusterd/nfs/nfs-server.vol upon
              restarting glusterd.
              Bug 2094: Fixed the issue related to turning off NFS.
              Bug 2258: Fixed the layout issue occurred during rebalance volume.
              Bug 2294: Fixed the issue of setting both RDMA and TCP/IP transport type while creating
              volumes.
              Bug 2369: Fixed the permission issues which occurred during rebalancing volumes.
              Bug 2454: Fixed the issue of fops like write receiving payload data in more than one vector. This
              can happen with write-behind being loaded on client side.




Gluster File System                               Release_Notes_3.1.3_01_C                                        Pg No. 11
         ds




         7. Known Issues
         The following are the known issues:
              FIO crashes on a fuse mount
         FIO application crashes on gluster, because fuse does not support O_DIRECT flags for opens over the
         mount point. For more information, see bug 2174.
              Sticky bit gets removed after rebalancing volume
         The current way of rebalance logic has this limitation. This will be fixed in future release.
          For more information, see bug 2523.




Gluster File System                              Release_Notes_3.1.3_01_C                                      Pg No. 12
         ds




         8. Documentation
         Product documentation of GlusterFS is available at:
         http://www.gluster.com/community/documentation/index.php/Main_Page .




Gluster File System                             Release_Notes_3.1.3_01_C        Pg No. 13
         ds




         9. Appendix – Bugs Fixed
         The following are the list of bugs fixed in GlusterFS 3.1.3:
           Bug Number         URL
           329                http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=329
           625                http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=625
           1172               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1172
           1174               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1174
           1188               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1188
           1404               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1404
           1453               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1453
           1598               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1598
           1761               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1761
           1783               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1783
           1922               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1922
           2005               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2005
           2064               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2064
           2066               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2066
           2094               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2094
           2113               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2113
           2124               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2124
           2153               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2153
           2157               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2157
           2194               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2194
           2213               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2213
           2221               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2221
           2240               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2240
           2241               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2241
           2249               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2249
           2250               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2250
           2258               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2258
           2273               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2273
           2279               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2279
           2281               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2281
           2287               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2287
           2289               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2289
           2294               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2294
           2296               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2296
           2298               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2298
           2308               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2308
           2314               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2314
           2319               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2319
           2321               http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2321




Gluster File System                               Release_Notes_3.1.3_01_C                     Pg No. 14
         ds


           Bug Number   URL
           2332         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2332
           2333         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2333
           2335         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2335
           2345         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2345
           2354         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2354
           2369         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2369
           2370         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2370
           2371         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2371
           2374         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2374
           2393         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2393
           2409         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2409
           2410         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2410
           2418         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2418
           2426         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2426
           2435         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2435
           2436         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2436
           2440         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2440
           2442         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2442
           2443         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2443
           2444         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2444
           2447         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2447
           2450         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2450
           2452         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2452
           2454         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2454
           2461         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2461
           2481         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2481
           2483         http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=2483




Gluster File System                      Release_Notes_3.1.3_01_C                        Pg No. 15

				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:2
posted:2/17/2012
language:English
pages:15