cluster gateway resolve
Lists the gateways configured on a data-fabric cluster that are up and running at the time that the command is issued.
Run this command on a source data-fabric cluster to find out how many gateways are available for table replication to a destination data-fabric cluster, or for indexing table data in an Elasticsearch cluster.
This command uses the following criteria to get the list:
-
If you specified the locations of the gateways with the
cluster gateway set
command, themaprcli cluster gateway resolve
command returns the list of the gateways. -
If you specified the locations of the gateways only with a DNS record, this command performs a DNS lookup for gateways on the specified data-fabric cluster and returns the list that it finds.
-
If you did not specify the locations of the gateways using the previously listed methods, this command assumes that gateways are located on the CLDB nodes configured in the
mapr-clusters.conf
file on the data-fabric cluster where the command is run.
For more information about gateways, see MapR Gateways.
Syntax
- CLI
-
/opt/mapr/bin/maprcli cluster gateway resolve [ -cluster <cluster on which the command is to be run> ] -dstcluster <destination cluster name>
- REST
-
http[s]://<host>:<port>/rest/cluster/gateway/resolve?dstcluster=<clustername>
Parameters
Parameter | Description |
---|---|
cluster |
If you are not on the source data-fabric cluster, provide the name of the source cluster on which this command should run. |
dstcluster |
The name of the cluster for which you want to list the available gateways. If you are replicating table data to another data-fabric cluster, specify the name of that destination cluster. This destination cluster can be the source cluster if you are performing intra-cluster replication. If you are indexing table data in an Elasticsearch cluster, specify the name of the source data-fabric cluster because that is where the gateways are located. |
Example
This example shows that only one gateway is up and running on the data-fabric cluster cluster1
.
The IP address of this gateway was found in a DNS record, as indicated by the
Source
field.
- CLI
-
/opt/mapr/bin/maprcli cluster gateway resolve -dstcluster cluster1 -json
- REST
-
https://<host>:<port>/rest/cluster/gateway/resolve?dstcluster=cluster1
- Example Output
-
{ "timestamp":1424266395862, "timeofday":"2015-02-18 01:33:15.862 GMT+0000", "status":"OK", "total":1, "data":[ { "GatewayHosts":"10.10.20.12:7660", "Source":"DNS" } ] }