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.

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: add instructions for connecting edge host to wifi #2092

Merged
merged 18 commits into from
Jan 25, 2024
Merged

Conversation

lennessyy
Copy link
Contributor

@lennessyy lennessyy commented Jan 23, 2024

Describe the Change

This PR adds instructions on how to connect an Intel NUC edge host to Wifi.

Review Changes

💻 Connect to Wifi

🎫 Jira Ticket

Copy link

netlify bot commented Jan 23, 2024

Deploy Preview for docs-spectrocloud ready!

Name Link
🔨 Latest commit d2052f5
🔍 Latest deploy log https://app.netlify.com/sites/docs-spectrocloud/deploys/65b1a80fcb9cdb0009727116
😎 Deploy Preview https://deploy-preview-2092--docs-spectrocloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@lennessyy lennessyy marked this pull request as ready for review January 24, 2024 19:57
@lennessyy lennessyy requested a review from a team as a code owner January 24, 2024 19:57
Copy link
Contributor

@karl-cardenas-coding karl-cardenas-coding left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Neat guide @lennessyy I left you some minor comments suggestions.

Lenny Chen and others added 2 commits January 24, 2024 13:21
Co-authored-by: Karl Cardenas <karl@spectrocloud.com>
Copy link
Contributor

@caroldelwing caroldelwing left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really nice how-to!

@@ -0,0 +1,139 @@
---
sidebar_label: "Connect Intel NUC Edge Host to Wifi"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
sidebar_label: "Connect Intel NUC Edge Host to Wifi"
sidebar_label: "Connect Intel NUC Edge Host to Wi-Fi"

Wifi or Wi-Fi?

---

This how-to walks you through how to connect an Edge host to a Wi-Fi network with
[wpa_supplicant](https://wiki.archlinux.org/title/wpa_supplicant), using Intel NUCs as an example. An Intel NUC is a
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it valid to add the NUC (Next Unit of Computing) definition?

This how-to walks you through how to connect an Edge host to a Wi-Fi network with
[wpa_supplicant](https://wiki.archlinux.org/title/wpa_supplicant), using Intel NUCs as an example. An Intel NUC is a
mini PC that can be used as an Edge host for Palette Edge. You can apply the steps in this how-to with other hardware,
but steps for configuring the network interface might be be different.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
but steps for configuring the network interface might be be different.
but the steps for configuring the network interface might be different.

To connect an Edge host to Wi-Fi using `wpa_supplicant`, you need to build `wpa_supplicant` into the OS image used for
the Edge host and provide the Wi-Fi credentials to the Edge host. Depending on how Edge devices are managed at an
organization, these two steps are often done by different teams. If they are being done by the same team or person, you
can merge the user-data in the step [Supply Site-Specific User Data](#supply-site-specific-user-data) with the original
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
can merge the user-data in the step [Supply Site-Specific User Data](#supply-site-specific-user-data) with the original
can merge the user data in the step [Supply Site-Specific User Data](#supply-site-specific-user-data) with the original

but steps for configuring the network interface might be be different.

To connect an Edge host to Wi-Fi using `wpa_supplicant`, you need to build `wpa_supplicant` into the OS image used for
the Edge host and provide the Wi-Fi credentials to the Edge host. Depending on how Edge devices are managed at an
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
the Edge host and provide the Wi-Fi credentials to the Edge host. Depending on how Edge devices are managed at an
the Edge host and provide the Wi-Fi credentials to the Edge host. Depending on how Edge devices are managed in an

### Procedure

1. Create a file named `user-data`, and include the following content. Replace `network-name` and `network-password`
with the name and password of your Wifi network.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
with the name and password of your Wifi network.
with the name and password of your Wi-Fi network.

docs/docs-content/clusters/edge/networking/connect-wifi.md Outdated Show resolved Hide resolved

### Validate

1. Power up the Edge host and wait for it to boot to the registration screen. Do not connect the Edge host with a wired
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe a call out box for Do not connect the Edge host with a wired?

@lennessyy lennessyy added auto-backport Enable backport backport-version-4-2 Backport change to version 4.2 labels Jan 25, 2024
:::tip

Consider including some other lightweight network utilities in the OS image that can help you troubleshoot or set up
network configurations alternatively if needed. For example, if you are using Ubuntu, consider replacing the RUN
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐶
[spectrocloud.ableism] Avoid using ableism terms. Use 'issue' instead of 'RUN'.

@lennessyy lennessyy merged commit 28a9469 into master Jan 25, 2024
9 checks passed
@lennessyy lennessyy deleted the wpa-wifi branch January 25, 2024 16:48
@vault-token-factory-spectrocloud
Copy link
Contributor

💔 All backports failed

Status Branch Result
version-4-2 Backport failed because of merge conflicts

Manual backport

To create the backport manually run:

backport --pr 2092

Questions ?

Please refer to the Backport tool documentation and see the Github Action logs for details

@vault-token-factory-spectrocloud
Copy link
Contributor

🎉 This PR is included in version 4.2.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@vault-token-factory-spectrocloud
Copy link
Contributor

🎉 This PR is included in version 4.2.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
auto-backport Enable backport backport-version-4-2 Backport change to version 4.2 released
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants