Description of problem: The procedure described here: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Self-Hosted_Engine_Guide/index.html#chap-Migrating_from_Bare_Metal_to_a_RHEL-Based_Self-Hosted_Environment Ends up in a broken state in two scenarios: A. If the management network is not set as a VM Network in the Original Setup B. If it's a upgrade from pre-3.6, where the management network is rhevm. Hosted-Engine --deploy has a default of 'ovirtmgmt', which later won't match the DB. Because: A. There will be no rhevm/ovirtmgmt bridge to attach the HE VM to if it's not a VM network. B. --deploy default network is ovirtmgmt, but in 3.5 and below it's rhevm. So if setup was upgraded, the network name won't match the DB and things go south. In both scenarios the HostedEngine vm.conf, after the system is up, ends up with incorrect/missing configuration in it's network section. Example: devices={nicModel.....network:None....} results in <interface address="None" type="bridge"> <mac address="00:16:3e:1e:cd:f5"/> <model type="virtio"/> <source bridge="None"/> <link state="up"/> </interface> Which results in: libvirtError: Cannot get interface MTU on 'None': No such device I don't think it's a software bug. In my opinion this is just incorrect configuration for these two cases. Version-Release number of selected component (if applicable): rhevm-3.6.8 How reproducible: 100% Steps to Reproduce: 1. Install RHEV 3.5- with non-VM network rhevm 2. Upgrade to 3.6 3. Migrate to Hosted-Engine Actual results: HostedEngine faces multiple issues, not able to start on second reboot, missing NIC, missing bridge... Expected results: Additional info: I haven't tested yet, but I believe this is also the case in RHV 4.0, where possibly more customers will probably think of migrating to SHE. And some of they may come from pre-3.6 installs. - Problem A is easily solved with a Note in the documentation: * Please configure the management network as a VM network prior to Migrating to SHE. - Problem B is slightly more complex, but possibly solved by appending an additional config to hosted-engine --deploy. See below: # cat /tmp/answers-rhevm.conf OVEHOSTED_NETWORK/bridgeName=str:rhevm # hosted-engine --deploy --config-append=/tmp/answers-rhevm.conf
Can you help with updating the KBase?
Documentation team, please handle this bug soon. Action required: For both 3.6 and 4.0 guides add the following to Procedure 5.1. Migrating to a Self-Hosted Environment Part A: "Step 13: Creating a Backup of BareMetal-Manager" Either modify that step with a NOTE or add a new step before it. The instruction should be: "Make sure the management network is configured as a VM network prior to taking the backup. If it is not, configure it, as per [optional link to the admin guide where we should how to do that]" Part B: "Step 1: Initiating a Self-Hosted Engine Deployment" Add a Note on top of the step saying: "If your original installation was done on earlier RHEV version then 3.6 and your current management network name is rhevm, when running hosted-engine --deploy, provide it with a modified answering file as [below/stated in this KCS]: # cat /tmp/answers-rhevm.conf OVEHOSTED_NETWORK/bridgeName=str:rhevm # hosted-engine --deploy --config-append=/tmp/answers-rhevm.conf " Comments on B: It sounds reasonable to me to create a KCS for this and reference to a KCS. However, I am not sure this solution would work on RHEV-H. And that's why it can be indeed better to reference to KCS and once we find that solution to modify the KCS (if that solution exists, of course). Or we can state that we only support RHEL hosts in such a case.
Here is the KCS: https://access.redhat.com/solutions/2292861 However, I do not think we should link it to the documentation on Part B. The suggested wording should be enough.
As reported in bug 1454998, we should also document that currently Self-hosted Engine cannot use VM-FEX.
Can you review this bug and the linked documentation and recommended on the needed additions and changes?
Lucy, let's reference: https://access.redhat.com/solutions/2292861
Assigning to Emma for review.
Marina/Yaniv In https://bugzilla.redhat.com/show_bug.cgi?id=1369690#c3 Marina said that she doesn't think that the note should link to this KB article. However, Yaniv suggested that we should link to it. Can you please confirm that what you think should appear in the guide. Also, the article only mentions 3.5 to 3.6. I am updating only the 4.0 and 4.1 guides, so does it still make sense to reference a 3.6 article? Has the solution been confirmed for 4.0 and 4.1?
Marina, does this issue only occur when migrating to a self-hosted from a 3.5 environment? If so, I don't think it is even relevant for 4.x and we are no longer updating 3.6.
(In reply to Emma Heftman from comment #13) > Marina, does this issue only occur when migrating to a self-hosted from a > 3.5 environment? > If so, I don't think it is even relevant for 4.x and we are no longer > updating 3.6. Hi Marina, after speaking to Lucy, I understand that we will update the 3.6 where required.
*** Bug 1449547 has been marked as a duplicate of this bug. ***
The 3.6 Self-Hosted Engine Guide is available on the Customer Portal: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Self-Hosted_Engine_Guide/index.html#Migrating_to_a_Self-Hosted_Environment
The 4.1 Self-Hosted Engine Guide is available on the Customer Portal: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/self-hosted_engine_guide/#Migrating_to_a_Self-Hosted_Environment