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

Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 1310059

Summary:	User guide lacks documentation on VM (dis)association
Product:	Red Hat Satellite	Reporter:	mertensb.mazda
Component:	Docs User Guide	Assignee:	Zac Dover <zdover>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Charles Wood <chwood>
Severity:	high	Docs Contact:
Priority:	high
Version:	6.1.6	CC:	adahms, dmacpher, mertensb.mazda
Target Milestone:	Unspecified	Keywords:	Reopened
Target Release:	Unused
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-03-27 23:17:49 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 mertensb.mazda 2016-02-19 10:58:29 UTC

Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html-single/User_Guide/index.html

Section Number and Name: n/a

Describe the issue: 
1) The user guide does not explain that when a host record that is associated with a VM is deleted the VM will be deleted as well.
2) The user guide does not explain the function of the associate VM's button on the compute resource screen.

Suggestions for improvement: 
1) There are two KB articles that explain this. I believe they should be included at least in the user guide and possibly in the provisioning guide as well.
- How to delete hosts from Foreman while keeping provisioned Virtual Machines in Red Hat Satellite 6 : https://access.redhat.com/solutions/1572333
- How to delete virtual machines from Satellite 6 WebUI, without actually deleting it from a compute resource?: https://access.redhat.com/solutions/1504603

2) this function should be explained in the user guide

Additional information:

Comment 1 Andrew Dahms 2016-11-15 11:56:17 UTC

Moving to NEW and the default assignee to be triaged as the schedule allows.

Comment 2 Andrew Dahms 2017-02-16 01:56:20 UTC

Assigning to Zac for review.

Zac - we'll need to add a procedure after 'Removing a Host' in the Host Configuration Guide that outlines the problem, and how disassociating virtual machines can help. Combining some of the context provided in the two KBase articles would provide some much-needed guidance as well.

As for the problem - A user wants to remove a host (in this case, a VM running on a hypervisor) from Satellite without also removing it from the hypervisor. To do so, they need to disassociate it first.

Comment 5 Andrew Dahms 2017-03-09 00:49:56 UTC

This content is live on the Customer Portal.

Closing.

Comment 6 mertensb.mazda 2017-03-13 08:27:05 UTC

Where can this be found?

The ticket is closed as currentrelease which I suppose is 6.2 right now but no user guide is available for 6.2.

So I checked the 6.1 user guide and I can't find it. Section 14.5 Removing a host does not mention this at all.

I searched for "associ" and found 45 hits but nothing related to this issue.

Comment 7 Andrew Dahms 2017-03-13 09:27:23 UTC

Thank you for following up on this bug, and my apologies for not providing a detailed link at the time the bug was closed.

In Red Hat Satellite 6.2, the 'User Guide' was split into two guides - a 'Server Administration Guide' that outlines how to administer the Satellite Server itself, and a 'Host Configuration Guide' that outlines how to work with and configure hosts.

The new content can be found in the following section of the Host Configuration Guide -

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.2/html-single/host_configuration_guide/#sect-Red_Hat_Satellite-Host_Configuration_Guide-Configuring_Hosts-Removing_a_Host

Let me know if you have any questions or concerns, or if we can move this bug to 'CLOSED'.

Comment 8 mertensb.mazda 2017-03-27 11:23:38 UTC

Thanks for the link and the info.

This looks good and this can be closed.

Comment 9 Andrew Dahms 2017-03-27 23:17:49 UTC

Thank you for confirming.

I will now close this bug, but please let us know if you have any further requests at any time.