Bug 783282

Summary:	need to document new agent registration requirement
Product:	[JBoss] JBoss Operations Network	Reporter:	Deon Ballard <dlackey>
Component:	Documentation	Assignee:	Deon Ballard <dlackey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Mike Foley <mfoley>
Severity:	high	Docs Contact:
Priority:	high
Version:	JON 3.0.0	CC:	akostadi, hrupp, mazz
Target Milestone:	---
Target Release:	JON 3.0.1
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	783247	Environment:
Last Closed:	2014-01-02 20:42:52 UTC	Type:	---
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:	782612, 783247, 786588
Bug Blocks:

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 1 Deon Ballard 2012-01-31 01:05:01 UTC

Hey, I actually did this. Rock on.

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

3.0 is in SVN, awaiting, 3.0.1:
http://svn.devel.redhat.com/cgi-bin/viewvc.cgi/ecs/JON/3.0/Admin_ServerAgent/en-US/Agent.xml?r1=76555&r2=77499

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.