You are here: Reference Manual > Client-side Commands (VTL) > vtl haAdmin subCommands > vtl haAdmin addMember Client Command

Client-Computer HAadmin Commands (vtl)

vtl haAdmin addMember Client Command

NAME

 vtl haAdmin -addMember   - Add a member to an HA group

SYNOPSIS

vtl haAdmin -addMember -group <groupNum> -serialNum <SN> -password <password>

DESCRIPTION

Add a member to a HA group that already exists on this client. If network replication is allowed on the partition, the new member will share the same HA key as the existing members in the group.

Use the command vtl haAdmin -synchronize to replicate any objects on other group members to the new member (only works if network replication is allowed - if network replication is not allowed, use the lunash:> partition backup and partition restore commands to manually copy objects among the HA group members.)

 

OPTIONS

-group <groupNum>  [mandatory] The HA group's number. Group numbers can be found using the vtl haAdmin -listGroups command.

-serialNum <SN>  [mandatory] The serial number of the partition to add to the group. The partition's serial number can be obtained using 'partition -show' from the lunash, or by using C_GetTokenInfo via a PKCS#11 application such as ckdemo. All partitions have unique serial numbers.

-password <password>  [mandatory] The text password for the partitions. The password must be the same as other partitions in the group or an error will occur.

SAMPLE OUTPUT


vtl haAdmin -addMember -group testgroup -serial 66010002 -password testpassword
Member 66010002 successfully added to group testgroup. New group configuration is:
HA Group Label:  testgroup
HA Group Number:  165010001
HA Group Slot#:  6
Synchronization: enabled
Group Members:  65010001, 66010002
Standby members: <none>
  In sync:  yes

Please use the command 'vtl haAdmin -synchronize' when
you are ready to replicate data between all members of the
HA group. (If you have additional members to add, you may
wish to wait until you have added them before synchronizing
to save time by avoiding multiple synchronizations.)

Notice here that you are told to synchronize - do NOT synchronize if you intend to perform a recovery. Synchronization occurs automatically when you use the vtl haAdmin recover command.

 

See Also