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
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.
Listing an object’s master replica
You can find the master replica for an object using the cleartool describe command and also on the Mastership page in the Properties Browser on Windows®.

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.
        Listing an object’s master replica
        You can find the master replica for an object using the cleartool describe command and also on the Mastership page in the Properties Browser on Windows®.
        Listing objects mastered by a replica
        The lsmaster command lists the objects mastered by a VOB replica. The command uses the information at your current replica unless you use the –inreplicas option, which retrieves information from sibling replicas.
        Listing the history of mastership changes for an object
        The lshistory –minor command and the History Browser (with the Include minor events toolbar icon selected) list mastership changes for an object.
        Displaying mastership request settings
        The describe command and (on Windows®) the Mastership page in the Properties Browser display mastership request settings for replicas, branch types, and branches.
      - 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®).
      - 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.

Listing an object’s master replica

You can find the master replica for an object using the cleartool describe command and also on the Mastership page in the Properties Browser on Windows®.

About this task

Procedure

To list an object’s master replica, use one of the following methods:


Method	Description
Mastership page in the Properties Browser (Windows®)	This page lists the object’s master replica.
cleartool describe object-selector	This command lists general information about the object, including its master replica.
cleartool describe –fmt "%[master]p\n" object-selector	This command lists only the master replica of the object. For more information about the –fmt option, see the fmt_ccase reference page in the VersionVault Command Reference.

Example

Examples:

To list a replica object’s master replica:


cleartool describe replica:boston_hub@\dev
replica "boston_hub"
created 15-Aug-00.14:19:03 by susan.user
replica type: unfiltered
master replica: boston_hub@\dev
...

To list an element’s master replica:

cleartool describe –fmt "%n\t%[master]p\n" cmdsyn.c@@
cmdsyn.c@@      bangalore@/vobs/dev

To list a type object’s master replica:

cleartool describe lbtype:V1.0@/vobs/dev
label type "V1.0" 
  created 25-Aug-00.12:14:52 by Susan Goechs (susan.user@minuteman)
  master replica: boston_hub@/vobs/dev
...

To list a branch’s master replica:

cleartool describe –fmt "%n\t%[master]p\n" cmdsyn.c@@\main\v3_bugfix

cmdsyn.c@@\main\v3_bugfix boston_hub@\dev

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.