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 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
.The Create backup plan dialog box appears.
-
In the Plan name, enter a name for the backup plan.
-
From the Storage list, select the storage to use for the backups.
-
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.
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:
-
To add the content to back up, in the Content area, click Add > Browse or Custom path.
-
To enter paths to items you want to include in backups, in the Enter custom path field, enter a path, and then click the add
button. -
To select items from a file system view of the server, do the following:
-
Click Browse.
The Browse Options dialog box appears.
-
In the Interface path box, provide the path details to browse the data.
-
From the Access nodes list, select the access node, and then click Browse.
The Add content dialog box appears.
-
Select the check boxes for the items that you want to include in the backup and then click Save.
-
-
-
To add filters to exclude items from backups, in the Exclusions area, click Add > Browse or Custom path.
-
To enter paths to items you want to exclude from backups, in the Enter custom path field, enter a filter pattern, and then click the add
button. -
To select items from a file system view of the server, do the following:
-
Click Browse.
The Browse Options dialog box appears.
-
In the Interface path box, provide the path details to browse the data to exclude.
-
From the Access nodes list, select the access node, and then click Browse.
The Add exclusions dialog box appears.
-
Select the check boxes for the items that you want to exclude in the backup and then click Save.
-
-
-
You can add the exceptions on the excluded data. To do so, move the Define exceptions toggle key to the right, and then click Add > Browse or Custom path.
-
To enter paths to items you want to exempt from the excluded data, in the Enter custom path field, enter a filter pattern, and then click the add
button. -
To select items from a file system view of the server, do the following:
-
Click Browse.
The Browse Options dialog box appears.
-
In the Interface path box, provide the path details to browse the data to except.
-
From the Access nodes list, select the access node, and then click Browse.
The Add exceptions dialog box appears.
-
Select the check boxes for the items that you want to except from the excluded data and then click Save.
-
-
-
From the Include global exclusions list, select one the following:
-
Off: To disable global filters for this subclient; only subclient exclusions are applied. This value overrides the Use Global Filters on All Subclients global filters setting.
-
On: To enable global filters for this subclient; both global and subclient exclusions are applied. This value overrides the Use Global Filters on All Subclients global filters setting.
-
Use cell level policy: To include global filters for this subclient only if the Use Global Filters on All Subclients option is selected in the 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.