7.3 Changing the Host Name for a Replica

When you move a replica's storage directory to a different host, or when you rename a replica's host, you must update the host name in the replica's VOB database. The database keeps track of the hosts on which the replicas in a VOB family reside so that the store-and-forward facility can determine how to route updates to the replicas.

To change the host name, use the chreplica command or the Properties Browser (Windows). The change is not propagated to other replicas in the VOB family until you export an update packet from the current replica and the packet is imported at the other replicas. For restrictions, see the chreplica reference page.

To change a host name using the chreplica command:

multitool chreplica -host mardelplata buenosaires@/vobs/dev
Updated replica information for "buenosaires".

To change a host name using the Properties Browser:

1. Display properties of the replica. See Displaying Properties of a Replica.

2. On the General tab, type the new host name in the Host box.

3. Click OK or Apply.