Altus Data Warehouse Clusters in the CLI

You can use the Cloudera Altus client to create an Altus Data Warehouse cluster, view the properties of a cluster, or terminate a cluster. You can use the commands listed here as examples for how to use the Cloudera Altus commands to work with Altus Data Warehouse clusters.

For more information about the Altus Data Warehouse commands available in the Altus client , run the following command:
altus dataware help 

Creating a Cluster for AWS

You can use the following command to create a cluster:

altus dataware create-aws-cluster \
--cluster-name=ClusterName \
--cdh-version=CDHVersion \
--public-key=FullPath&FileNameOfPUBfile \
--instance-type=InstanceType \
--environment-name=AltusEnvironmentName \
--workers-group-size=NumberofWorkerNodes
Guidelines for using the create-aws-cluster command:
  • The public-key parameter requires the full path and file name of a .pub file prefixed with file://. For example: --public-key=file:///my/file/path/to/ssh/publickey.pub.
  • You must specify the version of CDH to include in the cluster.

    The Altus Data Warehouse service supports CDH 5.15 or CDH 6.1 with Impala 2.12. Set the cdh-version parameter to CDH515 or CDH61.

  • The CDH version that you specify affects the SDX namespace you can use with the cluster:
    CDH 6.1
    You can use a CDH 6.1 cluster only with a configured SDX namespace that points to version 6.1 of the Hive metastore and Sentry databases.
    CDH 5.x
    You can use a CDH 5.x cluster only with a configured SDX namespace that points to version 5.x of the Hive metastore and Sentry databases.
  • You can use the --cloudera-manager-username and --cloudera-manager-password parameters to specify the user name and password for a read-only account for the Cloudera Manager instance in the cluster. If you do not specify the Cloudera Manager user credentials, Altus sets the user name to guest and generates a password for the account.
  • The response object for the create-aws-cluster command contains the credentials for the read-only Cloudera Manager user account. You must note down the credentials from this response since the credentials are not made available again.

Creating a Cluster for Azure

You can use the following command to create a cluster:

altus dataware create-azure-cluster \
--cluster-name=ClusterName \
--cdh-version=CDHVersion \
--public-key=FullPath&FileNameOfPUBfile \
--instance-type=InstanceType \
--environment-name=AltusEnvironmentName \
--workers-group-size=NumberofWorkerNodes
Guidelines for using the create-azure-cluster command:
  • The public-key parameter requires the full path and file name of a .pub file prefixed with file://. For example: --public-key=file:///my/file/path/to/ssh/publickey.pub.
  • You must specify the version of CDH to include in the cluster.

    The Altus Data Warehouse service supports CDH 5.15 or CDH 6.1 with Impala 2.12. Set the cdh-version parameter to CDH515 or CDH61.

    The Altus Data Warehouse service supports CDH 5.15 or CDH 6.1 with Impala 2.12. Set the cdh-version parameter to CDH515 or CDH61.

  • The CDH version that you specify affects how you use with the cluster:
    CDH 6.1
    • You can use a CDH 6.1 cluster only with a configured SDX namespace that points to version 6.1 of the Hive metastore and Sentry databases.
    • For clusters with CDH 6.1, Altus archives logs to ADLS Gen1 or Gen2, based on the folder you specify.
    CDH 5.x
    • You can use a CDH 5.x cluster only with a configured SDX namespace that points to version 5.x of the Hive metastore and Sentry databases.
    • For clusters with CDH 5.x, Altus archives logs to ADLS Gen1.
  • You can use the --cloudera-manager-username and --cloudera-manager-password parameters to specify the user name and password for a read-only account for the Cloudera Manager instance in the cluster. If you do not specify the Cloudera Manager user credentials, Altus sets the user name to guest and generates a password for the account.
  • The response object for the create-azure-cluster command contains the credentials for the read-only Cloudera Manager user account. You must note down the credentials from this response since the credentials are not made available again.

Getting the Cluster Credentials Using the CLI

When you create an Altus Data Warehouse cluster, Altus generates a user ID and password unique to the cluster. Access to the cluster from a client tool requires the user name and password. When you set up a connection to an Altus Data Warehouse cluster in your BI tool, you must include the user name and password in the connection properties.

You can use the following command to get the user ID and password of a cluster:

altus dataware get-cluster-access-tokens \
--cluster-name=ClusterName

Viewing the Status of a Cluster

When you create a cluster, you can immediately check its status. If the cluster creation process is not yet complete, you can view information regarding the progress of cluster creation.

You can use the following command to display information about a cluster:

altus dataware describe-cluster \
--cluster-name=ClusterName

Deleting a Cluster

You can use the following command to delete a cluster:

altus dataware delete-cluster \
--cluster-name=ClusterName