Skip to content

Commit

Permalink
DOCS-3274: Suport older NetworkManager
Browse files Browse the repository at this point in the history
  • Loading branch information
@npentrel
npentrel committed Jan 20, 2025
1 parent 2c7e413 commit 62c2e2b
Showing 1 changed file with 11 additions and 1 deletion.
12 changes: 11 additions & 1 deletion docs/manage/fleet/provision/setup.md
View file
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 network(s).

Check failure on line 449 in docs/manage/fleet/provision/setup.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Viam.PluralsPossibility] Don’t use (s), /s, (es), or /es at the end of a word ('network(s)') to indicate the possibility of more than one item, and don’t combine the singular and plural forms of a verb, such as is/are. Use the singular form or the plural form, use both forms joined by a conjunction, or use the phrase one or more.

Raw Output:
{"message": "[Viam.PluralsPossibility] Don’t use (s), /s, (es), or /es at the end of a word ('network(s)') to indicate the possibility of more than one item, and don’t combine the singular and plural forms of a verb, such as is/are. Use the singular form or the plural form, use both forms joined by a conjunction, or use the phrase one or more.", "location": {"path": "docs/manage/fleet/provision/setup.md", "range": {"start": {"line": 449, "column": 131}}}, "severity": "ERROR"}
If your device does not connect to your network, adjust the `fallback_timeout` value in the [`agent-provisioning` configuation](http://localhost:1313/manage/fleet/provision/setup/#configure-agent-provisioning).

Check failure on line 450 in docs/manage/fleet/provision/setup.md

View workflow job for this annotation

GitHub Actions / runner / codespell 

configuation ==> configuration

### 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

0 comments on commit 62c2e2b

Please sign in to comment.