Skip to content

Commit 265ea94

Browse files
committed
Adding documentation and changelog
Documenting the ability to rename network interfaces on snapshot restore. Signed-off-by: Andrew Laucius <[email protected]>
1 parent 99dea5f commit 265ea94

File tree

2 files changed

+17
-0
lines changed

2 files changed

+17
-0
lines changed

CHANGELOG.md

+3
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,9 @@ and this project adheres to
1616
onwards. Users of Firecracker will need to backport the relevant patches on
1717
top of their 6.1 kernels to make use of the feature.
1818

19+
- [#4731](https://github.com/firecracker-microvm/firecracker/pull/4731): Added
20+
support for modifying the host device name during snapshot restore.
21+
1922
### Changed
2023

2124
### Deprecated

docs/snapshotting/network-for-clones.md

+14
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,20 @@ Otherwise, packets originating from the guest might be using old Link Layer
146146
Address for up to arp cache timeout seconds. After said timeout period,
147147
connectivity will work both ways even without an explicit flush.
148148

149+
### Renaming host device names
150+
151+
In some environments where the jailer is not being used, restoring a snapshot
152+
may be tricky because the tap device on the host will not be the same as the tap
153+
device that the original VM was mapped to when it was snapshotted, as when the
154+
tap device come from a pool of such devices.
155+
156+
In this case you can use the network_overrides parameter to snapshot restore to
157+
specify which network device (based on the name inside the VM, such as "eth0")
158+
maps to which host tap device (e.g. "vmtap01").
159+
160+
This may require reconfiguration of the networking inside the VM so that it is
161+
still routable externally.
162+
149163
## Scalability evaluation
150164

151165
We ran synthetic tests to determine the impact of the addtional iptables rules

0 commit comments

Comments
 (0)