# virsh-external-snapshots

**Repository Path**: opensource77/virsh-external-snapshots

## Basic Information

- **Project Name**: virsh-external-snapshots
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-03
- **Last Updated**: 2025-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## virsh-snap.sh: create and revert external libvirt snapshots easily

### Installation

- Download script:
  ```sh
  wget -P ~/.local/bin https://github.com/shvchk/virsh-external-snapshots/raw/main/virsh-snap.sh
  ```

- Make it executable:
  ```sh
  chmod +x ~/.local/bin/virsh-snap.sh
  ```


### Usage

- Create snapshot named `snapshot-1` of `vm-42`:
  ```sh
  virsh-snap.sh create vm-42 snapshot-1
  ```
  Snapshot name is optional, by default current date and time is used as a name, e.g. `2022.07.29_23.55.12`.

- List snapshots of `vm-42`:
  ```sh
  virsh-snap.sh list vm-42
  ```
  Note that this is not the same as `virsh snapshot-list`. Snapshots are created without metadata and won't be shown with `virsh snapshot-list`.

- Revert and delete `snapshot-1` of `vm-42`:
  ```sh
  virsh-snap.sh revert vm-42 snapshot-1
  ```

- Revert, but don't delete `snapshot-1` of `vm-42`:
  ```sh
  virsh-snap.sh soft-revert vm-42 snapshot-1
  ```
  This allows to use this snapshot later with `unrevert`.

- Undo revert of a `snapshot-1` of `vm-42`, i.e. make it active again:
  ```sh
  virsh-snap.sh unrevert vm-42 snapshot-1
  ```

- Delete snapshot `snapshot-1` of `vm-42`:
  ```sh
  virsh-snap.sh delete vm-42 snapshot-1
  ```
  Might be useful if you change your mind after `soft-revert`.

- Show help:
  ```sh
  virsh-snap.sh help
  ```
  ```
  virsh-snap.sh: create and revert external libvirt snapshots easily

  Usage: virsh-snap.sh <action> <domain> [snapshot name]


  Actions:
  --------
  create, c           Create snapshot
                      If no snapshot name is provided, current date and time is used

  list, ls, l         List snapshots

  disks                Show active disks

  revert, rev, r      Revert snapshot and delete it (same as soft-revert + delete)

  soft-revert,
  srev, sr            Revert snapshot without deleting it (allows unrevert)

  unrevert,
  unrev, ur           Unrevert snapshot, i.e. make soft-reverted snapshot active again

  delete, del, rm     Delete snapshot

  help, h             This message


  Snapshots are created without metadata, so they won't be shown with `virsh snapshot-list`
  ```