Getting Started in Altus
Cloudera offers a free trial account to help you get familiar with Altus and find out how Altus makes it easy for you to build and run your data workloads in the cloud. The Altus trial account is a single user account. At the end of the free trial, you can convert your trial account into a paid subscription.
You can also contact Cloudera directly and set up a paid Altus subscription. You can set up multiple user accounts in an Altus subscription.
An Altus trial account follows a different account setup process than an Altus subscription.
Getting Started with a Trial Account
You can create a free trial account to try out Cloudera Altus and explore how you could quickly provision clusters and run your workloads in the cloud. The Altus trial account gives a single user 30 days of access to all Altus services that are generally available. With a trial account, you can also request access to Altus services that are in Beta release.
A free trial account limits you to one cluster. When your trial account expires, Altus automatically terminates the cluster. Before your trial account expires, contact Cloudera Sales if you wish to continue using Altus after the trial period ends. Find out how you can continue using the cluster and running the workloads that you have created.
Before you can start using Altus, you must have an AWS account or Azure subscription in which to create your Altus clusters. You must also be familiar with AWS or Azure and able to create and configure the resources required for Altus clusters and jobs.
For help with using Altus, join the Cloudera Altus community and get answers to your Altus questions.
- Go to the Cloudera Altus page and click Free Trial.
Create a Cloudera account for your Altus trial.
- On the Account Registration page, enter your email address and name and click Submit.
Cloudera sends you an email with a link to activate your Cloudera account.
- Click the activation link to complete the registration.
Set up the password and security questions for your Cloudera account.
- On the Cloudera Web Applications page, click the tile for Cloudera Altus Trial.
- On the Altus Trial Access page, fill out the Altus registration form and click Submit.
- Accept the Altus agreement for trial products and services.
By default, your Altus trial user account is designated the Altus account administrator. As an administrator, you have the permissions to create and manage clusters and jobs in your account and generate access keys for the Altus CLI.
For more information about the Altus account administrator user account, see Altus Account Administrator.
- On the Altus console, start by creating an Altus environment.
In the Altus environment, you specify the resources in your AWS account or Azure subscription that you want to use for the clusters and jobs you run on Altus.
For clusters on AWS, use the Quickstart to allow Altus to quickly and easily set up an Altus environment with a default resource configuration using your AWS credentials. For more information about using the Quickstart to set up an Altus environment, see Creating the Altus Environment with the Quickstart. If you are familiar with how to create AWS resources, you can use the Wizard to create the Altus environment. You must log in to AWS with your AWS credentials to create the resources and then specify the resources in the Altus environment. For more information about using the Wizard to set up an Altus environment, see Creating the Altus Environment with the Wizard.
For clusters on Azure, use the Wizard to create the Altus environment. Altus provides an Azure Resource Manager (ARM) template for creating the resources in your Azure subscription required for Altus clusters and jobs. Use the template to create the resources in Azure and then specify the resources in the Altus environment. For more information about using the Wizard to set up an Altus environment, see Setting up the Altus Environment for Azure.
- After you set up an environment, you can submit a job and create a cluster on which to run the job.
For more information about submitting a job, see Altus Data Engineering Jobs.
- If you want to use the Altus CLI, you can download and install the Altus client.
You can create clusters, run jobs, and perform most tasks on the console. If you want to use the Altus CLI to perform the tasks from the command line, install the Altus client. For more information about installing the Altus client, see Altus Client Setup.
Getting Started with a Subscription
If you have a subscription to Altus, you must have one person designated as the Altus account administrator. The Altus account administrator sets up accounts for other Altus users.
The Altus account administrator follows a different onboarding process than other Altus users.
Altus Account Administrator
You can use the Cloudera Altus console to set up access and authorization for users in your organization. You also use it to set up an Altus environment and establish the cloud provider account resources that Altus users can access.
- Verify that the following have been set up with Cloudera:
- A subscription to Altus.
- A Cloudera user account assigned to you that is designated as an Altus account administrator.
You use your Cloudera user account to log in to the Altus console. As an Altus account administrator, you have privileges to create an Altus environment and set up user authorization.
- Set up your cloud provider account resources to meet requirements for Altus.
- Verify that the AWS account has resources that meet Altus requirements. For more information about the AWS resources required for Altus see AWS Account Requirements .
- Ensure that you have access to an AWS user account with the permissions required to create policies and roles in AWS. For more information about the AWS privileges required for an Altus administrator, see AWS Permissions .
- Verify that the Azure subscription has resources that meet Altus requirements. For more information about the Azure resources required for Altus see Azure Subscription Requirements .
- Ensure that you have access to an Azure user account with the permissions required to create and manage resources and resource policies in Azure. For more information about the Azure privileges required for an Altus administrator, see Azure Permissions.
- Set up an Altus environment for your organization.
An Altus environment describes the resources in your cloud provider account available to Altus users for clusters and jobs. You must set up at least one Altus environment for users in your organization.
You can create as many Altus environments as you require. If users must access different resources in a shared cloud provider account, you can set up an Altus environment for each set of resources. You can then assign the Altus environments to different users so that they can access only the resources you allow them to use.
You can also create multiple Altus environments to describe the same set of resources. However, having multiple Altus environments for the same set of resources can be inefficient and confusing. Cloudera recommends that you create an Altus environment for a unique set of cloud resources.
For more information about setting up an Altus environment for an AWS account, see Environment Setup for AWS.
For more information about setting up an Altus environment for an Azure subscription, see Environment Setup for Azure.
- Set up user access and authorization in Altus.
Assign roles and provide access to an Altus environment to all Altus users in your organization. The role and environment that you assign to a user determines the areas of the Cloudera Altus console that the user can access and the commands that the user can run using the Altus client.
When you set up a user account in Altus, you must assign the user at least one role and one environment. Otherwise, the user cannot perform any task in Altus.
For more information about setting up access and authorization for Altus users, see Setting Up User Access and Authorization.
You need a Cloudera user account to access Cloudera Altus. The account administrator for your Altus account must assign a role and Altus environment to you before you can create clusters and run jobs in Altus.
- Create an account with Cloudera.
If you do not yet have a Cloudera account, go to the Cloudera Account Registration page and create an account.
You need a Cloudera account to sign in to Altus.
- Sign in to the Altus console.
The first time you sign in to Altus, Altus verifies your Cloudera user account and creates an Altus user account for you. Initially, you do not have privileges to perform tasks in Altus. An Altus administrator must assign privileges to your user account before you can use Altus.
- Contact the Altus account administrator to request authorization to use Altus and access to an Altus environment.
The administrator creates an Altus environment that determines where you can create clusters and run jobs and what resources you can use. To use Altus, you must have access to an Altus environment.
The Altus administrator assigns privileges to your user account based on the tasks you need to perform. When you log in to the Cloudera Altus console, you can view only the areas to which the administrator has given you access. When you use the Altus client, you can run only the commands for which you have permission. You can access only the resources included in the Altus environment that the administrator has assigned to you.
- Download and configure the Altus client.
You can use the Altus console to perform create clusters and run jobs. You can also use the Altus command-line interface. For example, you might want to use the command line to automate the process of creating a cluster and submitting a job to run on the cluster.
Altus provides the command-line interface through a Python client. To use the command-line interface, download the client and configure it with an access key. The access key identifies you when you run commands. For more information about installing and configuring the Altus client, see Altus Client Setup.
In addition to the Altus client, you could also use the Cloudera Altus SDK for Java to access the Altus Data Engineering service through the Altus API. For more information, see Using the Altus SDK for Java.
You can view the user profile for your Cloudera account from the Altus console. Your user profile page in my.cloudera.com displays your profile information, the Cloudera applications you have access to, and the support cases you have opened.
You can modify some information in your profile. You can update your personal information, location information, and job information. You can also open support cases for issues you encounter in the apps. Click Create New Case to create a new case.
To view your user profile:
- Click your login user name in the top right hand corner of the page.
- Click My Account. Your user account page appears.
- Click View Profile to view your User Profile. Your Profile Information on my.cloudera.com will appear in a new tab.