Skip to content

Commit

Permalink
Adding documentation and changelog
Browse files Browse the repository at this point in the history
Documenting the ability to rename network interfaces on snapshot
restore.

Signed-off-by: Andrew Laucius <[email protected]>
  • Loading branch information
andrewla committed Aug 26, 2024
1 parent 6bb709b commit 03c3be9
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 0 deletions.
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,9 @@ and this project adheres to
onwards. Users of Firecracker will need to backport the relevant patches on
top of their 6.1 kernels to make use of the feature.

- [#4731](https://github.com/firecracker-microvm/firecracker/pull/4731): Added
support for modifying the host device name during snapshot restore.

### Changed

### Deprecated
Expand Down
14 changes: 14 additions & 0 deletions docs/snapshotting/network-for-clones.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,20 @@ Otherwise, packets originating from the guest might be using old Link Layer
Address for up to arp cache timeout seconds. After said timeout period,
connectivity will work both ways even without an explicit flush.

### Renaming host device names

In some environments where the jailer is not being used, restoring a snapshot
may be tricky because the tap device on the host will not be the same as the tap
device that the original VM was mapped to when it was snapshotted, as when the
tap device come from a pool of such devices.

In this case you can use the network_overrides parameter to snapshot restore to
specify which network device (based on the name inside the VM, such as "eth0")
maps to which host tap device (e.g. "vmtap01").

This may require reconfiguration of the networking inside the VM so that it is
still routable externally.

## Scalability evaluation

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

0 comments on commit 03c3be9

Please sign in to comment.