stream replica add
Registers an existing stream as a replica of the specified stream.
Permissions Required at the Source Cluster
To run this command, your user ID must have the following permissions:readAce
andwriteAce
on the volumelookupdir
on directories in the pathadminperm
andcopyperm
permissions on the source stream
mapr
user is not treated as a
superuser. HPE Ezmeral Data Fabric Streams does not allow the
mapr
user to run this command unless that user is given the relevant
permission or permissions with access-control expressions.Permissions Required at the Target Cluster
To run this command, your user ID must have the following permissions:Syntax
CLI |
|
REST | http[s]://<host>:<port>/rest/stream/replica/add?path=<path>&replica=<name> |
Parameters
Parameter | Description |
---|---|
path |
The path and name of the stream that you want to create a replica for. |
replica |
The path and name of the stream that you want to create as a replica of the
stream that you specified with the -path parameter. |
paused |
A boolean value that specifies whether to pause the replication so that it does
not start immediately. The replication can be resumed using the replica resume
command at a later time. The values are true or
false . The default is false .Set
|
throttle |
A boolean value that specifies whether to throttle replication operations.
Throttle the replication stream to minimize the impact of the replication process on
incoming operations during periods of heavy load. The values are
true or false . The default is
false .Throttling has two effects, both of which allow HPE Ezmeral Data Fabric Streams to
use more system resources to process new messages:
|
networkencryption |
A boolean value that specifies whether or not to enable on-wire encryption. The
values are true or false . The default is
false . If you set the value to true , the local
cluster and any other cluster that is part of the replication process must be
enabled for security. |
synchronous |
A boolean value that specifies whether replication is synchronous or
asynchronous. The values are true or false . The
default is false and specifies asynchronous replication. |
networkcompression |
Specifies the type of compression to use when replicating messages. For more information, see Managing Compression. |