Troubleshooting
Problem
This technote explains why the error, text_file_delta: Error: Trouble accessing file
"
Symptom
Checkin of a text file produces the following error:
% cleartool ci -nc
/vobs/myvob/largefile.txt
text_file_delta: Error: Trouble accessing file
"/net/host1/vob_data/my_vob.vbs/s/sdft/7/d/tmp_4101.1": File too large
cleartool: Error: Type manager "text_file_delta" failed create_version
operation.
cleartool: Error: Unable to check in
"/vobs/myvob/largefile.txt"
Another example of this error reads:
text_file_delta: Error: Trouble writing to file
"/net/host1/vob_data/my_vob.vbs/s/sdft/7/d/tmp_4101.1": File too large.
Type manager "text_file_delta" failed create_version operation.
Unable to check in "/vobs/myvob/largefile.txt".
Failed to check in largefile.txt
Cause
The file version container size exceeds the 2 gigabyte (GB) limitation of the type manager. Note that the actual 2 GB limitation value may vary slightly based upon your OS platform.
The 2 GB limitation on all text and binary type managers exist in ClearCase versions 2002.05.00 and 2003.06.00; however, this limitation was partially lifted as of ClearCase 7.0 which supports files greater than 2 GB for particular type managers. ClearCase and ClearCase Multisite version 7.0 introduced support for large files, which enables certain types of VOB elements to grow beyond 2 GB.
Attempts to access the 2 GB object or element with an earlier version of ClearCase (prior to 7.0) will result in File too large errors.
Review the ClearCase 7.0 Release Notes for more information about the changes. Also, review technote 1127322 for additional information.
Resolving The Problem
ClearCase 7.0
Change the type of the element using cleartool chtype to change the type manager of the file to a binary type manager or other that can handle a file size larger than 2 GB.
All ClearCase Versions
Change the element type of the file using cleartool chtype to change the way the containers are managed.
Elements managed using a text file type manager have a single container per element, thus text files with lots of versions can cause the container to grow beyond 2 GB. Changing from "text_file" to "compressed_file" for example moves the content from one source container per element to one source container per version, and will help prevent files with large version deltas from exceeding the max container size.
Changing from "text_file" to something managed by "binary_delta_file" for example will change from one source container per element to one source container per branch, providing more flexibility with your version control.
Note: If you have a single version of a file that is larger that 2GB, you will run into problems with the container limitation unless you upgrade to 7.0 or later and use one of the new element types.
Example:
- M:\admin_vu\vob1>cleartool co -nc myfile.txt
Checked out "myfile.txt" from version "\main\2".
- M:\admin_vu\vob1>cleartool ci -nc myfile.txt
text_file_delta: Error: Trouble accessing file
"\\host1\vob_data\my_vob1.vbs\s\sdft\7\d\tmp_5801.1": File too large
cleartool: Error: Type manager "text_file_delta" failed create_version operation.
cleartool: Error: Unable to check in "myfile.txt"
- M:\admin_vu\vob1>cleartool describe myfile.txt
version "myfile.txt@@\main\CHECKEDOUT" from \main\2 (reserved)
checked out 16-Mar-06.16:24:11 by jdoe.ccuser@HOST1
by view: admin_vu ("HOST1:C:\Storage\views\admin_vu.vws")
Element Protection:
User : DOM1\jdoe : r--
Group: DOM1\ccuser : r--
Other: : r--
element type: text_file
predecessor version: \main\2
- M:\admin_vu\vob1>cleartool chtype compressed_file myfile.txt
Change version manager and reconstruct all versions for "myfile.txt"? [no] yes
Changed type of element "myfile.txt" to "compressed_file".
- M:\admin_vu\vob1>cleartool describe myfile.txt
version "myfile.txt@@\main\CHECKEDOUT" from \main\2 (reserved)
checked out 16-Mar-06.16:24:11 by jdoe.ccuser@HOST1
by view: admin_vu ("HOST1:C:\Storage\views\admin_vu.vws")
Element Protection:
User : DOM1\jdoe : r--
Group: DOM1\ccuser : r--
Other: : r--
element type: compressed_file
predecessor version: \main\2
- M:\admin_vu\vob1>ct ci -nc myfile.txt
Checked in "myfile.txt" version "\main\3".
For more information on type managers or cleartool chtype, refer to IBM Rational ClearCase Command Reference, or run cleartool man type_managers | chtype from command line.
Related Information
Was this topic helpful?
Document Information
Modified date:
29 September 2018
UID
swg21146566