Deploying a DataMiner Agent using the AWS AMI
On the AWS Marketplace, DataMiner Self-Hosted AWS Edition is available as an Amazon Machine Image (AMI). It allows you to rapidly launch a production-ready DataMiner environment on Amazon EC2 without complex installation or setup.
To deploy DataMiner using the AWS AMI, you will need to follow the steps below:
Note
- This setup requires a valid AWS account and knowledge of how to use the AWS management console. For more information, refer to the AWS documentation.
- The DataMiner license is separate from AWS infrastructure costs. You will be charged by AWS for the EC2 instance and any other AWS resources you use.
- After launching the AWS VM, you will be able to choose if you want to continue with the default DataMiner Community Edition license or use your perpetual license.
Launching the EC2 instance
Go to the DataMiner Self-Hosted AWS Edition listing on the AWS Marketplace and click View purchase options.
Subscribe to the product.
By default, DataMiner will be deployed with a free Community Edition license. If you need a paid license, you will need to purchase it outside of AWS Marketplace.
Tip
For more information about available licensing options, see Pricing.
After subscribing, click Launch your software.
This opens the Launch DataMiner Self-Hosted AWS Edition page.
Select Launch from EC2 Console as the launch method, select a region, and click Launch from EC2.
This opens the EC2 Launch an instance page.
Note
The One-click launch from AWS Marketplace option is not recommended, as it uses AWS default settings that may not be suitable for a DataMiner deployment (e.g., instance type, network, and security group settings).
In the Name and tags section, enter a name for your instance and optionally add tags.
The AMI is pre-selected based on your subscription. You do not need to change this.
In the Instance type section, select the instance type.
A t2.xlarge (4 vCPU, 16 GiB memory) or larger is recommended.
In the Key pair (login) section, select an existing key pair or create a new one.
Important
A key pair is required to retrieve the Windows Administrator password after launch. Do not proceed without a key pair, as you will not be able to connect to your instance.
In the Network settings section, configure the network:
- Ensure the instance has internet access for dataminer.services connectivity.
- Configure a security group that allows at least inbound RDP access (TCP port 3389) from your IP address. Let it assign a public IP so you can RDP after the instance is launched.
Note
By default, the instance is launched in the default VPC. If you want to use a custom IP address space, you will need to create a new VPC first and select it here. For more information, see Create a VPC in the AWS documentation.
In the Configure storage section, configure the storage.
The default root volume size is 54 GiB, but you can increase this before launching. You can also increase the volume size at any time after the instance has been launched.
Optionally, configure further advanced details.
Launch the instance.
Connecting to the instance
Once the EC2 instance is in the running state, retrieve the Windows Administrator password using your key pair via the AWS Management Console (Actions > Security > Get Windows password).
Connect to the instance using Remote Desktop Protocol (RDP) with the retrieved Administrator password.
The default username is Administrator.
Configuring DataMiner
As soon as you log in to the instance, the DataMiner Configurator window will be shown where you can configure your DataMiner System.
Important
At this point, the DataMiner core software is fully installed. If you continue with the steps below, the wizard will also automatically take care of the license and data storage configuration. However, if you do not want a default installation, you may not want to use this automatic configuration:
- If you intend to restore a backup coming from another machine, for example, because of a hardware migration or during disaster recovery, skip the configuration below and follow the steps under Restoring a backup onto a newly installed DataMiner Agent.
- If you are installing a Failover Agent, skip the configuration below, and follow the steps under Configuring the new DataMiner Agent as a new Agent in a Failover pair.
Note
If you accidentally close the configuration window, you can run it manually from C:\Skyline DataMiner\Tools\FirstStartupChoice\FirstStartupChoice.exe. Make sure to run it with administrator privileges.
Normally, a shortcut is created on the desktop the first time you close the configuration window. You can delete this shortcut once you have successfully started DataMiner.
Follow the steps below to configure your DataMiner Agent:
Click Next to get started.
Select the desired database type:
Storage as a Service (STaaS) (recommended).
Self-hosted - External Storage: A regular dedicated clustered storage setup. If you select this option, you will also need to fill in the connection details for both Cassandra and OpenSearch.
Note
Make sure these clusters are active and reachable from the instance you are setting up. You are responsible for the management of these external database clusters.
Click Next, and fill in the required details to connect your DataMiner Agent to dataminer.services:
- Organization API Key: Provide an organization key that has the necessary permissions to add DataMiner Systems in your organization. For more information on how to add a new organization key to your organization on dataminer.services, see Managing dataminer.services keys.
- System Name: This name will be used to identify the DataMiner System in various dataminer.services applications.
- System URL: This URL will grant you remote access to your DataMiner System web applications. You can choose to either disable or enable this remote access feature at any time.
- Admin Email: This email address must be associated with a dataminer.services account that is a member of your organization. It will become the owner of the DMS on dataminer.services.
- STaaS Region: If you have selected to use STaaS for data storage, select the region where your data should be hosted.
Note
By default, the configurator will guide you in subscription mode with a Community Edition license. If you want to install DataMiner with a perpetual license, click the link below the registration fields and enter the DataMiner ID provided by Skyline. If you do not have a DataMiner ID yet, contact dataminer.licensing@skyline.be.
You can also deploy DataMiner in subscription mode first and switch to a perpetual license or switch to an offline demo license later.
Click Next, and verify the selected configuration.
To start the configuration, click Next.
The configuration progress will now be displayed. When the configuration is complete, you can close the window.
DataMiner will automatically start up and connect to dataminer.services. DataMiner Cube will also be installed, so you can connect to DataMiner locally.
Log in to DataMiner Cube using the previously configured Administrator account.
Logging in automatically with the built-in Administrator account is not possible, so you will need to fill in the username and password.
Important
For security reasons, we strongly recommend creating a second user and disabling the built-in administrator account once the setup is complete. See Managing users.