Notice: This Wiki is now read only and edits are no longer 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"
m (Features controlled by system properties moved to Using Hudson/Features controlled by system properties) |
|||
(5 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | + | {{hudson|pageTitle=Controlling features of Hudson using system properties}} | |
− | + | <br/> | |
+ | == 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 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
{| width="1200" cellspacing="1" cellpadding="1" border="1" | {| width="1200" cellspacing="1" cellpadding="1" border="1" | ||
Line 16: | Line 19: | ||
| Version | | Version | ||
| Notes | | Notes | ||
− | |- | + | |- |
− | | hudson.ClassicPluginStrategy.useAntClassLoader | + | | hudson.ClassicPluginStrategy.useAntClassLoader |
− | | false | + | | false |
− | | 1.316 | + | | 1.316 |
| | | | ||
− | |- | + | |- |
| hudson.consoleTailKB | | hudson.consoleTailKB | ||
| 150 | | 150 | ||
− | | | + | | |
| How many KB of console log to show in default console view | | How many KB of console log to show in default console view | ||
− | |- | + | |- |
− | | hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceTheshold | + | | hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceTheshold |
| 1073741824 | | 1073741824 | ||
| 1.339 | | 1.339 | ||
Line 34: | Line 37: | ||
| hudson.diyChunking | | hudson.diyChunking | ||
| false | | false | ||
− | | | + | | |
| Set to true if the servlet container doesn't support chunked encoding. | | Set to true if the servlet container doesn't support chunked encoding. | ||
− | |- | + | |- |
| hudson.DNSMultiCast.disabled | | hudson.DNSMultiCast.disabled | ||
| false | | false | ||
− | | 1.359 | + | | 1.359 |
− | | Set to "true" to disable DNS multicast | + | | Set to "true" to disable DNS multicast |
− | |- | + | |- |
| hudson.Functions.autoRefreshSeconds | | hudson.Functions.autoRefreshSeconds | ||
| 10 | | 10 | ||
| 1.365 | | 1.365 | ||
− | | Number of seconds between reloads when Auto Refresh is enabled | + | | Number of seconds between reloads when Auto Refresh is enabled |
− | |- | + | |- |
− | | hudson.lifecycle | + | | hudson.lifecycle |
| | | | ||
− | | | + | | |
− | | Specify full class name for Lifecycle implementation to override default | + | | Specify full class name for Lifecycle implementation to override default |
− | |- | + | |- |
| hudson.matrix.MatrixConfiguration.useShortWorkspaceName | | hudson.matrix.MatrixConfiguration.useShortWorkspaceName | ||
− | | false | + | | false |
− | | | + | | |
− | | 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 | + | | hudson.model.DownloadService.never |
| false | | false | ||
| | | | ||
| Suppress the periodic download of data files for plugins | | Suppress the periodic download of data files for plugins | ||
|- | |- | ||
− | | hudson.model.Hudson.flyweightSupport | + | | hudson.model.Hudson.flyweightSupport |
− | | was:false <br>1.337:true | + | | was:false <br>1.337:true |
− | | 1.318 | + | | 1.318 |
| Matrix parent job won't consume an executor when true | | Matrix parent job won't consume an executor when true | ||
|- | |- | ||
− | | hudson.model.Hudson.killAfterLoad | + | | hudson.model.Hudson.killAfterLoad |
− | | false | + | | false |
| | | | ||
| Exit Hudson right after loading | | Exit Hudson right after loading | ||
Line 77: | Line 80: | ||
| Log startup timing info | | Log startup timing info | ||
|- | |- | ||
− | | hudson.model.Hudson.parallelLoad | + | | hudson.model.Hudson.parallelLoad |
− | | true | + | | true |
| | | | ||
| Loads job configurations in parallel on startup | | Loads job configurations in parallel on startup | ||
|- | |- | ||
| hudson.model.LoadStatistics.clock | | hudson.model.LoadStatistics.clock | ||
− | | 10000 | + | | 10000 |
| | | | ||
| Load statistics clock cycle in milliseconds | | Load statistics clock cycle in milliseconds | ||
|- | |- | ||
| hudson.model.LoadStatistics.decay | | hudson.model.LoadStatistics.decay | ||
− | | 0.9 | + | | 0.9 |
| | | | ||
| Decay ratio for every clock cycle in node utilization charts | | Decay ratio for every clock cycle in node utilization charts | ||
|- | |- | ||
− | | hudson.model.Run.ArtifactList.listCutoff | + | | hudson.model.Run.ArtifactList.listCutoff |
| 16 | | 16 | ||
− | | 1.330 | + | | 1.330 |
| More artifacts than this will use tree view or simple link rather than listing out artifacts | | More artifacts than this will use tree view or simple link rather than listing out artifacts | ||
|- | |- | ||
| hudson.model.Run.ArtifactList.treeCutoff | | hudson.model.Run.ArtifactList.treeCutoff | ||
− | | 40 | + | | 40 |
− | | 1.330 | + | | 1.330 |
| More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view | | More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view | ||
|- | |- | ||
− | | hudson.model.UpdateCenter.never | + | | hudson.model.UpdateCenter.never |
− | | false | + | | false |
| | | | ||
| When true, don't automatically check for new versions | | When true, don't automatically check for new versions | ||
|- | |- | ||
− | | hudson.model.WorkspaceCleanupThread.disabled | + | | hudson.model.WorkspaceCleanupThread.disabled |
− | | false | + | | false |
| | | | ||
| Don't clean up old workspaces on slave nodes | | Don't clean up old workspaces on slave nodes | ||
Line 117: | Line 120: | ||
| True to disable ZFS monitor on Solaris | | True to disable ZFS monitor on Solaris | ||
|- | |- | ||
− | | hudson.remoting.Launcher.pingIntervalSec | + | | hudson.remoting.Launcher.pingIntervalSec |
− | | 600 | + | | 600 |
| 1.367 | | 1.367 | ||
| Seconds between ping checks to monitor health of slave nodes; 0 to disable ping | | Seconds between ping checks to monitor health of slave nodes; 0 to disable ping | ||
|- | |- | ||
| hudson.remoting.Launcher.pingTimeoutSec | | hudson.remoting.Launcher.pingTimeoutSec | ||
− | | 240 | + | | 240 |
− | | 1.367 | + | | 1.367 |
| If ping of slave node takes longer than this, consider it dead; 0 to disable ping | | If ping of slave node takes longer than this, consider it dead; 0 to disable ping | ||
|- | |- | ||
Line 133: | Line 136: | ||
|- | |- | ||
| hudson.scheduledRetention | | hudson.scheduledRetention | ||
− | | false | + | | false |
− | | Up to 1.354 | + | | Up to 1.354 |
| Control a slave based on a schedule | | Control a slave based on a schedule | ||
|- | |- | ||
| hudson.scm.CVSSCM.skipChangeLog | | hudson.scm.CVSSCM.skipChangeLog | ||
− | | false | + | | false |
| | | | ||
| Useful with ancient versions of CVS that don't support the -d option in the log command | | Useful with ancient versions of CVS that don't support the -d option in the log command | ||
|- | |- | ||
| hudson.security.csrf.requestfield | | hudson.security.csrf.requestfield | ||
− | | .crumb | + | | .crumb |
− | | 1.310 | + | | 1.310 |
| Parameter name that contains a crumb value on POST requests | | Parameter name that contains a crumb value on POST requests | ||
|- | |- | ||
− | | hudson.security.ExtendedReadPermission | + | | hudson.security.ExtendedReadPermission |
− | | false | + | | false |
− | | 1.324 | + | | 1.324 |
| The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin | | The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin | ||
|- | |- | ||
− | | hudson.security.ArtifactsPermission | + | | hudson.security.ArtifactsPermission |
− | | false | + | | false |
− | | 1.374 | + | | 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 | | 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 | + | | hudson.security.LDAPSecurityRealm.groupSearch |
− | | Mouseover | + | | Mouseover |
| | | | ||
| LDAP filter to look for groups by their names | | LDAP filter to look for groups by their names | ||
|- | |- | ||
− | | hudson.security.WipeOutPermission | + | | hudson.security.WipeOutPermission |
− | | false | + | | false |
− | | 2.1.1 | + | | 2.1.1 |
| Allows to manage "workspace wipe out" action permissions. | | Allows to manage "workspace wipe out" action permissions. | ||
|- | |- | ||
− | | hudson.tasks.ArtifactArchiver.warnOnEmpty | + | | hudson.tasks.ArtifactArchiver.warnOnEmpty |
| false | | false | ||
| | | | ||
| When true, builds don't fail when there is nothing to archive | | When true, builds don't fail when there is nothing to archive | ||
|- | |- | ||
− | | hudson.tasks.MailSender.maxLogLines | + | | hudson.tasks.MailSender.maxLogLines |
| 250 | | 250 | ||
| | | | ||
Line 178: | Line 181: | ||
|- | |- | ||
| hudson.TreeView | | hudson.TreeView | ||
− | | false | + | | false |
| | | | ||
| Experimental nested views feature | | Experimental nested views feature | ||
|- | |- | ||
| hudson.triggers.SCMTrigger.starvationThreshold | | hudson.triggers.SCMTrigger.starvationThreshold | ||
− | | 1 hour | + | | 1 hour |
| | | | ||
| Milliseconds waiting for polling executor before trigger reports it is clogged | | Milliseconds waiting for polling executor before trigger reports it is clogged | ||
|- | |- | ||
− | | hudson.udp | + | | hudson.udp |
| 33848 | | 33848 | ||
| | | | ||
Line 193: | Line 196: | ||
|- | |- | ||
| hudson.upstreamCulprits | | hudson.upstreamCulprits | ||
− | | false | + | | false |
| 1.327 | | 1.327 | ||
| Pass blame information to downstream jobs | | Pass blame information to downstream jobs | ||
|- | |- | ||
− | | hudson.Util.noSymlink | + | | hudson.Util.noSymlink |
| false | | false | ||
| | | | ||
| True to disable creation of symbolic links in job/builds directories | | True to disable creation of symbolic links in job/builds directories | ||
|- | |- | ||
− | | hudson.util.ProcessTree.disable | + | | hudson.util.ProcessTree.disable |
| false | | false | ||
| | | | ||
| True to disable cleanup of child processes | | True to disable cleanup of child processes | ||
|- | |- | ||
− | | hudson.util.Secret.provider | + | | hudson.util.Secret.provider |
| | | | ||
| 1.360 | | 1.360 | ||
| Force a particular crypto provider; with Glassfish Enterprise set value to SunJCE to workaround a known issue. | | Force a particular crypto provider; with Glassfish Enterprise set value to SunJCE to workaround a known issue. | ||
|- | |- | ||
− | | hudson.Util.symlinkEscapeHatch | + | | hudson.Util.symlinkEscapeHatch |
| false | | false | ||
| | | | ||
Line 218: | Line 221: | ||
|} | |} | ||
− | === No compatibility guarantee === | + | === 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. |
Latest revision as of 14:28, 22 March 2013
Hudson Continuous Integration Server | |
Website | |
Download | |
Community | |
Mailing List • Forums • IRC • mattermost | |
Issues | |
Open • Help Wanted • Bug Day | |
Contribute | |
Browse Source |
Controlling features of Hudson using system properties |
---|
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.