# Installing CockroachDB Package on Cluster Nodes

You can install the CockroachDB package on your cluster nodes.

For information about supported OS types, see system requirements.

Note

For CockroachDB, on nodes that already have an existing Commvault instance, push installation is not supported; for interactive installation see required configuration.

## Before You Begin

- You need the following information:

  - Host name

  - User name and password

  - OS type

- Make sure that you have a valid database subscription.

## Procedure

1. From the Command Center navigation pane, go to Explore > Service catalog.

2. On the Welcome page, in the Big Data tile, click Configure.

3. On the Configure big data app page, select CockroachDB, and then click Next.

4. On the Configure CockroachDB cluster page, you can install the CockroachDB package on your cluster nodes using the following two methods:

   Interactive Installation

   1. Select Interactive Installation.

   2. If you want to use select a Backup gateway, do the following:

      1. Move the Select backup gateway toggle key to right.

      2. From the Backup gateway list, either select an existing backup gateway or add a new one. To add a new backup gateway, do the following:

         1. Click +.

         2. On the Add a new backup gateway dialog box, follow the instruction to add the backup gateway.

   3. Follow the onscreen instructions to download and install CockroachDB package.

   4. From the CockroachDB access node list, select the newly installed access node.

   5. Click Next.

   Push Installation

   1. Select Push Installation.

   2. Click Add to add the CockroachDB servers.

   3. On the Perform remote install on node dialog box, inter the following details:

      1. In the Host name box, enter the host name of the CockroachDB node.

      2. If you do not use the Use saved credentials toggle key, enter the details in the following boxes: User name, Password and Confirm password.

      3. If you move the Use saved credentials toggle to right, either select a saved credential from Credential list or add a new credential. To add a new credential, do the following:

         1. Click +.

            The Add Credential dialog box appears.

         2. In the Account type list, select an account.

         3. In the Credential vault list, select the credential vault.

         4. In the credential name box, enter the name of the credential.

         5. In the User account box, enter the user account.

         6. If you move the Use SSH key toggle key to right, select a SSH key path.

         7. In the Password box, enter the password.

         8. In the Description box, enter a description of the credential.

         9. Click Save.

      4. In the SSH port number box, enter the port number.

      5. If you move the Use SSH key toggle key to right, select a SSH key path.

      6. In the Installation location box, enter the location for the install.

      7. Click Install.

   4. From the CockroachDB gateway node list, select the newly installed access node.

   5. Click Next.

5. On the Plan page, select a plan, and then click Next.

6. On the Add CockroachDB cluster page, enter the following details:

   1. In the Cluster name box, enter a name of the cluster.

   2. In Host box, enter the name of the Load balancer (LB) or any CockroachDB host.

   3. In Port number box, enter the port number used for CockroachDB connection.

   4. Under Database authentication section, from the Database credential name list, select a credential or add a new credential. To add a new credential, do the following:

      Steps to Add a Database Credential

      1. Click +.

         The Add Credential dialog box appears.

      2. In the Credential vault box, select a credential vault to store, share, and update account credentials with shared resources in your environment.

      3. In the Credential name box, enter the credential name of the database user.

      4. In the Username box, enter the user name of the database user account.

      5. In the Password box, enter the password of the database user.

      6. In the Description box, enter a description of the credential.

      7. Click Save.

   5. Under the S3 Authentication, enter the following details:

      1. From the Authentication list, you can select the following options:

         - Access and secret keys

         - IAM Role

      2. If you select Access and secret keys, From the Storage credential name, select an existing storage credential or add a new credential. To add a new credential, do the following:

         Steps to Add a Storage Credential

         1. Click +.

            The Add Credential dialog box appears.

         2. In the Vendor Type box, Amazon Web Services is selected by default.

         3. In the Authentication type box, the access secret keys is selected by default.

         4. From Credential Vault list, select the credential vault that you want to add.

         5. In the Credential name box, enter the name of the credential.

         6. In the Access key ID box, enter the access key ID of the cloud account.

         7. In the Secret access key box, enter the secret access key of the cloud account.

         8. Click Save.

      3. In the Service host box, enter the Amazon S3 endpoint in the format s3.amazonaws.com.

         For some cloud service providers, the Service host box is populated with the default value for that cloud service provider.

      4. In Staging path box, enter the full path of the staging location to be used for backups.

   6. From the CockroachDB SSL credential list, select an existing SSL credential or add a new credential. To add a new credential, do the following:

      Steps to Add a SSL Credential

      1. Click +.

         The Add Credential dialog box appears.

      2. In the Credential name box, enter the name of the credential.

      3. In the CA Certificate path box, enter the path of the Certificate Authority (CA) file that will be used with the CockroachDB commands.

      4. In the Client certificate path box, enter the path of the client certificate file.

      5. In the Client private key path box, enter the path of private key file name.

         Note

         If SSL is enabled on cluster node, the user needs to consider the following scenarios:

         - Defining SSL CA Certificate path is mandatory.

         - The user can define SSL CA Certificate path and skip defining Client certificate path and Client private key path.

         - If the user defines either Client certificate path or Client private key path, then it is mandatory to define both the paths.

      6. Click Next.

7. On the Summary page, a validation message is displayed indicating the successful configuration of CockroachDB.

8. Click Finish.

×

Loading...