thelio-astra-a1-n1 #263
thelio-astra-a1-n1 #263
Conversation
| - On the `Network configuration` page, you should have a successfully connected ethernet port. Select `Done` to continue. | ||
| - On the `Proxy configuration` page, enter any required proxy (this should almost always be left blank). Select `Done` to continue. | ||
| - On the `Ubuntu archive mirror configuration` page, the default mirror for packages will be tested. When it completes, select `Done` to continue. | ||
| - On the `Guided storage configuration` page, select `Use an entire disk`, and choose the desired disk. Select `Done` to continue. |
There was a problem hiding this comment.
This page has a setting to set up the disk as an LVM group that's selected by default. We were unsure about that, so we should probably mention the setting, even if we want to keep it on (or at least explicitly state to leave the rest of the settings on their defaults).
| - Upgrade the system with the following commands: | ||
| ``` | ||
| sudo apt-get update | ||
| sudo apt-get dist-upgrade |
|
|
||
| ## Desktop environment install | ||
|
|
||
| - The system will boot to a terminal login prompt. Log in with `system76` as the username and `system76` as the password. |
There was a problem hiding this comment.
By default, we got this prompt in the BMC serial console, and not the physical display connected with the machine. The expected behavior needs to be clarified; we thought it wasn't working because the physical display wasn't giving us a prompt.
| sudo apt-get install ubuntu-desktop | ||
| ``` | ||
| - At this point, NetworkManager will be installed alongside systemd-networkd. This will cause boot delays as they both wait for network completion. The following steps will disable systemd-networkd in favor of NetworkManager, which has better integration with the Ubuntu desktop. These instructions were adapted from https://cloudspinx.com/disable-systemd-networkd-on-ubuntu-linux/. | ||
| - Disable and mask systemd-networkd services with the following commands: |
There was a problem hiding this comment.
Pedantic, but this and the next two bullet points should be indented underneath the note about what they do (and where they came from).
| - When using lower core count CPUs, the first two PCIe x16 slots (closest to the CPU) will run at x8 speeds. Place x16 devices into the last two slots for optimal performance. | ||
| - Install all required hardware before Operating System installation, including GPUs and WiFi cards. | ||
| - The system firmware version must be `3.02` in order to support early boot output on NVIDIA GPUs. | ||
| - There is a jumper labeled `BMC disable` that can bypass the requirement that the BMC boots before the power button is functional. |
There was a problem hiding this comment.
We did not put this jumper on. Would it have completely disabled the BMC, preventing us from using its serial console functionality? If so, that would have prevented us from getting through the setup, so it shouldn't be recommended (at least for NVIDIA systems).
| sudo netplan generate | ||
| ``` | ||
| - Reboot by running `sudo reboot`. | ||
| - You should see a login screen, where you can log in to the `System76` user with the password `system76`. |
There was a problem hiding this comment.
We needed to be plugged into DisplayPort via the NVIDIA card at this point, and possibly needed one display rather than another. More notes about the requirements after the reboot should be added if possible.
| ``` | ||
| - Install the System76 driver with the following command: | ||
| ``` | ||
| sudo apt-get install system76-driver |
There was a problem hiding this comment.
Not sure if a note not to install system76-driver-nvidia would be warranted, since that's the SOP for most of our NVIDIA systems.
| - On the `Ubuntu Pro` page, select `Skip for now`. Click on `Next` to continue. | ||
| - On the `Help improve Ubuntu` page, select `No, don't share system data`. Click on `Next` to continue. | ||
| - On the `Ready to go` page, click on `Finish`. | ||
| - Additional ethernet connections will repeatedly fail to connect. Open `nm-connnection-editor` to remove them. |
There was a problem hiding this comment.
Tony needed clarification that this was a command; maybe say "Run nm-connection-editor to open the connection manager and remove them." to make it more clear how that works.
| - Upgrade the system with the following commands. This may downgrade some packages as they pull the version from the System76 PPA: | ||
| ``` | ||
| sudo apt-get update | ||
| sudo apt-get dist-upgrade |
There was a problem hiding this comment.
Again, this should be full-upgrade for a newly written guide.
Thelio Astra documentation, with additional Ubuntu setup guides.
Draft until standard documentation is filled out.