Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pd 1375 min io enterprise and stable app updates #3021

Merged
merged 18 commits into from
Sep 6, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -16,56 +16,51 @@ keywords:
- two-factor authentication (2FA)
---

{{< include file="/static/includes/SCALEEnterpriseApps.md" >}}

The instructions in this article apply to the TrueNAS MinIO Enterprise application installed in a Multi-Node Multi-Disk (MNMD) multi-mode configuration.

For more information on MinIO multi-mode configurations see [MinIO Single-Node Multi-Drive (SNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-single-node-multi-drive.html) or [Multi-Node Multi-Drive (MNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-multi-node-multi-drive.html#minio-mnmd).
MinIO recommends using MNMD (distributed) for enterprise-grade performance and scalability.
For more information on MinIO multi-mode configurations see [MinIO Single-Node Multi-Drive (SNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-single-node-multi-drive.html) or [Multi-Node Multi-Drive (MNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-multi-node-multi-drive.html#minio-mnmd). MinIO recommends using MNMD (distributed) for enterprise-grade performance and scalability.

This article applies to the TrueNAS MinIO application in the **enterprise** train.
This smaller version of MinIO is tested and polished for a safe and supportable experience for TrueNAS Enterprise customers.
The enterprise MinIO application is tested and verified as an immutable target for Veeam Backup and Replication.


## Adding MinIO Enterprise App
Community members can add and use the MinIO Enterprise app or the default community version.

{{< include file="/static/includes/AddMinioEnterpriseTrain.md" >}}

## Befor You Begin
Complete these steps for every system (node) in the cluster.

Assign four sequential IP addresses or host names such as **minio1.*mycompany.com*** through **minio4.*mycompany.com*** to the TrueNAS system.
If you assign IP address numbers such as *#.#.#.*100 - 103 or *#.#.#.134 - .137, you can use these in the command string in the **Multi Mode** field.
If not using sequential IP addresses, use sequentially numbered host names.
Add network settings using either the **Network** screen. Enter host names on the **Global Configuration** screen.

When creating the certificate, enter the system IP addresses for each system in **Subject Alternate Names**.
If configuring MinIO in an MNMD cluster, enter the system IP addresses for each system in the cluster.
## Before You Begin

{{< include file="/static/includes/MinIOEnterpriseFirstSteps.md" >}}
{{< include file="/static/includes/MinIOEnterpriseMultiModeBeforeYouBegin.md" >}}

## Installing MinIO Enterprise

{{< hint info >}}
This procedure covers the required Enterprise MinIO App settings.
This basic procedure covers the required MinIO enterprise app settings.
For optional settings, see [Understanding MinIO Wizard Settings](#understanding-minio-wizard-settings).
{{< /hint >}}

Repeat this procedure for every system (node) in the MNND cluster.
{{< include file="/static/includes/AddMultipleAppInstancesAndNaming.md" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig1.md" >}}

{{< include file="/static/includes/MinIOEnterpriseStorageConfig.md" >}}
{{< include file="/static/includes/MinIOEnterpriseConfig2.md" >}}

{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig2.md" >}}

Select **Enable Multi Mode (SNMD or MNMD)**, then click **Add**.
If the systems in the cluster have sequentially assigned IP addresses, use the IP addresses in the command string you enter in the **Multi Mode (SNMD or MNMD)** field.
For example, <b>https://<i>10.123.12.10</i>{0...3}:30000/data{1...4}</b> where the last number in the last octet of the IP address number is the first number in the **{0...3}** string.
Separate the numbers in the curly brackets with three dots.
If your sequential IP addresses are not using 100 - 103, for example *10.123.12.125* through 128, then enter them as <b>https://<i>10.123.12.12</i>{5...8}:30000/data{1...4}</b>.
Enter the same string in the **Multi Mode (SNMD or MNMD)** field in all four systems in the cluster.
{{< include file="/static/includes/MinIOEnterpriseMultiModeConfigMNMD.md" >}}

If you do not have sequentially numbered IP addresses assigned to the four systems, assign sequentially numbered host names.
For example, **minio1.*mycompany.com*** through **minio4.*mycompany.com***.
Enter <b>https://minio{1...4}.<i>mycompany.com</i>:30000/data{1...4}</b> in the **Multi Mode (SNMD or MNMD)** field.
Enter the same string in the **Multi Mode (SNMD or MNMD)** field in all four systems in the cluster!

{{< trueimage src="/images/SCALE/Apps/InstallMinIOAddMultiModeConfigExample.png" alt="Multi Mode MDN Command" id="Multi Mode MNDN Command" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig2.md" >}}
{{< include file="/static/includes/MinIOEnterpriseConfig3.md" >}}

{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig3.md" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig4.md" >}}

### Completing the MinIO Configuration

Expand All @@ -74,4 +69,39 @@ After installing and getting the MinIO Enterprise application running in TrueNAS
Go to **Monitoring > Metrics** to verify the servers match the total number of systems (nodes) you configured.
Verify the number of drives matches the number you configured on each system, four systems each with four drives (4 systems x 4 drives each = 16 drives).

Refer to MinIO documentation for more information.
Refer to MinIO documentation for more information.

## Understanding MinIO Wizard Settings
The following section provides more detailed explanations of the settings in each section of the **Install MinIO** configuration wizard.

### Application Name Settings

{{< include file="/static/includes/AppsWizardAppNameAndVersion.md" >}}

### MinIO Configuration Settings

{{< include file="/static/includes/MinIOEnterpriseMinIOConfig.md" >}}

#### MultiMode Configuration
Multi-mode installs the app in either a [MinIO Single-Node Multi-Drive (SNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-single-node-multi-drive.html) or [Multi-Node Multi-Drive (MNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-multi-node-multi-drive.html#minio-mnmd) cluster.
MinIO recommends using MNMD for enterprise-grade performance and scalability.

Click **Enabled** under **Multi Mode (SNMD or MNMD) Configuration** to enable multi-mode and show the **Multi Mode (SNMD or MNMD)** and **Add** option.

{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig.md" >}}

### User and Group Configuration

{{< include file="/static/includes/AppUserAndGroupConfig.md" >}}

### Network Configuration

{{< include file="/static/includes/MinIOEnterpriseNetworkConfig.md" >}}

### Storage Configuration

{{< include file="/static/includes/MinIOEnterpriseStorageConfig.md" >}}

### Resource Configuration

{{< include file="/static/includes/SyncthingWizardResourceConfig.md" >}}
Original file line number Diff line number Diff line change
Expand Up @@ -15,33 +15,79 @@ keywords:
- enterprise data storage
---

{{< include file="/static/includes/SCALEEnterpriseApps.md" >}}

The instructions in this article apply to the TrueNAS MinIO Enterprise application installed in a Single-Node Multi-Disk (SNMD) multi-mode configuration.

For more information on MinIO multi-mode configurations see [MinIO Single-Node Multi-Drive (SNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-single-node-multi-drive.html) or [Multi-Node Multi-Drive (MNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-multi-node-multi-drive.html#minio-mnmd). MinIO recommends using MNMD (distributed) for enterprise-grade performance and scalability.

This article applies to the TrueNAS MinIO application in the **enterprise** train.
This smaller version of MinIO is tested and polished for a safe and supportable experience for TrueNAS Enterprise customers.
The enterprise MinIO application is tested and verified as an immutable target for Veeam Backup and Replication.

## Adding MinIO Enterprise App
Community members can add and use the MinIO Enterprise app or the default community version.

{{< include file="/static/includes/AddMinioEnterpriseTrain.md" >}}

## First Steps
## Before You Begin

{{< include file="/static/includes/MinIoEnterpriseFirstSteps.md" >}}
{{< include file="/static/includes/MinIOEnterpriseMultiModeBeforeYouBegin.md" >}}

## Installing MinIO Enterprise

{{< hint info >}}
This procedure covers the required Enterprise MinIO App settings.
This basic procedure covers the required MinIO enterprise app settings.
For optional settings, see [Understanding MinIO Wizard Settings](#understanding-minio-wizard-settings).
{{< /hint >}}

{{< include file="/static/includes/AddMultipleAppInstancesAndNaming.md" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig1.md" >}}

{{< include file="/static/includes/MinIOEnterpriseStorageConfig.md" >}}
{{< include file="/static/includes/MinIOEnterpriseConfig2.md" >}}

Select **Enable Multi Mode (SNMD or MNMD)**, then click **Add**.
Enter **/data{1...4} in the **Multi Mode (SNMD or MNMD)** field.
{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig2.md" >}}

{{< trueimage src="/images/SCALE/Apps/InstallMinIOAddMultiModeSNMD.png" alt="Multi Mode SNDN Command" id="Multi Mode SNDN Command" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig2.md" >}}
{{< include file="/static/includes/MinIOEnterpriseConfig3.md" >}}

{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig3.md" >}}

{{< include file="/static/includes/MinIoEnterpriseConfig4.md" >}}


## Understanding MinIO Wizard Settings
The following section provides more detailed explanations of the settings in each section of the **Install MinIO** configuration wizard.

### Application Name Settings

{{< include file="/static/includes/AppsWizardAppNameAndVersion.md" >}}

### MinIO Configuration Settings

{{< include file="/static/includes/MinIOEnterpriseMinIOConfig.md" >}}

#### Multi-Mode Configuration
Multi-mode installs the app in either a [MinIO Single-Node Multi-Drive (SNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-single-node-multi-drive.html) or [Multi-Node Multi-Drive (MNMD)](https://min.io/docs/minio/linux/operations/install-deploy-manage/deploy-minio-multi-node-multi-drive.html#minio-mnmd) cluster.
MinIO recommends using MNMD for enterprise-grade performance and scalability.

Click **Enabled** under **Multi Mode (SNMD or MNMD) Configuration** to enable multi-mode and show the **Multi Mode (SNMD or MNMD)** and **Add** option.

{{< include file="/static/includes/MinIOEnterpriseMultiModeConfig.md" >}}

### User and Group Configuration

{{< include file="/static/includes/AppUserAndGroupConfig.md" >}}

### Network Configuration

{{< include file="/static/includes/MinIOEnterpriseNetworkConfig.md" >}}

### Storage Configuration

{{< include file="/static/includes/MinIOEnterpriseStorageConfig.md" >}}

### Resource Configuration

{{< include file="/static/includes/SyncthingWizardResourceConfig.md" >}}
Loading
Loading