Skip to content

Commit

Permalink
Update MinIOPlugin.md
Browse files Browse the repository at this point in the history
  • Loading branch information
DjP-iX committed Apr 18, 2024
1 parent 06fdd17 commit 2d3a053
Showing 1 changed file with 24 additions and 0 deletions.
24 changes: 24 additions & 0 deletions content/CORETutorials/JailsPluginsVMs/Plugins/MinIOPlugin.md
Expand Up @@ -32,6 +32,8 @@ For additional information please review [Migrate from Gateway or Filesystem Mod
## First Steps

[Create a dataset]({{< relref "Datasets.md" >}}) to use for **Minio** Plugin storage.
This tutorial uses <file>/mnt/tank/minio</file>.

MinIO manages files as objects.
These objects cannot mix with other dataset files.

Expand All @@ -41,6 +43,9 @@ You can migrate data to a different networked device with enough storage capacit
For better performance, total pool capacity should not exceed 80%.
For example, if the original S3 dataset is 25TB and the destination dataset is created in the same pool, the total pool capacity should be at least 62.5TB (25TB for each dataset plus 20% overhead).

[Edit permissions]({{< relref "permissions.md" >}}) for the new dataset.
Set **User** as **minio** and **Group** as **wheel**.

## Installing the Minio Plugin

Go to the **Plugins** screen.
Expand Down Expand Up @@ -125,6 +130,25 @@ Next [configure the **Minio** plugin](#configuring-the-minio-plugin-for-migratio

After migrating data, you can either create an archive of the TrueNAS S3 service or delete it.

### Preparing the Dataset

After [installing the MinIO Plugin](#installing-the-minio-plugin), confirm the plugin starts.
Then stop the MinIO plugin.

Log in to the TrueNAS CORE shell using SSH.

Copy the hidden folder <file>minio.sys</file> from <file>/mnt/tank/iocage/jails/*minio-jail*/root/var/db/minio</file> to the dataset created in [First Steps](#first-steps), where *minio-jail* is the jail that houses the installed plugin.
Enter the command `cp -rp /mnt/tank/iocage/jails/minio-jail/root/var/db/minio/.minio.sys /mnt/tank/minio` with the configured dataset and jail paths.

Delete the <file>.minio.sys</file> folder from <file>/mnt/tank/iocage/jails/*minio-jail*/root/var/db/minio</file>.

Go to **Plugins**, locate the MinIO plugin row, and click <i class="material-icons" aria-hidden="true" title="Expand">chevron_right</i> to expand it.
Click **Mount Points** to create a new mount point.
Enter or click to select the new dataset, with the <file>.minio.sys</file> folder present, in **Source**.
Enter or click to select the plugin jail in **Destination**.

{{< trueimage src="/images/CORE/13.0/MinioMountPoint.png" alt="MinIO Mount Point" id="MinIO Mount Point" >}}

### Installing the MinIO Client

The [MinIO Client](https://min.io/docs/minio/linux/reference/minio-mc.html) (MC) is a command line tool with support for both filesystems and S3-compatible cloud storage services.
Expand Down

0 comments on commit 2d3a053

Please sign in to comment.