From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <a.lauterer@proxmox.com>
Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (2048 bits))
 (No client certificate requested)
 by lists.proxmox.com (Postfix) with ESMTPS id B6BDB68B71
 for <pve-devel@lists.proxmox.com>; Wed, 10 Feb 2021 13:50:31 +0100 (CET)
Received: from firstgate.proxmox.com (localhost [127.0.0.1])
 by firstgate.proxmox.com (Proxmox) with ESMTP id AB3A08E83
 for <pve-devel@lists.proxmox.com>; Wed, 10 Feb 2021 13:50:31 +0100 (CET)
Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com
 [212.186.127.180])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (2048 bits))
 (No client certificate requested)
 by firstgate.proxmox.com (Proxmox) with ESMTPS id 1151C8F54
 for <pve-devel@lists.proxmox.com>; Wed, 10 Feb 2021 13:50:30 +0100 (CET)
Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1])
 by proxmox-new.maurer-it.com (Proxmox) with ESMTP id C4BB6460EB
 for <pve-devel@lists.proxmox.com>; Wed, 10 Feb 2021 13:50:29 +0100 (CET)
From: Aaron Lauterer <a.lauterer@proxmox.com>
To: pve-devel@lists.proxmox.com
Date: Wed, 10 Feb 2021 13:50:28 +0100
Message-Id: <20210210125028.3128-1-a.lauterer@proxmox.com>
X-Mailer: git-send-email 2.20.1
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-SPAM-LEVEL: Spam detection results:  0
 AWL -0.020 Adjusted score from AWL reputation of From: address
 KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment
 RCVD_IN_DNSWL_MED        -2.3 Sender listed at https://www.dnswl.org/,
 medium trust
 SPF_HELO_NONE           0.001 SPF: HELO does not publish an SPF Record
 SPF_PASS               -0.001 SPF: sender matches SPF record
 URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See
 http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more
 information. [mobatek.net, proxmox.com]
Subject: [pve-devel] [PATCH v3 docs] ha-manager: simulator: add note for
 xauth and ssh config
X-BeenThere: pve-devel@lists.proxmox.com
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Proxmox VE development discussion <pve-devel.lists.proxmox.com>
List-Unsubscribe: <https://lists.proxmox.com/cgi-bin/mailman/options/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=unsubscribe>
List-Archive: <http://lists.proxmox.com/pipermail/pve-devel/>
List-Post: <mailto:pve-devel@lists.proxmox.com>
List-Help: <mailto:pve-devel-request@lists.proxmox.com?subject=help>
List-Subscribe: <https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=subscribe>
X-List-Received-Date: Wed, 10 Feb 2021 12:50:31 -0000

Installing the ha-simulator on a PVE node directly to start it via ssh
and x11 forwarding will need the 'xauth' package installed on the PVE
node as well and X11Forwarding enabled.

Otherwise one is likely to encounter the following error when starting
the simulator: `Unable to init server: Could not connect: Connection
refused`

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
---
third times the charm (hopefully) ;)

v3: Rephrased the note to make it clear that xauth is needed and that
X11Forwarding needs to be enabled in the sshd_config file.

Moved the note further up, right after where SSH forwarding
possibilities are discussed.

Dropped the dependency patch as handling this situation technically is
harder than assumed at first. See [0] for more infos.

[0] https://lists.proxmox.com/pipermail/pve-devel/2021-February/046981.html


 ha-manager.adoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/ha-manager.adoc b/ha-manager.adoc
index 2162d25..7de0754 100644
--- a/ha-manager.adoc
+++ b/ha-manager.adoc
@@ -485,6 +485,10 @@ ssh root@<IPofPVE> -Y
 
 On Windows it works with https://mobaxterm.mobatek.net/[mobaxterm].
 
+NOTE: If you want to forward the simulator window over SSH, install the `xauth`
+package on the {pve} node and make sure that the 'X11Forwarding' option in the
+`/etc/ssh/sshd_config` file is set to 'yes'.
+
 After connecting to an existing {pve} with the simulator installed or
 installing it on your local Debian-based system manually, you can try it out as
 follows.
-- 
2.20.1