Setting a shorter file path for production export

book

Article ID: 100043100

calendar_today

Updated On:

Description

Error Message

The following error is displayed under IGC component logs at D:\CW\\logs\component-logs:
[processpool.igc.IGCConvertCallable] (IGCConverter-PDF-thread-14-22:) [#670209] "Imaging failed due to an unknown error. [publish_error]

The “Target/source full path length is xxx characters, greater than maximum allowed of 260, publish may fail” error/warning is displayed in the IGC Windows service’s job status logs at http://localhost:7070/log on your master appliance.


If you see above listed error messages, then you should perform the following steps.

Cause

This limitation is because IGC supports file paths with a maximum limit of 260 characters only. This issue mainly appears in a pure IPv6 setup.

Example of a file path in IPv6 environment:
fe80-0-0-0-c16f-3b24-e26a-ca13s12.ipv6-literal.net\D$\CW\V90\data\Worker1\dataStore_case_akbjpa837c_79879712\fileManager\0.14.56.1\jobRun_24__fileMgr__tmp\xe_tmp\tempFiles\d26\bce\ff831b500b4a10f95686874bb5\conv-1\image\0.7.65.5115_MixedMode_Production_Slipsheet.tif

In this example, <fe80-0-0-0-c16f-3b24-e26a-ca13s12.ipv6-literal.net> is the IPv6 machine name which results into a longer path.

Resolution

Users can get this error in Caching, Bulk Redaction, Production, or Production/Metadata export workflows. A workaround to fix this issue is mentioned below.

  1. Caching, Bulk Redaction, and Production jobs
    Set the cache location for Temp and Perm cache to an external location (by using the property esa.cluster.externalBaseDir) as mentioned in the “Moving Cache (On or Off) the Appliance” section of the System Administration Guide. Please refer to the Note below for specifications on the file path length of the cache location.
  2. Production/Metadata export jobs
  • Set the cache location for Temp and Perm cache to an external location (by using the property esa.cluster.externalBaseDir) as mentioned in the “Moving Cache (On or Off) the Appliance” section of the System Administration Guide. Please refer to the Note below for specifications on the file path length of the cache location.
  • Change the default export output location using the property esa.export.joboutput.external as mentioned in the “Export to an External Drive “ section of the Export and Production Guide.

Guidelines for setting the value of these two properties:

Ensure that the length of the file path (i.e. value of these properties) excluding the <hostname> should be less than or equal to 30 characters.
For example: in \D$\data\cwexport, the length of the file path “\D$\data\cwexport” is less than 30 characters.

 

Issue/Introduction

Production export fails on IGC for files with a full source path or full target path longer than 260 characters. The file name characters are also included in the 260 characters length.