Create an Administration Process on a Specific Storage Node

Every data store has an administration database. The Admin CLI is currently connected to the Storage Node node01. Use the deploy-sn command to deploy the Storage Node node01. You then use the command deploy-admin to deploy an Administration process on the same Storage Node node01 to continue configuring this data store.

The deploy-admin command creates an Administration process, with the same type as the Storage Node (SN) zone — if the zone is primary, the Admin is a primary Admin; if a secondary zone, so is the Admin.

Secondary Admins support failover. If a primary Admin fails, it converts to an offline secondary to re-establish quorum using existing Admins. A secondary Admin converts to a primary to take over for the failed primary. For more information on how quorum is applied, see the Concepts Guide.

To support failover, ensure that any zones used to continue data store operation after a failure contain at least one Admin node.

Note:

A deployed Admin must be the same type (PRIMARY or SECONDARY) as its zone. Also, the number of deployed Admins in a zone should be equal to the Zone Replication Factor.

The deploy-sn command requires a Zone ID. You can get this ID by using the show topology command:

kv-> show topology
store=mystore  numPartitions=0 sequence=1
zn: id=zn1 name=Boston repFactor=1 type=PRIMARY
allowArbiters=false masterAffinity=false

The zone ID is zn1 in the output.

When you deploy the Storage Node, provide the zone ID, the node's network name, and its registry port number. For example:

kv-> plan deploy-sn -zn zn1 -host <hostname> -port 5000 -wait
Executed plan 2, waiting for completion...
Plan 2 ended successfully 

Having deployed the Storage Node, create the Admin process on the Storage Node that you just deployed, using the deploy-admin command. This command requires the Storage Node ID (which you can obtain using the show topology command) and an optional plan name.

kv-> plan deploy-admin -sn sn1 -wait
Executed plan 3, waiting for completion...
Plan 3 ended successfully