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.
  
  

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.

Run the command:

infinihost snapshot refresh <snapshot-volume-name> [--system=SYSTEM] [--yes]

• "–yes" is required for the command execution.
  

Deleting Snapshots

Run the command:

infinihost snapshot delete <snapshot-volume-name> [--system=SYSTEM] [--yes]

• "–yes" is required for the command execution.
  

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]