Skip to content

Commit 2c39eee

Browse files
ydirsonthomas-dkmt
andcommitted
Document how to access the installer using ssh
Signed-off-by: Yann Dirson <yann.dirson@vates.tech> Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech>
1 parent 42f5fa2 commit 2c39eee

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

docs/troubleshooting/installation-upgrade.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,34 @@ When asking for help about installation errors, providing this file increases yo
2929

3030
The target installation partition is mounted in `/tmp/root`.
3131

32+
### Getting remote access to host during installation
33+
34+
While the console access method described above may be sufficient for simple issues, collecting full logs (install logs, kernel logs, etc.) often requires copying large amounts of data, which is impractical without direct file access.
35+
36+
To enable SSH/SCP access during installation, you can use the Linux kernel command line to:
37+
38+
- Activate the network
39+
- Enable the sshd service with a root password of your choice
40+
41+
For the most common case (setting up the network via DHCP), add the following parameters to the Linux boot section:
42+
43+
```
44+
network_device=all sshpassword=YOURCHOICE
45+
```
46+
47+
You can also use the `network_config` parameter (which defaults to `dhcp`) to define an alternative network setup. Here are some template examples; replace the capitalized values with your own settings, square brackets ([]) indicate optional parameters:
48+
49+
```
50+
network_config=dhcp[:vlan=VLAN]
51+
network_config=static:ip=IP;netmask=NETMASK[;gateway=GW][;dns=DNS1[,DNS2]][;domain=DOMAIN][;vlan=VLAN]
52+
```
53+
54+
:::note
55+
You can specify an interface name such as `eth1` instead of `all` if necessary, which can be useful when you need to setup a static IP address.
56+
:::
57+
58+
The ssh server will be available once the network is up. If you are unsure which DHCP address was obtained, you can use the shell console as described above to look it up using `ip a`. You can then connect as `root` using the password you provided on the commandline.
59+
3260
## The ISO installer does not offer to upgrade the existing install (XCP-ng or XenServer)
3361

3462
:::note

0 commit comments

Comments
 (0)