Hi Danny,

We're investigating this issue.

Nick Edgar had a suggestion, "One possible workaround is to exclude the component with symbolic links from being loaded by the plugin (in the build definition), then add an extra step and use the SCM CLI to load the 3rd component."

I've adjusted the priority using the Jenkins guidelines,

Blocker
Blocks development and/or testing work, production could not run.
Critical
Crashes, loss of data, severe memory leak.
Major
Major loss of function.
Minor
Minor loss of function, or other problem where easy workaround is present.
Trivial
Cosmetic problem like misspelled words or misaligned text

Also Danny, could you indicate which platform and version of the build toolkit you're using?

Thanks,
Scott

RTC support for symbolic links requires one or two libraries (.dll/.so files).

• Eclipse file system natives
• RTC file system natives

The reason is Java 6 and earlier don't have support for creating/looking at properties of symbolic links. So RTC uses some C code to manage symbolic links.

Java 7 has symbolic link support that works on linux, but on Windows it has some limitations when creating links when the target has not yet been created (type is defaulted to file which is not good if its a directory).

If you are running Linux and can use Java 7 then the only .so you need is for the Eclipse natives. Otherwise, you will need both.

I'll describe what has to happen on Windows, but the steps are similar for linux.

In the Build engine directory (buildengine\eclipse\plugins), look for the
com.ibm.team.filesystem.client_3.1.600.v20130415_0257.jar
org.eclipse.core.filesystem.win32.x86_1.1.201.R36x_v20100727-0745.jar or equivalent jars for your platform/release.

From the com.ibm.team.filesystem.client jar you want to extract the winfsnatives.dll (libfsnatives.so on linux). Take all the .dll/.so from the org.eclipse.core.filesystem jar. Place them directly in a directory (eg. c:\natives\winfsnatives.dll).

Now when you start Jenkins, we need to tell java about the directory so that it can load the libraries from it. This is done through the -Djava.library.path variable.
eg. java -Djava.library.path="c:\natives;%Path%" -jar jenkins-1.509.1.war

We are just adding to what the default would be for Java. You could also add the directory to your path instead.

I realize the setup is a little convoluted, we could probably help by packaging the toolkit a bit differently. But this might be simpler than trying to load the component through the CLI.

Also, looking at the trace included leads me to think that your sandbox (place where the load is occurring) is corrupted. The lack of symbolic link support should have generated a nicer error message. So I would also recommend that you delete everything that has been loaded before you try it out.

Finally, if you are running on Windows, you need to be sure that you have permission to create symbolic links. The Symbolic links article in the jazz.net library https://jazz.net/library/article/970/ describes how.

Danny had responded by email (before Heather's responses above):
>> This is a tricky one, since the ability to create a symbolic link can also be limited by the OS (Win 7 supports it, by requires updated user & application security settings. Win XP requires a patch). However the system and userids I’m using are set-up to allow the creation of symbolic links. Therefore it stands to reason it’s either the application security settings, or the ‘inability’ of the application.
>> Regarding the ability of the application: If you’re utilizing the (l)scm load command, it usually does create the symbolic links when we start it from the command line in a CMD file ourselves. If run the same CMD file in a Jenkins Job, it usually doesn’t. We haven’t been able to figure out why…
>> Regarding the security settings to allow creation of symlinks: Can you indicate what the (user/application security) settings should be, to allow the plugin to create symbolic links on Win7?
>> You have a good suggestion, but it’s only a workaround. We’re currently looking into it.

Hopefully the article Heather linked to above helps with the question of settings.