Bug 534755 (RHQ-1520)

Summary:	Documentation needs to outline availability/lack of `readlink` in solaris.
Product:	[Other] RHQ Project	Reporter:	Corey Welton <cwelton>
Component:	Documentation	Assignee:	RHQ Project Maintainer <rhq-maint>
Status:	CLOSED NEXTRELEASE	QA Contact:	Corey Welton <cwelton>
Severity:	medium	Docs Contact:
Priority:	high
Version:	1.2	Flags:	cwelton: archived+
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	All
URL:	http://jira.rhq-project.org/browse/RHQ-1520
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:

Description Corey Welton 2009-02-10 16:46:00 UTC

`readlink`, which we are using to determine the originating path for rhq-agent binaries, does not exist on some/most stock Solaris installs.  Apparently many admins go and download this (and other unix utils) from Sunfreeware.  That said, it doesn't exist by default, so we'll need to document this requirement and/or any limitations.

Recommended text:

<!> Solaris Admins:  Symbolically linking the rhq agent binaries requires invocation of `readlink` in "rhq-agent-wrapper.sh".  However, `readlink` is not supplied by default in some Solaris installations.  Solaris users must either download `readlink` from a third party provider (such as Sunfreeware), or refrain from symbolically linking the agent binaries, when using the wrapper script.

Comment 1 Heiko W. Rupp 2009-02-16 10:01:22 UTC

Moved to Docs queue

Comment 2 Ian Springer 2009-06-12 21:52:02 UTC

Note, this is also an issue on HP-UX, which also does not include readlink out-of-box. It also may be an issue on AIX - this needs to be checked.

Comment 3 Red Hat Bugzilla 2009-11-10 20:34:50 UTC

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