mc admin replicate update

Modifies the endpoint used for an existing peer site participating in site replication.

Syntax

The command has the following syntax:

mc [GLOBALFLAGS] admin replicate update                     \
                            ALIAS                           \
                            --deployment-id [deploymentID]  \
                            --endpoint [newEndpoint]        \
                            --mode ["sync" | "async"]       \
                            --bucket-bandwidth [VALUE]      \
                            --enable-ilm-expiry-replication \
                            --disable-ilm-expiry-replication

Parameters

ALIAS

Required

The alias of the MinIO AIStor deployment.

--bucket-bandwidth

Optional

Set default bandwidth limit for bucket in bytes per second.

Valid units include:

  • B for bytes
  • K for kilobytes
  • M for megabytes
  • G for gigabytes
  • T for terabytes
  • Ki for kibibytes
  • Mi for mebibytes
  • Gi for gibibytes
  • Ti for tebibytes

For example, the following command limits the replication on the myaistor deployment to no more than 2 gigabytes per second.

mc admin replicate update myaistor --deployment-id c1758167-4426-454f-9aae-5c3dfdf6df64 --bucket-bandwidth "2G"

--deployment-id

Required

The unique ID of the deployment to change.

The deployment ID can be found by running mc admin replicate info ALIAS

--disable-ilm-expiry-replication

Optional

Stops the replication of ILM expiration rules between peer sites. Existing rules already synchronized across peers are not removed from any peer site.

--enable-ilm-expiry-replication

Optional

Start replication of ILM expiration rules between peer sites.

--endpoint

Required

The new endpoint or URL to associate with the peer site.

--mode

Optional

Specify whether MinIO AIStor performs replication operations to the peer synchronously or asynchronously. Available values are sync and async.

Defaults to async.

Global flags

This command supports any of the global flags.

Example

mc admin replicate update                                                   \
                   myaistor2                                                 \
                   --deployment-id c1758167-4426-454f-9aae-5c3dfdf6df64   \
                   --endpoint https://myaistor2:9000