Red Hat Bugzilla – Bug 1449842
[RFE] Need to correct guide to reflect virt-who.d configuration naming requirements
Last modified: 2018-08-31 11:19 EDT
Document URL: https://access.redhat.com/documentation/en-us/red_hat_satellite/6.2/html-single/virtual_instances_guide/#virt_who_configuration_files Section Number and Name: 5.1. VIRT-WHO CONFIGURATION FILES Describe the issue: At the time this documentation was written, any file with any or no extension, could be used as a config file inside '/etc/virt-who.d/'. With the release of virt-who-0.19.x+ this is no longer the case. We should cover all of this documentation relating to configuration in the virt-who.d drop directory to note that all usable config files must have the '.conf' suffix. (ex. rhev1.conf, vsphere22.conf, etc..) Anything without '.conf' as the suffix will now be completely ignored as a configuration file in this directory. (No longer a universal drop directory) Suggestions for improvement: Additional information: This is already live in RHEL 6's current release of virt-who. There is still a BZ in progress for RHEL 7's next release, that also is working to include correction to the error we will see if we cannot find a config file ending in '.conf' here: https://bugzilla.redhat.com/show_bug.cgi?id=1369107
Note: This needs to be evaluated for the entire 5.x section of the guide to ensure all instances of reference to configuration in '/etc/virt-who.d/' are changed to reflect the '.conf' suffix requirement.
Looking for a place to clone this BZ in relation to additional copy of this documentation that will also need to be identically updated: https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1.0/html-single/virtual_instances_guide/
Assigning to Michaela for review. Michaela - it looks like we will need the following changes: * A second 'Note' box at the top of Section 5.1 that tells users that the conf files in the directory mentioned in the summary above must end in .conf when the version of virt-who is 'virt-who-0.19' or above. * Change item 4. in Section 5.1.2 to '/etc/virt-who.d/*.conf' * Change the conf file name in Step 2. of Section 5.3 from 'rhevmhost1' to 'rhevmhost1.conf' * Change the conf file name in Step 4. of Section 5.4 from 'rhelhost1' to 'rhelhost1.conf' * Change the conf file name in Step 2. of Section 5.5 from 'vcenterhost1' to 'vcenterhost1.conf' A brief look over the chapter to see any other instances of conf files that could be similarly renamed may also be a good idea.
These changes are now live on the customer portal.