Files
jenkins/osx/Library/Documentation/Jenkins/command-line-preferences.html
T

56 lines
2.6 KiB
HTML

<html>
<head>
<title>Jenkins command-line preferences</title>
</head>
<body>
<h1>Jenkins command-line preferences</h1>
<p><a href="https://wiki.jenkins-ci.org/display/JENKINS/Starting+and+Accessing+Jenkins">The Jenkins Wiki page</a> tells you how to change settings like which port number Jenkins will listen to. These settings need to be specified on the command line when Jenkins is started.
<h4>Launch daemon</h4>
<p>For the Mac, Jenkins is deployed as a launch daemon. (If you want to know more about launchd and daemons, see <a href="http://developer.apple.com/library/mac/#technotes/tn2083/_index.html">here</a> and <a href="http://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPSystemStartup/Articles/LaunchOnDemandDaemons.html">here</a>)
<p>The launch daemon picks up the command line options from a standard preferences file, <tt>/Library/Preferences/org.jenkins-ci.plist</tt>. If the file does not exist, built-in defaults are used. The preference files are manipulated using the standard utility <tt>defaults</tt>.
<h4>How To Use the defaults Command</h4>
<p>To view all settings in the file, run:
<tt>defaults read /Library/Preferences/org.jenkins-ci</tt>
<p>To get the value of a single setting, run:
<tt>defaults read /Library/Preferences/org.jenkins-ci SETTING</tt>
<p>To set the value of a setting, run:
<tt>defaults write /Library/Preferences/org.jenkins-ci SETTING VALUE</tt>
<p>For more information, see <tt>man defaults</tt>
<h4>Supported Settings</h4>
<p>The list of settings supported by the Jenkins launch daemon (see <a href="http://winstone.sourceforge.net/#commandLine">documentation</a>):
<ul>
<li>prefix
<li>httpPort
<li>httpListenAddress
<li>httpsPort
<li>httpsListenAddress
<li>ajp13Port
<li>ajp13ListenAddress
</ul>
<p>Additionally, you can set also these:
<ul>
<li>war (Full path name to jenkins.war file. Defaults to <tt>/Applications/Jenkins/jenkins.war</tt>)
<li>JENKINS_HOME (Full path to JENKINS_HOME directory where Jenkins keeps its files. Defaults to <tt>/Users/Shared/Jenkins</tt>)
<li>minHeapSize (Passed to java command-line <tt>-Xms</tt> parameter. Defaults to 256m on 64bit architectures and 64m on 32bit)
<li>heapSize (Passed to java command-line <tt>-Xmx</tt> parameter. Defaults to 512m on 64bit architectures and 128m on 32bit)
<li>minPermGen (Passed to java command-line <tt>-XX:PermSize</tt> parameter. Defaults to 256m on 64bit architectures and 64m on 32bit)
<li>permGen (Passed to java command-line <tt>-XX:MaxPermSize</tt> parameter. Defaults to 512m on 64bit architectures and 128m on 32bit)
</ul>
</body>
</html>