Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/sect-NFS.html Section Number and Name: 7.2.3.x Describe the issue: The `gluster nfs-ganesha enable` command will in fact start the nfs-ganesha and pacemaker services, so at runtime everything will begin operating as expected. However, on a reboot neither the nfs-ganesha nor the pacemaker services start as they have not been enabled with systemctl or chkconfig, so the cluster does not start and NFS does not serve exports. The nfs-ganesha and pacemaker services should be enabled with systemctl to ensure the services survive a reboot. Suggestions for improvement: Add instructions to enable these services. With RHEL 7: systemctl enable nfs-ganesha.service systemctl enable pacemaker.service Additional information:
BZ1236017 captures the discussions we had to some extent with respect to nfs-ganesha service not starting by default. Do we still need to document to enable the service by default or leave it to admin to decide?
Thanks Soumya! The conversation in BZ1236017 does cover the question of the nfs-ganesha service, but not the pacemaker service, which the docs also do not say to enable. Without the pacemaker service enabled at boot time, the cluster will not form and starting the nfs-ganesha service will not result in the VIP failing back to the node.
I've edited the title to reflect that we only need to update the docs for the pacemaker service and not the nfs-ganesha service.
(In reply to Dustin Black from comment #3) > Thanks Soumya! > > The conversation in BZ1236017 does cover the question of the nfs-ganesha > service, but not the pacemaker service, which the docs also do not say to > enable. > > Without the pacemaker service enabled at boot time, the cluster will not > form and starting the nfs-ganesha service will not result in the VIP failing > back to the node. Right. Thanks for the update.
An additional bullet point is added to enable pacemaker under "7.2.3.3.1. Prerequisites to run NFS-Ganesha". *Enable the pacemaker service using the following command: For Red Hat Enterprise Linux 6: # chkconfig --add pacemaker # chkconfig pacemaker on For Red Hat Enterprise Linux 7: # systemctl enable pacemaker.service Dustin, I have added the command for RHEL 6 too. Can you let me know if both the commands are necessary or should i remove " # chkconfig pacemaker on". http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-3.1.2-Stage_Administration_Guide%20%28html-single%29/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#sect-NFS_Ganesha
Looks good.
Moving the bug on_qa.
Verified this bug on both RHEL 6 and RHEL 7 platform by enabling the pacemaker service, as mentioned in the doc, using below commands For Red Hat Enterprise Linux 6: # chkconfig --add pacemaker # chkconfig pacemaker on For Red Hat Enterprise Linux 7: # systemctl enable pacemaker.service http://10.34.3.139:8080/view/Gluster/job/doc-Red_Hat_Gluster_Storage-3.1.2-Administration_Guide%20%28html-single%29/ws/tmp/en-US/html-single/index.html#sect-NFS_Ganesha After reboot, pacemaker service was started automatically. based on the document content and verified steps, marking this bug as Verified.