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
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.
Determining whether a type object is shared or unshared
On Windows®, the Properties Browser displays the kind of mastership on the Mastership tab. You can also use the describe and lstype commands.

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®).
      - 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.
        Creating a shared type object
        When you create a type object, you can specify that the type object is shared using the –shared option with the command that creates the object.
        Determining whether a type object is shared or unshared
        On Windows®, the Properties Browser displays the kind of mastership on the Mastership tab. You can also use the describe and lstype commands.
        Converting a type object from unshared to shared
        You can convert an unshared attribute type, hyperlink type, or label type to be shared.
    - 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.

Determining whether a type object is shared or unshared

On Windows®, the Properties Browser displays the kind of mastership on the Mastership tab. You can also use the describe and lstype commands.

About this task

Procedure

The describe command includes the kind of mastership in its output:

cleartool describe attype:TESTED
attribute type "TESTED"
created 15-Aug-00.14:23:27 by Susan Goechs (susan.user@minuteman)
master replica: boston_hub@/vobs/dev
instance mastership: shared
...

You can also use the –fmt option to display only the kind of mastership.
For example, to list the mastership kind of a single type object:
```
cleartool describe –fmt "%n\t%[type_mastership]p\n" attype:TESTED 
TESTED    shared
```

To list the mastership kind of all label types in a VOB replica:

cleartool lstype –fmt "kind lbtype 
BACKSTOP        shared
BANGALORE_BASE  unshared
BUENOSAIRES_BASE        unshared
CHECKEDOUT      shared
LATEST  shared
BOSTON_BASE        unshared
SANFRAN_BASE    unshared
V1.0    unshared
V2.0    unshared

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.