zestyctl verification - Verify Linux instance permissions

This topic describes the zestyctl verification CLI command.

If you plan to use the Zesty Disk CLI (zestyctl) on Linux instances, you should first run the zestyctl verification command to check that the integrated AWS instance account has the necessary permissions to run Zesty Disk features.

Run the verification command before using these features:

  • Create a new Zesty Disk filesystem.

  • Extend a filesystem with Auto Extend.

  • Use EZswitch for standalone instances.

You can run the command once to verify all of the features, or you can run it multiple times and specify which feature to verify on each run.

During verification, a volume is created and deleted. If tagging is enforced on new volumes, use the --device_name flag to specify an existing instance device. The verification will identify the related volume and its tags and will use those for the volume created for the verification test.

Syntax

zestyctl disk verification start [--feature=<feature>] [--device_name=<device>]

The verification process may take a few minutes. When you want to see results, run the following command:

zestyctl disk verification status

Example

The following example will start verification for EZswitch, using tagging from a current device:

zestyctl disk verification start [--feature=ezswitch] [--device_name=/dev/xvdb]

Parameters

Parameter

Description

Required

zestyctl disk verification start

Starts the verification process.

Y

--feature

Verifies permissions required for a specific Zesty Disk feature.

Type the string for the feature to verify.

  • zestydisk

  • ezswitch

  • autoextend

If you do not include this flag, the verification command will verify permissions for all features at one time.

N

--device_name

Indicates a current device from which tagging information can be derived.

N

Parameter

Description

Required

zestyctl disk verification status

Shows the verification report.

Y

Output

After running the zestyctl disk verification status command, output similar to the following is displayed:

# zestyctl disk verification status
The verification process completed successfully.
Describe instances: Pass
Create volume: Pass
Create snapshot: Pass
Delete snapshot: Pass
Modify volume: Pass
Create tags: Pass
Attach volume: Pass
Detach volume: Pass
Delete volume: Pass

If errors are shown, they are usually configuration errors, not issues in Zesty Disk.

If errors are shown when verifying for all features, you can run the verification command on a feature-by-feature basis to isolate the issue.

Prerequisites