About
Host PowerTools allows to create snapshots and to perform other related operations on the host's mapped volumes and their snapshots.
Creating a Snapshot
Run the command:
infinihost snapshot create <device-or-mount> <name> [--description=DESCRIPTION] [--system=SYSTEM]
- The <name> parameter supports Python's strftime directives.
The create snapshot command is not application-aware and therefore does not create an application-consistent snapshot by default. In order to create an application-consistent snapshot, please refer to the application's vendor documentation.
Python's strftime directives
Python's strftime directives can be embedded in the snapshot name string. This allows a wide range of naming conventions and can be simply used within scripts.
- The full list of supported directives can be found at: http://strftime.org/
Example:
infinihost snapshot create Vol1 Oracle.DB1.Snap.%b_%d_%Y.%H_%M_%S
Result:
- A snapshot was created for 'Vol1'.
- The snapshot volume name is: "Oracle.DB1.Snap.Aug_15_2018.13_33_36"
Viewing snapshots
Run the command:
infinihost snapshot list [--master=MASTER] [--system=SYSTEM] [--detailed | --json]
- Using the "–master" parameter allows to filter only for snapshots of a specific volume.
Output exmaple:
SNAPSHOT NAME MASTER DEVICE PARENT DESCRIPTION CREATED AT MAPPED Snap_1 Vol1 (E:\) Vol1 Daily Oracle DB1 Snapshot 15-08-2018 No
- The "MASTER DEVICE" field presents the mapped volume that is the highest in the snapshot's hierarchy.
Exposing Snapshots
The expose snapshot command performs the following:
- Creates a snapshot of the specified snapshot to expose (child snapshot).
- Makes the child snapshot write-enabled.
- Maps the child snapshot to the host.
- Mounting parameters are also available.
Run the command:
infinihost snapshot expose <snapshot-volume-name> [--name=NAME] [--description=DESCRIPTION] [--system=SYSTEM] [--lun=LUN] [--mount=PATH] [--yes]
- If "–name" is not specified, the snapshot name would be created using the following format:
- 'Parent_Vol_Name'.Exposed.yyyy.mm.dd_hhmmss
- In cases where the total snapshot volume name length is larger than 65 characters, 'Parent_Vol_Name' will be trimmed.
- "–yes" is required for the command execution.
Example:
infinihost snapshot expose Snap_1 --name=Exposed_Snap_1 --description="Exposed DB1" --mount=D:\ --yes
Output example for viewing the exposed snapshot:
>infinihost snapshot list SNAPSHOT NAME MASTER DEVICE PARENT DESCRIPTION CREATED AT MAPPED Snap_1 Vol1 (E:\) Vol1 Daily Oracle DB1 Snapshot 15-08-2018 No Exposed_Snap_1 Vol1 (E:\) Snap_1 Exposed DB1 15-08-2018 Yes (D:\)
Refreshing Snapshots
A snapshot can be refreshed so that its content adheres to a new point-in-time but all other snapshot attributes remain the same.
Warning
Refreshing a snapshot will overwrite its data.
Run the command:
infinihost snapshot refresh <snapshot-volume-name> [--system=SYSTEM] [--yes]
- "–yes" is required for the command execution.
Note
- Refreshing a snapshot is allowed only for snapshots that were created by Host PowerTools
- Refreshing a mounted snapshot is not allowed. (snapshot can me mapped but not mounted)
Deleting Snapshots
Run the command:
infinihost snapshot delete <snapshot-volume-name> [--system=SYSTEM] [--yes]
- "–yes" is required for the command execution.
Note
Deleting a snapshot is allowed only for snapshots that were created by Host PowerTools.
Editing Snapshots
The snapshot name and description can be modified.
Run the command:
infinihost snapshot edit <snapshot-volume-name> [--name=NAME] [--description=DESCRIPTION] [--system=SYSTEM]
Last edited: 2020-11-05 10:17:56 UTC
Comments