> For the complete documentation index, see [llms.txt](https://dev.solid-run.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.solid-run.com/other-articles/snippets/general-troubleshooting.md).

# General troubleshooting

## General troubleshooting

* [Bedrock 'hangs' after system update or on new installation](#bedrock-hangs-after-system-update-or-on-new-installation)
  * [Status](#status)
  * [Symptom](#symptom)
  * [Fix](#fix)
    * [Wait for the system to boot](#wait-for-the-system-to-boot)
* [USB Hotplug does not work after pulling out and plugging in](#usb-hotplug-does-not-work-after-pulling-out-and-plugging-in)
  * [Status](#status)
  * [Symptom](#symptom)
  * [Fix](#fix)
    * [Linux](#linux)
    * [Windows](#windows)
* [Bedrock overheats when positioned flat or without a stand](#bedrock-overheats-when-positioned-flat-or-without-a-stand)

## Bedrock 'hangs' after system update or on new installation

#### Status

Closed

#### Symptom

![image-20240703-104108.png](/files/TXLaH0jCvR1iz4H3rmga)

System 'hangs' on the systemd-networkd-wait-online service start during the boot process.\
It looks like a bug in the service file since it waits for ALL interfaces to get an ip and unless this happens, it will 'hang'.

However, the system does not hang, it will be like this for about 3 minutes, then the service will time out.

#### Fix

**Wait for the system to boot**

* run
  * sudo systemctl edit systemd-networkd-wait-online.service
* Uncomment the line where there is the execstart="..." and to the end of the command add "--any"
  * Should look line this:`ExecStart=/usr/lib/systemd/systemd-networkd-wait-online --any`
* Save the file
* run
  * Systemctl daemon-reload
  * sudo systemctl restart systemd-networkd-wait-online.service

## USB Hotplug does not work after pulling out and plugging in

#### Status

Closed

#### Symptom

USB works when booting the system with it plugged, when unplugged and plugged again it stops working.

#### Fix

**Linux**

* Run:
  * nano /etc/default/grub
* on the line that starts with: GRUB\_CMDLINE\_LINUX\_DEFAULT change to:
  * GRUB\_CMDLINE\_LINUX\_DEFAULT="quiet splash **usbcore.autosuspend=-1**"
* Run:
  * update-grub
* Reboot

**Windows**

## Bedrock overheats when positioned flat or without a stand

Bedrock convection cooling works by the chimney effect which requires

1. Bedrock to be positioned vertically
2. Having space below the Bedrock body for cool air to enter heatsink

Convection cooling does not work effectively in the following cases

1. Bedrock is positioned horizontally rather than vertically
2. Bedrock is positioned on a flat surface without the stand
3. Bedrock is placed in a small closed cabinet with no ventilation which results in elevated temperature of ambient air

See [Bedrock Mounting options](/amd/r8000-r7000/sbc-platform/bedrock-mechanical-documentation/bedrock-mounting-options.md) for proper positioning of Bedrock.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.solid-run.com/other-articles/snippets/general-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.