Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCS-3274: Suport older NetworkManager #3869

Merged
merged 2 commits into from
Jan 21, 2025
Merged

DOCS-3274: Suport older NetworkManager #3869

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
62c2e2b
DOCS-3274: Suport older NetworkManager
npentrel Jan 20, 2025
ee9c7ab
Fix build
npentrel Jan 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion docs/manage/fleet/provision/setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Eject and reinsert the card to make sure it's mounted with the newly written con

{{< alert title="Support Notice" color="note" >}}

Provisioning is supported and tested only on Debian 11 (Bullseye), and 12 (Bookworm) but should work on most distros using NetworkManager v1.42 (or newer) as well.
Provisioning is supported and tested on Ubuntu 22.04, Debian 11 (Bullseye), and 12 (Bookworm) but should work on most distros using NetworkManager v1.30 (or newer) as well.
For Bullseye, the installation of `viam-agent` changes the network configuration to use NetworkManager.

{{< /alert >}}
Expand Down Expand Up @@ -443,6 +443,14 @@ sudo ./preinstall.sh /path/to/rootfs

## Troubleshooting

### Device not detecting networks

Some systems can't scan for WiFi networks while in hotspot mode, meaning they won't automatically detect networks coming online or into range until the `fallback_timeout` expires.
The `fallback_timeout` causes your device to exit hotspot mode, at which point your device will be able to detect newly available networks.
If your device does not connect to your network, adjust the `fallback_timeout` value in the [`agent-provisioning` configuration](/manage/fleet/provision/setup/#configure-agent-provisioning).

### Test GRPC components of the provisioning service

If you need to test the GRPC components of the provisioning service, there is a CLI client available.
Get the code from the [`agent-provisioning` repo](https://github.com/viamrobotics/agent-provisioning) and run `go run ./cmd/client/` for info.

Expand Down Expand Up @@ -476,6 +484,8 @@ For a guide you can give to end users for setting up their machine, see [Setup m
1. If you as the end user have a provisioning mobile app, go back to the app to complete setup.
In the mobile app, you will be prompted to provide the network information for the machine.

- If your device is not detecting networks, see [Troubleshooting](/manage/fleet/provision/setup/#device-not-detecting-networks).

1. The machine will then disable the hotspot network and attempt to connect using the provided network information.
If `viam-agent` cannot establish a connection using the provided network information, the machine will create the hotspot again and continue going through steps (2-5) until a connection is successfully established.
1. If the connection is successful, `viam-agent` installs `viam-server`.
Expand Down
Loading