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 1139510 - Document --delete flag for hammer import
Summary: Document --delete flag for hammer import
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Docs Transition Guide
Version: 6.0.4
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: Unspecified
Assignee: David O'Brien
QA Contact: Peter Ondrejka
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-09-09 06:30 UTC by David O'Brien
Modified: 2019-09-26 16:28 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-04-28 00:06:06 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description David O'Brien 2014-09-09 06:30:01 UTC 
Description of problem:

Left-over from 6.0 review:

> 3.6.3 "Importing Users"
> 
> "Deleting imported Users" - you can use --delete with any command (including
> all, now). Do we want to describe it more generally?
> 
Prefer to make this 6.1 or async release post-GA. I think it needs more than a casual mention, and I need to know just what it does, and potential dangers.


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

6.0.4



Additional info:
Comment 1 RHEL Program Management 2014-09-09 06:33:14 UTC 
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.
Comment 3 RHEL Program Management 2015-04-21 16:10:30 UTC 
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.
Comment 4 David O'Brien 2015-12-14 03:00:57 UTC 
Rich (or anyone)

Can you provide a use case and example for this?

Looking at --help I see:
--delete  Delete entities instead of importing them
Default: false

Why would you do that? The existing section only describes how, not why.

http://file.bne.redhat.com/~daobrien/Satellite6.2-dev/Transition_Guide/
3.7.2. Importing Users
"Deleting Imported Users"

thanks
Comment 6 David O'Brien 2016-01-15 03:00:07 UTC 
Bumped the list for info.
Comment 9 David O'Brien 2016-01-19 01:34:27 UTC 
Based on Comment 7 perhaps we could turn this over to Peter for consideration for the Hammer Ref Guide?

Peter?
Comment 12 David O'Brien 2016-02-02 23:11:57 UTC 
adahms commented he'd review this and other hammer "need-info" bugs to determine where bets to put them.
Comment 13 Andrew Dahms 2016-02-03 03:23:52 UTC 
I agree that this content is a good candidate for the Transition Guide, where users will be most likely to use these commands.

We can add a link to the Transition Guide from the CLI Guide where necessary, but the scope of this bug shall cover the documentation of this flag in the Transition Guide.
Comment 14 David O'Brien 2016-02-09 02:45:50 UTC 
Here's the plan:

Because --delete works with any entity now, including "all", let's take the subsection "Deleting Users" out, and create a new entry in the FAQ about "undoing" an import. We can include info about "--delete <entity>" and "--delete all", include the extended info in this bug, and use the existing Deleting Imported Users subsection as an example.

The new entry can include the why, the how, example scenario, and the above-mentioned example.
Comment 15 Andrew Dahms 2016-02-09 03:10:15 UTC 
Hi David,

Thank you for the needinfo request - this sounds like a good plan of attack to me!

Kind regards,

Andrew
Comment 18 David O'Brien 2016-02-09 22:27:06 UTC 
Ack from Grant so I'll give it a quick once-over before peer review.
Comment 20 Andrew Dahms 2016-02-11 01:02:22 UTC 
Assigning Peter as the QA contact.

Peter - could you take a look at the changes for this bug?
Comment 22 David O'Brien 2016-02-15 22:54:12 UTC 
Thanks Peter.
Comment 23 Andrew Dahms 2016-04-28 00:06:06 UTC 
This content is now live on the Customer Portal.

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