Bug 1293253

This bug is automatically being proposed for the current z-stream release of Red Hat Gluster Storage 3 by setting the release flag 'rhgs‑3.1.z' to '?'. 

If this bug should be proposed for a different release, please manually change the proposed release flag.

This is due to the S29CTDB* hook scripts being changed (fixed) in RHGS 3.1.2 to not touch smb.conf. [A Samba installation is either clusterd or not clustered, that does not change due to a lock volume being available or not...]

We should possibly also add a note to the section on configuring Samba, that the admin needs to put 'clustering = yes' into smb.conf before starting ctdb and leave it there.

(We could also put this into the rhs-smb.conf snipped shipped with our samba packages...)

(In reply to Michael Adam from comment #2)
> This bug is automatically being proposed for the current z-stream release of
> Red Hat Gluster Storage 3 by setting the release flag 'rhgs‑3.1.z' to '?'. 
> 
> If this bug should be proposed for a different release, please manually
> change the proposed release flag.

ignore this -- copy'n'paste error ... :-/

https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/sect-SMB.html

7.3.1:
Setting up CTDB for Samba 

Prerequisites section:
yum install ctdb2.5 should be changed to yum install ctdb

Hi Surabhi,

I have made the changes suggested:

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Administration_Guide%20%28html-single%29/lastStableBuild/artifact/tmp/en-US/html-single/index.html#idm139901669488864

1. Add clustering =yes to be added manually before ctdb start.

2. ctdb service start should be added just after ctdb config.

In section 7.3 SMB :

In warning section have to add one more point :

The CTDB version 2.5 is being deprecated from Red Hat Gluster Storage 3.1 Update 2 release. Further updates will not be provided for ctdb2.x. You must upgrade the system to ctdb-4.x, which is provided in a separate channel or repository, for all updates including the security updates. For more information regarding the installation and upgrade steps refer the Red Hat Gluster Storage 3.1 Installation Guide. 

Michael, could you review this and provide your inputs for this.

Just a small correction :


The CTDB version 2.5 is being deprecated from Red Hat Gluster Storage 3.1 Update 2 release. Further updates will not be provided for ctdb2.x. You must upgrade the system to ctdb-4.x, which is provided in samba channel, for all updates including the security updates. For more information regarding the installation and upgrade steps refer the Red Hat Gluster Storage 3.1 Installation Guide.

Also just before yum install ctdb add a note that :

Ensure that you are subscribed to samba channel to get latest ctdb packages.

(In reply to surabhi from comment #10)
> Just a small correction :
> 
> 
> The CTDB version 2.5 is being deprecated from Red Hat Gluster Storage 3.1
> Update 2 release. 

Maybe omit ' release' ?

> Further updates will not be provided for ctdb2.x.

> You must
> upgrade the system to ctdb-4.x, which is provided in samba channel, for all
> updates including the security updates.

Possibly reverse the order for increased clarity:

"For all updates including security updates, you must upgrade ..."

> For more information regarding the
> installation and upgrade steps refer the Red Hat Gluster Storage 3.1

refer +to the ...

> Installation Guide.


The question is how strong a statement we want to make:

The above reads as if a customer can continue using ctdb 2.5, but
should install ctdb from the samba channels in  order to receive
further updates.

A slightly stronger statement might be similar to this:

CTDB version 2.5 is being deprecated from Red Hat Gluster Storage 3.1 Update 2 and is not supported any more. Further updates will not be provided for ctdb2.5.
Starting with RHGS 3.1.2, the CTDB software is provided by the Samba channel.
In order to use CTDB in RHGS 3.1.2 and newer, you must install CTDB  4.x from the samba-channel. ...

Not 100% sure what our position is, here. I would prefer a stronger variant.

Bug #1298830 is the counterpart of this BZ for the installation guide. They should be in sync.

Bug #1298893 treats correspondong changes to the RHGS lifecycle page. I think the wordings should be sync'd.

Hi Surabhi,

Have added the "warning" and made the other changes based on your comments and our discussions with Raghavendra.

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Administration_Guide%20%28html-single%29/lastStableBuild/artifact/tmp/en-US/html-single/index.html#sect-SMB

Hi Bhavana,

The note should be above the yum install ctdb command.

Rest look fine.

"... must upgrade the system to CTDB 4.x, which is provided in a separate channel or repository."

I think that 'in a separate channel or repository.' sounds very mysterious.
Can we name it as the samba-channel?

Have made the suggested changes:

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Administration_Guide%20%28html-single%29/lastStableBuild/artifact/tmp/en-US/html-single/index.html#idm140133827565168

Looks good to me, thanks!

All changes are made and the doc looks fine. Moving the BZ to verified.