diff options
| author | hagbard-01 <39653662+hagbard-01@users.noreply.github.com> | 2020-01-19 09:02:45 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-01-19 09:02:45 -0800 |
| commit | 4af7d711710d10eff2b1bb5ad2c4ffa3c41f49d7 (patch) | |
| tree | 0c904c54260e0481e6dd631129ed4e782cffbb06 | |
| parent | df79114b9b1bd7bcbf3a17836667d0f99c5effc9 (diff) | |
| parent | 58cc285c041467e8e8922abe20ebc7c4884bc364 (diff) | |
| download | vyos-documentation-4af7d711710d10eff2b1bb5ad2c4ffa3c41f49d7.tar.gz vyos-documentation-4af7d711710d10eff2b1bb5ad2c4ffa3c41f49d7.zip | |
Merge pull request #189 from kroy-the-rabbit/install-updates
install: new section about known issues that can't be fixed
| -rw-r--r-- | docs/install.rst | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/install.rst b/docs/install.rst index dbf426ec..c99397d2 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -401,4 +401,24 @@ automatically taken from the TFTP and HTTP servers. Once finished you will be able to proceed with the ``install image`` command as in a regular VyOS installation. +Known Issues +------------ + +This is a list of known issues that can arise during installation. + +Black screen on install +^^^^^^^^^^^^^^^^^^^^^^^ + +GRUB attempts to redirect all output to a serial port for ease of installation on headless hosts. +This appears to cause an hard lockup on some hardware that lacks a serial port, with the result being a +black screen after selecting the `Live system` option from the installation image. + +The workaround is to type `e` when the boot menu appears and edit the GRUB boot options. Specifically, remove the: + +`console=ttyS0,115200` + +option, and type CTRL-X to boot. + +Installation can then continue as outlined above. + .. _SYSLINUX: http://www.syslinux.org/ |