Home
Administering
Learn how to administer the product.
Administering HCL VersionVault MultiSite
Learn to configure and manage the HCL VersionVault MultiSite environment to support development activities at different locations.
Administering replicas
Managing mastership
Changing mastership of VOB objects
When you create an object in a replicated VOB, your current replica is the new object’s master replica. To transfer mastership of the object to another replica, use the chmaster command or the Properties Browser (Windows®).
Transferring mastership of a branch
When a branch is created, it is mastered by the replica that masters the branch type. This is called default mastership. When you transfer mastership of a branch to another replica, using the chmaster command, that replica now masters the branch. This is called explicit mastership.

Administering
Learn how to administer the product.
- Administering HCL VersionVault
  Learn about performing administrative tasks for an HCL VersionVault community including managing software licenses, user and group accounts, VersionVault server and client hosts, shared data, and the network that connects them.
- Administering platforms for HCL VersionVault
  Learn how to perform HCL VersionVault administrative tasks on supported platforms.
- Administering HCL VersionVault MultiSite
  Learn to configure and manage the HCL VersionVault MultiSite environment to support development activities at different locations.
  - Introduction
    HCL VersionVault MultiSite adds a powerful capability to HCL VersionVault. With MultiSite, developers at different locations can use the same HCL VersionVault versioned object base (VOB). For HCL VersionVault, each location (site) has its own copy (replica) of the VOB. At any time, changes made in one replica can be sent in update packets to other replicas. You can manage replicas by using the command-line tools.
  - MultiSite operation
  - Implementation planning
    Before you install and use HCL VersionVaultHCL Compass MultiSite, you need to plan your implementation.
  - MultiSite command set
    This section summarizes the commands for HCL VersionVault MultiSite and HCL VersionVault that display HCL VersionVault MultiSite information. There are a series of MultiSite commands and API functions that display or modify MultiSite information.
  - Packet transportation methods and configuration
    The method you choose for transporting packets between replicas depends on connectivity. If your replicas do not have IP connectivity, you must use a file-based transport method. If your replicas have connectivity, you can use the store-and-forward facility.
  - Feature levels
    Feature levels allow different replica hosts in a VOB family to run different versions of HCL VersionVault. You can raise the feature level of either a single replica host or an entire VOB family.
  - Creating VOB replicas
    Before creating a replica, you must make decisions about branching, mastership, identities and permissions preservation, and method of packet delivery.
  - Replica synchronization
    Replica synchronization uses the same export-transport-import procedure that is used during replica creation.
  - Administering replicas
    - Using the CLI and native GUIs
    - Managing mastership
      - Mastership commands for VOB objects
        You can use the command-line interface to manage mastership of VOB objects. On Windows®, many of the VersionVault and MultiSite interfaces (for example, Check Out, the Properties Browser, Request for Mastership, and so on) contain extended functionality that also supports managing mastership.
      - Displaying mastership information for VOB objects
        Mastership information that can be displayed for VOB objects includes the master replica of an object, all objects mastered by a particular replica, the mastership changes for an object, and settings for mastership requests.
      - Assigning branch mastership during element creation
        By default, when you create an element in a replicated VOB, mastership of the branch main for that element is assigned to the replica that masters the branch type main. You can override this default behavior by explicitly assigning mastership of the main branch when you create the element.
      - Changing mastership of VOB objects
        When you create an object in a replicated VOB, your current replica is the new object’s master replica. To transfer mastership of the object to another replica, use the chmaster command or the Properties Browser (Windows®).
        Transferring mastership of a type object
        When you create a type object, it is mastered by the replica where you create it. You can change the mastership of the type object using the chmaster command.
        Transferring mastership of a replica object
        When you create a new replica, its replica object is mastered by the replica at which you enter the mkreplica –export command. You can change the mastership of the replica object using the chmaster command.
        Transferring mastership of a VOB
        When you replicate a VOB for the first time, the VOB is mastered by the original replica. You can change the mastership of the VOB using the chmaster command.
        Transferring mastership of an element
        When you create a new element, it is mastered by the replica in which you create it. You can change the mastership of the element using the chmaster command.
        Transferring mastership of a branch
        When a branch is created, it is mastered by the replica that masters the branch type. This is called default mastership. When you transfer mastership of a branch to another replica, using the chmaster command, that replica now masters the branch. This is called explicit mastership.
        Removing explicit mastership of a branch
        A branch can have default or explicit mastership. You can use the chmaster –default command to return mastership of a branch to the replica that masters the branch type.
        Transferring mastership of a stream
        The chmaster –stream command transfers mastership of a stream and its associated objects.
        Transferring mastership of all objects mastered by a replica
        Before removing a replica, you must transfer mastership of all objects mastered by that replica, using the chmaster –all command.
      - Fixing an accidental mastership change
        If a mastership change is made in a replica by mistake, you can fix the problem by following the steps that are described in this topic.
      - Working with type objects
        When you create an attribute type, a hyperlink type, or a label type, you can make the type shared or unshared.
    - Implementing requests for mastership
      To support development of VOB elements that cannot be merged, you can give developers the ability to request mastership of branches and branch types.
  - Using MultiSite for VOB backup and interoperability
    You can use HCL VersionVault MultiSite to back up a VOB and to provide access to VOBs in a heterogeneous network.
  - Troubleshooting MultiSite operations
    When you encounter a situation where running an HCL VersionVault MultiSite command produces an unexpected result, or produces a warning or error message, the information in this section can assist you in troubleshooting the problem.

Transferring mastership of a branch

When a branch is created, it is mastered by the replica that masters the branch type. This is called default mastership. When you transfer mastership of a branch to another replica, using the chmaster command, that replica now masters the branch. This is called explicit mastership.

About this task

Procedure

At the master replica, enter a chmaster command:

MINUTEMAN% multitool chmaster –c "bugfix at bangalore" bangalore 
Makefile@@/main
Changed mastership of branch "Makefile@@/main" to "bangalore"

At the old master replica, export an update packet to the new master replica:

MINUTEMAN% multitool syncreplica –export –fship bangalore@/vobs/dev
 
Generating synchronization packet 
/opt/hcl/ccm/versionvault/shipping/ms_ship/outgoing/sync_boston_hub_1
0-Dec-02.18.15.57_3056_1
- shipping order file is
/opt/hcl/ccm/versionvault/shipping/ms_ship/outgoing/sh_o_sync_boston_
hub_10-Dec-02.18.15.57_3056_1
Attempting to forward/deliver generated packets...
-- Forwarded/delivered packet
/opt/hcl/ccm/versionvault/shipping/ms_ship/outgoing/sync_boston_hub_1
0-Dec-02.18.15.57_3056_1

At the new master replica, import the packet:

RAMOHALLI> multitool syncreplica –import –receive 
Applied sync. packet C:\Program Files\HCL\CCM\VersionVault\var\shipping
\ms_ship\incoming\sync_boston_hub_10-Dec-02.18.15.57_3056_1 to VOB 
\\ramohalli\vobs\dev.vbs

At the new master replica, verify that mastership has been received:

RAMOHALLI> multitool describe –fmt "%n\t%[master]p\n" Makefile@@\main
Makefile@@\main      bangalore@\dev

What to do next

For information about enabling use of the reqmaster command, see Implementing requests for mastership.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.