networking: Document how to customize NIC names #146
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Should this be under the "network.adoc" page? |
kelvinfan001
force-pushed
the
customize-nic
branch
2 times, most recently
from
6537d79 to
5859906
Compare
lucab
reviewed
Aug 7, 2020
kelvinfan001
force-pushed
the
customize-nic
branch
from
5859906 to
8b30dd9
Compare
dustymabe
reviewed
Aug 7, 2020
| mode: 0644 | ||
| contents: | ||
| inline: | | ||
| SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="12:34:56:78:9a:bc", ATTR{type}=="1", NAME="infra"' |
There was a problem hiding this comment.
off topic: is ATTR{type}=="1" a way to match based on the type of networking interface?
There was a problem hiding this comment.
😮
I believe it is. This would help a lot with supporting custom names in networking devices in console-login-helper-messages!
kelvinfan001
force-pushed
the
customize-nic
branch
2 times, most recently
from
7e68ca2 to
684a69c
Compare
dustymabe
reviewed
Aug 7, 2020
| ---- | ||
|
|
||
| == Networking in the Initramfs via Kernel Arguments | ||
| If networking in the initramfs is required, the Dracut argument `ifname=` dynamically creates a udev rule to change the name of a NIC. |
There was a problem hiding this comment.
It feels like we might need to give the user some more background information. Maybe something like:
Suggested change
| If networking in the initramfs is required, the Dracut argument `ifname=` dynamically creates a udev rule to change the name of a NIC. | |
| If networking in the initramfs is required, the kernel argument `ifname=` will dynamically create a udev rule to change the name of a NIC in the initramfs. If the custom name needs to be applied to the real root then a systemd .link file or udev rule, as discussed earlier on this page, will need to get created via Ignition. See [this issue](https://github.com/coreos/fedora-coreos-tracker/issues/553) for more details. |
There was a problem hiding this comment.
ahh. I see this information is in the last paragraph. Maye we can add some of this down there and add a link to the issue down there so people can get more context on why they need to do both.
kelvinfan001
force-pushed
the
customize-nic
branch
from
684a69c to
6aff023
Compare
dustymabe
approved these changes
Aug 7, 2020
|
|
||
| Currently, unlike other parts of the networking config from the initramfs (e.g. static IPs, hostnames, etc.), these udev rules are not persisted into the real root. If the custom name needs to be applied to the real root, either a link file or udev rule must be created, as shown above. See xref:https://github.com/coreos/fedora-coreos-tracker/issues/553[this issue] for more details. | ||
|
|
||
| For example, to name NIC with the MAC `12:34:56:78:9a:bc` to "infra", provide the argument `ifname=infra:12:34:56:78:9a:bc`. A udev rule like the following would be created in the initramfs: |
There was a problem hiding this comment.
Suggested change
| For example, to name NIC with the MAC `12:34:56:78:9a:bc` to "infra", provide the argument `ifname=infra:12:34:56:78:9a:bc`. A udev rule like the following would be created in the initramfs: | |
| For example, to give the NIC with the MAC `12:34:56:78:9a:bc` a name of "infra", provide a `ifname=infra:12:34:56:78:9a:bc` kernel argument. A udev rule would be created in the initramfs like: |
kelvinfan001
force-pushed
the
customize-nic
branch
from
6aff023 to
7d039c6
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Document how to customize NIC names using link files, udev rules, and kernel arguments.