Adding a configuration profile

Add a configuration profile that defines the configuration for DataStax Enterprise clusters. The config profile informs Lifecycle Manager which supported version of DataStax Enterprise to install, configure, and manage.

Add a configuration profile that defines the configuration for DataStax Enterprise clusters. The config profile informs Lifecycle Manager which supported version of DataStax Enterprise to install, configure, and manage.

When you manually upgrade the version of DataStax Enterprise installed on a cluster, you must add a new Config Profile that reflects the actual version of DSE installed and update your clusters, datacenters, and nodes to use the new profile where appropriate. To prevent any potential loss of settings between different versions, the DSE version cannot be edited after saving the Config Profile. Cloning a config profile allows changing the DSE version of a config profile and facilitates upgrades with notifications of any setting changes.

LCM jobs fail if the installed DSE version does not match the version specified in the Config Profile associated with a cluster, datacenter, or node. Install jobs also fail if the operating system is not supported by the DSE version. Automated DSE upgrades to major versions are not supported in Lifecycle Manager at this time. Automated DSE upgrades to minor versions within a release series are supported in Lifecycle Manager for versions 6.5 and later. Downgrades of DSE are not supported at this time.

Note: The data (cluster topology models, configuration profiles, credentials, repositories, job history, and so forth) for Lifecycle Manager is stored in the lcm.db database. Your organization is responsible for backing up the lcm.db database. You must also configure failover to mirror the lcm.db.


  1. From the Lifecycle Manager navigation menu, click Config Profiles > Add Config Profile.
    The Config Profiles page appears.

  2. Required: Enter a Name for the config profile. The name of the config profile displays on the main Config Profiles page where you can edit or delete the profile, and within the Config Profile lists of the Add/Edit Cluster, Datacenter, and Node dialogs when associating the config profile with a cluster, datacenter, or node in the Clusters workspace.
  3. Required: Select the supported version of DataStax Enterprise to associate with the config profile.
    Note: The DSE Version cannot be edited after saving the Config Profile. If you manually upgrade DSE (externally from LCM; only recommended for upgrading to a major release version), you must add a Config Profile with the new DSE version. Apply the Config Profile where appropriate to a cluster, datacenter, or node.
    Tip: If the OpsCenter machine does not have an internet connection, you can manually update the definitions to access the most currently supported versions of DSE.
    The Config Profile pane populates with the config files and their corresponding options for the selected DSE version.
  4. Optional: Enter a comment about the config profile. For example: DSE 6 Graph.
  5. Optional: If there are any configuration files for which you want to override the default values, select the configuration file in the Config Profile pane to access its configuration options. A subset of the configuration options are available for overriding defaults for each configuration file. If you click save without overriding any defaults or customizing settings, the config profile is created with standard and sensible default settings. You can continue to edit the config profile file and run a configuration job at any time.
  6. Note: If at any time you navigate away from the Config Profiles workspace after making changes, you are prompted to confirm leaving the page. Click OK to discard your changes and leave the Config Profiles workspace, or click Cancel to retain any changes and remain in the Config Profiles page.
    When you are done with the configuration profile changes, click Save.
    If there are any validation errors, error messages appear that indicate any issue with a setting.

    Prompts to correct validation errors in LCM Config Profiles

  7. Click on an error message. The file that has an error highlights in red the setting in error. Correct each error and save the config profile.
    The newly added configuration profile is listed on the Configuration Profiles page. An edit, clone, and delete option are available for each config profile.

What's next

  • Continue customizing the sections of the config profile as appropriate for clusters, datacenters, or nodes.
  • Configure Java setup for automatically installing and managing Java installs and upgrades, and for installing and managing the JCE Policy files (recommended).
  • Configure a package proxy to cache and accelerate package downloads (recommended), isolate DataStax Enterprise clusters offline from the internet, or both.
  • Select the newly added Config Profile and assign it to the appropriate cluster, datacenter, or node in the Clusters Workspace. Edit the cluster, datacenter, or node and select the Config Profile.
  • Run a configuration job to propagate the configuration profile to its targets.