Home >

Utilities Reference Guide > VTL > vtl haAdmin addMember

vtl haAdmin addMember

Name

 vtl haAdmin addMember   - Add a member to an HA group

Syntax

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.

Example

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.)

Note:  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.