Changing the @ separator character for workspace folders when concurrent builds are enabled

Article ID:360055788811
1 minute readKnowledge base

Issue

  • You are facing issues seeing or parsing the workspace folder name when concurrent builds are enabled and the workspace name contains the "@" character.

  • You need to change this "@" separator character for your workspace folder to a different one.

Resolution

System properties are defined by passing -Dproperty=value to the java command line to start Jenkins. This separator character on the workspace folder name is defined by the hudson.slaves.WorkspaceList property, that by default is set to @.

Please refer to the "Usage" section on this article to see how to apply these properties. See the below example:

java -Dhudson.slaves.WorkspaceList=newCharacter -jar jenkins.war

Please also make sure to pass all of these arguments before the -jar argument, otherwise they will be ignored.

References

How to add Java arguments to Jenkins? and just mention the property