Cloudera Docs

Installing Atlas using Add Service

You can install Atlas service in your Cloudera Manager instance by using the Add Service method.

  1. From Cloudera Manager > select Add Service menu option.
  2. On the Add Service page, Select Atlas and click Continue. You will be navigated to a new listing page that prompts you to follow the next set of instructions.
  3. On the Atlas: Select Backend page, select the database backend to use for Atlas metadata storage.

    Make sure that there are no additional dependencies required on your Cloudera Manager cluster.

  4. On the Select Dependencies page, review the required services.

    Ensure that no additional dependencies are required on your Cloudera Manager cluster. The required dependencies vary based on the backend you selected.

    • If you selected HBASE, the HBase service is required.
      Figure 1. HBase dependencies
    • If you selected POSTGRESQL (RDBMS), the HBase service is not required.
      Figure 2. No HBase dependencies
  5. Select Continue.
    You must assign roles and also make sure you do not assign additional roles that can impact the overall performance.
  6. If you selected the PostgreSQL backend, the Setup Database page is displayed. Enter the PostgreSQL connection details.

    You can also click Test Connection to validate the credentials and SSL/TLS connectivity before proceeding.

    Table 1. PostgreSQL database setup fields
    Field name Description
    Database Hostname The host name of the PostgreSQL database server. If a non-default port is assigned, use the host:port notation.
    Database Name The name of the Atlas database. The default value is atlas.
    Username The Atlas database user name. The default value is atlas.
    Password The Atlas database user password.
    Figure 3. Setup Database page
  7. Optional: To enforce SSL/TLS for the PostgreSQL connection, enable the JDBC URL override and append the SSL parameters.
    1. Select Yes from the Use JDBC URL Override drop-down list.
    2. In the JDBC URL field, enter the connection string in the following format: 
      jdbc:postgresql://<DB-HOST>:<DB-PORT>/<ATLAS-DB>?sslmode=verify-full&sslrootcert=<path-to-database-server-certificate>
  8. Review the changes and ensure that the following fields (depending on the installation type that you have chosen) are marked as checked. For more information, review the Atlas installation prerequisite section.
    • (Optional) Enable Kerberos Authentication - Atlas (Service-Wide)
    • (Optional) Enable File Authentication - Atlas Service Default Group

    You must add the Admin Password as applicable.

  9. Review the Command Details and make sure that the installation proceeds on the expected lines.
  10. Click Continue.
    When using a fresh Cloudera Manager cluster, collections are created directly.

    Summarise the installation process to confirm that Atlas service is installed and configured on your Cloudera Manager cluster.

  11. Once the installation is complete, to bring up Atlas on your Cloudera Manager cluster, restart the Atlas service.
  12. Once Atlas is installed, you must restart stale configurations.