import DownloadSectionTesting from "@site/src/components/DownloadSectionTesting";
import { DakotaSection } from "@site/src/components/DownloadSectionTesting";

Here is a short runbook for the Bluefin installation process. Read the entirety of this documentation in order to ensure survival. (In case of a raptor attack).

Things to Test For#

• Installation experience
• Secure Boot
• First run experience, check a few applications and the Bazaar app store
• Bare metal if possible but not required
• If you've got the time, go through the docs and run through the new user experience step by step. These bugs are highly prized, so if you find one, file it!
• File issues in the @projectbluefin/iso repository

Dakotaraptor {#dakotaraptor}#

Verifying Downloads with Checksums#

Checksums allow you to verify that your download completed successfully and wasn't corrupted or tampered with. After downloading an ISO, you can compare its checksum to the official checksum file to ensure integrity. While optional, verification is recommended for important installations.

How to verify checksums using sha256sum#

1. Download both the ISO file and its corresponding CHECKSUM file

   • For example: bluefin-stable-x86_64.iso and bluefin-stable-x86_64.iso-CHECKSUM

2. Generate the checksum of your downloaded ISO:

   ⧉

   sha256sum bluefin-stable-x86_64.iso
   

3. Verify against the official checksum file:

   ⧉

   sha256sum -c bluefin-stable-x86_64.iso-CHECKSUM --ignore-missing
   

4. Confirm the result: Look for OK in the output for your ISO file.

Example:

# Generate checksum of downloaded file
$ sha256sum bluefin-stable-x86_64.iso
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456 bluefin-stable-x86_64.iso

# Verify against official checksum file
$ sha256sum -c bluefin-stable-x86_64.iso-CHECKSUM --ignore-missing
bluefin-stable-x86_64.iso: OK

# 🦖 Rawr! Your download is verified

Installer bug reporting setup and running#

1. Before installing - enabling ujust report:
   • Connect the running live system to the network.
   • Open Firefox and log into GitHub.
   • Open a terminal and do brew install gh.
   • Do a command line authentication: gh auth login. Use the browser method.
2. After a failed install:
   • Use the Screenshot tool to capture relevant screenshots.
   • In the terminal, do ujust report. When the report is complete, use ESC to terminate.
   • The browser should automatically open to a new issue in the appropriate repo. Just fill it in.