Bug 985670

Summary: Documentation gives incorrect command for deleting a user's namespace
Product: OpenShift Container Platform Reporter: Miciah Dashiel Butler Masters <mmasters>
Component: DocumentationAssignee: bmoss
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 1.2.0CC: baulakh, bleanhar, bmoss, jokerman, lcarlon, libra-onpremise-devel, mmccomas, nmone
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-07-29 04:37:30 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 Miciah Dashiel Butler Masters 2013-07-18 04:29:51 UTC
Description of problem:
In Section 3.3. "Removing User Data" of the Administration Guide, the command for deleting the user's domain is missing the -n flag.


Version-Release number of selected component (if applicable):
OpenShift Enterprise Administration Guide Edition 1.2


How reproducible:
Completely.


Steps to Reproduce:
1. Read Section 3.3, Procedure 3.4., Step 4.


Actual results:
I see the following: command

    # oo-admin-ctl-domain -l username -c delete testdomain


Expected results:
I should see the following command (note the -n option before the domain name):

    # oo-admin-ctl-domain -l username -c delete -n testdomain


Additional info:
I am referencing the Administration Guide using the following URL:

https://access.redhat.com/site/documentation/en-US/OpenShift_Enterprise/1/html-single/Administration_Guide/index.html#sect-OpenShift_Enterprise-Administration_Guide-Removing_User_Data

Without the -n option, the domain argument is ignored, and oo-admin-ctl-domain tries to delete the user (this is on OSE 1.2):

    # oo-admin-ctl-domain -l demo -c delete testdomain
    User still has domains. Delete them first.

I notice that OSE 1.1 didn't even offer a way to delete the domain (I haven't checked whether it is possible to delete a user who has a domain):

https://github.com/openshift/enterprise-server/blob/enterprise-1.1/broker-util/oo-admin-ctl-domain#L111

In OSE 1.2, one can delete the domain if one specifies the -n option:

https://github.com/openshift/enterprise-server/blob/enterprise-1.2/broker-util/oo-admin-ctl-domain#L234

Also, as can be seen above, on OSE 1.2, it is necessary to delete the domain before one can delete the user.