vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

install: new section about known issues that can't be fixed

Browse Source
This commit is contained in:
kroy 2020-01-18 22:00:14 -06:00
parent df79114b9b
commit 58cc285c04
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/install.rst
View File

@ -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 Once finished you will be able to proceed with the ``install image`` command as
in a regular VyOS installation. 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/ .. _SYSLINUX: http://www.syslinux.org/