Jump to main content
HCL Logo Product Documentation
  • Customer Support
HCL VersionVault V2.0.1
  • HCL VersionVault V2.0.1
  • Overview
  • Installing
  • Upgrading
  • Administering
  • Developing
  • Managing change and releases
  • Integrating
  • Tutorials
  • Extending product function
  • Reference
  • Glossary
  1. Home
  2. AdministeringLearn how to administer the product.
  3. Administering HCL VersionVault MultiSite
  4. Administering replicas
  5. Managing mastership
  • AdministeringLearn how to administer the product.
    • Administering HCL VersionVault
    • Administering platforms for HCL VersionVault
    • Administering HCL VersionVault MultiSite
      • IntroductionHCL 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 planningBefore you install and use HCL VersionVaultHCL Compass MultiSite, you need to plan your implementation.
      • MultiSite command setThis 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 configurationThe 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 levelsFeature 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 replicasBefore creating a replica, you must make decisions about branching, mastership, identities and permissions preservation, and method of packet delivery.
      • Replica synchronizationReplica 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 objectsYou 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 objectsMastership 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 creationBy 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 objectsWhen 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 changeIf 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 objectsWhen you create an attribute type, a hyperlink type, or a label type, you can make the type shared or unshared.
        • Implementing requests for mastershipTo 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 interoperabilityYou can use HCL VersionVault MultiSite to back up a VOB and to provide access to VOBs in a heterogeneous network.
      • Troubleshooting MultiSite operationsWhen 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.

Managing mastership

This chapter describes how to manage the mastership of objects in a replica. Before reading this chapter, read the information in Independent development: Mastership Modification management in multiple replicas: 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.
  • Disclaimer
  • Privacy
  • Terms of use
  • Cookie Preferences