Home
Installing
Learn how to install the product.
Deploy HCL VersionVault
Read these topics for information about planning, installing, and configuring your HCL VersionVault deployment.
Configuring your environment after deploying
For some types of HCL VersionVault and HCL VersionVault MultiSite hosts, you must complete some configuration tasks after you have installed the products.
Set up ACLs on new and existing VOBs
Before you introduce ACL-enabled VOBs into the VersionVault environment, complete administrative tasks to prepare the VOB to support and enforce ACLs.
Check VOB health before enabling ACLs
Before enabling ACLs, use the checkvob command to check the health of your VOB, its elements, and their containers.

Installing
Learn how to install the product.
- HCL VersionVault Release Notes
  To learn about the changes in the product, see the release notes.
- Deploy HCL VersionVault
  Read these topics for information about planning, installing, and configuring your HCL VersionVault deployment.
  - Requirements
    Review the requirements information to identify system requirements, prerequisite tasks, and other information needed to successfully install or upgrade HCL VersionVault and HCL VersionVault MultiSite
  - Plan your deployment
    Review a checklist of required and optional tasks with links to additional information for planning the installation and deployment process for HCL VersionVault and HCL VersionVault MultiSite.
  - Install HCL VersionVault clients and servers
    The method that is used to install HCL VersionVault depends on the target platform and on your installation strategy.
  - Configuring your environment after deploying
    For some types of HCL VersionVault and HCL VersionVault MultiSite hosts, you must complete some configuration tasks after you have installed the products.
    - Completing the installation on a registry server host
      To complete installation of a registry server host, you must create a VOB-tag password file on that registry server host.
    - Verifying installation on individual hosts
      Perform these tasks to determine whether HCL VersionVault is properly configured for an individual host. On Linux and UNIX systems, enter the commands listed in a shell. On Windows™, enter them at the command prompt.
    - Administering HCL VersionVault and HCL VersionVault MultiSite
    - Configure VersionVault WAN server
    - Customizing a client host environment for HCL VersionVault
      If you are installing for the first time on your client host, you might want to customize your environment to make it easier to use HCL VersionVault.
    - Set up ACLs on new and existing VOBs
      Before you introduce ACL-enabled VOBs into the VersionVault environment, complete administrative tasks to prepare the VOB to support and enforce ACLs.
      - ACL enforcement and enablement
        Review information about ACL enforcement and enablement and supporting clients and servers in mixed version environments.
      - Check VOB health before enabling ACLs
        Before enabling ACLs, use the checkvob command to check the health of your VOB, its elements, and their containers.
      - Setting up ACL-enabled VOBs
        VOBs created in VersionVault are enabled for ACLs by default. To set up the ACL access rules, define the ACLs for the VOBs and test them in a limited environment before enabling ACL enforcement for all VOB users.
    - Integrating HCL VersionVault with other products
      Learn how to integrate HCL VersionVault with other products.
    - VersionVault on AWS
    - VersionVault and Docker containers
      HCL VersionVault supports deploying a Linux container capable of using dynamic views.
- Use IBM® installation and packaging utilities
  Use IBM installation and packaging utilities to download and install software.

Check VOB health before enabling ACLs

Before enabling ACLs, use the checkvob command to check the health of your VOB, its elements, and their containers.

Check that all necessary source containers are present in the VOB

Use the cleartool checkvob -pool -source command to check the source containers. Fix any errors before you proceed with the VOB upgrade. If you have missing source containers, contact HCL Customer Support for assistance with repairing your VOB.

Check owners and groups on all VOB elements

Use the elem-owner-check.pl script on the VOB to be upgraded to verify that all VOB elements are owned by known users and a group that is in the VOB's group list. The script

Runs vob_sidwalk through the VOB.
Reports a summary of all elements that are owned by invalid users or groups.
Generates a command script to fix problems in /tmp/ct-fix.sh.

Before running the generated script, verify that the suggested owner-users and owner-groups are correct. For example, before enabling ACLs, you can run this command:

ratlperl elem-owner-check.pl /vobs/my_source /tmp/ct-fix.sh

The elem-owner-check.pl script is located in %CLEARCASEHOME%/etc/utils/elem-owner-check.pl. If necessary, use the full path to ratlperl, /opt/hcl/common/bin/ratlperl, for example.

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.