Agora on AWS Marketplace Quick Start Guide
You can translate the document:
The goal of this guide is to serve as a quick start to configure Agora on AWS Marketplace and understand the main functionalities in Agora, the Denodo Cloud Service, like creating a new account and instantiating a new Subscription.
For general documentation and tutorials on how to use Denodo Platform, please refer to the Denodo Community site
IMPORTANT NOTICE
Take into account the Agora Execution Plane is deployed and runs in your AWS account:
- You need the required AWS administrative permissions to deploy the Execution Plane AWS infrastructure in your AWS account.
- You will pay Execution Plane AWS infrastructure usage fees through your AWS bill.
Agora Architecture Overview
Agora operates using two different planes: a Control Plane and an Execution Plane. The following diagram represents the architecture and data flows.
- The Control Plane: managed by Denodo in its cloud accounts. It includes all the capabilities related with account and Subscription management. Additionally, the Control Plane also includes a adapted version of the Denodo Solution Manager (which allows you to manage the environments and clusters of your Execution Plane), and hosts the web-based clients (Design Studio, Scheduler Administration Tool and the Monitoring and Diagnostics tool). This part of the Control Plane is deployed in a dedicated isolated instance per Agora Subscription.
- The Execution Plane: where your data is processed. It includes the VDP and Scheduler servers, and the Data Catalog. The Execution Plane is hosted in your cloud account.
To further clarify the concepts covered in this section, you can watch our detailed video tutorial here: https://youtu.be/rXQE99qUxK8 |
Agora on AWS Marketplace Set Up Overview
Steps:
- Subscribe to Agora on AWS
- Create an Agora User
- Create an Agora Organization
- Create an Agora Billing Account associated with AWS Marketplace
In the following sections each one of the steps will be detailed.
1-Subscribe to Agora on AWS
You will need an AWS user with privileges to accept AWS Marketplace agreements trough public or private offers.
Once you have subscribed to Agora after accepting a public or private offer, you will need to set up your account in Agora: clicking on vendor’s website you will be redirected to Agora Sign In page.
2-Create an Agora User
If it is your first time using Agora you need to register an Agora User. If this is not your first time using agora and you already have an Agora User that is administrator of an Agora Organization you can jump to the next step.
In order to register a new user, you need to provide basic information like name, last name, email and password.
In the login page, click on Register, fill the form and click on the Register button to create a new user.
After clicking on the Register button you will receive an email to the registered address to validate the introduced information.
Please keep in mind that this user will be the global administrator of the account for your Organization. You will be able to create additional users later on.
3-Create an Agora Organization
Having an Agora User YOU HAVE TO RETURN AGAIN TO the AWS Marketplace AWS on Agora Subscription page and click again on vendor’s website to be redirected to Agora Sign In page.
This time you have to sign in with your Agora User instead of Register.
Once logged in, you need to select an Agora Organization or create a new one. An Agora Organization can have multiple Subscriptions, which is useful for example if you want to have multiple Denodo deployments in different cloud providers or in different regions, but manage them all under the same account.
4-Create an Agora Billing Account associated with AWS Marketplace
After selecting Agora Organization you will need to create a new Agora Billing Account associated with your AWS agreement.
An Agora Organization has at least one Billing Account that is the logical entity used to manage payments and it is associated with a Subscription plan (Standard, Enterprise or Enterprise Plus). Billing accounts are established at the Organization level and can be associated with multiple Agora Subscriptions configured with the same plan.
First you must choose the Subscription plan associated with the Billing Account based on your public or private offer.
Then, you need to enter a name for the Billing Account and set an optional description.
After clicking Create the Billing Account will be created with Agora Credits associated with the public or private offer you signed that you can use in Subscriptions for launching deployments based on the selected plan chosen during Billing Account creation.
Appendix A - Organization Admin Panel
If you are the owner of an Organization (the user created in the first step), or you have the required roles, you can access the Organization Admin Panel using the link at the bottom-left of the screen.
In this panel you can perform some global actions, depending on your role:
- Settings: Update Organization attributes (name, description).
- Subscriptions: Create or update Subscriptions and navigate to their panel.
- Roles: Check which global roles are assigned to each user.
- Users: Add / remove / activate / suspend users and manage their global roles.
- Usage: You can check the usage information of all your Subscriptions here and filter by date range, Subscription, environment types, etc.
- Audit: You can check all the audit records for your entire Organization, filtering by date range, action type, Subscription, etc.
- Billing accounts: here you can obtain information for each Billing Account. You can also configure existing Billing Accounts and add new ones.
Appendix B - Subscription Admin Panel
Inside the Subscription panel, on the left hand section of the screen, you have access to additional options to manage roles, users, and monitor usage.
Settings
On this page, there are two tabs: General settings and Cloud settings.
General Settings
You can edit the basic Subscription information such as name and description. You also have the options to Cancel Subscription or Upgrade plan.
Cancel a Subscription
You can cancel an active Subscription and remove all the resources created by Agora in your AWS account. To do this, go to the Subscription settings page and press the “Cancel Subscription” button. A confirmation dialog is shown to avoid possible mistakes.
You can still access a canceled Subscription to check its usage details.
Cloud settings
In this option, you can edit the AWS client account access configuration, such as the IAM role ARN.
Roles
A Subscription has two different types of roles:
- Roles for permissions for Agora. They can be assigned to users in the “Users” section.
- Roles for permissions for the Solution Manager. In the “Roles” section, you can check the predefined Solution Manager roles, and you can create new custom roles which will be available in the Solution Manager and in the execution plane (you can use the Design Studio to assign execution plane permissions to these custom roles).
Users
Manage all the users of your Subscription:
- Invite new users to the Subscription (and Organization)
- Remove users
- Suspend and activate users
- Manage user roles
For a quick overview and step-by-step walkthrough, watch the following video tutorial: https://youtu.be/5VWMQePQOfU |
Usage
In this page you can see the usage details for your Subscription, like uptime and consumed credits. In the summary section you can check the information of the services you have consumed in a particular time period and filter using different parameters.
For a more visual explanation of this process, refer to the video tutorial: https://youtu.be/wcnJwJ9kGj0 |
Maintenance
This section describes the maintenance actions performed by Agora that are associated with a Subscription and may affect its availability. These actions include planned tasks at improving performance, updating systems, or resolving technical issues. During these maintenance periods, the service may temporarily not be available or experience limited interruptions.
In this page, you can review the scheduled maintenance or the maintenance history.
