Bug 1004622

Summary:	helpful additional components for install documentation
Product:	[Retired] Beaker	Reporter:	Tim Flink <tflink>
Component:	Doc	Assignee:	Nick Coghlan <ncoghlan>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Amit Saha <asaha>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	0.14	CC:	aigao, asaha, dcallagh, ebaak, llim, qwan, rmancy
Target Milestone:	0.14.4
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:
Clones:	1035121 (view as bug list)		Environment:
Last Closed:	2013-12-19 05:09:30 UTC	Type:	Bug
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:	1035121

Description Tim Flink 2013-09-05 04:44:13 UTC

I recently installed beaker and there are a few things that would have been nice to have in those docs:

 - discussion of firewall ports that need to be open (8000, 80/443. 69)
 - usage of cobbler to download pxe related files
 - requirements for power configuration on virthosts (ssh keys, polkit changes etc.)
 - configuration of VMs to use with beaker (set to boot from network, hd and power settings for virsh)

A lot of this is discussed in the dev env setup guide [1] but would be useful to have it in the main install documentation.

Comment 2 Amit Saha 2013-09-05 04:52:37 UTC

Tim, thanks for reporting these.

(In reply to Tim Flink from comment #0)
> I recently installed beaker and there are a few things that would have been
> nice to have in those docs:
> 
>  - discussion of firewall ports that need to be open (8000, 80/443. 69)
>  - usage of cobbler to download pxe related files
>  - requirements for power configuration on virthosts (ssh keys, polkit
> changes etc.)

Could you describe the polkit changes that you needed to do? I don't remember having to do any when I setup/wrote the docs for Fedora.

Comment 3 Tim Flink 2013-09-05 05:46:34 UTC

(In reply to Amit Saha from comment #2)
 
> Could you describe the polkit changes that you needed to do? I don't
> remember having to do any when I setup/wrote the docs for Fedora.

It's not so much a "have to" as I chose not to use root on the virthost.

Add the file /etc/polkit-1/rules.d/10-libvirt.rules which contains:

polkit.addRule(function (action, subject) {
    if (action.id == "org.libvirt.unix.manage" && subject.isInGroup("kvm"))
        return polkit.Result.YES;
});

then add the remote user to the kvm group and you don't need to have passwordless root access to the virthosts

Comment 5 Nick Coghlan 2013-11-27 06:38:49 UTC

I split out bug 1035121 to cover documenting how to add a virsh host to Beaker.

This bug now just covers Tim's first two points:

 - discussion of firewall ports that need to be open (8000, 80/443. 69)
 - usage of cobbler to download pxe related files

Comment 6 Nick Coghlan 2013-11-27 07:20:30 UTC

On Gerrit: http://gerrit.beaker-project.org/2556

Comment 7 Nick Coghlan 2013-11-28 04:23:09 UTC

These changes have been included in the updated installation instructions at:

http://beaker-project.org/docs-release-0.14/admin-guide/installation.html

Comment 8 Amit Saha 2013-11-28 05:31:36 UTC

(In reply to Nick Coghlan from comment #5)
> I split out bug 1035121 to cover documenting how to add a virsh host to
> Beaker.
> 
> This bug now just covers Tim's first two points:
> 
>  - discussion of firewall ports that need to be open (8000, 80/443. 69)
>  - usage of cobbler to download pxe related files

Verified that these have been added in the 0.14 install guide.