Bug 982717

Summary: [Doc] Confirm whether adminshell is actually packaged and if so how.
Product: Red Hat OpenStack Reporter: Stephen Gordon <sgordon>
Component: doc-Getting_Started_GuideAssignee: Summer Long <slong>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: high    
Version: 3.0CC: alyoung, breeler, sgordon, slong
Target Milestone: asyncKeywords: Documentation, Triaged, ZStream
Target Release: 3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1002781 (view as bug list) Environment:
Last Closed: 2014-01-06 03:57:37 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:
Bug Depends On:    
Bug Blocks: 1002781, 1011085    

Description Stephen Gordon 2013-07-09 16:21:52 UTC 
Document URL: 

https://access.redhat.com/site/documentation/en-US/Red_Hat_OpenStack/3/html/Getting_Started_Guide/ch06s05.html

Section Number and Name: 

6.5. Launching an Instance

Describe the issue: 

I have some concerns that this segment of the note about accessing the instance console is incorrect/invalid:

"""
From the command line:

    Navigate to the adminshell Directory:

    #cd /EAP_HOME/eds/teiid/adminshell/

    Launch the adminshell-console script:

    # ./adminshell-console.sh

The AdminShell GUI is displayed. You can exit the GUI at any time by clicking on: File → Exit
"""

In particular I would query whether we actually ship adminshell in RHOS, and if we do what package it is provided by. Additionally the presence of the EAP_HOME variable suggests to me these instructions are referring to something that is *not* provided via YUM/RPM (possibly EAP and ZIP file distribution).

Suggestions for improvement: 

Confirm whether these instructions are in fact valid and either remove them entirely or make them clearer.
Comment 1 Stephen Gordon 2013-07-09 16:22:13 UTC 
Summer can you please follow up on this?
Comment 3 Summer Long 2013-07-10 04:53:57 UTC 
Removed faulty command-line instructions (no idea of their origin).
Steve, you want to confirm? Can be viewed here: http://file.bne.redhat.com/~slong/docs/Installation_and_Configuration_Guide/#Launching_an_Instance
Comment 4 Bruce Reeler 2013-08-30 04:18:24 UTC 
This bug was originally for the Getting Started Guide, however the fix in Comment 3 was done to the Installation & Config Guide, which has the same text. 

This bug has now also been fixed in the GSG.