summaryrefslogtreecommitdiffstats
path: root/doc/release-notes/3.7.0.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/release-notes/3.7.0.md')
-rw-r--r--doc/release-notes/3.7.0.md167
1 files changed, 167 insertions, 0 deletions
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 <volname>` 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 <volname> 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 <volname>
+ # gluster volume start <volname>
+ ~~~
+
+ 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).