<div dir="ltr"><div>We sent an email few days back for proposal to deprecate some features in glusterfs (<a href="https://lists.gluster.org/pipermail/gluster-devel/2018-July/054997.html">https://lists.gluster.org/pipermail/gluster-devel/2018-July/054997.html</a>).</div><div><br></div><div>Shyam recently sent the document as a patch upstream Gluster @ <a href="https://review.gluster.org/20538/">https://review.gluster.org/20538/</a>. (Same is copied below in email here). Please provide your valuable feedback on the same, so we can make it a general practice.<br></div><div><br></div><div>This is done for making things more clear about proper expectation from each of the component/feature, we want to have more classification of each feature, control them using the code itself, and make sure we keep the list up-to-date with each release, so our users have proper expectations set.<br><br class="gmail-Apple-interchange-newline"></div><div><content-from-patch></div><div><br></div><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">The purpose of the document is to define a classification for various xlators and expectations around what each classification means from a perspective of health and maintenance of the xlator.</p><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">The need to do this is to ensure certain classifications are kept in good health, and helps the community and contributors focus efforts on around the same.</p><h2 class="gmail-part" id="gmail-Classifications" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.5em;padding-bottom:0.3em;border-bottom:1px solid rgb(238,238,238);letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Classifications" title="Classifications" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Classifications</h2><ol class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">Experimental (E)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">TechPreview (TP)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Maintained/Supported (M)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Sunset (S)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Deprecated (D)</li></ol><h3 class="gmail-part" id="gmail-Experimental-E" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.25em;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Experimental-E" title="Experimental-E" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Experimental (E)</h3><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">Developed in the experimental branch, for exploring new features. These are NEVER released, and MAYBE packaged to help with getting feedback from interested users.</p><h4 class="gmail-part" id="gmail-Quality-expectations" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Quality-expectations" title="Quality-expectations" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Quality expectations</h4><ul class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">Compiles</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Does not break nightly experimental regressions</li></ul><h3 class="gmail-part" id="gmail-TechPreview-TP" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.25em;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#TechPreview-TP" title="TechPreview-TP" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>TechPreview (TP)</h3><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">Features in master or release branches that are not complete for general purpose consumption, but are mature enough to invite feedback and host user data.</p><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">These features will receive better attention from maintainers/authors that are working on maturing the same, than ones in Experimental/Sunset/Deprecated states.</p><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">There is no grantee that these features will move to the Maintained state, and may just get Deprecated based on feedback, or other project goals or technical alternatives.</p><h4 class="gmail-part" id="gmail-Quality-expectations1" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Quality-expectations1" title="Quality-expectations1" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Quality expectations</h4><ul class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">Same as Maintained, sans<ul style="box-sizing:border-box;margin-top:0px;margin-bottom:0px;padding-left:2em"><li class="gmail-" style="box-sizing:border-box">Performance, Scale, other(?)</li></ul></li></ul><h3 class="gmail-part" id="gmail-Maintained-M" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.25em;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Maintained-M" title="Maintained-M" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Maintained (M)</h3><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">These features are part of the core Gluster functionality and are maintained actively. These are part of master and release branches and get high priority attention from maintainers and other interested contributors.</p><h4 class="gmail-part" id="gmail-Quality-expectations2" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Quality-expectations2" title="Quality-expectations2" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Quality expectations</h4><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">NOTE: A short note on what each of these mean are added here, details to follow.</p><ul class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">Bug backlog: Actively address bug backlog</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Enhancement backlog: Actively maintain outstanding enhancement backlog (need not be acted on, but should be visible to all)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Review backlog: Actively keep this below desired counts and states</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Static code health: Actively meet near-zero issues in this regard<ul style="box-sizing:border-box;margin-top:0px;margin-bottom:0px;padding-left:2em"><li class="gmail-" style="box-sizing:border-box">Coverity, spellcheck and other checks</li></ul></li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Runtime code health: Actively meet defined coverage levels in this regard<ul style="box-sizing:border-box;margin-top:0px;margin-bottom:0px;padding-left:2em"><li class="gmail-" style="box-sizing:border-box">Coverage, others?</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Per-patch regressions</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Glusto runs</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Performance</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Scalability</li></ul></li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Technical specifications: Implementation details should be documented and updated at regular cadence (even per patch that change assumptions in here)</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">User documentation: User facing details should be maintained to current status in the documentation</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Debuggability: Steps, tools, procedures should be documented and maintained each release/patch as applicable</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Troubleshooting: Steps, tools, procedures should be documented and maintained each release/patch as applicable<ul style="box-sizing:border-box;margin-top:0px;margin-bottom:0px;padding-left:2em"><li class="gmail-" style="box-sizing:border-box">Steps/guides for self service</li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Knowledge base for problems</li></ul></li><li class="gmail-" style="box-sizing:border-box;margin-top:0.25em">Other common criteria that will apply: Required metrics/desired states to be define per criteria<ul style="box-sizing:border-box;margin-top:0px;margin-bottom:0px;padding-left:2em"><li class="gmail-" style="box-sizing:border-box">Monitoring, usability, statedump, and other such xlator expectations</li></ul></li></ul><h3 class="gmail-part" id="gmail-Sunset-S" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.25em;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Sunset-S" title="Sunset-S" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Sunset (S)</h3><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">Features on master or release branches that would be deprecated and/or replaced with similar or other functionality in the next major release.</p><h4 class="gmail-part" id="gmail-Quality-expectations3" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Quality-expectations3" title="Quality-expectations3" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Quality expectations</h4><ul class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">Retain status-quo when moved to this state, till it is moved to deprecated</li></ul><h3 class="gmail-part" id="gmail-Deprecated-D" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:1.25em;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Deprecated-D" title="Deprecated-D" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Deprecated (D)</h3><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">Features/code still in tree, but not packaged or shipped or supported in any form. This is noted as a category till the code is removed from the tree.</p><p class="gmail-part" style="box-sizing:border-box;margin:0px 0px 16px;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial">These feature and their corresponding code and test health will not be executed.</p><h4 class="gmail-part" id="gmail-Quality-expectations4" style="box-sizing:border-box;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-weight:600;line-height:1.25;color:rgb(51,51,51);margin-top:24px;margin-bottom:16px;font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><a class="gmail-anchor gmail-hidden-xs" href="https://hackmd.io/q_aEokbxSBSN-LdoaJ6Z6A#Quality-expectations4" title="Quality-expectations4" style="box-sizing:border-box;background-color:transparent;color:rgb(51,122,183);text-decoration:none;float:left;padding-right:4px;line-height:1"><span class="gmail-octicon gmail-octicon-link" style="box-sizing:border-box;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:16px;line-height:1;font-family:octicons;display:inline-block;text-decoration:none;color:rgb(0,0,0);vertical-align:middle"></span></a>Quality expectations</h4><ul class="gmail-part" style="box-sizing:border-box;margin-top:0px;margin-bottom:16px;padding-left:2em;color:rgb(51,51,51);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";font-size:16px;letter-spacing:0.35px;text-decoration-style:initial;text-decoration-color:initial"><li class="gmail-" style="box-sizing:border-box">None</li></ul></content-from-patch><div><br></div><div>Regards,</div><div>Amar<br><div><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jul 19, 2018 at 12:26 PM, Amar Tumballi <span dir="ltr"><<a href="mailto:atumball@redhat.com" target="_blank">atumball@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><b style="font-weight:normal" id="gmail-m_-7397576002577491585gmail-docs-internal-guid-20f1d087-b150-f265-7a7b-38310e167fab"><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Hi all,</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Over last 12 years of Gluster, we have developed many features, and continue to support most of it till now. But along the way, we have figured out better methods of doing things. Also we are not actively maintaining some of these features.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">We are now thinking of cleaning up some of these ‘unsupported’ features, and mark them as ‘SunSet’ (i.e., would be totally taken out of codebase in following releases) in next upcoming release, </span><span style="font-size:10pt;font-family:"Courier New";color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">v5.0</span><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">. The release notes will provide options for smoothly migrating to the supported configurations.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are using any of these features, do let us know, so that we can help you with ‘migration’.. Also, we are happy to guide new developers to work on those components which are not actively being maintained by current set of developers.</span></p><h3 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:16.5pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">List of features hitting sunset:</span></h3><h4 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">‘cluster/stripe’ translator:</span></h4><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">This translator was developed very early in the evolution of GlusterFS, and addressed one of the very common question of Distributed FS, which is “What happens if one of my file is bigger than the available brick. Say, I have 2 TB hard drive, exported in glusterfs, my file is 3 TB”. While it solved the purpose, it was very hard to handle failure scenarios, and give a real good experience to our users with this feature. Over the time, Gluster solved the problem with it’s ‘Shard’ feature, which solves the problem in much better way, and provides much better solution with existing well supported stack. Hence the proposal for Deprecation.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are using this feature, then do write to us, as it needs a proper migration from existing volume to a new full supported volume type before you upgrade.</span></p><h4 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">‘storage/bd’ translator:</span></h4><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">This feature got into the code base 5 years back with this </span><a href="http://review.gluster.org/4809" style="text-decoration:none" target="_blank"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,122,183);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">patch</span></a><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">[1]. Plan was to use a block device directly as a brick, which would help to handle disk-image storage much easily in glusterfs.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">As the feature is not getting more contribution, and we are not seeing any user traction on this, would like to propose for Deprecation.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are using the feature, plan to move to a supported gluster volume configuration, and have your setup ‘supported’ before upgrading to your new gluster version.</span></p><h4 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">‘RDMA’ transport support:</span></h4><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Gluster started supporting RDMA while ib-verbs was still new, and very high-end infra around that time were using Infiniband. Engineers did work with Mellanox, and got the technology into GlusterFS for better data migration, data copy. While current day kernels support very good speed with IPoIB module itself, and there are no more bandwidth for experts in these area to maintain the feature, we recommend migrating over to TCP (IP based) network for your volume.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are successfully using RDMA transport, do get in touch with us to prioritize the migration plan for your volume. Plan is to work on this after the release, so by version 6.0, we will have a cleaner transport code, which just needs to support one type.</span></p><h4 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">‘Tiering’ feature</span></h4><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Gluster’s tiering feature which was planned to be providing an option to keep your ‘hot’ data in different location than your cold data, so one can get better performance. While we saw some users for the feature, it needs much more attention to be completely bug free. At the time, we are not having any active maintainers for the feature, and hence suggesting to take it out of the ‘supported’ tag.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are willing to take it up, and maintain it, do let us know, and we are happy to assist you.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">If you are already using tiering feature, before upgrading, make sure to do </span><span style="font-size:10pt;font-family:"Courier New";color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">gluster volume tier detach</span><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap"> all the bricks before upgrading to next release. Also, we recommend you to use features like </span><span style="font-size:10pt;font-family:"Courier New";color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">dmcache</span><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap"> on your LVM setup to get best performance from bricks.</span></p><h4 dir="ltr" style="line-height:1.2;margin-top:18pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:700;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">‘Quota’</span></h4><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">This is a call out for ‘Quota’ feature, to let you all know that it will be ‘no new development’ state. While this feature is ‘actively’ in use by many people, the challenges we have in accounting mechanisms involved, has made it hard to achieve good performance with the feature. Also, the amount of extended attribute get/set operations while using the feature is not very ideal. Hence we recommend our users to move towards setting quota on backend bricks directly (ie, XFS project quota), or to use different volumes for different directories etc.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">As the feature wouldn’t be deprecated immediately, the feature doesn’t need a migration plan when you upgrade to newer version, but if you are a new user, we wouldn’t recommend setting quota feature. By the release dates, we will be publishing our best alternatives guide for gluster’s current quota feature.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Note that if you want to contribute to the feature, we have </span><a href="https://github.com/gluster/glusterfs/issues/184" style="text-decoration:none" target="_blank"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,122,183);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">project quota based issue open</span></a><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">[2] Happy to get contributions, and help in getting a newer approach to Quota.</span></p><br><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"></p><hr><p></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">These are our set of initial features which we propose to take out of ‘fully’ supported features. While we are in the process of making the user/developer experience of the project much better with providing well maintained codebase, we may come up with few more set of features which we may possibly consider to move out of support, and hence keep watching this space.</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">[1] - </span><a href="http://review.gluster.org/4809" style="text-decoration:none" target="_blank"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,122,183);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">http://review.gluster.org/4809</span></a></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">[2] - </span><span style="text-decoration:underline;font-size:12pt;font-family:Roboto;color:rgb(51,122,183);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;vertical-align:baseline;white-space:pre-wrap"><a href="https://github.com/gluster/glusterfs/issues/184" style="text-decoration:none" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/184</a></span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span id="gmail-m_-7397576002577491585gmail-docs-internal-guid-20f1d087-b150-f265-7a7b-38310e167fab"></span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255);display:inline"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Regards,</span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255)"><span id="gmail-m_-7397576002577491585gmail-docs-internal-guid-20f1d087-b150-f265-7a7b-38310e167fab"></span></p><p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:12pt;background-color:rgb(255,255,255);display:inline"><span style="font-size:12pt;font-family:Roboto;color:rgb(51,51,51);background-color:transparent;font-weight:400;font-style:normal;font-variant:normal;text-decoration:none;vertical-align:baseline;white-space:pre-wrap">Vijay, Shyam, Amar</span></p></b><div><br></div><div class="gmail-m_-7397576002577491585gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><br></div></div></div></div></div>
</div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Amar Tumballi (amarts)<br></div></div></div></div></div>
</div></div></div></div>