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.
[Admin_Config] Ready for Review.
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
Steps to Reproduce:
This option is not listed.
Option "purgeplugins" should be listed.
This option is listed when executing "rhq-agent.sh -help":
$ ./rhq-agent.sh -help
Usage: org.rhq.enterprise.agent.AgentMain [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
svn commit -m "https://bugzilla.redhat.com/show_bug.cgi?id=1128770 - added the -g --purgeplugins option as described."
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.
Added the command in as prescribed.