Bug 1667746 - RHHI fails to install via cockpit at gdeploy step
Summary: RHHI fails to install via cockpit at gdeploy step
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Deploying_RHHI
Version: rhhiv-1.6
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ---
: RHHI-V 1.6
Assignee: Laura Bailey
QA Contact: SATHEESARAN
URL:
Whiteboard:
Depends On:
Blocks: RHHI-V-1-6-Documentation-InFlight-BZs
TreeView+ depends on / blocked
 
Reported: 2019-01-20 19:52 UTC by Brian J. Atkisson
Modified: 2019-05-20 04:18 UTC (History)
18 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-05-20 04:18:22 UTC
Embargoed:


Attachments (Terms of Use)
Picture (40.44 KB, image/png)
2019-01-21 10:11 UTC, Wei Wang
no flags Details
Volume selection screenshot (36.26 KB, image/png)
2019-04-12 10:33 UTC, SATHEESARAN
no flags Details
Review and edit (44.51 KB, image/png)
2019-04-12 10:34 UTC, SATHEESARAN
no flags Details
Review and edit (43.65 KB, image/png)
2019-04-12 10:36 UTC, SATHEESARAN
no flags Details

Description Brian J. Atkisson 2019-01-20 19:52:50 UTC
Description of problem:

When following the directions at https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.5/html-single/deploying_red_hat_hyperconverged_infrastructure_for_virtualization/#install-host-physical-machines, which refers to https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html/installation_guide/installing_cockpit_on_linux_hosts, the installer fails with a gdeploy error (attached).

Version-Release number of selected component (if applicable):

[root@rhv ~]# rpm -qa | grep ovirt
ovirt-hosted-engine-setup-2.2.32-1.el7ev.noarch
ovirt-engine-sdk-python-3.6.9.1-1.el7ev.noarch
python-ovirt-engine-sdk4-4.2.9-1.el7ev.x86_64
ovirt-setup-lib-1.1.5-1.el7ev.noarch
cockpit-machines-ovirt-176-4.el7.noarch
ovirt-provider-ovn-driver-1.2.16-1.el7ev.noarch
ovirt-hosted-engine-ha-2.2.18-1.el7ev.noarch
ovirt-vmconsole-host-1.0.4-1.el7ev.noarch
cockpit-ovirt-dashboard-0.11.37-1.el7ev.noarch
ovirt-host-dependencies-4.2.3-1.el7ev.x86_64
ovirt-vmconsole-1.0.4-1.el7ev.noarch
ovirt-host-deploy-1.7.4-1.el7ev.noarch
ovirt-imageio-daemon-1.4.5-0.el7ev.noarch
ovirt-host-4.2.3-1.el7ev.x86_64
ovirt-imageio-common-1.4.5-0.el7ev.x86_64
[root@rhv ~]# rpm -qa | grep cockpit
cockpit-system-173.1-1.el7.noarch
cockpit-storaged-176-4.el7.noarch
cockpit-machines-ovirt-176-4.el7.noarch
cockpit-ws-173.1-1.el7.x86_64
cockpit-ovirt-dashboard-0.11.37-1.el7ev.noarch
cockpit-173.1-1.el7.x86_64
cockpit-dashboard-176-4.el7.x86_64
cockpit-bridge-173.1-1.el7.x86_64



How reproducible: Always.


Steps to Reproduce:
1. Follow documentation at https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.5/html/deploying_red_hat_hyperconverged_infrastructure_for_virtualization_on_a_single_node/ word for word.
2. Docs direct you to follow https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html/installation_guide/chap-red_hat_enterprise_linux_hosts for RHEL-based hosts
3. Following cockpit-ovirt-dashboard install, bounce back to https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.5/html-single/deploying_red_hat_hyperconverged_infrastructure_for_virtualization/#install-host-physical-machines
4. Click 'Run Gluster Wizard for Single node'
5. Receive gdeploy error: Gdeploy isn't installed on Host. To continue deployment, please install Gdeploy on Host and try again.

Nowhere do the docs tell you to enable the gluster server repo and install the gdeploy package.  Even if you do this, the install still fails as the gluster-server package also needs to be installed.

Comment 1 Wei Wang 2019-01-21 10:10:26 UTC
Test Version
RHEL-7.6-20180814.0-Server-x86_64-boot.iso
ovirt-vmconsole-1.0.4-1.el7ev.noarch
python-ovirt-engine-sdk4-4.2.9-1.el7ev.x86_64
cockpit-machines-ovirt-176-4.el7.noarch
cockpit-ovirt-dashboard-0.11.37-1.el7ev.noarch
ovirt-host-deploy-1.7.4-1.el7ev.noarch
ovirt-host-dependencies-4.2.3-1.el7ev.x86_64
ovirt-setup-lib-1.1.5-1.el7ev.noarch
ovirt-imageio-daemon-1.4.5-0.el7ev.noarch
ovirt-host-4.2.3-1.el7ev.x86_64
ovirt-imageio-common-1.4.5-0.el7ev.x86_64
ovirt-provider-ovn-driver-1.2.16-1.el7ev.noarch
ovirt-hosted-engine-ha-2.2.18-1.el7ev.noarch
ovirt-vmconsole-host-1.0.4-1.el7ev.noarch
ovirt-hosted-engine-setup-2.2.32-1.el7ev.noarch
ovirt-engine-sdk-python-3.6.9.1-1.el7ev.noarch
cockpit-machines-ovirt-176-4.el7.noarch
cockpit-ovirt-dashboard-0.11.37-1.el7ev.noarch
cockpit-173.1-1.el7.x86_64
cockpit-bridge-173.1-1.el7.x86_64
cockpit-dashboard-176-4.el7.x86_64
cockpit-system-173.1-1.el7.noarch
cockpit-ws-173.1-1.el7.x86_64
cockpit-storaged-176-4.el7.noarch

Test Steps:
1. Clean install RHEL-7.6-20180814.0-Server-x86_64-boot.iso
2. Install cockpit-ovirt according to https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html/installation_guide/enabling_the_red_hat_enterprise_linux_host_repositories_rhel_install
3. Login to cockpit with root account
4. Click "start" button underneath Hyperconverged in hosted-engine tab
5. Click 'Run Gluster Wizard for Single node'

Result:
Receive gdeploy error: Gdeploy isn't installed on Host. To continue deployment, please install Gdeploy on Host and try again.

QE can reproduce this issue, flag of qa_ack is changed to "+".

Comment 2 Wei Wang 2019-01-21 10:11:03 UTC
Created attachment 1522077 [details]
Picture

Comment 3 Brian J. Atkisson 2019-01-21 23:23:52 UTC
Is rh-gluster-3-for-rhel-7-server-rpms the correct repo to add as a work-around? Or is there a more fundamental problem other than incorrect documentation?

Comment 4 Sahina Bose 2019-01-22 06:55:49 UTC
(In reply to Brian J. Atkisson from comment #3)
> Is rh-gluster-3-for-rhel-7-server-rpms the correct repo to add as a
> work-around? Or is there a more fundamental problem other than incorrect
> documentation?

The documentation handles deployment on a RHV-H node, which is the supported platform for RHHI. With RHV-H, all required packages (including gdeploy) are pre-installed.
If you're deploying on a RHEL based node, you will need to subscrible to RHGS channels for the additional rpms. (Please reach out to khartsoe for partner documentation that handles this use case)

Comment 5 Brian J. Atkisson 2019-01-22 13:47:17 UTC
Hrm, if RHHI on RHEL is not a supported deployment, the docs really need to be updated to reflect this. It is not at all clear.

Comment 12 Sahina Bose 2019-04-02 08:43:26 UTC
Chapter 3 - 2d. Enable and start Cockpit
        systemctl enable cockpit
        systemctl start cockpit

Chapter 5 can be skipped for single node deployment, as there's no gluster traffic between nodes

Comment 17 SATHEESARAN 2019-04-12 10:31:03 UTC
There are few changes required.

1. Volume type is no longer listed as 'replicate' in the cockpit.
Its documented in Chapter 4.1, point 4 'Specify volumes' shows the
screenshot of 'replicate' volume type. Screenshot needs to be changes,
and also the important note beneath this point needs to be removed.
I will provide the screenshot for the same

2. Point6 'Review and edit configuration' shows the real hostname,
where as the deployment example started using host1.example.com
I will attach the screenshot for the same, please replace the same.

3. Section 4.2, point4 screenshot has the hostname as IP address.
It should be the same host name 'host1.example.com'
Can this screenshot be edited with graphic tools ?

4. Section 4.2, point5 screenshot has 2 problems
          a. hostname should be 'host1.example.com' instead of 'node1.example.com'
          b. mount options should be empty for single node deployment
Can this screenshot be edited with graphic tools ?

Comment 18 SATHEESARAN 2019-04-12 10:32:52 UTC
@Laura, can the requests in comment17 can be fixed ?

Comment 19 SATHEESARAN 2019-04-12 10:33:43 UTC
Created attachment 1554765 [details]
Volume selection screenshot

This is the screenshot to replace 'specify volumes' section screenshot

Comment 20 SATHEESARAN 2019-04-12 10:34:41 UTC
Created attachment 1554766 [details]
Review and edit

This is the 'review and edit' section screenshot

Comment 21 SATHEESARAN 2019-04-12 10:36:01 UTC
Created attachment 1554768 [details]
Review and edit

This is the screenshot for 'review and edit'

Comment 23 SATHEESARAN 2019-04-17 11:03:39 UTC
Verified the doc link and looks good


Note You need to log in before you can comment on or make changes to this bug.