Bug 534225 (RHQ-1041)

Summary:	test how updating agent affects windows service/unix boot-time daemon
Product:	[Other] RHQ Project	Reporter:	John Mazzitelli <mazz>
Component:	Agent	Assignee:	John Mazzitelli <mazz>
Status:	CLOSED NOTABUG	QA Contact:
Severity:	medium	Docs Contact:
Priority:	medium
Version:	unspecified	CC:	rsoares
Target Milestone:	---	Keywords:	SubTask
Target Release:	---
Hardware:	All
OS:	All
URL:	http://jira.rhq-project.org/browse/RHQ-1041
Whiteboard:
Fixed In Version:	1.2	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		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:
Bug Blocks:	534300

Description John Mazzitelli 2008-11-03 16:26:00 UTC

Need to test this update when an agent is installed as a windows service or a UNIX boot-time daemon process.

Unless the layout of the agent changes drastically, I don't think this affects a previously installed Windows Service - i.e. a previously installed Windows Service should still run the agent, even though the agent has been updated to a new version.

Because a UNIX boot-time agent process will probably use the rhq-agent-wrapper.sh script in the initd structure, its possible users may still have to do something manual (i.e. update the old initd wrapper script file with the changes that are found in the updated agent). This could be a problem - we may have to write the agent wrapper in a way that we should guarantee in the future it will never change.

Comment 1 John Mazzitelli 2008-11-17 07:19:00 UTC

http://support.rhq-project.org/display/RHQ/Design-AgentAutoUpdate#Design-AgentAutoUpdate-UpdatingAgentRunningAsAWindowsService%2FUNIXBootTimeProcess

Comment 2 John Mazzitelli 2008-12-13 02:14:56 UTC

Whatever we come up with, we need to make sure we test:

1) deployed as a Windows Service and we added a *.inc file (I'm not sure but I think this might require us to remove then re-install the service).

2) deployed as an init.d script on UNIX. We need to find out how to deploy the agent as a boot-time startup process that still supports being auto-updated.

3) updating an agent that has customized -env scripts (we will not support customized rhq-agent-wrapper.sh/bat or customized rhq-agent.sh/bat files - you customize the environment by changing the -env files only

Comment 3 John Mazzitelli 2008-12-17 19:56:03 UTC

re: #1, the Windows Service is configured to start this command:

C:\path\to\rhq-agent\bin\wrapper\windows-x86_32\wrapper.exe
-s C:\path\to\rhq-agent\bin\\wrapper\rhq-agent-wrapper.conf
set.RHQ_AGENT_HOME=C:\path\to\rhq-agent
set.RHQ_AGENT_INSTANCE_NAME=rhqagent-HOSTNAME
set.RHQ_AGENT_JAVA_EXE_FILE_PATH=C:\path\to\java\bin\java.exe
set.RHQ_AGENT_OS_PLATFORM=windows-x86_32
set.RHQ_AGENT_WRAPPER_LOG_DIR_PATH=C:\path\to\rhq-agent\logs

So, unless the agent's home directory changes, the agent windows service can remain intact and not needed to be removed/re-installed. The only issue is the Java executable. If the Java executable moved, the agent will need to be re-installed. We would have to ship the agent with an embedded JRE to get around this issue.

Comment 4 John Mazzitelli 2008-12-17 19:58:22 UTC

See : http://support.rhq-project.org/display/RHQ/Design-AgentAutoUpdate#Design-AgentAutoUpdate-RestartingtheAgent

"Therefore, we will assume that the person initially provisioning the agent into a production environment will:

    * setup all the required environment and command line settings in rhq-agent-env.[sh,bat]
    * start the agent via the rhq-agent-wrapper.[sh,bat] launcher script"

I think if we require rhq-agent-wrapper to be the agent start script for production environments, we'll be ok.  still need to test this but it will be as part of the agent-auto-update testing in general.

Comment 5 Red Hat Bugzilla 2009-11-10 20:22:37 UTC

This bug was previously known as http://jira.rhq-project.org/browse/RHQ-1041
This bug is related to RHQ-1108
This bug is related to RHQ-1189