Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1686887

Summary: Documentation incorrect for "fake" pxe driver
Product: Red Hat OpenStack Reporter: Jeremy <jmelvin>
Component: documentationAssignee: Alex McLeod <amcleod>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: medium Docs Contact:
Priority: medium    
Version: 13.0 (Queens)CC: amcleod, dcadzow, dhill
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-01-13 14:04:55 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Jeremy 2019-03-08 15:29:31 UTC
Description of problem:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/director_installation_and_usage/index#sect-Fake_PXE_Driver

Shoud say instead: 

To enable this driver, add fake to the enabled_driver option in your undercloud.conf

Because:




openstack overcloud node import ~/instackenv.json
Started Mistral Workflow tripleo.baremetal.v1.register_or_update. Execution ID: b57e83b3-4aea-4e87-838c-439a78335803
Waiting for messages on queue 'tripleo' with no timeout.
Resource temporarily unavailable, please retry. (HTTP 503)
Exception registering nodes: Resource temporarily unavailable, please retry. (HTTP 503)

###not working with fake
[root@director13 stack]# grep ^enabled_driver /etc/ironic/ironic.conf
enabled_drivers=pxe_drac,pxe_ilo,pxe_ipmitool,fake
(undercloud) (undercloud) [root@director13 stack]# grep ^enabled_hardware /etc/ironic/ironic.conf
enabled_hardware_types=redfish,ipmi,idrac,fake,ilo
(undercloud) (undercloud) [root@director13 stack]# 


[root@director13 stack]#  systemctl status openstack-ironic-conductor
● openstack-ironic-conductor.service - OpenStack Ironic Conductor service
   Loaded: loaded (/usr/lib/systemd/system/openstack-ironic-conductor.service; enabled; vendor preset: disabled)
   Active: inactive (dead) since Fri 2019-03-08 10:10:42 EST; 3s ago
  Process: 24356 ExecStart=/usr/bin/ironic-conductor (code=exited, status=0/SUCCESS)
 Main PID: 24356 (code=exited, status=0/SUCCESS)

grep pm_type instackenv.json 
            "pm_type":"fake_pxe"
            "pm_type":"fake_pxe"



###changed to fake driver
[root@director13 stack]# grep ^enabled_driver /etc/ironic/ironic.conf
enabled_drivers=pxe_drac,pxe_ilo,pxe_ipmitool,fake

####do not set enabled_hardware to fake or will not work!!!
(undercloud) (undercloud) [root@director13 stack]# grep ^enabled_hardware /etc/ironic/ironic.conf
enabled_hardware_types=redfish,ipmi,idrac,ilo
(undercloud) (undercloud) [root@director13 stack]# 
systemctl restart openstack-ironic-conductor
(undercloud) (undercloud) [root@director13 stack]#  systemctl status openstack-ironic-conductor
● openstack-ironic-conductor.service - OpenStack Ironic Conductor service
   Loaded: loaded (/usr/lib/systemd/system/openstack-ironic-conductor.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2019-03-08 10:13:50 EST; 2s ago
 Main PID: 24710 (ironic-conducto)
    Tasks: 1
   CGroup: /system.slice/openstack-ironic-conductor.service
           └─24710 /usr/bin/python2 /usr/bin/ironic-conductor


 grep pm_type instackenv.json 
            "pm_type":"fake"
            "pm_type":"fake"

$ openstack overcloud node import ~/instackenv.json
2node(s) successfully moved to the "manageable" state.
Successfully registered node UUID 9dd2848e-4ecd-4eec-87be-7395a3e34112
Successfully registered node UUID a0916216-656c-49bf-98ba-6e0476c5aefb

Comment 2 David Hill 2019-08-13 19:43:57 UTC
We should document on how to set this through the hieradata too... I don't think documenting manual changes of the configuration is the best approach here.