Changing the host name for a VOB replica

You can use the chreplica command (or the Property Browser on Windows) to change the host name for a VOB replica.

About this task

When you move a VOB 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".
Note: The hostname can also be represented by an IP address. For the syntax and a description of the –host option, see the chreplica reference page.

Procedure

  1. Display the properties of the replica. See Displaying properties of a VOB replica.
  2. On the General tab, type the new host name in the Host field.
  3. Click OK or Apply.