Bug 1164362

Summary: Installation guide section Installing the Server on Linux incorrectly refers to rhqctl.sh instead of rhqctl
Product: [JBoss] JBoss Operations Network Reporter: Larry O'Leary <loleary>
Component: DocumentationAssignee: Jared MORGAN <jmorgan>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: medium Docs Contact:
Priority: unspecified    
Version: JON 3.2CC: loleary, mmurray
Target Milestone: GA   
Target Release: JON 3.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
An issue with how the rhqctl script was documented in the Installation Guide caused issues with executing the script correctly on Linux. A fix to the "Basic Setup: Installing the Server on Linux" section now removes the trailing .sh at the end of the command, which fixes the originally reported issue.
Story Points: ---
Clone Of: Environment:
[Install_Guide] Ready for Review
Last Closed: 2014-12-11 14:00:05 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 Larry O'Leary 2014-11-14 18:49:57 UTC
Document URL: https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.2/html/Installation_Guide/install-rhel-jar.html

Section Number and Name:  ⁠2.7. Basic Setup: Installing the Server on Linux

Describe the issue: Step 5 incorrectly refers to rhqctl.sh instead of rhqctl. 

>    5. Run the JBoss ON control script to configure the server and other services. If the rhq-server.properties file is not edited, then the script prompts for a bind address for the server; this can be set to 0.0.0.0.
>
>    [root@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl.sh install --start
>    23:07:00,901 INFO  [org.jboss.modules] JBoss Modules version 1.2.2.Final-redhat-1
>    ...

Suggestions for improvement: 
    5. Run the JBoss ON control script to configure the server and other services. If the rhq-server.properties file is not edited, then the script prompts for a bind address for the server; this can be set to 0.0.0.0.

    [root@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl install --start
    23:07:00,901 INFO  [org.jboss.modules] JBoss Modules version 1.2.2.Final-redhat-1
    ...

Comment 1 Jared MORGAN 2014-11-16 23:08:05 UTC
This string cited in #Description was controlled by an XML entity in the doc. I've changed the XML entity to read rhqctl instead of rhqctl.sh.