> Documentation > End User Access > Command Center > Applications > Salesforce > Configuration

Creating Salesforce Instances

Create a Salesforce instance for each Salesforce organization.

Before You Begin

  • Verify that you have your consumer key and your consumer secret.

  • If your account logs on through the API, then verify that you have the Salesforce API token. Salesforce sends this token the first time that you sign in.

    For additional information about Salesforce tokens, go to the Salesforce help site, Reset Your Security Token.

  • If you want to back up Salesforce objects in a database or use certain features, review the list of features and the requirements for the Microsoft SQL server database or the PostgreSQL database, and then verify that you have the following database information:

    • The type of database

    • The client that hosts the database. The access node is able to connect to the database instance using JDBC URL.

    • The database name

    • The credentials for a user who meets the following criteria:

      • Microsoft SQL server: Is a SQL authentication user, has owner permissions, and if the database does not exist, has the dbcreator role

      • PostgreSQL: Has super user permissions

  • Decide if you want to connect to Salesforce with OAuth or with a user name and password. To connect using OAuth, you must upgrade to the latest Commvault feature release. If you connect with OAuth, you will provide the Salesforce consumer key and the Salesforce consumer secret, and then log on to Salesforce. If your Salesforce org is configured to use SSO as the user login method, and SSO is the only method used, you must use OAuth authentication.

  • If you want to connect to Salesforce by using a mutual authentication certificate, review the information in Connecting to Salesforce Using Mutual Authentication.

Procedure

  1. From the navigation pane, go to Protect > Applications > Cloud apps > Salesforce.

    The Apps page appears.

  2. In the Name column, click the app.

    The app details page appears.

  3. Click Add instance.

    The Add Salesforce instance page appears.

  4. On the General tab, enter the client details:

    1. In the App name box, type the name that you want to use to identify the specific Salesforce organization.

    2. In the Instance name box, type the name that you want to use to identify the Salesforce database.

    3. From the Access node list, select the server where you installed the Cloud Apps package.

      The access node connects to Salesforce and performs API calls.

    4. From the Storage Policy list, select the storage policy that you want to use for backups.

    5. In the Number of Data Backup Streams box, type the number of streams that you want to use for backups.

  5. Click Next.

  6. On the Connection details tab, enter the information on how you connect to Salesforce:

    1. In the Salesforce login URL box, type the URL that you use to connect to Salesforce.

    2. In the User Name box and Password boxes, type the user credentials that you use to connect to Salesforce.

    3. In the API Token box, type the token that you use to connect to Salesforce.

    4. In the Consumer Key box, type the Salesforce consumer key.

    5. In the Consumer Secret box, type the Salesforce consumer secret.

    6. Optional: In the Mutual auth certificate box, enter the path to the PEM file.

  7. Click Next.

  8. On the Backup options tab, specify the backup location:

    1. In the Download cache path box, type the full path for the staging location that the Commvault uses when it backs up the data.

      Note

      The software uses this value as the default for all subclients that you create for this virtual client.

    2. Best Practice: To back up Salesforce objects in a database, select the Sync To Database check box, and then provide the following information:

      • From the Database Type list, select the database type.

      • From the Database Host list, select the client that hosts the database.

      • From the Database Name list, select the database name.

      • In the Database Port box, type the port that you use to connect to the database.

      • In the User Name and Password boxes, type the credentials for a user who has permissions for the database.

        Note

        If you use Microsoft SQL Server, the user must be a SQL authentication user.

  9. Click Save.

Result

The Commvault software creates the instance and a default backup set and subclient for the instance.

Loading...