Skip to content

Commit 99af74e

Browse files
committed
Document how to access the installer using ssh
Signed-off-by: Yann Dirson <yann.dirson@vates.tech>
1 parent 6060114 commit 99af74e

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

docs/troubleshooting/installation-upgrade.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,37 @@ 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 for simple problems access through the console as described
35+
above can be sufficient, it can be necessary to collect the full
36+
install log, kernel log and such large amount of data, which is quite
37+
impractical unless you can just copy the files.
38+
39+
To enable ssh/scp access during installation, you can request on the
40+
linux kernel command line the activation of the network, and enabling
41+
of sshd service with a root password of your choice. For the common
42+
case of setting up the network with DHCP, add the following to the
43+
linux boot parameters:
44+
45+
```
46+
network_device=all sshpassword=YOURCHOICE
47+
```
48+
49+
You may select an alternative setup using `network_config` (which
50+
defaults to `dhcp`). Its usage summary is as follows (values you need
51+
to provide are the ones in capital, brackets denote optional
52+
parameters:
53+
54+
```
55+
network_config=dhcp[:vlan=VLAN]
56+
network_config=static:ip=IP;netmask=NETMASK[;gateway=GW][;dns=DNS1[,DNS2]][;domain=DOMAIN][;vlan=VLAN]
57+
```
58+
59+
Note you can specify an interface name such as `eth1` instead of `all`
60+
if necessary, which can be useful when you need to setup a static IP
61+
address.
62+
3263
## Installation logs
3364

3465
On the installed system, the installer logs are kept in `/var/log/installer/`.

0 commit comments

Comments
 (0)