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

Bug 1128770

Summary: Missing option in 7.3.2. Agent Start Options (Configuring JON Servers and Agents)
Product: [JBoss] JBoss Operations Network Reporter: bkramer <bkramer>
Component: DocumentationAssignee: Jared MORGAN <jmorgan>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: high Docs Contact: Jared MORGAN <jmorgan>
Priority: unspecified    
Version: JON 3.2CC: lcarlon, loleary, mmurray, snegrea
Target Milestone: GAKeywords: Documentation, EasyFix
Target Release: JON 3.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
An option was missing from the list of Agent Start Options in the Configuring JON Servers and Agents documentation. Users were unable to view the information associated with the --purgeplugins command. The new documentation contains a reference to the --purgeplugins command. Users can view the command and its description.
Story Points: ---
Clone Of: Environment:
[Admin_Config] Ready for Review.
Last Closed: 2014-12-11 14:04:07 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 bkramer 2014-08-11 14:12:56 UTC
Description of problem:
In the chapter 7.3.2 Agent Start Options, the option "--purgeplugins" is missing.

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

How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:
This option is not listed.

Expected results:
Option "purgeplugins" should be listed.

Additional info:

Comment 1 bkramer 2014-08-11 14:28:06 UTC
Additional info:

This option is listed when executing "rhq-agent.sh -help":

$ ./rhq-agent.sh -help
RHQ Agent

Usage: org.rhq.enterprise.agent.AgentMain [options]

options:
   -a, --advanced                If setup is needed at startup, the advanced setup is run, rather than the basic
   -c, --config=<filename>       Specifies an agent configuration preferences file (on filesystem or classpath)
   -d, --daemon                  Agent runs in daemon mode - will not read from stdin for commands
   -D<name>[=<value>]            Overrides an agent configuration preference and sets a system property
   -e, --console=<type>          Specifies the implementation to use when reading console input: jline, sigar, java
   -g, --purgeplugins            Deletes all plugins, forcing the agent to re-download all of them
   -h, --help                    Shows this help message (default)
   -i, --input=<filename>        Specifies a script file to be used for input
   -l, --cleanconfig             Clears out existing configuration and data files, except for the security token.
   -L, --fullcleanconfig         Clears out all existing configuration and data files so the agent starts with a totally clean slate
   -n, --nostart                 If specified, the agent will not be automatically started
   -o, --output=<filename>       Specifies a file to write all output (excluding log messages)
   -p, --pref=<preferences name> Specifies the agent preferences name used to identify what configuration to use
   -s, --setup                   Forces the agent to ask setup questions, even if it is fully configured
   -t, --nonative                Forces the agent to disable the native system, even if it is configured for it
   -u, --purgedata               Purges persistent inventory and other data files
   --                            Stop processing options

Comment 3 Jared MORGAN 2014-10-22 02:56:11 UTC
svn commit -m "https://bugzilla.redhat.com/show_bug.cgi?id=1128770 - added the -g --purgeplugins option as described."
Sending        en-US/Agent.xml
Sending        en-US/Feedback.xml
Sending        en-US/Perf.xml
Sending        en-US/Revision_History.xml
Transmitting file data ....
Committed revision 98008.

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html/Admin_and_Config/agent-start-cmds.html once staged.

Summary: 

Added the command in as prescribed.