From a470448e3befa9bd4db086a0503b267dcbde1ae1 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 29 Dec 2024 12:04:26 +0000 Subject: [PATCH 1/6] Troubleshooting: expand, and begin to update Mention Secure Boot. Link to STABLE. Add a placeholder (ellipsis) for the desktop environment not appearing. Whilst here, reword things a little. --- .../installation-guide/troubleshooting.md | 25 +++++++++++++++---- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index 5cf078b..45c4bd5 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -3,20 +3,35 @@ Troubleshooting ## The live system does not boot. +### If Secure Boot is enabled, in BIOS settings for your computer, disable it. + +Support for Secure Boot is [not yet integral to FreeBSD](https://wiki.freebsd.org/SecureBoot). + ### Your hardware may not be supported. -GhostBSD is based on the FreeBSD Stable branch and hardware support can change often. Hardware support is generally good, however, some more recent hardware may have issues. You can try to boot the live system on another computer to determine if the issue is related to your hardware or with the bootable USB itself. +GhostBSD is based on [the STABLE branch](https://www.freebsd.org/where/#helptest) of FreeBSD. +Hardware support is generally good, however, there may be issues with some modern hardware. + +To determine whether the issue relates to your hardware, or to the bootable USB: + +- try to boot the live system on a different computer. Please refer to [FreeBSD Hardware Compatibility](https://docs.freebsd.org/en/books/faq/#hardware) for more information on indiviual components. ### The installation media may be corrupted. -Ocassionally, ISO files may become corrupted during download or during the creation of a bootable USB flash drive. Please refer to the [Getting started](getting-started.md) guide to download a new ISO file and create a new bootable USB flash drive. +Corruption may occur during download of an installer image file, or during creation of a bootable USB flash drive. +Please refer to the [Getting started](getting-started.md) guide to download a new image and create a new bootable USB flash drive. ## The live system does not reach a graphical desktop environment. -### The installation ISO may be outdated or require general bug fixes. +… + +### The installation ISO may be outdated. + +Try creating a bootable USB using the [latest image](https://www.ghostbsd.org/download). +GhostBSD is a rolling release and ocassionally updates and fixes are pushed to the latest build before a new official image is created. -Try creating a bootable USB using the [latest iso](https://www.ghostbsd.org/download) found on the Download page under *Latest Builds*. GhostBSD is a rolling release and ocassionally updates and fixes are pushed to the latest build before a new official image is created. +---- -*Please note*: This section is incomplete and is currently being updated. +Please note: this page is incomplete. From 6fc9255a72ee5dded2063a158821f8e218316bf8 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 29 Dec 2024 13:11:27 +0000 Subject: [PATCH 2/6] Troubleshooting: refer to FreeBSD hardware info For hardware components, the FreeBSD FAQ book currently lacks what's required. So, encourage people to read the much more informative hardware information that is provided by the FreeBSD Primary Release Engineering Team. --- source/user/installation-guide/troubleshooting.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index 45c4bd5..52d18f0 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -12,11 +12,13 @@ Support for Secure Boot is [not yet integral to FreeBSD](https://wiki.freebsd.or GhostBSD is based on [the STABLE branch](https://www.freebsd.org/where/#helptest) of FreeBSD. Hardware support is generally good, however, there may be issues with some modern hardware. -To determine whether the issue relates to your hardware, or to the bootable USB: +To determine whether the issue relates to hardware, or to the USB drive: -- try to boot the live system on a different computer. +- try to boot from the same drive on a different computer. -Please refer to [FreeBSD Hardware Compatibility](https://docs.freebsd.org/en/books/faq/#hardware) for more information on indiviual components. +For information about hardware components, please see FreeBSD information for the _RELEASE_ that corresponds to the version of _STABLE_ used by GhostBSD. + +You can run `ghostbsd-version -kv` to show the version number. As an example, _**14**0**1**502_ was from the _14.1-STABLE_ branch, and **hardware information** is amongst the pages at . ### The installation media may be corrupted. From bb83f5e2dcd880abbe5e5693caf3e2245a38bb33 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 29 Dec 2024 14:22:48 +0000 Subject: [PATCH 3/6] Troubleshooting: dual-GPU scenarios The first of the two symptoms is based on https://old.reddit.com/r/GhostBSD/comments/1h3cpjm/problem_for_install_ghostbsd/m3ljzbu/?context=2 The second is based on https://github.com/ghostbsd/issues/issues/14 Revert to 'section' (not 'page') to describe what is incomplete. --- .../installation-guide/troubleshooting.md | 20 ++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index 52d18f0..fe7963a 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -27,13 +27,27 @@ Please refer to the [Getting started](getting-started.md) guide to download a ne ## The live system does not reach a graphical desktop environment. -… +### GhostBSD automated configuration of X.Org does not support some dual-GPU configurations. + +Symptoms may include: + +- _Setting up (Intel DRM).. Please wait.._ -- on screen, no progress beyond this line +- a mostly black screen -- a white rectangle in the upper left corner, with a pointer that can not be moved. + +Auto-config may fail with, for example: + +- computers that support [NVIDIA Optimus](https://en.wikipedia.org/wiki/Nvidia_Optimus) +- some dual-GPU Macs. + +If your computer BIOS allows one of two GPUs to be disabled: please make this setting before your next attempt to boot the live system. + +Users of affected Apple hardware may find it impossible to set the Mac to use a single GPU. ### The installation ISO may be outdated. Try creating a bootable USB using the [latest image](https://www.ghostbsd.org/download). GhostBSD is a rolling release and ocassionally updates and fixes are pushed to the latest build before a new official image is created. ----- +### … -Please note: this page is incomplete. +Please note: this section is incomplete. From cee7fd5a009fcdab761f2907c5e6ee0b08e06a2b Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 29 Dec 2024 14:45:56 +0000 Subject: [PATCH 4/6] Troubleshooting: desktop environment auto-config Shorten the subheading. Be a little more descriptive about auto-config. --- source/user/installation-guide/troubleshooting.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index fe7963a..742ec45 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -27,14 +27,14 @@ Please refer to the [Getting started](getting-started.md) guide to download a ne ## The live system does not reach a graphical desktop environment. -### GhostBSD automated configuration of X.Org does not support some dual-GPU configurations. +### GhostBSD automated configuration does not support some dual-GPU configurations. Symptoms may include: - _Setting up (Intel DRM).. Please wait.._ -- on screen, no progress beyond this line - a mostly black screen -- a white rectangle in the upper left corner, with a pointer that can not be moved. -Auto-config may fail with, for example: +Auto-config (kernel modules, other graphics drivers, X.Org) may fail with, for example: - computers that support [NVIDIA Optimus](https://en.wikipedia.org/wiki/Nvidia_Optimus) - some dual-GPU Macs. From ce5b41fb2d78d459291fe84cb1d2d5f4036902b8 Mon Sep 17 00:00:00 2001 From: Eric Turgeon <4249848+ericbsd@users.noreply.github.com> Date: Sun, 29 Dec 2024 12:08:44 -0400 Subject: [PATCH 5/6] Update source/user/installation-guide/troubleshooting.md Co-authored-by: Graham Perrin --- source/user/installation-guide/troubleshooting.md | 1 - 1 file changed, 1 deletion(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index 742ec45..999fae0 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -46,7 +46,6 @@ Users of affected Apple hardware may find it impossible to set the Mac to use a ### The installation ISO may be outdated. Try creating a bootable USB using the [latest image](https://www.ghostbsd.org/download). -GhostBSD is a rolling release and ocassionally updates and fixes are pushed to the latest build before a new official image is created. ### … From 4b7941f1763ef9de8294423a75b90d047ac9b1fc Mon Sep 17 00:00:00 2001 From: Eric Turgeon <4249848+ericbsd@users.noreply.github.com> Date: Sun, 29 Dec 2024 12:10:29 -0400 Subject: [PATCH 6/6] Update source/user/installation-guide/troubleshooting.md --- source/user/installation-guide/troubleshooting.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/source/user/installation-guide/troubleshooting.md b/source/user/installation-guide/troubleshooting.md index 999fae0..1b502cb 100644 --- a/source/user/installation-guide/troubleshooting.md +++ b/source/user/installation-guide/troubleshooting.md @@ -43,9 +43,6 @@ If your computer BIOS allows one of two GPUs to be disabled: please make this se Users of affected Apple hardware may find it impossible to set the Mac to use a single GPU. -### The installation ISO may be outdated. - -Try creating a bootable USB using the [latest image](https://www.ghostbsd.org/download). ### …