From 5fbc2ba630f3bcff3bbf80d6541c459e3dca5bf4 Mon Sep 17 00:00:00 2001 From: MicJ Date: Wed, 11 May 2022 16:03:34 -0400 Subject: [PATCH] Docs-3588 Update VMware-Snapshots Article This commit updates the VMware-Snapshots.md how-to article content, creates the new VMware-SnapshotsScreen.md article. Fixes style issues. Local build test links working. --- .../CORETutorials/Storage/VMware-Snapshots.md | 25 +++++++++---------- .../Storage/VMware-SnapshotsScreen.md | 20 +++++++++++++++ 2 files changed, 32 insertions(+), 13 deletions(-) create mode 100644 content/CORE/UIReference/Storage/VMware-SnapshotsScreen.md diff --git a/content/CORE/CORETutorials/Storage/VMware-Snapshots.md b/content/CORE/CORETutorials/Storage/VMware-Snapshots.md index 3ce1009699..af8cf00d47 100644 --- a/content/CORE/CORETutorials/Storage/VMware-Snapshots.md +++ b/content/CORE/CORETutorials/Storage/VMware-Snapshots.md @@ -1,5 +1,5 @@ --- -title: "VMware-Snapshots" +title: "Creating VMware-Snapshots" weight: 30 aliases: /core/storage/vmware-snapshots/ --- @@ -7,28 +7,27 @@ aliases: /core/storage/vmware-snapshots/ **Storage** > **VMware-Snapshots** coordinates ZFS snapshots when using TrueNAS as a VMware datastore. When a ZFS snapshot is created, TrueNAS automatically snapshots any running VMware virtual machines before taking a scheduled or manual ZFS snapshot of the dataset or zvol backing that VMware datastore. -Virtual machines **must be powered on** for TrueNAS snapshots to be copied to VMware. +To copy TrueNAS snapshots to VMWare, virtual machines must be powered-on. The temporary VMware snapshots are then deleted on the VMware side but still exist in the ZFS snapshot and are available as stable restore points. -These coordinated snapshots go in the **Storage > Snapshots** list. +These coordinated snapshots go on the **Storage > Snapshots** list. {{< hint info >}} -You need a paid-edition for VMware ESXi to use VMware-Snapshots. If you try to use them with ESXi free then you see the following error message: **Error: Can’t create snapshot, current license or ESXi version prohibits execution of the requested operation.**. Indeed ESXi free has locked (read-only) API that prevents using TrueNAS VMware-Snapshots. The cheapest ESXi edition that is compatible with TrueNAS VMware-Snapshots is *VMware vSphere Essentials Kit*. +You need a paid-edition for VMware ESXi to use VMware-Snapshots. +If you try to use them with ESXi free edition you see the following error message: **Error: Can't create snapshot, current license or ESXi version prohibits execution of the requested operation.** +ESXi free has a locked (read-only) API that prevents using TrueNAS VMware-Snapshots. +The cheapest ESXi edition that is compatible with TrueNAS VMware-Snapshots is **VMware vSphere Essentials Kit**. {{< /hint >}} ## Create a VMware Snapshot -Go to **Storage > VMware Snapshots** and click *ADD*. +Go to **Storage > VMware Snapshots** and click **ADD**. ![StorageVMwareSnapshotsAdd](/images/CORE/12.0/StorageVMwareSnapshotsAdd.png "Creating a VMware Snapshot") -| Setting | Value | Description | -|---------|-------|-------------| -| Hostname | string | Enter the IP address or hostname of the VMware host. When clustering, use the IP address or hostname of the vCenter server for the cluster. | -| Username | string | Enter a user account name created on the VMware host. The account must have permission to snapshot virtual machines. | -| Password | string | Enter the password associated with the *Username*. | -| ZFS Filesystem | browse button | Select a filesystem to snapshot. | -| Datastore | drop-down menu | After entering the *Hostname*, *Username*, and *Password*, click *FETCH DATASTORES* to populate the menu. Select the datastore to synchronize. | +After entering the **Hostname**, **Username**, and **Password**, click **FETCH DATASTORES** to populate the menu and then select the datastore to synchronize. TrueNAS connects to the VMware host after clicking *FETCH DATASTORES*. -The *ZFS Filesystem* and *Datastore* drop-down menus populate from the VMware host response. +The **ZFS Filesystem** and **Datastore** drop-down menus populate from the VMware host response. Choosing a datastore also selects any previously mapped dataset. + +See [VMware Screen]({{< relref "/CORE/UIReference/Storage/VMware-SnapshotsScreen.md" >}}) \ No newline at end of file diff --git a/content/CORE/UIReference/Storage/VMware-SnapshotsScreen.md b/content/CORE/UIReference/Storage/VMware-SnapshotsScreen.md new file mode 100644 index 0000000000..3a4440db1b --- /dev/null +++ b/content/CORE/UIReference/Storage/VMware-SnapshotsScreen.md @@ -0,0 +1,20 @@ +--- +title: "VMware-Snapshots Screen" +weight: 30 +--- + +Use **Storage** > **VMware-Snapshots** to add a VMWare snapshot that coordinates ZFS snapshots when using TrueNAS as a VMware datastore. + +![StorageVMwareSnapshotsAdd](/images/CORE/12.0/StorageVMwareSnapshotsAdd.png "Creating a VMware Snapshot") + +| Setting | Description | +|---------|-------------| +| **Hostname** | Enter the IP address or host name of the VMware host. When clustering, use the IP address or host name of the vCenter server for the cluster. | +| **Username** |Enter a user account name created on the VMware host. The account must have permission to snapshot virtual machines. | +| **Password** | Enter the password associated with the value in **Username**. | +| **ZFS Filesystem** | Select a file system to snapshot from the dropdown list. Values populate from the VMWare host response. | +| **Datastore** | Select an option from the dropdown list after entering the **Hostname**, **Username**, and **Password**, click **FETCH DATASTORES** to populate the menu. Select the datastore to synchronize. Selecting a datastore also select any previously mapped datasets. | + +Use **FETCH DATASTORES** to have TrueNAS connect to the VMware host. + +For more informtion see [VMWare Shanpshots]({{< relref "/CORE/CORETutorials/Storage/VMware-Snapshots.md" >}})