IBM Support

File too large error accessing or checking in a text file

Troubleshooting


Problem

This technote explains why the error, text_file_delta: Error: Trouble accessing file "": File too large, might occur while attempting to checkin a text file on Microsoft® Windows®, UNIX® and Linux®.

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:

  1. M:\admin_vu\vob1>cleartool co -nc myfile.txt
    Checked out "myfile.txt" from version "\main\2".

  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"

  3. 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

  4. 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".

  5. 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

  6. 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.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Type Manager","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2002.05.00;2003.06.00;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Cleartool","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Type Manager","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Cleartool","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 September 2018

UID

swg21146566