The file server guided setup guides you through adding a file server and creating a backup plan to protect Amazon FSx for NetApp ONTAP files exported to CIFS.
Before You Begin
-
To complete the setup wizard for the File Servers application, you will need the following information:
-
The host name of the Amazon FSx for NetApp ONTAP storage virtual machine (SVM)
-
Credentials the access node will use to access the SVM and create snapshots
-
Access node group or access node that will be used for backup
- An access node group is a server group containing one or more access node.
-
Credentials the access node will use to access the SVM data via CIFS
-
-
The required package can be installed on the access node(s) as part of the setup.
Start the Configuration Wizard
-
From the Command Center navigation pane, go to Explore > Service catalog.
-
In the Files tile, click Configure.
-
Select Cloud File Shares, and then click Next.
-
Select Amazon FSx for NetApp ONTAP as the cloud file share type.
-
Click Next.
Configure Permissions
-
From the Authentication method list, select the authentication type.
Note
-
To use auto-scaled access nodes, you must use AWS STS AssumeRole authentication for discovery and backup of the SVM. If a discovery resource pool is configured in your environment, the authentication method is managed by the MSP, and you might not be required to explicitly select AWS STS AssumeRole authentication.
-
Auto-scaled access nodes require AWS STS AssumeRole authentication. If you select another authentication method, the auto-scale option is not available.
-
-
Click the Launch the CloudFormation Stack link to open the AWS account in the AWS console.
Note
-
If you do not have permission to create a role in the AWS account, copy the Launch the CloudFormation Stack link and share it with your AWS IAM administrator.
-
To use auto-scaled access nodes, verify that the CloudFormation template creates a CommvaultAdminRole with EC2 create/terminate permissions and any required marketplace permissions.
-
-
Log on to the AWS console.
-
Under Capabilities, read the information about the template, and then select the acknowledgment check box.
-
Click Create stack.
Wait for the CloudFormation Stack to finish creating the IAM role.
IAM roles and policies for FSx for NetApp ONTAP
The IAM role used during backup configuration depends on whether auto-scale prerequisites are configured and how discovery is set up.
-
If auto-scale is enabled (scale manager is configured) CommvaultAdminRole is always used.
-
If auto-scale is not enabled:
-
If a discovery resource pool is configured, CommvaultTenantRole will be created.
-
If a discovery resource pool is not configured, CommvaultAdminRole will be created.
-
-
CommvaultAdminRole includes the following policies to support discovery, backup operations, and auto-scale:
-
CommvaultAdminRole-CVAutoScalePolicy
-
CommvaultAdminRole-DocDBPolicy
-
CommvaultAdminRole-DynamoDBPolicy
-
CommvaultAdminRole-EC2Policy
-
CommvaultAdminRole-FSPolicy
-
CommvaultAdminRole-FSxPolicy
-
CommvaultAdminRole-RDSPolicy
-
CommvaultAdminRole-RedshiftPolicy
-
CommvaultAdminRole-S3CloudLibPolicy
-
CommvaultAdminRole-S3Policy
-
CommvaultAdminRole-STSAssumePolicy
-
CommvaultAdminRole-VPCPolicy
-
-
If you are not using auto-scale and a discovery resource pool is configured, CommvaultTenantRole includes the following policies:
-
CommvaultTenantRole-DocDBPolicy
-
CommvaultTenantRole-EC2Policy
-
CommvaultTenantRole-FSxPolicy
-
CommvaultTenantRole-RDSPolicy
-
CommvaultTenantRole-RedshiftPolicy
-
CommvaultTenantRole-S3Policy
-
CommvaultTenantRole-VPCPolicy
-
Note
CloudFormation templates may include policies for multiple workloads. You can remove unused policies if they are not required for your FSx for NetApp ONTAP environment.
Permissions required to discover Amazon FSx for NetApp ONTAP resources
-
"fsx:DescribeFileSystems"
-
"fsx:DescribeStorageVirtualMachines"
-
"fsx:DescribeVolumes"
-
"fsx:ListTagsForResource"
Permissions required to create and manage auto-scaled access nodes
-
If auto-scale configurations are enabled, then the following additonal permissions are required:
-
"ec2:AllocateAddress"
-
"ec2:AllocateIpamPoolCidr"
-
"ec2:AssociateAddress"
-
"ec2:DescribeAddresses"
-
"ec2:DescribeIpamPools"
-
"ec2:DisassociateAddress"
-
"ec2:ReleaseAddress"
-
"iam:ListInstanceProfilesForRole"
-
"s3:ListBucketMultipartUploads"
-
"ec2:DescribeIpams"
-
-
-
After the stack is created, on the Outputs tab of the AWS console, copy the ExternalID and IAMRole key values.
-
Return to the Commvault Cloud configuration wizard.
-
From the Credential list, select existing credentials or create new credentials to discover the Amazon FSx for NetApp ONTAP cloud file share.
Important
The credentials must have an external ID and an IAM role ARN—the values that you copied from the Outputs tab of the AWS console in the preceding step:
-
If you select existing credentials, to verify that the credentials have an external ID and an IAM role ARN, click the edit button
. -
If you create new credentials, make sure to enter the external ID and the IAM role ARN.
-
-
Click Next.
-
From the Authentication method list, select the authentication type.
Note
-
To use auto-scaled access nodes, you must use AWS STS AssumeRole authentication for discovery and backup of the SVM. If a discovery resource pool is configured in your environment, the authentication method is managed by the MSP, and you might not be required to explicitly select AWS STS AssumeRole authentication.
-
Auto-scaled access nodes require AWS STS AssumeRole authentication. If you select another authentication method, the auto-scale option is not available.
-
-
Click the Launch the CloudFormation Stack link to open the AWS account in the AWS console.
Note
-
If you do not have permission to create a role in the AWS account, copy the Launch the CloudFormation Stack link and share it with your AWS IAM administrator.
-
To use auto-scaled access nodes, verify that the CloudFormation template creates a CommvaultAdminRole with EC2 create/terminate permissions and any required marketplace permissions.
-
-
Log on to the AWS console.
-
Under Capabilities, read the information about the template, and then select the acknowledgment check box.
-
Click Create stack.
Wait for the CloudFormation Stack to finish creating the IAM role.
IAM roles and policies for FSx for NetApp ONTAP
The IAM role used during backup configuration depends on whether auto-scale prerequisites are configured and how discovery is set up.
-
If auto-scale is enabled (scale manager is configured) CommvaultAdminRole is always used.
-
If auto-scale is not enabled:
-
If a discovery resource pool is configured, CommvaultTenantRole will be created
-
If a discovery resource pool is not configured, CommvaultAdminRole will be created.
-
-
CommvaultAdminRole includes the following policies to support discovery, backup operations, and auto-scale:
-
CommvaultAdminRole-CVAutoScalePolicy
-
CommvaultAdminRole-DocDBPolicy
-
CommvaultAdminRole-DynamoDBPolicy
-
CommvaultAdminRole-EC2Policy
-
CommvaultAdminRole-FSPolicy
-
CommvaultAdminRole-FSxPolicy
-
CommvaultAdminRole-RDSPolicy
-
CommvaultAdminRole-RedshiftPolicy
-
CommvaultAdminRole-S3CloudLibPolicy
-
CommvaultAdminRole-S3Policy
-
CommvaultAdminRole-STSAssumePolicy
-
CommvaultAdminRole-VPCPolicy
-
-
If you are not using auto-scale and a discovery resource pool is configured, CommvaultTenantRole includes the following policies:
-
CommvaultTenantRole-DocDBPolicy
-
CommvaultTenantRole-EC2Policy
-
CommvaultTenantRole-FSxPolicy
-
CommvaultTenantRole-RDSPolicy
-
CommvaultTenantRole-RedshiftPolicy
-
CommvaultTenantRole-S3Policy
-
CommvaultTenantRole-VPCPolicy
-
Note
CloudFormation templates may include policies for multiple workloads. You can remove unused policies if they are not required for your FSx for NetApp ONTAP environment.
Permissions required to discover Amazon FSx for NetApp ONTAP resources
-
"fsx:DescribeFileSystems"
-
"fsx:DescribeStorageVirtualMachines"
-
"fsx:DescribeVolumes"
-
"fsx:ListTagsForResource"
Permissions required to create and manage auto-scaled access nodes
-
If auto-scale configurations are enabled, then the following additonal permissions are required:
-
"ec2:AllocateAddress"
-
"ec2:AllocateIpamPoolCidr"
-
"ec2:AssociateAddress"
-
"ec2:DescribeAddresses"
-
"ec2:DescribeIpamPools"
-
"ec2:DisassociateAddress"
-
"ec2:ReleaseAddress"
-
"iam:ListInstanceProfilesForRole"
-
"s3:ListBucketMultipartUploads"
-
"ec2:DescribeIpams"
-
-
-
After the stack is created, on the Outputs tab of the AWS console, copy the Role ARN key value.
-
Return to the Commvault configuration wizard.
-
From the Credential list, select existing credentials or create new credentials to discover the Amazon FSx for NetApp ONTAP cloud file share.
Important
-
Credentials are required only for the AWS STS AssumeRole and Access keys for IAM users authentication methods.
-
The credentials must have an IAM role ARN - the values that you copied from the Outputs tab of the AWS console in the preceding step:
-
If you select existing credentials, verify that the IAM role ARN is correct.
-
If you create new credentials, make sure to enter the IAM role ARN.
-
-
-
Click Next.
Region
-
Select the region where the SVM resides.
-
Click Next.
Server Configuration
-
From the Storage Virtual Machine list, select the name of the Amazon FSx for NetApp ONTAP cloud file share.
Verify the ONTAP Management Interface, which is automatically populated based on the SVM that you selected.
If you have not created a dedicated workload resource pool, then the Access node for discovering Storage Virtual Machines list is displayed. Select or add an EC2 instance that will be used as the access node to discover the Amazon FSx for NetApp ONTAP cloud file share.
-
From the ONTAP Credential list, select existing credentials or create new credentials.
Steps to add new credentials
To add credentials to the Credential Manager, click the plus button (+), and then specify the following in the Add Credential dialog box.
-
In the Credential name box, enter the name of the credential.
-
In the User account box, enter the name of the user account.
-
In the Password box, enter the password.
-
In the Description box, you can enter a description of the credentials.
-
Click Save.
-
-
Verify the Display name for the Amazon FSx for NetApp ONTAP cloud file share.
-
Click Next.
-
From the Access node for discovering Storage Virtual Machines list, select or add an EC2 instance that will be used as the access node to discover the Amazon FSx for NetApp ONTAP cloud file share.
If you had selected the Access keys for IAM users authentication method, then all available access nodes with the VSA package installed are displayed.
Note
The IAM Role must already be created before you add an access node.
Steps to create an access node
-
Click the add button
. -
The Storage region is automatically selected based on the region that was selected from the Region page. You cannot edit this box.
-
Click the Launch the CloudFormation Stack link to open the AWS account in the AWS console.
Note: If you do not have permission to create a role in the AWS account, copy the Launch the CloudFormation Stack link and share it with your AWS IAM administrator.
-
Log on to the AWS console.
-
Under Network Configuration, from the Subnet ID list, select the subnet ID for the cloud file share.
-
Click Create stack.
Wait for the CloudFormation Stack to finish creating the access node.
-
-
From the Storage Virtual Machine list, select the name of the Amazon FSx for NetApp ONTAP cloud file share.
Verify the ONTAP Management Interface, which is automatically populated based on the SVM that you selected.
-
From the ONTAP Credential list, select existing credentials or create new credentials.
Steps to add new credentials
To add credentials to the Credential Manager, click the plus button (+), and then specify the following in the Add Credential dialog box.
-
In the Credential name box, enter the name of the credential.
-
In the User account box, enter the name of the user account.
-
In the Password box, enter the password.
-
In the Description box, you can enter a description of the credentials.
-
Click Save.
-
-
Verify the Display name for the Amazon FSx for NetApp ONTAP cloud file share.
-
Click Next.
Plan
-
From the Plan list, select the backup plan to use for the cloud file share.
Steps to create a new backup plan
-
Click the add button
. -
In the Plan name, enter a name for the backup plan.
-
If you have an active Files and Objects subscription, from the Storage list, select the storage to use for the backups.
-
If you have an active AGP bundle for File and Object subscription:
- The Storage region is automatically selected based on the region that was selected from the Region page. You cannot edit this box.
-
If you have both the above subscriptions:
-
To use regular storage for backups, move the Bring your own storage toggle to the right, and then select the Storage to use for the backups.
-
To use AGP bundled storage, leave the Bring your own storage toggle disabled.
- The Storage region is automatically selected based on the region that was selected from the Region page. You cannot edit this box.
-
-
For the backup plan settings, select pre-defined settings or create custom settings:
-
To select pre-defined settings, under Retention rules, select one of the following:
- Select Standard retention to retain the incremental backups for 1 month.
-
To create custom settings, move the Custom plan toggle key to the right, and then specify the following:
-
For Retention, specify the amount of time to retain the backup jobs.
-
For Backups run every, specify how often to run backups.
-
-
-
Click Done.
-
-
Click Next.
-
From the Plan list, select the backup plan to use for the cloud file share.
Steps to create a new backup plan
-
Click the add button
. -
In the Plan name field, enter a name for the backup plan.
-
From the Storage list, select the storage location for the backups.
-
Configure the backup plan retention and schedule by choosing one of the following options:
Use pre-defined settings
- Under Retention, select Standard retention to retain backups for 1 month.
Create custom settings
-
Enable the Custom plan toggle.
-
For Retention, specify how long to keep backups (example: 30 days, 1 year).
-
For Backups run every, specify how frequently to run backups (example: daily, weekly).
-
Click Done.
The backup plan is created and appears in the backup plan list.
-
-
Click Next.
Backup Content
-
To use dynamically provisioned access nodes, move the Auto scale toggle to the right.
To use permanent access nodes, proceed to select the backup protocol, and then the access nodes.
-
Move the CIFS toggle key to the right.
-
If you have enabled Auto scale, proceed to modify the backup content.
To use permanent access nodes to back up the Amazon FSx for NetApp ONTAP cloud file share, from the Access nodes list, select one or more access node groups or access nodes.
An access node is a machine with Commvault software installed to manage communication to and from the protected system. To access your Amazon FSx for NetApp ONTAP cloud file share via CIFS, the access node requires the Windows File System software.
If you do not already have a permanent access node, create a new one using the CloudFormation Stack or add an access node manually.
Steps to create an access node using the CloudFormation Stack
-
Click the add button
. -
The Storage region is automatically selected based on the region that was selected from the Region page. You cannot edit this box.
-
Click the Launch the CloudFormation Stack link to open the AWS account in the AWS console.
Note: If you do not have permission to create a role in the AWS account, copy the Launch the CloudFormation Stack link and share it with your AWS IAM administrator.
-
Log on to the AWS console.
-
Under Network Configuration, from the Subnet ID list, select the subnet ID cloud file share.
-
Click Create stack.
Wait for the CloudFormation Stack to finish creating the access node.
Note
-
Starting with Commvault Innovation Release 11.42.60, IntelliSnap backups of CIFS shares using Linux access nodes is supported for Amazon FSx for NetApp ONTAP.
-
The deferred cataloging and inline cataloging features are not supported while using Linux access nodes. To use these features, select a Windows access node for snapshot backups of CIFS shares.
-
-
From the CIFS Credentials list, select existing credentials or create new credentials that will be used to access the CIFS shares.
You must configure CIFS credentials to change the backup content.
Steps to add new credentials
To add credentials to the Credential Manager, click the plus button (+), and then specify the following in the Add Credential dialog box.
-
In the Credential name box, enter the name of the credential.
-
In the User account box, enter the name of the user account.
-
In the Password box, enter the password.
-
In the Description box, you can enter a description of the credentials.
-
Click Save.
-
-
By default, all CIFS shares will be selected for backup. To modify the backup content, move the All CIFS shares toggle key to the left and follow these steps:
-
In the Content area, click Add, and then choose one of the following methods:
-
Browse: Select items from the file system.
-
Custom path: Enter one or more paths manually.
-
-
In the Exclusions area, click Add, and then use Browse or Custom path to specify items to exclude.
-
To create exceptions, enable Define exceptions, click Add, and then use Browse or Custom path to specify items to exempt from the exclusions.
Browse
-
Click Browse.
-
Enter the Interface path.
-
Select an access node, and then click Browse.
-
Select the required items, and then click Save.
Custom path
-
Enter a path or filter pattern in the Enter custom path field.
-
Click the add button.
-
-
From the Include global exclusions list, select one of the following:
-
Off: Applies only subclient exclusions. This option overrides the Use Global Filters on All Subclients setting.
-
On: Applies both global filters and subclient exclusions. This option overrides the Use Global Filters on All Subclients setting.
-
Use cell level policy: Applies global filters only if Use Global Filters on All Subclients is enabled in Global Filters.
Note
If the Auto scale toggle is enabled, the first content browse operation might take longer to display results.
-
-
To verify the connection between the array and access node, click Test connection.
Note
This option is not available when backups are configured using auto-scaled access nodes.
-
Click Finish.