HCL VersionVault on the UNIX™ system and Linux™

The following issues are common to most or all variants of the UNIX™ system and Linux™ on which HCL VersionVault runs.

Limitations of native file backup and copy programs can affect VOB backup and copy operations

Before using native utilities such as tar and cpio to back up or copy VOBs, you must verify that the utility you are using can copy all of the files in the VOB database, regardless of how many there are or how large the largest file is. This is especially important for VOBs at schema version 54, feature level 5, or both.

Establishing the time zone

When establishing the time zone on a host, you must you must specify a full POSIX value for the TZ environment variable. For example:

TZ=EST5DST4,M410/02:00:00,M1050/02:00:00

If you do not, the HCL VersionVault scheduler will not work as designed during transitions into and out of daylight time. On hosts that support the zoneinfo library, you can use zoneinfo to establish the time zone correctly. For more information about the TZ environment variable and the values it can take, see the environ(5) man page for your host operating system.

Shared libraries

HCL VersionVault is implemented through a set of shared libraries. In addition, two shared libraries are supplied from vendors in versionvault-home-dir/shlib (where versionvault-home-dir is your installation directory, /opt/hcl/ccm/versionvault by default). The libraries are the C++ compiler library libC.so or libC.sl (depending on vendor; other possible shared C compiler library names follow the pattern libCstring.so, where string may be any short character string), and the EZ-RPC run-time library libezrpc.so (.sl). If the HCL VersionVault libraries in the versionvault-home-dir/shlib directory are missing, the HCL VersionVault executables do not run.

Installing in a nondefault installation directory

If you install HCL VersionVault software in a nondefault location (that is, other than in /opt/hcl/ccm), you must set the proper platform-dependent library search-path environment variable to include the versionvault-home-dir/shlib pathname so that HCL VersionVault executables can find the required shared libraries.

The order of the pathnames in the environment variable is important. At run time, an executable must find the supplied vendor libraries before it finds any other versions of those libraries in other paths in the list. Other applications that use this definition of the library search-path environment variable may find these supplied vendor libraries instead of other versions of those libraries installed on your system. This behavior may or may not be compatible with those applications. If the supplied vendor libraries are missing, the executables may search the system libraries (the order of search, where it searches, and whether it searches is platform dependent). If a library of the appropriate name is found, the execution may not succeed because the library found may not be compatible with the HCL VersionVault executable.

You need to define the search-path environment variable to allow HCL VersionVault executables to find their shared libraries. The search-path environment variable name for linux_x86_64 is LD_LIBARARY_PATH.

Enabling ACLs on locally stored VOBs on ext3 and ext4 filesystems

Attempts to enable ACLs can fail if the filesystem is not configured correctly. You may see errors like the following when creating a VOB:

cleartool: Warning: File system "s/sdft" does not support ACLs: Access control list too long or storage pool file system misconfigured for ACLs.
cleartool: Warning: File system "d/ddft" does not support ACLs: Access control list too long or storage pool file system misconfigured for ACLs.
cleartool: Warning: File system "c/cdft" does not support ACLs: Access control list too long or storage pool file system misconfigured for ACLs.

To configure the filesystem to support ACLs,

Edit the file /etc/fstab to change "defaults" to "acl".
Remount the filesystem: mount -o remount /var/tmp

xversionvault preferences can cause invalid memory allocation

When Group by Config Spec Rule or Group by Type is set in xversionvault preferences (by using the GUI or by editing the .xversionvault file), and its column is not visible in the xversionvault display, the display is not refreshed correctly after a checkin or checkout. As a result, an incorrect number of selected cells is reported, which can cause invalid memory allocation.

Platform compatibility with clearmake

You can run clearmake in compatibility modes that support certain platform-specific features of make. For more information, see VersionVault Guide to Building Software.

The lock manager

HCL VersionVault run a lock manager process on the UNIX™ system and Linux™. Database access for each VOB on a VOB server is now handled by the VOB's db_server process. This enables you to configure different database parameters for each VOB on your VOB server, which will allow your VOB server to accommodate more VOBs and users. To set default database parameters that apply to all VOBs on your server, configure the vob_almd_params file that is located in /opt/hcl/ccm/versionvault/config/vob/db. You can override these default settings for individual VOBs by configuring each VOB's vob_almd_params file, which is located in VOB-storage-dir/db/vob_almd_params. The syntax used in this file is as follows:

LOCKMGR_OPTS = -u num -q num

For more information about how to set the -u and -q parameters, see the VersionVault Administrator's Guide..

Issues relevant to specific platforms are discussed in the following topics: