/usr/share/doc/cockpit/guide/feature-machines.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 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Multiple 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-kubernetes.html" title="Kubernetes">
<link rel="next" href="feature-selinux.html" title="SELinux Policy">
<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-kubernetes.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="feature-selinux.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-machines"></a>Multiple Machines</h2></div></div></div>
<p>Cockpit can connect to multiple machines from a single Cockpit session.
These are listed on the <span class="emphasis"><em>Machines</em></span> dashboard.</p>
<p>These additional machines are accessed via SSH from the machine that
the first machine connected to, and are
<a class="link" href="authentication.html" title="Cockpit Authentication">authenticated</a> with the logged in
user's password and/or SSH keys.</p>
<p>Using SSH keys is only supported when the system has the
necessary APIs in libssh.</p>
<p>SSH host keys are stored in
<code class="filename">/etc/ssh/ssh_known_hosts</code>.</p>
<p>The machine data is stored in
<code class="filename">/etc/cockpit/machines.d/*.json</code>. Settings in
lexicographically later files amend or override settings in earlier ones.
Cockpit itself writes into <code class="filename">99-webui.json</code>; packages or
admins who want to pre-configure machines should ship files like
<code class="filename">05-mymachine.json</code> so that changes from the web
interface override the pre-configured files.</p>
<p>Each JSON file contains an object that maps machine IDs to objects that
define the properties of that machine. The ID can be a human readable name
or an IP address or any other unique value, and is shown in the web
interface until conneting to it the first time, at which point the web
interface will show the machine's host name.</p>
<p>The following properties are recognized:</p>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><code class="code">"address"</code></span></p></td>
<td><p><span class="emphasis"><em>(string, mandatory)</em></span> IP address or
DNS name of the machine</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="code">"visible"</code></span></p></td>
<td><p><span class="emphasis"><em>(boolean, optional)</em></span> If
<code class="code">true</code>, the machine will be displayed and
available for managing with Cockpit. If <code class="code">false</code> (the
default), it will not be displayed, but still taken into account for
type-ahead search when adding new machines in the web
interface.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="code">"user"</code></span></p></td>
<td><p><span class="emphasis"><em>(string, optional)</em></span> User name on the remote machine.
When not given, Cockpit will default to the user name that was being
used to log into Cockpit itself.</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="code">"port"</code></span></p></td>
<td><p><span class="emphasis"><em>(integer, optional)</em></span> ssh port of the
remote machine. When not given, the default port 22 is used.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="code">"color"</code></span></p></td>
<td><p><span class="emphasis"><em>(string, optional)</em></span> Color to
assign to the machine label in the web interface. This can be either given as
<code class="code">rgb(r_value, g_value, b_value)</code> with each value being an
integer between 0 and 255, or as a color name like <code class="code">yellow</code>.
When not given, Cockpit will assign an unused color automatically.
</p></td>
</tr>
</tbody>
</table></div>
<p>Example:</p>
<pre class="programlisting">
{
"web server": {
"address": "192.168.2.4",
"visible": true,
"color": "rgb(100, 200, 0)",
"user": "admin"
},
"192.168.2.1": {
"address": "192.168.2.1",
"port": 2222,
"visible": true,
"color": "green"
}
}</pre>
<p>There is currently no command line interface for adding and/or removing
machines from the dashboard.</p>
</div>
<div class="footer"><hr></div>
</body>
</html>
|