diff options
| author | kroy <kroy@kroy.io> | 2020-01-18 22:00:14 -0600 |
|---|---|---|
| committer | kroy <kroy@kroy.io> | 2020-01-18 22:00:14 -0600 |
| commit | 58cc285c041467e8e8922abe20ebc7c4884bc364 (patch) | |
| tree | 0c904c54260e0481e6dd631129ed4e782cffbb06 | |
| parent | df79114b9b1bd7bcbf3a17836667d0f99c5effc9 (diff) | |
| download | vyos-documentation-58cc285c041467e8e8922abe20ebc7c4884bc364.tar.gz vyos-documentation-58cc285c041467e8e8922abe20ebc7c4884bc364.zip | |
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/ |