Skip to content

Commit

Permalink
Merge pull request #2023 from SkylineCommunications/DaaS-procedure
Browse files Browse the repository at this point in the history
Deploying a DMS in the cloud (DaaS)
  • Loading branch information
MariekeGO committed Sep 29, 2023
2 parents a6fb95a + 6349653 commit 93be0ec
Show file tree
Hide file tree
Showing 20 changed files with 133 additions and 42 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -149,4 +149,6 @@ The **Remote Administration** rule must be enabled when the DataMiner server is
## Secure the databases

Cassandra and Elasticsearch/OpenSearch form a crucial part of recent DataMiner Systems. For this reason, it is important that you spend some time making sure their configuration is as secure as possible. For detailed information, refer to [Securing the DataMiner databases](xref:Cassandra_authentication).
If you do not make use of [Storage as a Service (STaaS)](xref:STaaS) but manage DataMiner storage yourself, you need to make sure that the databases used for DataMiner storage are fully secure.

In recent DataMiner Systems, Cassandra and Elasticsearch/OpenSearch are used for this. It is important that you spend some time making sure their configuration is as secure as possible. For detailed information, refer to [Securing the DataMiner databases](xref:Cassandra_authentication).
2 changes: 1 addition & 1 deletion user-guide/Advanced_Functionality/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -241,7 +241,7 @@ items:
topicUid: Separate_Cassandra_setup_without_Elasticsearch
- name: Legacy setup with MySQL or MSSQL database
topicUid: Legacy_setup_with_MySQL_or_MSSQL_database
- name: Storage as a Service
- name: Storage as a Service (STaaS)
topicUid: STaaS
- name: Database configuration
topicUid: Configuring_dedicated_clustered_storage
Expand Down
5 changes: 3 additions & 2 deletions user-guide/Getting_started/BasicConcepts/BasicConcepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,9 @@ To be able to work with DataMiner, you must have at least one DataMiner Agent an

| Concept | Description |
|--|--|
| DataMiner Agent or DMA | A physical or virtual compute instance running the DataMiner software. |
| DataMiner client | An entity communicating with the Agent. The term is mostly used to denote a client application that allows users to interact with the DataMiner Agent. |
| DataMiner Agent or DMA | A physical or virtual compute instance or "node" running the DataMiner software. |
| DataMiner System or DMS | A group of one or more DataMiner Agents, seamlessly working together as one system. |
| DataMiner client | An entity communicating with a DataMiner Agent. The term is mostly used to denote a client application that allows users to interact with a DataMiner System. |

> [!TIP]
> See also: [DataMiner System layout](xref:GeneralLayout)
Expand Down
78 changes: 78 additions & 0 deletions user-guide/Getting_started/Deploying_a_DMS_in_the_cloud.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
uid: Deploying_a_DMS_in_the_cloud
---

# Deploying a DataMiner System in the cloud (DaaS)

> [!IMPORTANT]
> At present, this feature is only available in preview for the "Empower" organization.
> [!TIP]
> If you have any questions or need support with the DaaS feature, contact <daas@dataminer.services>.
With **DataMiner as a Service (DaaS)**, you can deploy a complete DataMiner System (DMS) in mere minutes. The DataMiner System is fully hosted in the cloud, so that you can immediately enjoy all the benefits of being connected to the [dataminer.services platform](xref:AboutCloudPlatform). As DaaS uses our [Storage as a Service (STaaS) solution](xref:STaaS), you will be able to make use of a scalable and user-friendly cloud-native storage platform. Scaling will be easy, both vertically (adding or removing resource), and horizontally (adding or removing nodes), whenever you need.

## Deploying a new DMS on dataminer.services

1. Log on to [dataminer.services](https://dataminer.services).

> [!TIP]
> For more detailed information, see [Logging on to dataminer.services](xref:Logging_on_to_the_DataMiner_Cloud_Platform).
1. Under *DataMiner Systems*, click *Deploy a new DataMiner System*.

![Deploy a new DataMiner System button](~/user-guide/images/deploy_001.png)

1. Click *Deploy a DataMiner System*.

![Deploy a DataMiner System button](~/user-guide/images/deploy_002.png)

1. Select the *Organization* under which you want to register the DataMiner System.

1. Enter a *DataMiner System Name*.

1. Enter a custom *DataMiner System URL* if you do not want the URL to be the same as the *DataMiner System Name*.

1. Select the box next to *I agree to the terms of service*.

1. Click *Deploy*.

![DataMiner System deployment configuration](~/user-guide/images/deploy_003.png)

1. Wait until your DataMiner System has been deployed.

The following message will be displayed:

![DataMiner System deployment confirmation](~/user-guide/images/deploy_005.png)

## Accessing a newly deployed DMS for the first time

1. Log on to [dataminer.services](https://dataminer.services).

> [!TIP]
> For more detailed information, see [Logging on to dataminer.services](xref:Logging_on_to_the_DataMiner_Cloud_Platform).
1. Under *DataMiner Systems*, click *Cube*.

![Cube icon on dataminer.services](~/user-guide/images/deploy_006.png "Access Cube")

1. If required, confirm by clicking *Open DataMiner Cube*.

![Open DataMiner Cube](~/user-guide/images/deploy_007.png)

1. Click *Connect*

![Connecting to Cube](~/user-guide/images/deploy_008.png)

1. Log in with the following credentials:

- Username: *DataMinerAdmin*

- Password: *DataMiner123!*

![Logging into Cube](~/user-guide/images/deploy_009.png)

Now that you are logged in, you can configure your DataMiner System to your specific preferences.

> [!IMPORTANT]
> We strongly recommend that you **start by configuring security**. You should in the very least change the password for the *DataMinerAdmin* account, but it would be even better configure your own admin account and then remove the *DataMinerAdmin* account. Next, configure the necessary rights and privileges for the other users of your DataMiner System. See [User management](xref:User_management).
21 changes: 21 additions & 0 deletions user-guide/Getting_started/Deploying_a_DataMiner_System.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
uid: Deploying_a_DataMiner_System
---

# Deploying a DataMiner System

To deploy a DataMiner System (DMS), there are different possibilities:

- You can make use of **DataMiner as a Service (Daas)**. This means that you [deploy your DMS in the cloud](xref:Deploying_a_DMS_in_the_cloud) in just a few clicks, and it will be fully hosted and maintained by Skyline Communications.

> [!IMPORTANT]
> At present, this feature is only available in preview for the "Empower" organization.
- You can host the DataMiner nodes yourself. For **self-hosted DataMiner nodes**, you will need to [install the DataMiner Agents](xref:Installing_a_DataMiner_Agent) and then set up your DataMiner System yourself. For the data storage for these nodes, two options are available:

- You can make use of [Storage as a Service (STaaS)](xref:STaaS). You connect your DataMiner System to a scalable, easy-to-use, cloud-native storage platform hosted by Skyline.

- You can host the storage nodes yourself. This means you will need to take care of [configuring and maintaining the databases](xref:Configuring_dedicated_clustered_storage).

> [!TIP]
> Not familiar with DataMiner? See [Basic concepts](xref:BasicConcepts).
2 changes: 1 addition & 1 deletion user-guide/Getting_started/Getting_Started.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ uid: Part1GettingStarted

<div class="row">
<div class="column">
<a href="/user-guide/Getting_started/Installing_a_DataMiner_Agent.html" title="Installing a DMA" target="_self"><img src="~/user-guide/images/Docs_InstallingDMA.svg" style="width:100%"></a>
<a href="/user-guide/Getting_started/Deploying_a_DataMiner_System.html" title="Deploying a DMS" target="_self"><img src="~/user-guide/images/Deploying_DMS.svg" style="width:100%"></a>
</div>
<div class="column">
<a href="/user-guide/Getting_started/BasicConcepts/BasicConcepts.html" title="Basic Concepts" target="_self"><img src="~/user-guide/images/Docs_BasicConcepts.svg" style="width:100%"></a>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,8 +77,8 @@ The DataMiner installer allows you to run a default DataMiner installation, whic
At this point, the basic installation is complete. However, to be able to make full use of all available DataMiner features, you will also need to:

- [Upgrade to the latest feature or main release version](xref:Upgrading_a_DataMiner_Agent)
- [Install Elasticsearch](xref:Installing_Elasticsearch_via_DataMiner)
- [Connect your DataMiner System to dataminer.services](xref:Connecting_your_DataMiner_System_to_the_cloud)
- Either deploy [Storage as a Service](xref:STaaS) to make use of cloud-native storage hosted by Skyline or, if you wish to host the DataMiner storage yourself, [configure the databases](xref:Configuring_dedicated_clustered_storage).

> [!IMPORTANT]
> During the DataMiner installation, you are automatically added to the Administrator group by the installation wizard, giving you all Administrator rights. To grant others access to your DMA, log in to Cube using the same username and password as during the installation process, and configure user permissions as described in [Basic security configuration](xref:Managing_users).
Expand Down Expand Up @@ -147,8 +147,8 @@ At this point, the basic installation is complete. However, to be able to make f
At this point, the basic installation is complete. However, to be able to make full use of all available DataMiner features, you will also need to:

- [Upgrade to the latest feature or main release version](xref:Upgrading_a_DataMiner_Agent)
- [Install Elasticsearch](xref:Installing_Elasticsearch_via_DataMiner)
- [Connect your DataMiner System to dataminer.services](xref:Connecting_your_DataMiner_System_to_the_cloud)
- Either deploy [Storage as a Service](xref:STaaS) to make use of storage nodes that are fully hosted by Skyline or, if you wish to host the storage nodes yourself, [configure the databases](xref:Configuring_dedicated_clustered_storage).

> [!IMPORTANT]
> During the DataMiner installation, you are automatically added to the Administrator group by the installation wizard, giving you all Administrator rights. To grant others access to your DMA, log in to Cube using the same username and password as during the installation process, and configure user permissions as described in [Basic security configuration](xref:Managing_users).
Expand Down
24 changes: 4 additions & 20 deletions user-guide/Getting_started/Installing_a_DataMiner_Agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,30 +2,14 @@
uid: Installing_a_DataMiner_Agent
---

# Installing a DataMiner Agent
# Installing a self-hosted DataMiner Agent

> [!TIP]
> With DataMiner as a Service (DaaS), scheduled for **production release in Q3 of 2023**, you can deploy a DataMiner System with a single click. For more information on DaaS and its benefits, see [Sneak peek: DataMiner as a Service (DaaS) in action](https://community.dataminer.services/sneak-peek-dataminer-as-a-service-daas-in-action/) on DataMiner Dojo.
>
> Currently, you can only use DaaS by [contacting Skyline](mailto:hi@skyline.be), after which a DaaS DataMiner System will be made available to you. Read more about this on [DataMiner Dojo](https://community.dataminer.services/dataminer-storage-as-a-service-staas-is-live/).
- [Installing DataMiner using the DataMiner Installer](xref:Installing_DM_using_the_DM_installer)

- [Unattended DataMiner installation](xref:Unattended_DM_installation)

- [Checking the DataMiner installation](xref:Checking_the_DM_installation)

- [Regarding virtual servers](xref:Regarding_virtual_servers)

- [Regarding antivirus software](xref:Regarding_antivirus_software)

- [Frequently asked questions](xref:Installing_a_DMA_FAQ)
If you want to take care of hosting your DataMiner System yourself, you can manually install the DataMiner Agents instead of [deploying the DMS in the cloud](xref:Deploying_a_DMS_in_the_cloud).

> [!IMPORTANT]
> The server onto which you plan to install the DataMiner Agent software has to comply with the DataMiner system requirements. See [DataMiner Compute Requirements](xref:DataMiner_Compute_Requirements).
To manually install a DataMiner Agent, you will need to [use the DataMiner Installer](xref:Installing_DM_using_the_DM_installer). Afterwards, you will need to [upgrade to the latest feature or main release version](xref:Upgrading_a_DataMiner_Agent), [connect your DataMiner System to dataminer.services](xref:Connecting_your_DataMiner_System_to_the_cloud), and either deploy [Storage as a Service](xref:STaaS) to make use of cloud-native storage hosted by Skyline or, if you wish to host the DataMiner storage yourself, [configure the databases](xref:Configuring_dedicated_clustered_storage).

> [!NOTE]
> The DataMiner Installer is available on the [DataMiner software](https://community.dataminer.services/downloads/) page on DataMiner Dojo. Note that the 10.2.0 installer does not support 32-bit systems, MySQL installation, and unattended installation of a cluster.
> [!TIP]
> Not familiar with DataMiner? See [Basic concepts](xref:BasicConcepts).
33 changes: 19 additions & 14 deletions user-guide/Getting_started/toc.yml
Original file line number Diff line number Diff line change
@@ -1,19 +1,24 @@
items:
- name: Installing a DataMiner Agent
topicUid: Installing_a_DataMiner_Agent
- name: Deploying a DataMiner System
topicUid: Deploying_a_DataMiner_System
items:
- name: Installing DataMiner using the DataMiner Installer
topicUid: Installing_DM_using_the_DM_installer
- name: Unattended DataMiner installation
topicUid: Unattended_DM_installation
- name: Checking the DataMiner installation
topicUid: Checking_the_DM_installation
- name: Regarding virtual servers
topicUid: Regarding_virtual_servers
- name: Regarding antivirus software
topicUid: Regarding_antivirus_software
- name: Frequently asked questions
topicUid: Installing_a_DMA_FAQ
- name: Deploying a DataMiner System in the cloud (DaaS)
topicUid: Deploying_a_DMS_in_the_cloud
- name: Installing a self-hosted DataMiner Agent
topicUid: Installing_a_DataMiner_Agent
items:
- name: Installing DataMiner using the DataMiner Installer
topicUid: Installing_DM_using_the_DM_installer
- name: Unattended DataMiner installation
topicUid: Unattended_DM_installation
- name: Checking the DataMiner installation
topicUid: Checking_the_DM_installation
- name: Regarding virtual servers
topicUid: Regarding_virtual_servers
- name: Regarding antivirus software
topicUid: Regarding_antivirus_software
- name: Frequently asked questions
topicUid: Installing_a_DMA_FAQ
- name: Basic concepts
topicUid: BasicConcepts
- name: DataMiner System layout
Expand Down
1 change: 1 addition & 0 deletions user-guide/images/Deploying_DMS.svg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 0 additions & 1 deletion user-guide/images/Docs_InstallingDMA.svg

This file was deleted.

Binary file added user-guide/images/deploy_001.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_002.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_003.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_004.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_005.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_006.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_007.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_008.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user-guide/images/deploy_009.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 93be0ec

Please sign in to comment.