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.
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.
Descriptions of subcommands
Replica creation, synchronization, and management commands
The commands in this topic create new replicas, change replica characteristics, and synchronize replicas, and display replica-related information.

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.
    - Location of HCL VersionVault MultiSite programs
      The HCL VersionVault MultiSite installation places programs and configuration files in the HCL VersionVault installation area on a host. (versionvault-home-dir refers to both the HCL VersionVault and HCL VersionVault MultiSite installation directory).
    - multitool use
      The multitool command is used to perform operations on VOB replicas.
    - Descriptions of subcommands
      - Replica creation, synchronization, and management commands
        The commands in this topic create new replicas, change replica characteristics, and synchronize replicas, and display replica-related information.
      - Object mastership commands
        The commands in this topic are used to manage mastership.
      - Failure-recovery commands
        The commands in this topic are used to work with epoch numbers.
      - multitool utility commands
        This topic lists the multitool utility commands, providing a short description of each one.
    - Additional MultiSite commands
      The MultiSite commands that are not multitool multiutil subcommands are listed in this topic. These commands are located under the installation directory for HCL VersionVault.
    - HCL VersionVault commands related to HCL VersionVault MultiSite
      This topic lists the HCL VersionVault commands that pertain to HCL VersionVault MultiSite, providing a short description of each one.
    - View contexts and VOB mounts
      Most MultiSite commands do not require a view context or mounting of the VOB replicas being processed. However, there are some advantages to running MultiSite commands in a view, with the VOB mounted.
    - Specifying VOBs in commands
      multitool commands use the vob-selector argument to specify a VOB family.
  - 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 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.

Replica creation, synchronization, and management commands

The commands in this topic create new replicas, change replica characteristics, and synchronize replicas, and display replica-related information.

Table 1. Replica creation, synchronization, and management commands
Command	Description
activate	Prepares a database set to be replicated
chreplica	Changes the properties of a replica
chsetting	Changes synchronization management settings
deactivate	Returns the last replica in a clan to a nonreplicated state
dumpoplog	Displays the contents of a replica’s oplog
idblockinfo	Lists information about the ID blocks for a replica family
lspacket	Lists one or more packet files created by mkreplica or syncreplica
lsreplica	Lists one or more replicas
lssetting	Displays information about synchronization management settings
mkreplica	Creates a new replica
renamesite	Renames a site
rmreplica	Removes a replica
scruboplog	Deletes oplog entries
syncreplica	Synchronizes a replica with one or more replicas in its family

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.