Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Using Hudson/Features controlled by system properties"
| Line 48: | Line 48: | ||
|- | |- | ||
| hudson.lifecycle | | hudson.lifecycle | ||
| − | | | + | | |
| + | | | ||
| Specify full class name for Lifecycle implementation to override default | | Specify full class name for Lifecycle implementation to override default | ||
|- | |- | ||
| Line 56: | Line 57: | ||
| Use shorter but cryptic names to avoid 256 character limit on paths in Cygwin | | Use shorter but cryptic names to avoid 256 character limit on paths in Cygwin | ||
|- | |- | ||
| + | | hudson.model.DownloadService.never | ||
| + | | false | ||
| + | | | ||
| + | | Suppress the periodic download of data files for plugins | ||
| + | |- | ||
| + | | hudson.model.Hudson.flyweightSupport | ||
| + | | was:false <br>1.337:true | ||
| + | | 1.318 | ||
| + | | Matrix parent job won't consume an executor when true | ||
| + | |- | ||
| + | | hudson.model.Hudson.killAfterLoad | ||
| + | | false | ||
| + | | | ||
| + | | Exit Hudson right after loading | ||
| + | |- | ||
| + | | hudson.model.Hudson.logStartupPerformance | ||
| + | | false | ||
| + | | | ||
| + | | Log startup timing info | ||
| + | |- | ||
| + | | hudson.model.Hudson.parallelLoad | ||
| + | | true | ||
| + | | | ||
| + | | Loads job configurations in parallel on startup | ||
| + | |- | ||
| + | | hudson.model.LoadStatistics.clock | ||
| + | | 10000 | ||
| + | | | ||
| + | | Load statistics clock cycle in milliseconds | ||
| + | |- | ||
| + | | hudson.model.LoadStatistics.decay | ||
| + | | 0.9 | ||
| + | | | ||
| + | | Decay ratio for every clock cycle in node utilization charts | ||
| + | |- | ||
| + | | hudson.model.Run.ArtifactList.listCutoff | ||
| + | | 16 | ||
| + | | 1.330 | ||
| + | | More artifacts than this will use tree view or simple link rather than listing out artifacts | ||
| + | |- | ||
| + | | hudson.model.Run.ArtifactList.treeCutoff | ||
| + | | 40 | ||
| + | | 1.330 | ||
| + | | More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view | ||
| + | |- | ||
| + | | hudson.model.UpdateCenter.never | ||
| + | | false | ||
| + | | | ||
| + | | When true, don't automatically check for new versions | ||
| + | |- | ||
| + | | hudson.model.WorkspaceCleanupThread.disabled | ||
| + | | false | ||
| + | | | ||
| + | | Don't clean up old workspaces on slave nodes | ||
| + | |- | ||
| + | | hudson.os.solaris.ZFSInstaller.disabled | ||
| + | | false | ||
| + | | | ||
| + | | True to disable ZFS monitor on Solaris | ||
| + | |- | ||
| + | | hudson.remoting.Launcher.pingIntervalSec | ||
| + | | 600 | ||
| + | | 1.367 | ||
| + | | Seconds between ping checks to monitor health of slave nodes; 0 to disable ping | ||
| + | |- | ||
| + | | hudson.remoting.Launcher.pingTimeoutSec | ||
| + | | 240 | ||
| + | | 1.367 | ||
| + | | If ping of slave node takes longer than this, consider it dead; 0 to disable ping | ||
| + | |- | ||
| + | | hudson.PluginStrategy | ||
| + | | | ||
| + | | | ||
| + | | Allow plugins to be loaded into a different environment, such as an existing DI container like Plexus; specify full class name here to override default ClassicPluginStrategy | ||
| + | |- | ||
| + | | hudson.scheduledRetention | ||
| + | | false | ||
| + | | Up to 1.354 | ||
| + | | Control a slave based on a schedule | ||
| + | |- | ||
| + | | hudson.scm.CVSSCM.skipChangeLog | ||
| + | | false | ||
| + | | | ||
| + | | Useful with ancient versions of CVS that don't support the -d option in the log command | ||
| + | |- | ||
| + | | hudson.security.csrf.requestfield | ||
| + | | .crumb | ||
| + | | 1.310 | ||
| + | | Parameter name that contains a crumb value on POST requests | ||
| + | |- | ||
| + | | hudson.security.ExtendedReadPermission | ||
| + | | false | ||
| + | | 1.324 | ||
| + | | The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin | ||
| + | |- | ||
| + | | hudson.security.ArtifactsPermission | ||
| + | | false | ||
| + | | 1.374 | ||
| + | | The Artifacts permission allows to control access to artifacts; When this property is unset or set to false, access to artifacts is not controlled | ||
| + | |- | ||
| + | | hudson.security.LDAPSecurityRealm.groupSearch | ||
| + | | Mouseover | ||
| + | | | ||
| + | | LDAP filter to look for groups by their names | ||
| + | |- | ||
| + | | hudson.security.WipeOutPermission | ||
| + | | false | ||
| + | | 2.1.1 | ||
| + | | Allows to manage "workspace wipe out" action permissions. | ||
| + | |- | ||
| + | | hudson.tasks.ArtifactArchiver.warnOnEmpty | ||
| + | | false | ||
| + | | | ||
| + | | When true, builds don't fail when there is nothing to archive | ||
| + | |- | ||
| + | | hudson.tasks.MailSender.maxLogLines | ||
| + | | 250 | ||
| + | | | ||
| + | | Number of lines of console output to include in emails | ||
| + | |- | ||
| + | | hudson.TreeView | ||
| + | | false | ||
| + | | | ||
| + | | Experimental nested views feature | ||
| + | |- | ||
| + | | hudson.triggers.SCMTrigger.starvationThreshold | ||
| + | | 1 hour | ||
| + | | Milliseconds waiting for polling executor before trigger reports it is clogged | ||
| + | |- | ||
| + | | hudson.udp | ||
| + | | 33848 | ||
| + | | | ||
| + | | Port for UDP multicast broadcast | ||
| + | |- | ||
| + | | hudson.upstreamCulprits | ||
| + | | false | ||
| + | | 1.327 | ||
| + | | Pass blame information to downstream jobs | ||
| + | |- | ||
| + | | hudson.Util.noSymlink | ||
| + | | false | ||
| + | | | ||
| + | | True to disable creation of symbolic links in job/builds directories | ||
| + | |- | ||
| + | | hudson.util.ProcessTree.disable | ||
| + | | false | ||
| + | | | ||
| + | | True to disable cleanup of child processes | ||
| + | |- | ||
| + | | hudson.util.Secret.provider | ||
| + | | | ||
| + | | 1.360 | ||
| + | | Force a particular crypto provider; with Glassfish Enterprise set value to SunJCE to workaround a known issue. | ||
| + | |- | ||
| + | | hudson.Util.symlinkEscapeHatch | ||
| + | | false | ||
| + | | | ||
| + | | True to use exec of "ln" binary to create symbolic links instead of native code | ||
|} | |} | ||
| − | + | === No compatibility guarantee === | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
In general, these switches are often experimental in nature, and subject to change without notice. If you find some of those useful, please file a ticket to promote it to the official feature. | In general, these switches are often experimental in nature, and subject to change without notice. If you find some of those useful, please file a ticket to promote it to the official feature. | ||
Revision as of 20:24, 6 December 2012
This article is a stub. It will be expanded as content is migrated from the Hudson-CIWeb site.
+ Hudson Features Controlled with System Properties +
Hudson has several "hidden" features that can be enabled with system properties. System properties are defined by passing -D<property name>=<value> when you start Hudson. The following table lists the properties and the version of Hudson they were introduced in.
Property - Java property name Default - Default value if not explicitly set Version - The version of Hudson the property was introduced in Notes - Other notes
| Property | Default | Version | Notes |
| hudson.ClassicPluginStrategy.useAntClassLoader | false | 1.316 | |
| hudson.consoleTailKB | 150 | How many KB of console log to show in default console view | |
| hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceTheshold | 1073741824 | 1.339 | The notification threshold for when the Hudson home directory is running low on disk space, in bytes. |
| hudson.diyChunking | false | Set to true if the servlet container doesn't support chunked encoding. | |
| hudson.DNSMultiCast.disabled | false | 1.359 | Set to "true" to disable DNS multicast |
| hudson.Functions.autoRefreshSeconds | 10 | 1.365 | Number of seconds between reloads when Auto Refresh is enabled |
| hudson.lifecycle | Specify full class name for Lifecycle implementation to override default | ||
| hudson.matrix.MatrixConfiguration.useShortWorkspaceName | false | Use shorter but cryptic names to avoid 256 character limit on paths in Cygwin | |
| hudson.model.DownloadService.never | false | Suppress the periodic download of data files for plugins | |
| hudson.model.Hudson.flyweightSupport | was:false 1.337:true |
1.318 | Matrix parent job won't consume an executor when true |
| hudson.model.Hudson.killAfterLoad | false | Exit Hudson right after loading | |
| hudson.model.Hudson.logStartupPerformance | false | Log startup timing info | |
| hudson.model.Hudson.parallelLoad | true | Loads job configurations in parallel on startup | |
| hudson.model.LoadStatistics.clock | 10000 | Load statistics clock cycle in milliseconds | |
| hudson.model.LoadStatistics.decay | 0.9 | Decay ratio for every clock cycle in node utilization charts | |
| hudson.model.Run.ArtifactList.listCutoff | 16 | 1.330 | More artifacts than this will use tree view or simple link rather than listing out artifacts |
| hudson.model.Run.ArtifactList.treeCutoff | 40 | 1.330 | More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view |
| hudson.model.UpdateCenter.never | false | When true, don't automatically check for new versions | |
| hudson.model.WorkspaceCleanupThread.disabled | false | Don't clean up old workspaces on slave nodes | |
| hudson.os.solaris.ZFSInstaller.disabled | false | True to disable ZFS monitor on Solaris | |
| hudson.remoting.Launcher.pingIntervalSec | 600 | 1.367 | Seconds between ping checks to monitor health of slave nodes; 0 to disable ping |
| hudson.remoting.Launcher.pingTimeoutSec | 240 | 1.367 | If ping of slave node takes longer than this, consider it dead; 0 to disable ping |
| hudson.PluginStrategy | Allow plugins to be loaded into a different environment, such as an existing DI container like Plexus; specify full class name here to override default ClassicPluginStrategy | ||
| hudson.scheduledRetention | false | Up to 1.354 | Control a slave based on a schedule |
| hudson.scm.CVSSCM.skipChangeLog | false | Useful with ancient versions of CVS that don't support the -d option in the log command | |
| hudson.security.csrf.requestfield | .crumb | 1.310 | Parameter name that contains a crumb value on POST requests |
| hudson.security.ExtendedReadPermission | false | 1.324 | The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin |
| hudson.security.ArtifactsPermission | false | 1.374 | The Artifacts permission allows to control access to artifacts; When this property is unset or set to false, access to artifacts is not controlled |
| hudson.security.LDAPSecurityRealm.groupSearch | Mouseover | LDAP filter to look for groups by their names | |
| hudson.security.WipeOutPermission | false | 2.1.1 | Allows to manage "workspace wipe out" action permissions. |
| hudson.tasks.ArtifactArchiver.warnOnEmpty | false | When true, builds don't fail when there is nothing to archive | |
| hudson.tasks.MailSender.maxLogLines | 250 | Number of lines of console output to include in emails | |
| hudson.TreeView | false | Experimental nested views feature | |
| hudson.triggers.SCMTrigger.starvationThreshold | 1 hour | Milliseconds waiting for polling executor before trigger reports it is clogged | |
| hudson.udp | 33848 | Port for UDP multicast broadcast | |
| hudson.upstreamCulprits | false | 1.327 | Pass blame information to downstream jobs |
| hudson.Util.noSymlink | false | True to disable creation of symbolic links in job/builds directories | |
| hudson.util.ProcessTree.disable | false | True to disable cleanup of child processes | |
| hudson.util.Secret.provider | 1.360 | Force a particular crypto provider; with Glassfish Enterprise set value to SunJCE to workaround a known issue. | |
| hudson.Util.symlinkEscapeHatch | false | True to use exec of "ln" binary to create symbolic links instead of native code |
No compatibility guarantee
In general, these switches are often experimental in nature, and subject to change without notice. If you find some of those useful, please file a ticket to promote it to the official feature.