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

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.

Environment

CloudBees CI (CloudBees Core)
CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller
CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center
CloudBees CI (CloudBees Core) on traditional platforms - Client controller
CloudBees CI (CloudBees Core) on traditional platforms - Operations Center
CloudBees Jenkins Enterprise
CloudBees Jenkins Enterprise - Managed controller
CloudBees Jenkins Enterprise - Operations center
Jenkins LTS

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

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.