From 5538051a64f9857b945e87c6412a4f85386004fe Mon Sep 17 00:00:00 2001 From: Niels de Vos Date: Thu, 14 May 2015 10:58:41 +0200 Subject: doc: add release notes for glusterfs-3.7.0 Change-Id: I4da42edc976ebcc5323270c82dfe445ba56f3eee BUG: 1199352 Signed-off-by: M S Vishwanath Bhat Signed-off-by: Vijay Bellur Signed-off-by: Niels de Vos Signed-off-by: Raghavendra Bhat Signed-off-by: Humble Chirammal Reviewed-on: http://review.gluster.org/10781 --- doc/release-notes/3.7.0.md | 167 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 doc/release-notes/3.7.0.md diff --git a/doc/release-notes/3.7.0.md b/doc/release-notes/3.7.0.md new file mode 100644 index 00000000000..bf542b7233b --- /dev/null +++ b/doc/release-notes/3.7.0.md @@ -0,0 +1,167 @@ +Release Notes for GlusterFS 3.7.0 + +## Major Changes and Features + +Documentation about major changes and features is included in the [`doc/features/` directory](https://github.com/gluster/glusterfs/tree/release-3.7/doc/features) of GlusterFS repository. + +### Bitrot Detection + +Bitrot detection is a technique used to identify an “insidious” type of disk error where data is silently corrupted with no indication from the disk to the +storage software layer that an error has occurred. When bitrot detection is enabled on a volume, gluster performs signing of all files/objects in the volume and scrubs data periodically for signature verification. All anomalies observed will be noted in log files. + +For more information, refer [here](http://www.gluster.org/community/documentation/index.php/Features/BitRot). + +### Multi threaded epoll for performance improvements + +Gluster 3.7 introduces multiple threads to dequeue and process more requests from epoll queues. This improves performance by processing more I/O requests. Workloads that involve read/write operations on a lot of small files can benefit from this enhancement. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/Feature_Smallfile_Perf). + +### Volume Tiering [Experimental] + +Policy based tiering for placement of files. This feature will serve as a foundational piece for building support for data classification. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/data-classification). + +Volume Tiering is marked as an experimental feature for this release. It is expected to be fully supported in a 3.7.x minor release. + +### Trashcan + +This feature will enable administrators to temporarily store deleted files from Gluster volumes for a specified time period. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/Trash). + +### Efficient Object Count and Inode Quota Support + +This improvement enables an easy mechanism to retrieve the number of objects per directory or volume. Count of objects/files within a directory hierarchy is stored as an extended attribute of a directory. The extended attribute can be queried to retrieve the count. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/Object_Count). + +This feature has been utilized to add support for inode quotas. + +For more details about inode quotas, refer [here](https://github.com/gluster/glusterfs/blob/master/doc/features/quota/quota-object-count.md). + +### Pro-active Self healing for Erasure Coding + +Gluster 3.7 adds pro-active self healing support for erasure coded volumes. + +### Exports and Netgroups Authentication for NFS + +This feature adds Linux-style exports & netgroups authentication to the native NFS server. This enables administrators to restrict access to specific clients & netgroups for volume/sub-directory NFSv3 exports. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/Exports_Netgroups_Authentication). + +### GlusterFind + +GlusterFind is a new tool that provides a mechanism to monitor data events within a volume. Detection of events like modified files is made easier without having to traverse the entire volume. + +For more information refer [here](https://github.com/gluster/glusterfs/blob/release-3.7/doc/tools/glusterfind.md). + +### Rebalance Performance Improvements + +Rebalance and remove brick operations in Gluster get a performance boost by speeding up identification of files needing movement and a multi-threaded mechanism to move all such files. + +For more information refer [here](http://www.gluster.org/community/documentation/index.php/Features/improve_rebalance_performance). + +### NFSv4 and pNFS support + +Gluster 3.7 supports export of volumes through NFSv4, NFSv4.1 and pNFS. This support is enabled via NFS Ganesha. Infrastructure changes done in Gluster 3.7 to support this feature include: + +- Addition of upcall infrastructure for cache invalidation. +- Support for lease locks and delegations. +- Support for enabling Ganesha through Gluster CLI. +- Corosync and pacemaker based implementation providing resource monitoring and failover to accomplish NFS HA. + +For more information refer the below links: + +- [NFS Ganesha Integration](https://github.com/gluster/glusterfs/blob/release-3.7/doc/features/glusterfs_nfs-ganesha_integration.md) +- [Upcall Infrastructure](http://www.gluster.org/community/documentation/index.php/Features/Upcall-infrastructure) +- [Gluster CLI for NFS Ganesha](http://www.gluster.org/community/documentation/index.php/Features/Gluster_CLI_for_ganesha) +- [High Availability for NFS Ganesha](http://www.gluster.org/community/documentation/index.php/Features/HA_for_ganesha) +- [pNFS support for Gluster](https://github.com/gluster/glusterfs/blob/release-3.7/doc/features/mount_gluster_volume_using_pnfs.md) + +pNFS support for Gluster volumes and NFSv4 delegations are in beta for this release. Infrastructure changes to support Lease locks and NFSv4 delegations are targeted for a 3.7.x minor release. + +### Snapshot Scheduling + +With this enhancement, administrators can schedule volume snapshots. + +For more information, see [here](http://www.gluster.org/community/documentation/index.php/Features/Scheduling_of_Snapshot). + +### Snapshot Cloning + +Volume snapshots can now be cloned to create a new writeable volume. + +For more information, see [here](http://www.gluster.org/community/documentation/index.php/Features/Clone_of_Snapshot). + +### Sharding [Experimental] + +Sharding addresses the problem of fragmentation of space within a volume. This feature adds support for files that are larger than the size of an individual brick. Sharding works by chunking files to blobs of a configurabe size. + +For more information, see [here](http://www.gluster.org/community/documentation/index.php/Features/sharding-xlator). + +Sharding is an experimental feature for this release. It is expected to be fully supported in a 3.7.x minor release. + +### RCU in glusterd + +Thread synchronization and critical section access has been improved by introducing userspace RCU in glusterd + +### Arbiter Volumes + +Arbiter volumes are 3 way replicated volumes where the 3rd brick of the replica is automatically configured as an arbiter. The 3rd brick contains only metadata which provides network partition tolerance and prevents split-brains from happening. + +For more information, see [here] +(https://github.com/gluster/glusterfs/blob/release-3.7/doc/features/afr-arbiter-volumes.md). + +### Better split-brain resolution + +split-brain resolutions can now be also driven by users without administrative intervention. + +For more information, see the 'Resolution of split-brain from the mount point' section [here](https://github.com/gluster/glusterfs/blob/release-3.7/doc/features/heal-info-and-split-brain-resolution.md). + +### Geo-replication improvements + +There have been several improvements in geo-replication for stability and performance. For more details, see [here](https://github.com/gluster/glusterfs/blob/release-3.7/doc/release-notes/geo-rep-in-3.7). + +### Minor Improvements + +* Message ID based logging has been added for several translators. +* Quorum support for reads. +* Snapshot names contain timestamps by default.Subsequent access to the snapshots should be done by the name listed in `gluster snapshot list` +* Support for `gluster volume get ` added. +* libgfapi has added handle based functions to get/set POSIX ACLs based on common libacl structures. + +### Known Issues + +* Enabling Bitrot on volumes with more than 2 bricks on a node is known to cause problems. +* Addition of bricks dynamically to cold or hot tiers in a tiered volume is not supported. +* The following configuration changes are necessary for qemu and samba integration with libgfapi to work seamlessly: + + ~~~ + # gluster volume set server.allow-insecure on + ~~~ + + Edit `/etc/glusterfs/glusterd.vol` to contain this line: `option rpc-auth-allow-insecure on` + + Post 1, restarting the volume would be necessary: + + ~~~ + # gluster volume stop + # gluster volume start + ~~~ + + Post 2, restarting glusterd would be necessary: + + ~~~ + # service glusterd restart + ~~~ + + or + + ~~~ + # systemctl restart glusterd + ~~~ + +### Upgrading to 3.7.0 + +Instructions for upgrading from previous versions of GlusterFS are maintained on [this wiki page](http://www.gluster.org/community/documentation/index.php/Upgrade_to_3.7). -- cgit