Edit

Quickstart: Create an Azure Data Manager for Energy Preview Preview instance

  • Article
  • 4 minutes to read

Important

Microsoft Azure Data Manager for Energy Preview is currently in preview. For legal terms that apply to features that are in beta, in preview, or otherwise not yet released into general availability, see the Supplemental Terms of Use for Microsoft Azure Previews.

Azure Data Manager for Energy Preview is now available to all customers and partners during the preview period. Get started with by creating an instance of the product here.

Get started by creating an Azure Data Manager for Energy Preview instance on Azure portal on a web browser. You first register an Azure application on Active Directory and then use the application ID to create an Azure Data Manager for Energy Preview instance in your chosen Azure Subscription and region.

The setup of Azure Data Manager for Energy Preview instance can be triggered using a simple interface on Azure portal and takes about 50 minutes to complete.

Azure Data Manager for Energy Preview is a managed "Platform as a service (PaaS)" offering from Microsoft that builds on top of the OSDU™ Data Platform. Azure Data Manager for Energy Preview lets you ingest, transform, and export subsurface data by letting you connect your consuming in-house or third-party applications.

Prerequisites

Prerequisite Details
Active Azure Subscription You'll need the Azure subscription ID in which you want to install Azure Data Manager for Energy Preview. You need to have appropriate permissions to create Azure resources in this subscription.
Application ID You'll need an application ID (often referred to as "App ID" or a "client ID"). This application ID will be used for authentication to Azure Active Directory and will be associated with your Azure Data Manager for Energy Preview instance. You can create an application ID by navigating to Active directory and selecting App registrations > New registration.
Client Secret Sometimes called an application password, a client secret is a string value that your app can use in place of a certificate to identity itself. You can create a client secret by selecting Certificates & secrets > Client secrets > New client secret. Record the secret's value for use in your client application code. This secret value is never displayed again after you leave this page.

Create an Azure Data Manager for Energy Preview instance

  1. Save your Application (client) ID and client secret from Azure Active Directory to refer to them later in this quickstart.

  2. Sign in to Microsoft Azure Marketplace

    Important

    Azure Data Manager for Energy Preview is accessible on the Azure Marketplace only if you use the above Azure portal link.

  3. If you have access to multiple tenants, use the Directories + subscriptions filter in the top menu to switch to the tenant in which you want to install Azure Data Manager for Energy Preview.

  4. Use the search bar in the Azure Marketplace (not the global Azure search bar on top of the screen) to search for Azure Data Manager for Energy Preview.

    Screenshot of the search result on Azure Marketplace that shows Azure Data Manager for Energy Preview. Azure Data Manager for Energy Preview shows as a card.

  5. In the search page, select Create on the card titled "Azure Data Manager for Energy Preview(Preview)".

  6. A new window appears. Complete the Basics tab by choosing the subscription, resource group, and the region in which you want to create your instance of Azure Data Manager for Energy Preview. Enter the App ID that you created during the prerequisite steps.

    Screenshot of the basic details page after you select 'create' for Azure Data Manager for Energy Preview. This page allows you to enter both instance and data partition details.

    Some naming conventions to guide you at this step:

    Field Name Validation
    Instance name Only alphanumeric characters are allowed, and the value must be 1-15 characters long. The name is not case-sensitive. One resource group can't have two instances with the same name.
    Application ID Enter the valid Application ID that you generated and saved in the last section.
    Data Partition name Name should be 1-10 char long consisting of lowercase alphanumeric characters and hyphens. It should start with an alphanumeric character and not contain consecutive hyphens. The data partition names that you chose are automatically prefixed with your Azure Data Manager for Energy Preview instance name. This compound name will be used to refer to your data partition in application and API calls.

    Note

    Azure Data Manager for Energy Preview instance and data partition names, once created, cannot be changed later.

  7. Select Next: Tags and enter any tags that you would want to specify. If nothing, this field can be left blank.

    Tip

    Tags are metadata elements attached to resources. They're key-value pairs that help you identify resources based on settings that are relevant to your organization. If you want to track the deployment environment for your resources, add a key named Environment. To identify the resources deployed to production, give them a value of Production. Learn more.

    Screenshot of the tags tab on the create workflow. Any number of tags can be added and will show up in the list.

  8. Select Next: Review + Create.

  9. Once the basic validation tests pass (validation takes a few seconds), review the Terms and Basic Details.

    Screenshot of the review tab. It shows that data validation happens before you start deployment.

  10. This step is optional. You can download an Azure Resource Manager (ARM) template and use it for automated deployments of Azure Data Manager for Energy Preview in future. Select Download a template for automation located on the bottom-right of the screen.

    Screenshot to help locate the link to download Azure Resource Manager template for automation. It is available on the bottom right of the review + create tab.

    Screenshot of the template that opens up when you select 'download template for automation'. Options are available to download or deploy from this page.

  11. Select Create to start the deployment.

  12. Wait while the deployment happens in the background. Review the details of the instance created.

    Screenshot of the deployment completion page. Options are available to view details of the deployment.

    Screenshot of the overview of Azure Data Manager for Energy Preview instance page. Details as such data partitions, instance URI, and app ID are accessible.

Delete an Azure Data Manager for Energy Preview instance

Deleting a Microsoft Energy Data instance also deletes any data that you've ingested. This action is permanent and the ingested data can't be recovered. To delete an Azure Data Manager for Energy Preview instance, complete the following steps:

  1. Sign in to the Azure portal and delete the resource group in which these components are installed.

  2. This step is optional. Go to Azure Active Directory and delete the app registration that you linked to your Azure Data Manager for Energy Preview instance.

OSDU™ is a trademark of The Open Group.

Next steps

After provisioning an Azure Data Manager for Energy Preview instance, you can learn about user management on this instance.

How to manage users