47 0 15MB
Integrating SwiftStack with Commvault V11
1 of 106
Table of Contents Table of Contents
2
Introduction
4
1. Initial Configuration
5
1.1 Set up Commvault User Account on SwiftStack
5
1.2 Configuration of Commvault V11
6
2. Configuring Storage Libraries
8
2.1 Configuration Procedure – Cloud Storage Library 2.2 Configuration Procedure – Local Disk Library
8 10
3. Licensing Validation
12
4. Basic Backup and Restore
14
4.1 Create a Storage Policy
14
4.2 Create a Subclient
19
4.3 Perform a Backup
26
4.4 Perform a Restore
28
5. Encrypted Backup and Restore
34
5.1 Enable Encryption
34
5.2 Create a Subclient
36
5.3 Perform Backup
36
5.4 Perform Restore
39
5.4 Disable Encryption
42
6. Auxiliary Copies
45
6.1 Cloud Library to Local Disk Library
45
6.1.1 Create Storage Policy and Primary Copy
45
6.1.2 Create Secondary Copy
47
6.1.3 Create Subclient
50
6.1.4 Perform Backup
50
6.1.5 Perform Auxiliary Copy
52
6.1.6 Restore from Auxiliary Copy
56
6.2 Local Disk Library to Cloud Library
59
6.2.1 Create Storage Policy and Primary Copy
59
6.2.2 Create Secondary Copy
61
6.2.3 Create Subclient
61 2 of 106
6.2.4 Perform Backup
62
6.2.5 Perform Auxiliary Copy
64
6.2.6 Restore from Auxiliary Copy
67
7. Verify Content
73
7.1 Check Mount Path
73
7.2 Check Media
73
8. Pruning
77
9. Deduplication
82
9.1 Create a Storage Policy
82
9.2 Create a Subclient
84
9.3 Perform a Backup
86
9.4 Perform a Restore
88
9.5 Deduplication Savings
91
10. Deconfigure
93
10.1 Delete Subclients
93
10.2 Delete a Storage Policy
94
10.3 Delete a Library
97
11. Reports and Logs
101
11.1 Reports
101
11.2 Log Collection
102
Conclusion
106
3 of 106
Introduction Commvault provides a single platform for automated global protection, retention, and recovery of data. Commvault enterprise data protection and recovery software automates global data protection, speeds up recovery, reduces costs, and simplifies operations. Commvault provides
a comprehensive data protection and management strategy which offers seamless and efficient backup, archiving, storage, and recovery of data in enterprise from any operating system, database, and application. This document provides instructions to configure Commvault’s cloud storage platform to utilize SwiftStack storage using the S3 API with Commvault’s V11 software. In addition, this document includes detailed configuration steps to set up the Commvault cloud storage library, perform backup and restore with deduplication and data encryption, perform auxiliary copy and restore operations from a local disk library to SwiftStack cloud storage and vice versa, perform data pruning, and generate reports and logs to support enterprise customer environments. Specifically, using source folders with files in them as sample data, the steps in this document will provide examples for how to configure and use storage policies to... 1. 2. 3. 4.
...backup data to a SwiftStack S3 target. ...backup data to a SwiftStack S3 target with deduplication enabled. ...backup data from a SwiftStack S3 target to a local disk library. ...backup data from a local disk library to a SwiftStack S3 target.
4 of 106
1. Initial Configuration 1.1 Set up Commvault User Account on SwiftStack The following steps will create an account in SwiftStack storage that can be used as a target for Commvault backups. 1. Using the SwiftStack controller, create a user account for Commvault; in this example, we named the user “Commvault.”
5 of 106
2. Click “Push Users to Cluster” to make this new account available for use.
3. Still using the SwiftStack Controller, note the S3 API Key (Secret Key) for the CommVault user.
4. Using SwiftStack client (available from swiftstack.com/downloads) or a similar tool, create a dedicated bucket (e.g. Test-1) within this new account space for the CommVault user to populate.
1.2 Configuration of Commvault V11 1. If not already installed, install Commvault V11 software on a Windows server or virtual machine. (Windows Server versions 2012 R2 or 2016 are required; see Commvault documentation for details and latest requirements.)
6 of 106
2. Add your license information to enable Commvault software for use, and configure a user account and password for the Commvault Commcell console, which provides a user interface through which users can manage all the functions of Disk Libraries.
7 of 106
2. Configuring Storage Libraries 2.1 Configuration Procedure – Cloud Storage Library The following steps outline what is needed to create a Cloud Storage Library. In this example, we will refer to it as "CommVault-1." 1. Within the CommCell Console, expand [Storage Resources] node from CommCell Browser. 2. Right-click [Libraries], and choose [Add] > [Cloud Storage Library].
3. After [Add Cloud Storage] dialog appears, enter the name of this Cloud Library (CommVault-1), choose S3 Type, select the MediaAgent that will control the CloudLibrary, define the Access Information, and click [OK].
8 of 106
4. Using the SwiftStack Client to observe the CommVault account and bucket you previously created, you should see that a folder is created in the “Test-1” bucket. (Note: In cloud storage, “folders” are just a logical concept and representation; in reality, the entire namespace in a bucket is flat, and any objects in a logical folder named “folder-a,” for example, simply have the folder name as a prefix of the object name, e.g., “folder-a/object-1,” “folder-a/object-2,” etc.)
9 of 106
5. Over time, Commvault can store many millions of objects in SwiftStack. To optimize performance with hundreds of millions of objects in a single bucket, SwiftStack uses an intelligent “container sharding” feature. When the SwiftStack controller identifies a bucket (i.e., container) that is a candidate for sharding, it will present a notice to the administrator on the Cluster > Monitor > Sharding > Manage Large Containers page. To maintain optimal performance, if you see this notice, you should take the recommended action to let SwiftStack perform the sharding function.
2.2 Configuration Procedure – Local Disk Library The following steps outline what is needed to create a Local Disk Library. In this example, we will refer to it as “local storageLibrary.” 1. Within the CommCell Console, expand [Storage Resources] node from CommCell Browser. 2. Right-click [Libraries], and choose [Add] > [Disk Library].
3. After the [Add Disk Library] dialog appears, type in the name of the Disk Library (local storageLibrary), then browse to select a folder path “Local Storage” using the “…” button next to [Disk Device].
10 of 106
4. Click [OK] to finish creating the Disk Library. 5. Confirm that both the Local Disk Library and the Cloud Storage Library (created in previous step) are listed under [Library] node.
11 of 106
3. Licensing Validation Once the Storage has been configured, you should confirm that your Commvault license allows for the use of cloud storage by using the [License Administration] dialog. 1. Click the [Home] tab at the top of the ribbon on the CommCell Console. 2. Click the [License and Registration] button from the ribbon as shown below:
3. Once the [Licensing and Registration] dialog is displayed, click the [License Details] tab.
12 of 106
4. Confirm that Evaluation or Permanent columns correctly display the quantity of [Cloud Storage] licenses you have configured.
13 of 106
4. Basic Backup and Restore Now that cloud and local storage libraries have been configured, we can use them within Storage Policies to run backup and restore jobs. To do so, we will define a Storage Policy and a backup subclient, then we can perform the Backup and Restore jobs.
4.1 Create a Storage Policy The following steps will guide you through creating a Storage Policy; in this example, we will name it SwiftStack-S3 and will use the Cloud Storage Library, CommVault-1. 1. F rom the CommCell Browser, expand the [Policies] node. 2. Right-click the [Storage Policies] node, and choose [New Storage Policy].
3. After the [Create Storage Policy Wizard] appears, choose [Data Protection and Archiving] in the [Storage Policy Type] section, and click the [Next] button.
14 of 106
4. Enter the name of the Storage Policy (SwiftStack-S3) into the [Storage Policy Name] field, and click the [Next] button.
5. If asked whether to utilize an Existing Global Deduplication Policy, select “No,” and click the [Next] button.
15 of 106
6. Choose a Cloud Storage Library (CommVault-1) from the [Library] drop-down list, and click [Next].
7. Choose the MediaAgent you designated when initially configuring your Cloud Storage Library. It should be the default choice for this dialog. Click [Next] to accept the MediaAgent selection.
16 of 106
8. Use the default value for Streams and Retention Criteria, and click [Next].
9. Ensure the [Software Encryption] option on the [Advanced settings for the primary copy] screen is unchecked (the default is to be unchecked), and then click the [Next] button.
17 of 106
10. Un-check the [Yes] checkbox to disable deduplication for this copy, and click the [Next] button.
11. Review the configuration options, and click the [Finish] button. 12. Confirm that a Storage Policy named SwiftStack-S3 is now visible under the [Storage Policies] node. If it does not appear, press F5 to refresh the CommCell Console, or [View] from the ribbon then [Refresh].
18 of 106
4.2 Create a Subclient The following steps will guide you to create a subclient named FC01_Local to backup the C:\DATA\DATA01 folder with the SwiftStack-S3 Storage Policy. (Substitute the name of your test data folder for C:\DATA\DATA01 and your MediaAgent for sac-se-mileston in the following steps if it differs). 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node. 2. Right-click the [defaultBackupSet] node, and choose [All Tasks] > [New Subclient].
3. After the [Subclient Properties of] dialog appears, enter name of Subclient (FC01_Local) into the [Subclient name] textbox, and click the [Content] tab.
19 of 106
20 of 106
4. Select the [Content] tab, then click [Browse].
5. Within the [Browsing content for] dialog, choose the target folder for backup (C:\DATA\DATA01), and click [Add] and then [Close].
21 of 106
6. Confirm that the selected path (C:\DATA\DATA01) is added into the [Content of subclient] list.
22 of 106
7. Select the [Storage Device] tab, and select the Storage Policy for this subclient (SwiftStack-S3) from the [Storage Policy] list.
23 of 106
8. Click on the [Deduplication] sub-tab, un-select the [Enable Deduplication] checkbox, and click [OK].
24 of 106
25 of 106
9. After the [Backup Schedule] dialog appears, choose [Do Not Schedule], and click [OK].
10. Confirm that the subclient is added into subclient list. If it does not appear, press F5 to refresh the CommCell Console, or [View] from the ribbon then [Refresh].
4.3 Perform a Backup With a storage policy and subclient now configured, the following steps will perform a full backup of the FC01_Local Subclient. (Remember to substitute your names for our examples where needed.) 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node and choose the [defaultBackupSet] node.
26 of 106
2. Right-click the Subclient for Backup (FC01_Local), and choose [Backup].
3. After the [Backup Options for Subclient] dialog appears, choose [Full] Backup Type, and click [OK].
4. It is possible to monitor the backup job from the Job Controller. Job details are available if you double-click on the job, or right-click and select [Job Details].
27 of 106
5. If interested, upon completion of the job, you can use the SwiftStack Client to observe that new objects (i.e., your backup data) have been successfully added under a new folder in your backup target bucket.
4.4 Perform a Restore To observe a restoration of the data you backed up, the following steps will guide you through moving your source data and running the restore job. (Remember to substitute your names for our examples where needed.) 1. Prior to restore, copy the contents of C:\DATA\DATA01 to a temporary location, and delete the files from C:\DATA\DATA01.
28 of 106
2. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 3. Right-click Subclient (FC01_Local) for restore, and choose [Browse and Restore]. After the [Browse and Restore Options] dialog appears, click [View Content].
29 of 106
4. After the [Browse and Restore Options] dialog appears, click [View Content].
30 of 106
5. After backed up files are listed, choose files for restore, and click [Recover All Selected].
6. After the [Restore Options for All Selected Items] dialog appears, confirm the configuration of the restore job, and click [OK]. The default options will automatically restore the files back in-place to their original location.
31 of 106
7. You can use the [Job Controller] tab to monitor the start and completion of the Restore job.
32 of 106
8. Confirm that files are restored successfully.
33 of 106
5. Encrypted Backup and Restore The following steps in this section are much like the previous steps for a basic backup and restore operation, but this demonstrates the use of encryption for your backup data. As in other sections, please remember to use your directory, bucket, mediaAgent, and other unique names in place of the examples in these steps.
5.1 Enable Encryption 1. From the CommCell Browser, expand the [Client Computers] node. 2. Right-click [sac-se-mileston], and select [Properties].
34 of 106
3. After the [Client Computer Properties for sac-se-mileston] dialog appears, click the [Advanced] button.
4. After the [Advanced Client Properties] dialog appears, click the [Encryption] tab. 5. Select the [Encrypt data with following settings] radio button in the [Encryption] tab and [OK]. This will enable the default choice of Blowfish software encryption with a key length of 128-bit. (Selecting the [Cipher] drop-down box will display other supported ciphers, while selecting [Key Length] will display supported key lengths for the currently selected cipher.)
35 of 106
6. Click the [OK] button in the [Client Computer Properties] dialog.
5.2 Create a Subclient Follow the same steps in the previous “Create a Subclient” section. In our example, we used the following parameters for this new subclient. ● ● ●
Subclient Name: FC02_Encrypt Content: C:\DATA\DATA02 Storage Policy: SwiftStack-S3
5.3 Perform Backup Similar to the last backup job, run a full backup of the new (FC02_Encrypt) subclient.
36 of 106
1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 2. Right-click the subclient for Backup (FC02_Encrypt), and choose [Backup].
3. After the [Backup Options for Subclient] dialog appears, choose [Full] Backup Type, and click [OK].
4. As before, you can monitor the job from the job controller. Wait for progress to reach 100%.
37 of 106
5. To review more details about the job, double-click on the job name.
38 of 106
5.4 Perform Restore Similar to the last restore steps, you can restore the encrypted backup files backed up with the new (FC02_Encrypt) subclient. 1. Move, copy, or delete the files that were backed up from the C:\DATA02 folder. 2. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 3. Right-click the subclient (FC02_Encrypt) for restore, and choose [Browse and Restore]. 4. After the [Browse and Restore Options] dialog appears, click [View Content].
5. After the backed up files are listed, choose the files for restore, and click [Recover All Selected].
39 of 106
6. After the [Restore Options for All Selected Items] dialog appears, confirm the configuration of the restore job, and click [OK]. The default options will automatically restore the files back in-place to their original location.
40 of 106
7. As before you can monitor the [Job Controller] tab for the start and completion of the Restore job.
41 of 106
8. Confirm that the files are restored successfully.
5.4 Disable Encryption If you do not want encryption to remain enabled, you can follow these steps to disable it. 1. From the CommCell Browser, expand the [Client Computers] node. 2. Right-click [sac-se-mileston], and choose [Properties].
42 of 106
3. After the [Client Computer Properties] dialog appears, click the [Advanced] button.
4. After the [Advanced Client Properties for sac-se-mileston] dialog appears, click the [Encryption] tab.
43 of 106
5. Select the [Do not encrypt] checkbox in the [Encryption] tab, and click the [OK] button.
6. Click [OK] to exit the Advanced Client Properties dialog, then [OK] to exit the [Client Computer Properties for sac-se-mileston] dialog.
44 of 106
6. Auxiliary Copies The following sections detail the steps needed to make auxiliary copies of your data in two directions—from your cloud storage to your local storage and vice versa.
6.1 Cloud Library to Local Disk Library Follow the steps below to create a new Storage Policy named Cloud2Local that will duplicate backup images from the Cloud Storage Library (CommVault-1) to the Local Disk Library (local storageLibrary). As in other sections, you may use your own unique names instead of those we use in our examples here.
6.1.1 Create Storage Policy and Primary Copy Follow the steps detailed with screenshots in section 4.1 and summarized here to create a storage policy. In this case, however, note that we have used a different storage policy name (Cloud2Local). 1. From the CommCell Browser, expand the [Policies] node. 2. Right-click the [Storage Policies] node, and choose [New Storage Policy]. 3. After the [Create Storage Policy Wizard] appears, choose [Data Protection and Archiving] in the [Storage Policy Type] section, and click the [Next] button. 4. Enter the name of the Storage Policy (Cloud2Local) into the [Storage Policy Name] field, and click the [Next] button.
45 of 106
5. Leave the [No] radio button selected in the [Use Existing Global Deduplication Policy] section, and click the [Next] button. (This screen will only appear if there are Global Deduplication Policies present in the CommCell.) 6. Choose the Cloud Storage Library (CommVault-1) from [Library] list, and then click the [Next] button. 7. Choose the MediaAgent (sac-se-mileston) to read / write images to the Cloud Storage Library from the [MediaAgent] list, and click the [Next] button. 8. Use the default value for Streams and Retention Criteria, and click the [Next] button. 9. Use the default value (the [Software Encryption] checkbox is unchecked)) on the [Advanced settings for the primary copy] screen, and click the [Next] button. 10. Un-check the [Yes] checkbox on the [Do you want to enable Deduplication for the primary copy?] screen to disable deduplication for this copy, and click the [Next] button.
46 of 106
11. Review the configuration option and click [Finish].
12. Confirm that a Storage Policy named Cloud2Local is added under the [Storage Policies] node.
6.1.2 Create Secondary Copy Follow the steps below to add a secondary copy to your new storage policy.
47 of 106
1. From the CommCell Browser, expand the [Policies] > [Storage Policies] node. 2. Right-click the [Cloud2Local] node, and choose [All Tasks] > [Create New Copy].
3. After the [Copy Properties] dialog appears, Enter Secondary into the [Copy Name] textbox, choose the Local Disk Library (local storageLibrary) in the [Library] drop-down box in the [Default Destination] section, choose sac-se-mileston in the [MediaAgent] drop-down box in the [Default Destination] section, and click the [OK] button.
48 of 106
4. After the [Auxiliary Copy Schedule] dialog appears, choose [Do Not Schedule], and click [OK]. 5. Confirm that a Storage Policy named Secondary is added to the Cloud2Local Storage Policy.
49 of 106
6.1.3 Create Subclient Follow the same steps in section 4.2 to create a subclient, but use the following parameters or your own unique names for this step: ● ● ●
Subclient name: FC03_Cloud2Local Content: C:\DATA\DATA03 Storage Policy: Cloud2Local
6.1.4 Perform Backup Follow the steps below to perform a full backup of the FC03_Cloud2Local subclient. Remember to substitute your own names for the examples we used. 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 2. Right-click the Subclient for Backup (FC03_Cloud2Local), and choose [Backup].
3. After the [Backup Options for Subclient] dialog appears, choose [Full] Backup Type, and click [OK].
50 of 106
4. You can monitor the Backup Job from the controller. Details are available by double-clicking on the job name.
5. When the job completes, you can observe with the SwiftStack Client that new objects have been successfully added under a new folder in your bucket.
51 of 106
6.1.5 Perform Auxiliary Copy Follow the steps below to duplicate the backup image from the Cloud Storage Library to the Local Disk Library. 1. From the CommCell Browser, expand the [Policies] > [Storage Policies] > [Cloud2Local] node. 2. Right-click the [Secondary] node, and choose [View] > [Jobs].
3. After the [Job Filter for Storage Policy] dialog appears, deselect the [Specify Time Range] checkbox, and click [OK].
52 of 106
4. Confirm that there are some jobs with the [To Be Copied] status.
5. From the CommCell Browser, expand the [Policies] > [Storage Policies] node.
53 of 106
6. Right-click the [Cloud2Local] node, and choose [All Tasks] > [Run Auxiliary Copy].
54 of 106
7. After the [Auxiliary Copy Job Options] dialog appears, click [OK].
8. Monitor the status of the Auxiliary Copy job from the Job Controller. (Additional details may be accessed by double-clicking on the job, or right-click, then select [Job Detail].) 9. From the CommCell Browser, expand the [Policies] > [Storage Policies] > [Cloud2Local] node. 10. Right-click the [Secondary] node, and choose [View] > [Jobs]. 11. After the [Job Filter for Storage Policy] dialog appears, deselect the [Specify Time Range] checkbox, and click [OK]. 12. Observe that the Status of Jobs are changed from [To Be Copied] to [Available] if the Aux Copy job is completed.
55 of 106
6.1.6 Restore from Auxiliary Copy Follow the steps below to restore files from the duplicated images on the Local Disk Library. 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 2. Right-click the [FC03_Cloud2Local] Subclient, and choose [Browse and Restore].
3. After the [Browse and Restore Options] dialog appears, click the [Advanced Options] tab. 4. Select the [Browse from copy precedence] checkbox, specify [2] in the textbox, and click the [View Content] button.
56 of 106
5. After backed up files are listed, choose files for restore, and click the [Recover All Selected] button.
6. After the [Restore Options for All Selected Items] dialog appears, confirm the configuration of the restore job, and click [OK]. (Note: Before restoring, move, or delete the files from DATA\DATA03 and the subfolder.)
57 of 106
7. Click [Job Controller] in the [Home] tab to display the Job Controller and check the status of the Restore job from the Job Controller.
8. Confirm that files are restored correctly. 9. Right-click the restore job, and choose [View Logs] > [By Job ID]. 10. After the [Log File for Job] dialog appears, press the [Ctrl] + [F] keys. 11. After the [Find] dialog appears, enter DATAPATH SELECTED into the [Find] textbox, and click the [Find Next] button.
58 of 106
12. Check the value of the LIBRARY parameter on the highlighted log file line, and confirm that the Local Disk Library (local storageLibrary) was used.
6.2 Local Disk Library to Cloud Library These steps perform the opposite of the last section. Follow along to create a Storage Policy named Local2Cloud that duplicates backup images from the Local Disk Library (local storageLibrary) to the Cloud Storage Library (CommVault-1). As always, remember to substitute your unique names for our examples.
6.2.1 Create Storage Policy and Primary Copy Follow the same steps detailed in section 6.1.1 with the following changes: 1. Use the storage policy name (Local2Cloud) in the [Storage Policy Name] field in step #4.
59 of 106
2. Choose the Local Disk Library (local storageLibrary) from the [Library] drop-down list in step #6. 3. Confirm that the Storage Policy named Local2Cloud is added under the [Storage Policies] node in step #12.
60 of 106
6.2.2 Create Secondary Copy Follow the same steps detailed in section 6.1.2 with the following changes: (Follow the steps in 6.1.2 with the following changes in 6.2.2.3 and 6.2.2.5) 1. In step #2, right-click the [Local2Cloud] node, and choose [All Tasks] > [Create New Copy]. 2. In step #3, after the [Copy Properties] dialog appears, enter Secondary into the [Copy Name] textbox, choose the Cloud Library (CommVault-1) from the [Library] drop-down box in the [Default Destination] section, choose sac-se-mileston from the [MediaAgent] drop-down box in the [Default Destination] section, and click the [OK] button. 3. In step #5, confirm that a Storage Policy copy named Secondary is added into the Local2Cloud Storage Policy.
6.2.3 Create Subclient Create a new subclient by following the procedure in section 4.2 with the following settings: 61 of 106
● ● ●
Subclient name: FC04_Local2Cloud Content: C:\DATA\DATA04 Storage Policy: Local2Cloud
6.2.4 Perform Backup Follow the steps below to perform a full backup of the FC04_Cloud2Local Subclient. 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node.
62 of 106
2. Right-click the Subclient for Backup (FC04_Local2Cloud), and choose [Backup].
3. After the [Backup Options for Subclient] dialog appears, choose [Full] Backup Type, and click [OK].
4. Monitor the Backup Job from the controller. Details are available when you double-click on the job name.
63 of 106
5. Upon completion of the job, you can observe on the SwiftStack Client that that new objects have been successfully added under a new folder in your bucket.
6.2.5 Perform Auxiliary Copy The following steps will duplicate the backup image from the Cloud Storage Library to the Local Disk Library. 1. From the CommCell Browser, expand the [Policies] > [Storage Policies] > [Cloud2Local] node. 2. Right-click the [Secondary] node, and choose [View] > [Jobs]. 3. After the [Job Filter for Storage Policy] dialog appears, deselect the [Specify Time Range] checkbox, and click [OK]. 4. Confirm that there are some jobs with [To Be Copied] status.
64 of 106
5. From the CommCell Browser, expand the [Policies] > [Storage Policies] node. 6. Right-click the [Cloud2Local] node, and choose [All Tasks] > [Run Auxiliary Copy].
65 of 106
7. After the [Auxiliary Copy Job Options] dialog appears, click [OK].
8. Monitor the status of the Auxiliary Copy job from the Job Controller. (Additional details may be accessed by double-clicking on the job, or right-click, then select [Job Detail].) 9. From the CommCell Browser, expand the [Policies] > [Storage Policies] > [Cloud2Local] node. 10. Right-click the [Secondary] node and choose [View] > [Jobs]. 11. After the [Job Filter for Storage Policy] dialog appears, de-select the [Specify Time Range] checkbox, and click [OK]. 12. Observe that the Status of Jobs are changed from [To Be Copied] to [Available] if the Aux Copy job completed.
66 of 106
6.2.6 Restore from Auxiliary Copy Follow the steps below to restore your files from duplicated images on the Local Disk Library. 1. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node.
67 of 106
2. Right-click the [FC03_Cloud2Local] Subclient, and choose [Browse and Restore].
3. After the [Browse and Restore Options] dialog appears, click the [Advanced Options] tab. 4. Select the [Browse from copy precedence] checkbox, specify [2] in the textbox, and click the [View Content] button.
68 of 106
5. After backed up files are listed, choose files for restore, and click the [Recover All Selected] button.
69 of 106
6. After the [Restore Options for All Selected Items] dialog appears, confirm the configuration of the restore job, and click [OK]. (Note: Delete or move all the files from DATA\DATA04 to a temporary location before restoring, and delete the subfolder.)
7. Click [Job Controller] in the [Home] tab to display the Job Controller, and check the status of the Restore job.
70 of 106
8. Confirm that files are restored correctly. 9. Right-click the restore job, and choose [View Logs] > [By Job ID]. 10. After the [Log File for Job] dialog appears, press the [Ctrl] + [F] keys. 11. After the [Find] dialog appears, enter DATAPATH SELECTED into the [Find] textbox, and click the [Find Next] button.
71 of 106
12. Check the value of the LIBRARY parameter on the highlighted log file line, and confirm that the Local Disk Library (local storageLibrary) was used.
72 of 106
7. Verify Content Check from Mount Path level, view content, amount of valid Chunk Info. Check View Job and media from SP copy level.
7.1 Check Mount Path Use these steps to observe the properties of the Mount Path on a Cloud Library (CommVault-1). 1. From the CommCell Browser, expand [Storage Resources] > [Libraries] > [CommVault-1]. 2. Right-click on the Mount Path, and choose [Properties]. 3. Click the [Sharing] tab. 4. Note the value of the [Username] column.
7.2 Check Media Use these steps to map data created by Commvault to that stored on SwiftStack. 1. From the CommCell Browser, expand the [Policies] > [Storage Policies] node, and choose [Local2Cloud]. 2. Right-click the [Secondary] node, and choose [View] > [Jobs]. 3. After the [Job Filter for Storage Policy] dialog appears, deselect the [Specify Time Range] checkbox, and click the [OK] button.
73 of 106
4. Right-click one of the Jobs, and choose [View Media].
74 of 106
5. After the [Media Used by Job ID] dialog appears, note the value of the [Barcode] column.
6. Using the SwiftStack Client, note that an object folder exists which has the same name as in the [Media Used by Job ID] dialog (1117).
75 of 106
76 of 106
8. Pruning Follow the steps below to initiate a pruning job and observe that it removes data as expected. In this example, we will remove the data from barcode 1117 as shown in the previous section. 1. From the CommCell Browser, expand the [Policies] > [Storage Policies] > [Local2Cloud] node. 2. Right-click the [Secondary] node, and choose [View] > [Jobs]. 3. After the [Job Filter for Storage Policy] dialog appears, deselect the [Specify Time Range] checkbox, and click the [OK] button.
77 of 106
4. After the list of available jobs are shown, right-click on an available job to delete, and choose [Delete Job].
5. After the [Delete Job] dialog appears, choose [Yes] and, click the [OK] button.
78 of 106
6. After the [Delete Job] dialog box with the job list appears, click the [OK] button.
7. After the [Enter Confirmation text] dialog appears, enter the “erase and reuse media” phrase into the text box, then click [OK] to start deletion of the Job.
8. Confirm that the Job has been deleted from the list. 9. From the CommCell Browser, right-click the root node (sac-se-mileston), and choose [All Tasks] > [Data Aging].
79 of 106
10. After the [Data Aging Options] dialog appears, click the [OK] button.
80 of 106
11. Wait for the Data Aging job to complete first (check the Job Controller).
12. When complete, you can confirm with the SwiftStack Client that the objects for barcode 1117 have been removed. Specifically, there are two objects remaining—one with media_label_size and another Directory_Holder, but all other chunks are all removed.
81 of 106
9. Deduplication The following sections provide steps and examples for running backup and restore jobs using a deduplication-enabled Storage Policy and confirming that deduplication is working to provide space savings. As in other sections, please remember to substitute your unique names for the examples we used.
9.1 Create a Storage Policy 1. Follow steps 1-10 as detailed in section 4.1 to create a storage policy, except name the storage policy CloudDedupe in step 4,...
...and select Yes to enable deduplication.
82 of 106
2. Specify a location for the deduplication database (DDB), and click the [Next] button.
83 of 106
3. Review the configuration options, and click the [Finish] button.
9.2 Create a Subclient Follow the steps detailed in section 4.2 to create a subclient, but use the following parameters or your own unique values: ● ● ●
Subclient Name: FC05_CloudDedupe Content: C:\DATA\DATA05 Storage Policy: SwiftStack-S3
84 of 106
●
Enable Deduplication: Yes (Storage Device->deduplication)
85 of 106
9.3 Perform a Backup The steps required to perform a backup are similar to those detailed in section 4.3.
86 of 106
1. Run a full backup of the FC05_CloudDedupe S ubclient.
2. Monitor the job from the Job Controller, and wait for the job to complete.
87 of 106
3. When the Backup Job completes, observe the objects that were created (in a separate folder) using SwiftStack Client.
9.4 Perform a Restore Follow the steps below to perform a restore job of the data that was just backed up. 1. Before restoring, delete or move the files in Data05 to a different folder, and delete the Data05 folder. 2. From the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose the [defaultBackupSet] node. 3. Right-click the subclient (FC05_CloudDedupel) for restore, and choose [Browse and Restore].
88 of 106
4. After [Browse and Restore Options] dialog appears, click [View Content].
5. After the backed up files are listed, choose files for restore, and click [Recover All Selected]. 6. After the [Restore Options for All Selected Items] dialog appears, confirm the configuration of the restore job, and click [OK]. The default options will automatically restore the files back in-place to their original location.
89 of 106
7. You can monitor the Job Controller to observe the completion of the Restore Job.
8. When the job is complete, confirm the restoration by looking at the files in folder C:\DATA05.
90 of 106
9.5 Deduplication Savings Follow the steps below to observe the savings realized by the deduplication operation during backup. 1. From the CommCell Browser, expand the [Storage Resources] node, then expand the [Deduplication Engines] node.
2. Select the [CloudDedupe/Primary] node, and note the [Total Application Size] value against the [Total Data Size on Disk] value to show that deduplication has taken effect. Please note that the results of this example test scenario may not be representative of the deduplication savings in an actual production environment due to the composition of the test data.
91 of 106
92 of 106
10. Deconfigure The following sections describe the steps required to deconfigure a cloud library—including deleting subclients, storage policies, and libraries. Remember that your names for things like subclients and libraries will likely differ from the examples used here.
10.1 Delete Subclients Follow the steps below to delete subclients as desired. 1. The list of available subclients can be viewed in the CommCell Browser.
2. In the CommCell Browser, expand the [Client Computers] > [sac-se-mileston] > [File System] node, and choose [defaultBackupSet]. 3. Right-click one of the subclients, and choose [Delete].
4. When the [Confirm Delete] dialog appears, click [Yes], and confirm that the subclient is deleted from the list. 93 of 106
5. Re-run these steps as needed to delete additional subclients.
10.2 Delete a Storage Policy Follow the steps below to delete a storage policy. Note that storage policies need to be unassociated from subclients before deleting. 1. From the CommCell Browser, expand the [Policies] > [Storage Policies] node. 2. Right-click the [CloudDedupe] storage policy, and select [Properties]. 3. On the [Associated Subclients] tab, select the [DDBBackup] subclient, and then click the [Re-Associate] button.
94 of 106
4. When the [Re-Associate Subclient(s)] dialog appears, select [Not Assigned] from the drop-down box, and then click the [OK] button
5. Click the [OK] button to close the [Storage Policy Properties: CloudDedupe] dialog box. 6. From the CommCell Browser, expand the [Policies] > [Storage Policies] node.
95 of 106
7. Right-click one of the Storage Policies, and choose [All Tasks] > [Delete].
8. After the [Confirm Delete] dialog appears, click the [Yes] button.
9. When the [Enter Confirmation text] dialog appears, enter the “erase and reuse media” phrase into the text box, then click [OK] to delete the Storage Policy.
96 of 106
10. Confirm the Storage Policy is deleted from the CommCell Browser.
11. Repeat these steps as needed to delete additional storage policies.
10.3 Delete a Library Follow the steps below to delete a storage library created to use SwiftStack Storage. 1. Before deleting, you can view the contents of your Cloud Storage Library in SwiftStack using the SwiftStack Client (available for free at swiftstack.com/downloads).
97 of 106
2. Using the CommCell Browser, expand [Storage Resources] > [Library].
98 of 106
3. Right-click the Cloud Storage Library (CommVault-1), and choose [Delete].
4. A fter the [Delete] dialog appears, click [Yes].
99 of 106
5. Using the CommCell Browser and/or the SwiftStack Client, observe that the Cloud Storage Library (CommVault-1) node has been deleted.
100 of 106
11. Reports and Logs The following sections provide a brief overview of how you can retrieve reports and observe logs from the activity of your Commvault and SwiftStack configuration.
11.1 Reports 1. From the ribbon at the top of the CommCell Console, select [Reports], then select [Other Reports]. From the drop-down, select [Library and Drive].
2. After the [Report Selection] dialog appears, click [Run], and wait for the report to load in the default browser.
101 of 106
The report will provide all the statistics and details of the jobs run on Commvault Libraries. Reports are saved in C:\Program Files\Commvault\ContentStore\Reports Folder (Note that there are two mount paths shown for CommVault-1. Test-1(9OKKHS_01.15.2019_20.38) path is used and the other path Test-1 (ZO7J0V_12.19.2018_21.04) is an old mount path and not valid)
11.2 Log Collection The following steps demonstrate how to capture logs that can be reviewed or sent to Commvault for support. 1. From the CommCell Browser, right-click on the CommServe, and choose [All Tasks] > [Send Log Files]. 2. On the [Computers] tab, select the [CommServe], [MediaAgents], and [Client Computers] checkboxes.
102 of 106
3. On the [CommCell Information] tab, select the [CommServe Database] and [Get Latest Database(s)] checkboxes.
103 of 106
4. On the [Machine Information] tab, select the [Logs], [Machine Configuration], and [OS Logs] checkboxes (these are the default settings).
5. On the [Output] tab, unselect the [Upload to HTTPS] checkbox, select the [Output To] checkbox, select the [Local Path] radio button, specify a temporary path to save the log 104 of 106
files, and then click the [OK] button.
6. The logs will be found in the location specified (C:\log_temp).
105 of 106
Conclusion SwiftStack Storage is fully tested for use with Commvault Cloud Storage Platform. Commvault’s V11 software now extends SwiftStack’s capability to provide native S3 support for all new and existing Commvault data protection use cases. Using Commvault’s new and enhanced cloud storage library and SwiftStack’s 1space functionality, SwiftStack can now extend on-premises private storage into both Amazon Web Services and Google Cloud Platform for long-term offsite data protection. Commvault’s new cloud storage S3-compatible interface can also take advantage of SwiftStack’s inherent multi-region and high-availability features to protect data starting from tens of terabytes in a single data center to hundreds of petabytes across multiple geographic regions. This document provides step-by-step examples and best practices for configuring the Commvault S3 interface and SwiftStack for use together. Questions can be directed to SwiftStack at https://www.swiftstack.com/contact-us.
106 of 106