/usr/share/doc/cockpit/guide/feature-ovirtvirtualmachines.html is in cockpit-doc 164-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>oVirt Virtual Machines</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="Cockpit Guide">
<link rel="up" href="features.html" title="Part II. Feature Internals">
<link rel="prev" href="feature-virtualmachines.html" title="Virtual Machines">
<link rel="next" href="development.html" title="Part III. Developer Guide">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="feature-virtualmachines.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="features.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Cockpit Guide</th>
<td><a accesskey="n" href="development.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h2 class="title">
<a name="feature-ovirtvirtualmachines"></a>oVirt Virtual Machines</h2></div></div></div>
<p>Cockpit can connect to <a class="ulink" href="https://ovirt.org/" target="_top">oVirt</a> REST API to extend
<a class="link" href="feature-virtualmachines.html" title="Virtual Machines">Virtual Machines</a> for oVirt-specifics, namely
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>Active operations</p></li>
<li class="listitem"><p>Extended virtual machine's details</p></li>
<li class="listitem"><p>Migration</p></li>
<li class="listitem"><p>VDSM configuration</p></li>
</ul></div>
<p>
</p>
<p>Required oVirt version: <span class="emphasis"><em>4.1.0</em></span></p>
<p>The machine running Cockpit must be configured as a <span class="emphasis"><em>host within the oVirt cluster.</em></span></p>
<p>CORS (Cross Origin Resource Sharing) must be enabled on oVirt engine (not done by default):
</p>
<pre class="programlisting">
$ <span class="command"><strong>ssh root@[ENGINE_FQDN]</strong></span> # log as `root` user in the oVirt engine machine
# <span class="command"><strong>engine-config -s CORSSupport=true</strong></span> # to turn on the CORS support for REST API
# <span class="command"><strong>engine-config -s CORSAllowDefaultOrigins=true</strong></span> # to allow CORS for all configured hosts
# <span class="command"><strong>systemctl restart ovirt-engine</strong></span> # to take effect
</pre>
<p>
</p>
<p>The <span class="emphasis"><em>URL of oVirt</em></span> (or RHV - Red Hat Virtualization) API server must be manually provided,
since it can't be determined automatically from a host.</p>
<p>To do so, please <span class="emphasis"><em>either</em></span>
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>log into Cockpit as <span class="emphasis"><em>root</em></span></p></li>
<li class="listitem"><p>visit <span class="emphasis"><em>Virtual Machines</em></span> page</p></li>
<li class="listitem"><p>provide <span class="emphasis"><em>oVirt's engine URL</em></span> within the shown dialog</p></li>
</ul></div>
<p>
<span class="emphasis"><em>or</em></span>
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
<p>run as <span class="emphasis"><em>root</em></span> in shell:</p>
<pre class="programlisting">
# <span class="command"><strong>/usr/share/cockpit/ovirt/install.sh https://[FQDN]/ovirt-engine</strong></span>
</pre>
</li></ul></div>
<p>
</p>
<p>By any of the actions above, following files are generated:
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>/etc/cockpit/machines-ovirt.config - feel free to adjust</p></li>
<li class="listitem"><p>/usr/share/cockpit/ovirt/override.json - to ease Content Security Policy towards oVirt's REST API</p></li>
</ul></div>
<p>
</p>
</div>
<div class="footer"><hr></div>
</body>
</html>
|