---
name: AnalyticsEngine-getting-started
title: Getting started tutorial
description: ''
last-updated: 2023-02-06
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/AnalyticsEngine?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

{:new_window: target="_blank"}
{:shortdesc: .shortdesc}
{:codeblock: .codeblock}
{:screen: .screen}
{:pre: .pre}

# Getting started tutorial
{: #getting-started}

IBM Analytics Engine Serverless instance is allocated to compute and memory resources on demand when Spark workloads are deployed. When an application is not in running state, no computing resources are allocated to the IBM Analytics Engine instance. Pricing is based on the actual amount of resources consumed by the instance, billed on a per second basis.

- [Serverless instance architecture and concepts](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-serverless-architecture-concepts&format=markdown)

- [Provisioning a serverless instance](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-provisioning-serverless&format=markdown)


## Getting started using serverless IBM Analytics Engine instances
{: #getting-started}

The IBM Analytics Engine Standard Serverless plan for Apache Spark offers the ability to spin up IBM Analytics Engine serverless instances within seconds, customize them with library packages of your choice, and run your Spark workloads.

Currently, you can create IBM Analytics Engine serverless instances only in the US South region.

## Before you begin
{: #getting-started-1}

To start running Spark applications in IBM Analytics Engine, you need:

- An IBM Cloud® account.
- Instance home storage in IBM Cloud Object Storage that is referenced from the IBM Analytics Engine instance. This storage is used to store Spark History events, which are created by your applications and any custom library sets, which need to be made available to your Spark applications. 
- An IBM Analytics Engine serverless instance.

## Provision an instance and create a cluster
{: #getting-started-2}

To provision an IBM Analytics Engine instance:

1. Get a basic understanding of the architecture and key concepts. See [Serverless instance architecture and concepts](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-serverless-architecture-concepts&format=markdown).
1. [Provision a serverless instance](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-provisioning-serverless&format=markdown)

## Run applications
{: #getting-started-3}

To run Spark applications in a serverless IBM Analytics Engine instance:

1. Optionally, give users access to the provisioned instance to enable collaboration. See [Managing user access to share instances](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-grant-permissions-serverless&format=markdown).
1. Optionally, customize the instance to fit the requirements of your applications. See [Customizing the instance](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-cust-instance&format=markdown).
1. Submit your Spark application by using the Spark application REST API. See [Running Spark batch applications](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-spark-batch-serverless&format=markdown).
1. Submit your Spark application by using the Livy batch API. See [Running Spark batch applications using the Livy API](https://cloud.ibm.com/docs/analyticsengine?topic=AnalyticsEngine-livy-api-serverless&format=markdown).

## End-to-end scenario using the Analytics Engine serverless CLI
{: #getting-started-4}

To help you get started quickly and simply with provisioning an Analytics Engine instance and submitting Spark applications, you can use the Analytics Engine serverless CLI.

For an end-to-end scenario of the steps you need to take, from creating the services that are required, to submitting and managing your Spark applications by using the Analytics Engine CLI, see [Create service instances and submit applications using the CLI](https://cloud.ibm.com/docs/AnalyticsEngine?topic=AnalyticsEngine-using-cli&format=markdown).