Configure Commvault for Oracle Cloud VMware Solution

Once you've installed Commvault, the configuration tasks required to use it include adding necessary hypervisors to manage Oracle Cloud VMware Solution and, optionally, to protect native Oracle Cloud Infrastructure instances and, as necessary, attach Oracle Cloud Infrastructure block stortage, file storage, and object storage as backup repositories.

Generate an API Signing Key on Windows

You must supply an RSA key pair in Privacy Enhanced Mail (PEM) format to authenticate with Oracle Cloud Infrastructure. You can generate this key pair using OpenSSL in Git Bash. This step assumes you have already installed Git Bash on your local system.

The installation process will create a folder in your filesystem called commvault_install/Base/certificates/ (where commvault_install is the base Commvault installation folder).

1. Start Git Bash.
2. Generate a private key encrypted with a passphrase that you provide by entering:

   $ openssl genrsa -out commvault_install/Base/certificates/private-key-file-name.pem -aes128 2048

   where private-key-file-name is a name of your choice for the private key file (for example, john_api_key_private.pem). For example:

   $ openssl genrsa -out commvault_install/Base/certificates/john_api_key_private.pem -aes128 2048 
   Generating RSA private key, 2048 bit long modulus ....
   +++ ....................................................................+++ 
   e is 65537 (0x10001)

3. When prompted, enter a passphrase to encrypt the private key file. Be sure to make a note of the passphrase you enter, as you will need it later.
4. When prompted, re-enter the passphrase to confirm it.
5. Confirm that the private key file has been created in the directory you specified. For example, by entering:

   $ ls -l commvault_install/Base/certificates/john_api_key_private.pem
   					
   -rw-r--r-- 1 johndoe staff 1766 Jul 14 00:24 commvault_install/Base/certificates/john_api_key_private.pem

6. Change permissions on the file to ensure that only you can read it. For example, enter:

   $ chmod go-rwx commvault_install/Base/certificates/john_api_key_private.pem

7. Generate a public key (in the same location as the private key file) by entering:

   $ openssl rsa -pubout -in commvault_install/Base/certificates/private-key-file-name.pem -out commvault_install/Base/certificates/public-key-file-name.pem 

   where:

   • private-key-file-name is what you specified earlier as the name of the private key file (for example, john_api_key_private.pem)
   • public-key-file-name is a name of your choice for the public key file (for example, john_api_key_public.pem) For example:

   $ openssl rsa -pubout -in commvault_install/Base/certificates/john_api_key_private.pem -out commvault_install/Base/certificates/john_api_key_public.pem
   Enter pass phrase for commvault_installjohn_api_key_private.pem:

8. When prompted, enter the same passphrase you previously entered to encrypt the private key file.
9. Confirm that the public key file has been created in the directory you specified. For example, by entering:

   $ ls -l commvault_install/Base/certificates/
   
   -rw------- 1 johndoe staff 1766 Jul 14 00:24 john_api_key_private.pem
   -rw-r--r-- 1 johndoe staff 451 Jul 14 00:55 john_api_key_public.pem

10. Copy the contents of the public key file you just created. For example, by entering:

    $ cat commvault_install/Base/certificates/john_api_key_public.pem | pbcopy

11. Having created the API key pair, upload the public key value to Oracle Cloud Infrastructure:
    1. Log in to the Console as the Oracle Cloud Infrastructure user who will be using Oracle Functions to create and deploy functions.
    2. In the top-right corner of the Console, open the Profile menu (User menu icon) and then click User Settings to view the details.
    3. On the API Keys page, click Add Public Key.
    4. Paste the public key's value into the window and click Add.
       The key is uploaded and its fingerprint is displayed (for example, d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:13).

       Note:

       Since you'll use the fingerprint in a subsequent configuration task, it's a good idea to copy it to a convenient and secure location so you can retrieve it later.

Add Hypervisors

To manage Oracle Cloud VMware Solution and, optionally, to protect native Oracle Cloud Infrastructure instances, with Commvault, you need to add them as hypervisors.

Add the Oracle Cloud VMware Solution SDDC as a Hypervisor

Adding the Oracle Cloud VMware Solution SDDC as a hypervisor allows you to manage it with Commvault.

To run this procedure, first, log in to the Commvault Command Center with the credentials you created when installing the product. Then:

1. Select Protect then Virtualization and then Hypervisors and click Add hypervisor.
2. On the Hypervisor dialog box, specify the necessary details:

   For this field	Do this
   Select vendor	Select VMWare vCenter from the dropdown list.
   vCenter server name	Enter the fully-qualified domain name for the vCenter server.
   Hypervisor display name	Enter a name by which you want to identify the hypervisor.
   Enter credentials	Select this option.
   User name	Enter the vCenter administrator username.
   Password	Enter the password associated with the vCenter administrator username.
   Access nodes	Leave the default value, which should be the client name you submitted during Commvault installation.

3. Click Save.
   The new hypervisor will appear, identified by the designated vCenter server name, on the Hypervisors page.

   Note:

   If the new hypervisor doesn't appear after clicking Save, refresh your page.

Add Oracle Cloud Infrastructure as a Hypervisor (Optional)

If you want to manage both Oracle Cloud Infrastructure and Oracle Cloud VMware Solution from a single pane of glass, you need to also add Oracle Cloud Infrastructure as a hypervisor. Commvault can then backup and recover instances in Oracle Cloud Infrastructure. Note that this is an optional configuration and is not necessary to deploy Commvault.

Note:

Before you begin, create a subfolder called external in //Commvault_intallation/ContentStore/Base/certificates/ and copy the private PEM key you created for this exercise into it; for example, //Commvault_intallation/ContentStore/Base/certificates/external/MyPEMkey.pem.

1. With the Commvault Command Center open, select Protect then Virtualization and then Hypervisors and click Add hypervisor.
2. On the Hypervisor dialog box, specify the necessary details:

   For this field	Do this
   Select vendor	Open the dropdown and select Oracle Cloud Infrastructure. This will cause the dialog box to reformat to accept vendor-specific data.
   Hypervisor name	Enter a unique name for this hypervisor.
   Tenacy OCID	Enter the Oracle Cloud Identifier (OCID) for your tenancy. You can find this value on the Tenancy tab your Oracle Cloud Infrastructure user Tenancy Details page.
   User OCID	Enter your unique user OCID. You can find this value on the User Information tab your Oracle Cloud Infrastructure User Details page.
   Finger print	Enter the Fingerprint for the public key you created for this process. You can find this value listed under API Keys on the User Information tab of your Oracle Cloud Infrastructure User Details page.
   Private key filename	Enter the private PEM key filename. This is the same file you copied into //Commvault_intallation/ContentStore/Base/certificates/external at the outset of this procedure.
   Private key password	Enter the password associated with the private PEM key.
   Home region name	Enter or select from the dropdown list the region identifier for your region; for example, ap-mumbai-1. Note: If you don't know the name of your region or it doesn't appear on the dropdown list, see "Regions and Availability Domains", listed in the "Before You Begin" topic of this playbook. You can then manually add the name to the list.
   Access node	Leave the default value, which should be the folder you created during Commvault installation.

3. Click Save.
   The new hypervisor will appear, identified by the Hypervisor name, on the Hypervisors page.

   Note:

   If the new hypervisor doesn't appear after clicking Save, refresh your page.

Configure Storage Targets

Commvault lets you attach Oracle Cloud Infrastructure block stortage, file storage, and object storage as backup repositories. This provides you with more economical options than Oracle Cloud VMware Solution's vSAN datastore, while ensuring a durable, scalable, and secure network file system.

If you chose to use the Oracle Cloud Infrastructure storage option, this section describes how to deploy a file system and add it as a backup repository.

Create Block Storage

First, create a block volume in Oracle Cloud Infrastructure to the Commvault Server.

Before you begin, ensure you've attached a block volume as paravirtualized to the compute instance on which Commvault is installed. Then in that compute instance, run a disk scan for the newly attach block volume, format the volume, and assign it a drive letter (for example, D://).

With a block volume attached, go to the Commvault Command Center and add the disk as a storage target:

1. Select Storage then Disk. Then click Add Disk.
2. On the Add Disk dialog box, enter a Name for the block storage volume and click Add.
3. Select the MediaAgent, in this case, Commvault-Serve and Local as the storage Type, then click the browse icon.
   The Select Backup Location dialog box appears, showing a list of local drives.
4. Browse the dropdown list and select to the new drive you created earlier. On this drive, create a new folder to use as the backup location. Then click Save.
5. On the Add Disk dialog box, ensure Use deduplication is selected (this should be the default). This will ensure a faster backup process.
6. Click the Deduplication DB location browse control to open the Select a deduplication DB location dialog box.
7. Click the dropdown control for drive to which you assigned block storage and select the Dedupe Storage folder (you can create a Dedupe folder if one doesn't exist). Then click Save.

You will see the names of the respective storage locations on the list of disks.

Create Resources in File Storage

We recommend creating a separate private subnet to deploy File Storage (file systems and mount targets).

Follow these steps to create a file system and mount target:

1. In the Oracle Cloud Infrastructure Console, navigate to the VCN in which you want to deploy File Storage.
2. Create an empty security list (for example, FSS-SL) and an empty route table (for example, FSS-RT).
   • For the security list, add ingress rules for the VCN CIDR to TCP ports 111, 2048, 2049, and 2050 and UDP ports 111 and 2048.
   • You can leave the route table empty because we’re planning to use the file system inside the same VCN.
3. Create a new private subnet with the appropriate CIDR block and select the security list and route table from step 2.
4. In the Console navigation menu, select File Storage and then select File Systems.
5. Click Create File System and complete the details as described in the following steps.
6. In the File System Information section, click Edit Details to make appropriate changes.
   • Name: Provide a name or choose the default.
   • Availability Domain: Select the same availability domain as your Oracle Cloud VMware Solution cluster.
7. In the Export Information section, edit the Export Path value as required. This value must be unique for each file system in the mount target.
8. Edit the values under Mount Target Information to select the appropriate VCN and File Storage subnet.
9. Click Create. The File Storage service typically creates the file system and mount target within seconds. When completed, you have a mount target with an export path.
10. Select the export path to see the mount commands.

Attach Oracle Cloud Infrastructure File Storage

If you want a more economical means of file storage than Oracle Cloud VMware Solution's vSAN datastore, you can attach an Oracle Cloud Infrastructure volume as file storage.

1. Select Storage then then Disk, then click Add Disk.
2. On the Add Disk dialog box, enter a Name for the file storage volume and click Add.
3. On the Add storage dialog box, select the MediaAgent and then for Type, select as Network.
4. For Credentials, do one of the following:
   • If you have Oracle Cloud Infrastructure credentails saved, chose the credential Name from the dropdown.
   • If you don't have Oracle Cloud Infrastructure credentials saved:
     1. Click the plus sign (+) next to the Name field.
     2. Enter a Name for your credential pair and then enter your Oracle Cloud Infrastructure User name and Password and click Save.
5. In Backup location, enter the file system storage path.
   The file system storage path is the mount target you created when you set up your Oracle Cloud Infrastructure file system. You can find this path by clicking Mount Commands on the Export Details page for your mount target. This will open the Mount Command dialog box. Select just the IP address and pathname—for example, ip_address:/CommVaultFSStorage) under COMMAND TO MOUNT THE FILE SYSTEM and use this as your backup location.

   Note:

   Since Oracle Cloud Infrastructure provides this data in Linux format, you will need to change the path to Windows format (that is, change the slashes—/—to back-slashes—\).
6. Enable Use depulication and click the Deduplication DB location browse control. Then, on the Select a deduplication DB location dialog box, select the folder you created earlier for file system storage deduplication and click Save.
7. Click Save again to save the storage disks. They will appear as Storage targets on the Add disk list.
8. Click Save to commit the disks.

Attach Oracle Cloud Infrastructure Object Storage

Next, add Oracle Cloud Infrastructure object storage to provide economical storage capacity for low tier or archival storage.

While you can add either the standard bucket or archive storage bucket, in this exercise you will just add a standard object storage bucket.

Note:

Before you begin, go to your filesystem and copy the private PEM key you created for this exercise into //Commvault_intallation/ContentStore/Base/certificates/.

1. From the Commvault Command Center, select Storage then Cloud and then click Add.
2. On the Add storage dialog box, enter a name for your storage and then Click the dropdown control and select Oracle Cloud Infrastructure object storage. The form expands to add these additional fields. Complete them as described here:

   For this field	Do this
   Media Agent	This should already have defaulted to commvault-serve.
   Service host	This field shows the default object storage bucket, with the default region of us-phoenix-1. If your bucket is deployed in a different region, replace us-phoenix-1 with the correct region name; for example, ap-mumbai-1.
   Tennacy OCID	Enter the Oracle Cloud Identifier (OCID) for your tenancy. You can find this value on the Tenancy tab your Oracle Cloud Infrastructure user Tenancy Details page.
   User OCID	Enter your unique user OCID. You can find this value on the User Information tab your Oracle Cloud Infrastructure User Details page.
   Key's fingerprint	Enter the Fingerprint for the public key you created for this process. You can find this value listed under API Keys on the User Information tab of your Oracle Cloud Infrastructure User Details page.
   Compartment Name	Enter the compartment name. You can find this name on the Oracle Cloud Infrastructure Compartments page. In elOracle Cloud Infrastructure, select Identity then Compartments to display this list.
   Pem key filename	Enter the private PEM key filename. This is the same file you copied into //Commvault_intallation/ContentStore/Base/certificates/ at the outset of this procedure.
   Private key's password	Enter the password associated with the private PEM key.
   Bucket name	Enter the bucket name. You can find this value on the Oracle Cloud Infrastructure Object Storage/Bucket Details page.
   Access node	Leave the default value, which should be commvault-serve.

3. On the Add cloud dialog box, ensure Use deduplication is selected (this should be the default). This will ensure a faster backup process.
4. Click the Deduplication DB location browse control to open the Select a deduplication DB location dialog box.
5. Click the dropdown control for the D: drive and select the Dedupe Storage folder (which you should have created as a prerequisite to running this procedure).
6. Click Save to finish attaching object storage.