Resolving YDK0001: "Preferences file ydkprefs.xml could not be located" error when running CDT

Resolving The Problem

This error is actually quite common when first configuring CDT.

Here's where to make some changes. In folder <YFS_HOME>\resources\ydkresources (or <YANTRA_HOME>\Applications\Foundation\resources\ydkresources, depending on version), there are two files, ydkconfig.xml and ydkprefs.xml, which must be modified to REPLACE references to generic placeholder <YFS_HOME> with a FULL PATH name.


For example, if the Sterling/Yantra Supply Chain Application is installed at C:\SCA:

1. ydkconfig.xml

Before: <ResourcesDir><YFS_HOME>/resources/ydkresources/</ResourcesDir>

After for SCA versions 7.6 or earlier: <ResourcesDir>C:/SCA/resources/ydkresources/</ResourcesDir>
or
After for SCA versions 7.7 or later: <ResourcesDir>C:/SCA/Runtime/resources/ydkresources/</ResourcesDir>

Note: The trailing slash '/' at the end of the path (just before closing tag) is REQUIRED!

2. ydkprefs.xml:

a. Before: <lastDir><YFS_HOME>\documentation\api_javadocs\XML</lastDir>

After for SCA versions 7.6 or earlier: <lastDir>C:\SCA\documentation\api_javadocs\XML</lastDir>
or
After for SCA versions 7.7 or later: <lastDir>C:\SCA\Runtime\documentation\api_javadocs\XML</lastDir>

b. Before: <workingDirectory><YFS_HOME>\webpages\portlets</workingDirectory>

After for SCA versions 7.6 or earlier: <workingDirectory>C:\SCA\webpages\portlets</workingDirectory>
or
After for SCA versions 7.7 or later: <workingDirectory>C:\SCA\Runtime\webpages\portlets</workingDirectory>


Note: For SCA versions 7.7 or later, this example would assume <YANTRA_HOME>=C:\SCA, and these changes should be made in the <YANTRA_HOME>\Applications\Foundation\resources\ydkresources folder instead. Then, when the Runtime is rebuilt, the changes are propogated to <YFS_HOME>=C:\SCA\Runtime and will not be lost on successive builds.