Bug 783282 - need to document new agent registration requirement
Summary: need to document new agent registration requirement
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Operations Network
Classification: JBoss
Component: Documentation
Version: JON 3.0.0
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: JON 3.0.1
Assignee: Deon Ballard
QA Contact: Mike Foley
URL:
Whiteboard:
Depends On: 782612 783247 786588
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-01-19 20:36 UTC by Deon Ballard
Modified: 2014-01-02 20:42 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of: 783247
Environment:
Last Closed: 2014-01-02 20:42:52 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Deon Ballard 2012-01-19 20:36:06 UTC
This needs to be added to the 2.4 documentation and the 3.0 documentation.


+++ This bug was initially created as a clone of Bug #783247 +++

rules for agent registration has changed. see bug #782612.

Need to go through and update all the RHQ wiki docs that are related to this.

--- Additional comment from mazz on 2012-01-19 14:25:40 EST ---

FAQ changes:

http://rhq-project.org/pages/diffpages.action?originalId=12616942&pageId=12616944
http://rhq-project.org/pages/diffpages.action?pageId=2195569&originalId=12616944

--- Additional comment from mazz on 2012-01-19 14:31:48 EST ---

changes to:

http://rhq-project.org/display/JOPR2/RHQ+Agent+Command+Line+Options

include adding the -L/--cleanallconfig option and rewording the --cleanconfig option to indicate it doesn't delete the security token.

--- Additional comment from mazz on 2012-01-19 15:22:47 EST ---

changes to http://rhq-project.org/display/JOPR2/Agent+Registration are done:

http://rhq-project.org/pages/diffpages.action?pageId=2196468&originalId=12616948

--- Additional comment from mazz on 2012-01-19 15:27:47 EST ---

all wiki docs are changed to reflect the new agent registration rules

Comment 2 John Mazzitelli 2012-01-31 13:33:44 UTC
Deon,

There needs to be a slight mod to 

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Operations_Network/2.4/html/Basic_Admin_Guide/agent-config.html#registering-agent

Where it says:

"An agent cannot register with an existing IP address/port combination without the corresponding security token."

It should have some additional info so it says:

"An agent cannot register with an existing IP address/port combination without the corresponding security token and must be registering with the same existing name that originally registered the IP address/port combination."

I'm sure you can word that better :) but the point is, one agent cannot steal another agent's address/port combination, even if it has the security token. In other words, if an agent has the proper security token and wants to register an existing address/port, it MUST also register with the same agent name from before. You can't rename an agent.

Comment 3 Deon Ballard 2012-06-28 15:31:28 UTC
In 3.1:
http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.1/html/Admin_Configuring_JON_Servers_and_Agents/agent-config.html#registering-agent

This is the same text as was used in the 3.0.1 updates.


Note You need to log in before you can comment on or make changes to this bug.