+++ This bug was initially created as a clone of Bug #440115 +++ Description of problem: Customers are confused by LVM behavior when they try to use LVM on a RHEL4 cluster. Using LVM in a cluster requires CLVM (or HA-LVM). This requirement needs to be noted throughout the documentation in all relevant locations. Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info:
Steven, is this a request to add this to the RHEL4.7 release notes? if so, could you please name the package required for using LVM in a cluster? or if possible, point me to where this is documented already so i can simply copy it? :-) thanks!
Don, No, this is not a request to add this to the RHEL4.7 release notes, at least not yet. This is to keep track of a documentation problem. I'm trying to determine where this issue needs to be documented, and how. It requires a note in the LVM manual and probably in a couple of the cluster documents as well and that's what I'm researching. It may also turn out that this needs a mention in the release notes, but I don't know that yet. I'm re-assigning this to me. -Steven
To address Bugs 440115, 440134, and 440133 (Documentation needs to emphasize CLVM requirement for RHEL4 cluster), I plan to make the following updates to the Red Hat cluster documentation for the RHEL 4.x and RHEL 5.x documentation. This doesn't address the packaging question or the question of getting the warning to customers in a more prominent place than within the documentation, but it's the piece that we can provide within the documentation itself. Please let me know if you have any questions or comments. 1. The LVM manual (all relevant releases) a) I will add the following note to the section of the Introduction that summarizes running LVM in a cluster (and mentions the clvmd daemon): NOTE: Shared storage for use in Red Hat Cluster Suite requires that you be running the cluster logical volume manager daemon (clvmd) or the High Availability Logical Volume Management agents (HA-LVM). If you are not able to use either the clvmd daemon or HA-LVM for operational reasons or because you do not have the correct entitlements, you must not use single-instance LVM on the shared disk as this may result in data corruption. If you have any concerns please contact your Red Hat service representative. b) The LVM Administrative Overview chapter includes a subsection on "Creating LVM Volumes in a Cluster". I will add the same full note to that section. c) In the section describing all the LVM commands, I will add this note right after the first paragraph summarizing the chapter: NOTE: If you are creating or modifying an LVM volume for a clustered environment, you must ensure that you are running the clvmd daemon. For information, see "Creating LVM Volumes in a Cluster". 2. Red Hat Cluster Suite Overview (both RHEL 4 and RHEL 5) a) Section 1.6 of the Red Hat Cluster Suite Overview is a section on "Cluster Logical Volume Manager". After the first introductory paragraph, I will add the full note on shared storage. b) Right at the beginning of the Cluster Suite Overview, in the Introduction, there is a one-sentence summary of CLVM. I will add this note to that summary: NOTE: When you create or modify a CLVM volume for a clustered environment, you must ensure that you are running the clvmd daemon. For information, see "Cluster Logical Volume Manager". 3.Configuring and Managing a Red Hat Cluster (both RHEL 4 and RHEL 5) a) In the chapter on configuring Red Hat Cluster with Conga, there is a brief subsection on "Configuring Cluster Storage". It refers to the LVM manual for all CLVM information. I will add the full warning note about running the clvmd daemon. b) In the chapter on configuring Red Hat Cluster with system-config-cluster, there is a section on "Starting the Cluster Software". This already includes a step on starting clvmd if there are clustered volumes. I think we can also add the full note about running CLVMD or HA-LVM right here. This would bring up the issue with running clvmd at every instance of CLVM documentation. -Steven
I made all the indicated changes for all versions of the documents and filed an RT ticket to push the updated versions of the documents out to the documentation websites: https://engineering.redhat.com/rt3/Ticket/Display.html?id=24352