Manage snapshot policies using the CLI

Manage snapshot policies using the CLI, ensuring efficient data protection and disaster recovery.

Overview

Creating policies using the CLI involves leveraging policy templates for efficient and consistent policy management that align with organizational requirements.

Process overview:

1. Export an existing policy to a template: The first step in creating a policy template is exporting an existing policy. If this is your first time, you can use the sys-default policy (json file), a predefined system policy that serves as a baseline. The sys-default policy is not editable, so it is ideal for use as an initial template.

2. Edit the exported policy template: After exporting the sys-default policy, you can modify the exported json file to suit your specific requirements. This customization allows you to create tailored templates for different groups of policies, streamlining policy creation for various scenarios.

3. Create a policy from a policy template: Create a new policy from the desired policy template and customize it further as needed to address specific use cases. This approach provides flexibility while ensuring consistency across policies derived from the same template.

4. Attach filesystems to a snapshot policy: Attach the relevant filesystems to the snapshot policy to ensure that the policy governs the creation, management, and retention of snapshots for these specific filesystems. This step links the policy to the filesystems, enabling consistent enforcement of snapshot rules and schedules.

After understanding the workflow for creating policies using the CLI, you can use the following commands to manage snapshot policies:

• List snapshot policies

• Show snapshot policy details

• Export snapshot policy

• Create snapshot policy

• Attach filesystems to a snapshot policy

• Detach filesystems from a snapshot policy

• Update snapshot policy

• Delete snapshot policy

List snapshot policies

Command: weka fs protection snapshot-policy list

This command displays a list of all existing snapshot policies in the system. The output includes details such as the policy ID, name, enabled status, description, and any filesystems the policy is attached to.

weka fs protection snapshot-policy list

Example: List snapshot policies

$ weka fs protection snapshot-policy list
SNAPSHOT POLICY ID  NAME         IS ENABLED  DESCRIPTION                                                                                         ATTACHED FILESYSTEMS
0                   sys-default  True        This snapshot policy is a fixed example configuration, it can be used as-is but cannot be modified
1                   weekly       True        Create a snapshot weekly on Saturdays                                                               fs1
2                   Policy1      True        Schedule daily snapshots                                                                            fs1, default

Show snapshot policy details

Command: weka fs protection snapshot-policy show

This command displays the configuration of a snapshot policy in JSON format. It provides a detailed representation of the policy, including schedules (hourly, daily, weekly, monthly, and periodic), retention settings, associated filesystems, and whether specific features are enabled.

JSON overview

• Schedules: Defines hourly, daily, weekly, monthly, and periodic snapshot schedules, including time, days, and upload settings.

• Retention: Specifies the number of snapshots to retain for each schedule type.

• Filesystems: Lists the filesystems attached to the policy.

• General settings: Includes the policy name, description, and enable/disable status.

weka fs protection snapshot-policy show <name>

Parameters

Parameter	Description
name*	Policy name

Example: Show snapshot policy details

$ weka fs protection snapshot-policy show Policy1
{
    "daily": {
        "days": "monday, wednesday, friday",
        "enable": true,
        "retention": 7,
        "time": "22:05",
        "upload": "local"
    },
    "description": "Policy description",
    "enabled": true,
    "filesystems": [
        "fs1",
        "default"
    ],
    "hourly": {
        "days": "monday, tuesday, wednesday, thursday, friday",
        "enable": false,
        "hours": "09, 10, 11, 12, 13, 14, 15, 16, 17, 18",
        "minuteOffset": 10,
        "retention": 10,
        "upload": "none"
    },
    "monthly": {
        "days": "07",
        "enable": false,
        "months": "all",
        "retention": 12,
        "time": "00:05",
        "upload": "local"
    },
    "name": "Policy1",
    "periodic": {
        "days": "monday, tuesday, wednesday, thursday, friday",
        "enable": false,
        "end_time": "18:00",
        "interval": 30,
        "retention": 4,
        "start_time": "09:00",
        "upload": "none"
    },
    "weekly": {
        "days": "saturday",
        "enable": false,
        "retention": 4,
        "time": "23:05",
        "upload": "local"
    }
}

Export snapshot policy

Command: weka fs protection snapshot-policy export

This command exports the configuration of an existing snapshot policy to a template file. Use the sys-default policy to export the cluster's default configuration as a baseline for creating customized policy templates.

weka fs protection snapshot-policy export <name> <path>

Parameters

Parameter	Description
name*	The snapshot policy to export.
path*	The path to the directory to save the export policy file.

Example: Export snapshot policy

$ weka fs protection snapshot-policy export sys-default /tmp/policy_template
Exported snapshot policy to /tmp/policy_template

Customize the policy template

To customize a policy template, follow these steps:

1. Open the exported template: Use a text editor, such as vi, to open the policy template file that you exported from the sys-default template or an existing snapshot policy.

2. Modify configuration details: Edit the template to customize the policy's configuration, such as schedules, retention rules, or other relevant settings, to meet your specific requirements.

3. Reuse the customized template: Save your changes. The modified template can now be used to create new policies tailored to your needs.

Example: Customize the policy template

In this example, the daily schedule is set for Monday, Wednesday, and Friday. The remaining schedules are disabled ("enable"=false,).

$ vi /tmp/policy_template

{
    "daily": {
        "days": "monday, wednesday, friday",
        "enable": true,
        "retention": 7,
        "time": "12:10",
        "upload": "local"
    },
    "hourly": {
        "days": "monday, tuesday, wednesday, thursday, friday",
        "enable": false,
        "hours": "09, 10, 11, 12, 13, 14, 15, 16, 17, 18",
        "minuteOffset": 5,
        "retention": 10,
        "upload": "none"
    },
    "monthly": {
        "days": "07",
        "enable": false,
        "months": "all",
        "retention": 12,
        "time": "00:05",
        "upload": "local"
    },
    "periodic": {
        "days": "monday, tuesday, wednesday, thursday, friday",
        "enable": false,
        "end_time": "18:00",
        "interval": 30,
        "retention": 4,
        "start_time": "09:00",
        "upload": "none"
    },
    "weekly": {
        "days": "saturday",
        "enable": false,
        "retention": 4,
        "time": "23:05",
        "upload": "local"
    }
}
-- INSERT --

Create snapshot policy

Command: weka fs protection snapshot-policy add

This command creates a new snapshot policy based on a specified template file. Provide the policy name, template file path, and optional parameters such as a description or enabled status.

weka fs protection snapshot-policy add <name> <path> [--description description] [--enabled enabled]

Parameters

Parameter	Description	Default
name*	The snapshot policy name. Up to 12 alphanumeric characters, hyphens (-), underscores (_), and periods (.)
path*	The path to the snapshot policy file. It must be in JSON format.
description	Policy description. Up to 128 characters.
enabled	Set snapshot policy status. Possible values: true or false	true

Example: Create a snapshot policy from a policy template

In this example, a new snapshot policy named policy2 is created using the template file located at /tmp/policy_template. The system returns the newly created policy's ID.

$ weka fs protection snapshot-policy create policy2 /tmp/policy_template
SnapPolicyId: 3

Attach filesystems to a snapshot policy

Command: weka fs protection snapshot-policy attach

This command attaches existing filesystems to a snapshot policy. Before proceeding, ensure each filesystem is attached to an object store.

weka fs protection snapshot-policy attach <name> [<filesystems>]...

Parameters

Parameter	Description
name*	The snapshot policy name.
filesystems... *	A list of filesystems you want to attach to the policy.

Example:

This command attaches the snapshot policy policy1 to the filesystems fs1 and default.

$ weka fs protection snapshot-policy attach policy1 fs1 default
$ weka fs protection snapshot-policy list
SNAPSHOT POLICY ID  NAME         IS ENABLED  DESCRIPTION                     ATTACHED FILESYSTEMS
0                   sys-default  True        Cluster default configuration  
1                   policy1      False       Schedule daily snapshots        fs1, default

Detach filesystems from a snapshot policy

Command: weka fs protection snapshot-policy detach

This command detaches the specified filesystems from the snapshot policy. To remove waiting tasks associated with the filesystems, add the --remove-waiting-tasks option.

weka fs protection snapshot-policy detach <name> [--remove-waiting-tasks] [<filesystems>]...

Parameters

Parameter	Description
name*	The snapshot policy name.
filesystems... *	A list of filesystems you want to detach from the policy.
remove-waiting-tasks	Allow to delete all waiting tasks corresponding to the filesystems.

Example: Detach a snapshot policy from filesystems

$ weka fs protection snapshot-policy detach pol1 fs1

Warning: You are about to detach filesystems. This action detach existing filesystem from the snapshot policy and cannot be undone.
Are you sure you want to continue (yes/no)? yes
Filesystems detached successfully

Update a snapshot policy

Command: weka fs protection snapshot-policy update

This command updates an existing snapshot policy. You can modify its name, description, policy parameters or enabled status.

weka fs protection snapshot-policy update <name> [--new-name new-name] [--description description] [--path path] [--enabled enabled]

Parameters

Parameter	Description
name*	Existing snapshot policy name.
new-name	New policy name. Up to 12 alphanumeric characters, hyphens (-), underscores (_), and periods (.).
description	New policy description. Up to 128 characters.
path	The path to the new or modified snapshot policy file. It must be in JSON format.
enabled	Set snapshot policy status. Possible values: true or false

Delete a snapshot policy

Command: weka fs protection snapshot-policy delete <name>

This command deletes the specified snapshot policy from the system. Ensure that no filesystems are attached to the policy before proceeding with the deletion.

weka fs protection snapshot-policy delete <name>

Parameters

Parameter	Description
name*	Existing snapshot policy name.

Example: Delete a snapshot policy

$ weka fs protection snapshot-policy delete policy2
Warning: You are about to delete a snapshot policy. This action deletes the snapshot policy and cannot be undone.

Are you sure you want to continue (yes/no)? yes