chef 0.10.0.beta.9 → 0.10.0.beta.10
Sign up to get free protection for your applications and to get access to all the features.
- data/README.rdoc +2 -0
- data/distro/common/html/chef-client.8.html +141 -0
- data/distro/common/html/chef-expander-cluster.8.html +164 -0
- data/distro/common/html/chef-expanderctl.8.html +146 -0
- data/distro/common/html/chef-server-webui.8.html +185 -0
- data/distro/common/html/chef-server.8.html +182 -0
- data/distro/common/html/chef-solo.8.html +191 -0
- data/distro/common/html/chef-solr.8.html +163 -0
- data/distro/common/html/knife-bootstrap.1.html +3 -3
- data/distro/common/html/knife-client.1.html +3 -3
- data/distro/common/html/knife-configure.1.html +1 -1
- data/distro/common/html/knife-cookbook-site.1.html +3 -3
- data/distro/common/html/knife-cookbook.1.html +3 -3
- data/distro/common/html/knife-data-bag.1.html +1 -1
- data/distro/common/html/knife-environment.1.html +3 -3
- data/distro/common/html/knife-exec.1.html +3 -3
- data/distro/common/html/knife-index.1.html +1 -1
- data/distro/common/html/knife-node.1.html +3 -3
- data/distro/common/html/knife-recipe.1.html +1 -1
- data/distro/common/html/knife-role.1.html +3 -3
- data/distro/common/html/knife-search.1.html +3 -3
- data/distro/common/html/knife-ssh.1.html +3 -3
- data/distro/common/html/knife-status.1.html +3 -3
- data/distro/common/html/knife-tag.1.html +3 -3
- data/distro/common/html/knife.1.html +3 -3
- data/distro/common/html/shef.1.html +3 -3
- data/distro/common/man/man1/knife-bootstrap.1 +1 -1
- data/distro/common/man/man1/knife-client.1 +1 -1
- data/distro/common/man/man1/knife-configure.1 +1 -1
- data/distro/common/man/man1/knife-cookbook-site.1 +1 -1
- data/distro/common/man/man1/knife-cookbook.1 +1 -1
- data/distro/common/man/man1/knife-data-bag.1 +1 -1
- data/distro/common/man/man1/knife-environment.1 +1 -1
- data/distro/common/man/man1/knife-exec.1 +1 -1
- data/distro/common/man/man1/knife-index.1 +1 -1
- data/distro/common/man/man1/knife-node.1 +1 -1
- data/distro/common/man/man1/knife-role.1 +1 -1
- data/distro/common/man/man1/knife-search.1 +1 -1
- data/distro/common/man/man1/knife-ssh.1 +1 -1
- data/distro/common/man/man1/knife-status.1 +1 -1
- data/distro/common/man/man1/knife-tag.1 +1 -1
- data/distro/common/man/man1/knife.1 +1 -1
- data/distro/common/man/man1/shef.1 +1 -1
- data/distro/common/man/man8/chef-client.8 +53 -32
- data/distro/common/man/man8/chef-expander-cluster.8 +97 -0
- data/distro/common/man/man8/chef-expanderctl.8 +62 -0
- data/distro/common/man/man8/chef-server-webui.8 +121 -72
- data/distro/common/man/man8/chef-server.8 +113 -73
- data/distro/common/man/man8/chef-solo.8 +131 -30
- data/distro/common/man/man8/chef-solr.8 +85 -26
- data/distro/common/markdown/man8/chef-client.mkd +65 -0
- data/distro/common/markdown/man8/chef-expander-cluster.mkd +82 -0
- data/distro/common/markdown/man8/chef-expanderctl.mkd +58 -0
- data/distro/common/markdown/man8/chef-server-webui.mkd +121 -0
- data/distro/common/markdown/man8/chef-server.mkd +121 -0
- data/distro/common/markdown/man8/chef-solo.mkd +107 -0
- data/distro/common/markdown/man8/chef-solr.mkd +85 -0
- data/lib/chef/config.rb +1 -1
- data/lib/chef/cookbook/metadata.rb +1 -0
- data/lib/chef/cookbook_uploader.rb +12 -5
- data/lib/chef/couchdb.rb +21 -21
- data/lib/chef/file_access_control.rb +4 -4
- data/lib/chef/knife.rb +11 -3
- data/lib/chef/knife/bootstrap/centos5-gems.erb +13 -7
- data/lib/chef/knife/bootstrap/fedora13-gems.erb +1 -1
- data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +2 -2
- data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +1 -1
- data/lib/chef/knife/client_create.rb +1 -1
- data/lib/chef/knife/configure.rb +10 -1
- data/lib/chef/knife/cookbook_bulk_delete.rb +13 -3
- data/lib/chef/knife/cookbook_site_download.rb +5 -5
- data/lib/chef/knife/cookbook_site_install.rb +5 -5
- data/lib/chef/knife/cookbook_site_list.rb +6 -2
- data/lib/chef/knife/cookbook_site_search.rb +1 -1
- data/lib/chef/knife/cookbook_site_show.rb +3 -3
- data/lib/chef/knife/cookbook_upload.rb +7 -8
- data/lib/chef/knife/core/ui.rb +1 -1
- data/lib/chef/knife/node_bulk_delete.rb +37 -3
- data/lib/chef/knife/recipe_list.rb +0 -1
- data/lib/chef/knife/role_bulk_delete.rb +27 -4
- data/lib/chef/mixin/language.rb +2 -2
- data/lib/chef/resource/deploy_revision.rb +5 -0
- data/lib/chef/rest.rb +5 -8
- data/lib/chef/version.rb +1 -1
- data/lib/chef/version_class.rb +4 -4
- metadata +20 -4
@@ -0,0 +1,185 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>chef-server-webui(8) - Start the Chef Server merb application slice providing Web User Interface (Management Console).</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
65
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
66
|
+
<a href="#AUTHOR">AUTHOR</a>
|
67
|
+
</div>
|
68
|
+
|
69
|
+
<ol class='man-decor man-head man head'>
|
70
|
+
<li class='tl'>chef-server-webui(8)</li>
|
71
|
+
<li class='tc'>Chef Manual</li>
|
72
|
+
<li class='tr'>chef-server-webui(8)</li>
|
73
|
+
</ol>
|
74
|
+
|
75
|
+
<h2 id="NAME">NAME</h2>
|
76
|
+
<p class="man-name">
|
77
|
+
<code>chef-server-webui</code> - <span class="man-whatis">Start the Chef Server merb application slice providing Web User Interface (Management Console).</span>
|
78
|
+
</p>
|
79
|
+
|
80
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
81
|
+
|
82
|
+
<p><strong>chef-server-webui</strong> <em>(options)</em></p>
|
83
|
+
|
84
|
+
<dl>
|
85
|
+
<dt><code>-u</code>, <code>--user USER</code></dt><dd>This flag is for having chef-server-webui run as a user other than the
|
86
|
+
one currently logged in. Note: if you set this you must also provide a
|
87
|
+
--group option for it to take effect.</dd>
|
88
|
+
<dt><code>-G</code>, <code>--group GROUP</code></dt><dd>This flag is for having chef-server-webui run as a group other than the
|
89
|
+
one currently logged in. Note: if you set this you must also provide a
|
90
|
+
--user option for it to take effect.</dd>
|
91
|
+
<dt><code>-d</code>, <code>--daemonize</code></dt><dd>This will run a single chef-server-webui in the background.</dd>
|
92
|
+
<dt><code>-N</code>, <code>--no-daemonize</code></dt><dd>This will allow you to run a cluster in console mode.</dd>
|
93
|
+
<dt><code>-c</code>, <code>--cluster-nodes NUM_MERBS</code></dt><dd>Number of merb daemons to run for chef-server-webui.</dd>
|
94
|
+
<dt><code>-I</code>, <code>--init-file FILE</code></dt><dd>File to use for initialization on load, defaults to config/init.rb.</dd>
|
95
|
+
<dt><code>-p</code>, <code>--port PORTNUM</code></dt><dd>Port to run chef-server-webui on, defaults to 4040. Additional nodes (-c)
|
96
|
+
listen on incrementing port numbers.</dd>
|
97
|
+
<dt><code>-o</code>, <code>--socket-file FILE</code></dt><dd>Socket file to run chef-server-webui on, defaults to
|
98
|
+
[Merb.root]/log/merb.sock. This is for web servers, like thin, that use
|
99
|
+
sockets. Specify this <em>only</em> if you <em>must</em>.</dd>
|
100
|
+
<dt><code>-s</code>, <code>--socket SOCKNUM</code></dt><dd>Socket number to run chef-server-webui on, defaults to 0.</dd>
|
101
|
+
<dt><code>-n</code>, <code>--name NAME</code></dt><dd>Set the name of the application. This is used in the process title and
|
102
|
+
log file names.</dd>
|
103
|
+
<dt><code>-P</code>, <code>--pid PIDFILE</code></dt><dd>PID file, defaults to [Merb.root]/log/merb.main.pid for the master
|
104
|
+
process and[Merb.root]/log/merb.[port number].pid for worker processes.
|
105
|
+
For clusters, use %s to specify where in the file chef-server-webui
|
106
|
+
should place the port number. For instance: -P myapp.%s.pid.</dd>
|
107
|
+
<dt><code>-h</code>, <code>--host HOSTNAME</code></dt><dd>Host to bind to (default is 0.0.0.0).</dd>
|
108
|
+
<dt><code>-m</code>, <code>--merb-root PATH_TO_APP_ROOT</code></dt><dd>The path to the Merb.root for the app you want to run
|
109
|
+
(default is current working directory).</dd>
|
110
|
+
<dt><code>-a</code>, <code>--adapter ADAPTER</code></dt><dd>The rack adapter to use to run chef-server-webui (default is mongrel)
|
111
|
+
[mongrel, emongrel, thin, ebb, fastcgi, webrick].</dd>
|
112
|
+
<dt><code>-R</code>, <code>--rackup FILE</code></dt><dd>Load an alternate Rack config file (default is config/rack.rb).</dd>
|
113
|
+
<dt><code>-i</code>, <code>--irb-console</code></dt><dd>This flag will start chef-server-webui in irb console mode. All your models
|
114
|
+
and other classes will be available for you in an irb session.</dd>
|
115
|
+
<dt><code>-S</code>, <code>--sandbox</code></dt><dd>This flag will enable a sandboxed irb console. If your ORM supports
|
116
|
+
transactions, all edits will be rolled back on exit.</dd>
|
117
|
+
<dt><code>-l</code>, <code>--log-level LEVEL</code></dt><dd>Log levels can be set to any of these options:
|
118
|
+
debug < info < warn < error < fatal (default is info).</dd>
|
119
|
+
<dt><code>-L</code>, <code>--log LOGFILE</code></dt><dd>A string representing the logfile to use. Defaults to
|
120
|
+
[Merb.root]/log/merb.[main].log for the master process and
|
121
|
+
[Merb.root]/log/merb[port number].logfor worker processes.</dd>
|
122
|
+
<dt><code>-e</code>, <code>--environment STRING</code></dt><dd>Environment to run Merb under [development, production, testing]
|
123
|
+
(default is development).</dd>
|
124
|
+
<dt><code>-r</code>, <code>--script-runner ['RUBY CODE'| FULL_SCRIPT_PATH]</code></dt><dd>Command-line option to run scripts and/or code in the chef-server-webui
|
125
|
+
app.</dd>
|
126
|
+
<dt><code>-K</code>, <code>-graceful PORT or all</code></dt><dd>Gracefully kill chef-server-webui proceses by port number.
|
127
|
+
Use chef-server -K all to gracefully kill all merbs.</dd>
|
128
|
+
<dt><code>-k</code>, <code>--kill PORT</code></dt><dd>Force kill one merb worker by port number. This will cause the worker
|
129
|
+
to be respawned.</dd>
|
130
|
+
<dt><code>--fast-deploy</code></dt><dd>Reload the code, but not yourinit.rb or gems.</dd>
|
131
|
+
<dt><code>-X</code>, <code>--mutex on/off</code></dt><dd>This flag is for turning the mutex lock on and off.</dd>
|
132
|
+
<dt><code>-D</code>, <code>--debugger</code></dt><dd>Run chef-server-webui using rDebug.</dd>
|
133
|
+
<dt><code>-V</code>, <code>--verbose</code></dt><dd>Print extra information.</dd>
|
134
|
+
<dt><code>-C</code>, <code>--console-trap</code></dt><dd>Enter an irb console on ^C.</dd>
|
135
|
+
<dt><code>-?</code>, <code>-H</code>, <code>--help</code></dt><dd>Show this help message.</dd>
|
136
|
+
</dl>
|
137
|
+
|
138
|
+
|
139
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
140
|
+
|
141
|
+
<p>The Chef Server WebUI (Management Console) is a Merb application slice.
|
142
|
+
The default listen port is 4040.</p>
|
143
|
+
|
144
|
+
<p>The Management Console is Chef Server's web interface. Nodes, roles,
|
145
|
+
cookbooks, data bags, and API clients can be managed through the Management
|
146
|
+
Console. Search can also be done on the console.</p>
|
147
|
+
|
148
|
+
<p>In order to start using the Management Console, you need to first create
|
149
|
+
a user or change the default password on the "admin" user.</p>
|
150
|
+
|
151
|
+
<p>The default credentials are:</p>
|
152
|
+
|
153
|
+
<ul>
|
154
|
+
<li><code>Username</code>: admin</li>
|
155
|
+
<li><code>Password</code>: p@ssw0rd1</li>
|
156
|
+
</ul>
|
157
|
+
|
158
|
+
|
159
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
160
|
+
|
161
|
+
<p>Full documentation for Chef and chef-server-webui (Management Console)
|
162
|
+
is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.</p>
|
163
|
+
|
164
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
165
|
+
|
166
|
+
<p>Chef was written by Adam Jacob <a href="mailto:adam@ospcode.com" data-bare-link="true">adam@ospcode.com</a> of Opscode
|
167
|
+
(http://www.opscode.com), with contributions from the community. This
|
168
|
+
manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a> with
|
169
|
+
help2man for the Debian project (but may be used by others). Permission
|
170
|
+
is granted to copy, distribute and / or modify this document under the
|
171
|
+
terms of the Apache 2.0 License.</p>
|
172
|
+
|
173
|
+
<p>On Debian systems, the complete text of the Apache 2.0 License can be
|
174
|
+
found in /usr/share/common-licenses/Apache-2.0.</p>
|
175
|
+
|
176
|
+
|
177
|
+
<ol class='man-decor man-foot man foot'>
|
178
|
+
<li class='tl'>Chef 0.10.0.beta.10</li>
|
179
|
+
<li class='tc'>April 2011</li>
|
180
|
+
<li class='tr'>chef-server-webui(8)</li>
|
181
|
+
</ol>
|
182
|
+
|
183
|
+
</div>
|
184
|
+
</body>
|
185
|
+
</html>
|
@@ -0,0 +1,182 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>chef-server(8) - Start the Chef Server merb application slice.</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
65
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
66
|
+
<a href="#AUTHOR">AUTHOR</a>
|
67
|
+
</div>
|
68
|
+
|
69
|
+
<ol class='man-decor man-head man head'>
|
70
|
+
<li class='tl'>chef-server(8)</li>
|
71
|
+
<li class='tc'>Chef Manual</li>
|
72
|
+
<li class='tr'>chef-server(8)</li>
|
73
|
+
</ol>
|
74
|
+
|
75
|
+
<h2 id="NAME">NAME</h2>
|
76
|
+
<p class="man-name">
|
77
|
+
<code>chef-server</code> - <span class="man-whatis">Start the Chef Server merb application slice.</span>
|
78
|
+
</p>
|
79
|
+
|
80
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
81
|
+
|
82
|
+
<p><strong>chef-server</strong> <em>(options)</em></p>
|
83
|
+
|
84
|
+
<dl>
|
85
|
+
<dt><code>-u</code>, <code>--user USER</code></dt><dd>This flag is for having chef-server-webui run as a user other than the
|
86
|
+
one currently logged in. Note: if you set this you must also provide a
|
87
|
+
--group option for it to take effect.</dd>
|
88
|
+
<dt><code>-G</code>, <code>--group GROUP</code></dt><dd>This flag is for having chef-server-webui run as a group other than the
|
89
|
+
one currently logged in. Note: if you set this you must also provide a
|
90
|
+
--user option for it to take effect.</dd>
|
91
|
+
<dt><code>-d</code>, <code>--daemonize</code></dt><dd>This will run a single chef-server-webui in the background.</dd>
|
92
|
+
<dt><code>-N</code>, <code>--no-daemonize</code></dt><dd>This will allow you to run a cluster in console mode.</dd>
|
93
|
+
<dt><code>-c</code>, <code>--cluster-nodes NUM_MERBS</code></dt><dd>Number of merb daemons to run for chef-server-webui.</dd>
|
94
|
+
<dt><code>-I</code>, <code>--init-file FILE</code></dt><dd>File to use for initialization on load, defaults to config/init.rb.</dd>
|
95
|
+
<dt><code>-p</code>, <code>--port PORTNUM</code></dt><dd>Port to run chef-server-webui on, defaults to 4040. Additional nodes (-c)
|
96
|
+
listen on incrementing port numbers.</dd>
|
97
|
+
<dt><code>-o</code>, <code>--socket-file FILE</code></dt><dd>Socket file to run chef-server-webui on, defaults to
|
98
|
+
[Merb.root]/log/merb.sock. This is for web servers, like thin, that use
|
99
|
+
sockets. Specify this <em>only</em> if you <em>must</em>.</dd>
|
100
|
+
<dt><code>-s</code>, <code>--socket SOCKNUM</code></dt><dd>Socket number to run chef-server-webui on, defaults to 0.</dd>
|
101
|
+
<dt><code>-n</code>, <code>--name NAME</code></dt><dd>Set the name of the application. This is used in the process title and
|
102
|
+
log file names.</dd>
|
103
|
+
<dt><code>-P</code>, <code>--pid PIDFILE</code></dt><dd>PID file, defaults to [Merb.root]/log/merb.main.pid for the master
|
104
|
+
process and[Merb.root]/log/merb.[port number].pid for worker processes.
|
105
|
+
For clusters, use %s to specify where in the file chef-server-webui
|
106
|
+
should place the port number. For instance: -P myapp.%s.pid.</dd>
|
107
|
+
<dt><code>-h</code>, <code>--host HOSTNAME</code></dt><dd>Host to bind to (default is 0.0.0.0).</dd>
|
108
|
+
<dt><code>-m</code>, <code>--merb-root PATH_TO_APP_ROOT</code></dt><dd>The path to the Merb.root for the app you want to run
|
109
|
+
(default is current working directory).</dd>
|
110
|
+
<dt><code>-a</code>, <code>--adapter ADAPTER</code></dt><dd>The rack adapter to use to run chef-server-webui (default is mongrel)
|
111
|
+
[mongrel, emongrel, thin, ebb, fastcgi, webrick].</dd>
|
112
|
+
<dt><code>-R</code>, <code>--rackup FILE</code></dt><dd>Load an alternate Rack config file (default is config/rack.rb).</dd>
|
113
|
+
<dt><code>-i</code>, <code>--irb-console</code></dt><dd>This flag will start chef-server-webui in irb console mode. All your models
|
114
|
+
and other classes will be available for you in an irb session.</dd>
|
115
|
+
<dt><code>-S</code>, <code>--sandbox</code></dt><dd>This flag will enable a sandboxed irb console. If your ORM supports
|
116
|
+
transactions, all edits will be rolled back on exit.</dd>
|
117
|
+
<dt><code>-l</code>, <code>--log-level LEVEL</code></dt><dd>Log levels can be set to any of these options:
|
118
|
+
debug < info < warn < error < fatal (default is info).</dd>
|
119
|
+
<dt><code>-L</code>, <code>--log LOGFILE</code></dt><dd>A string representing the logfile to use. Defaults to
|
120
|
+
[Merb.root]/log/merb.[main].log for the master process and
|
121
|
+
[Merb.root]/log/merb[port number].logfor worker processes.</dd>
|
122
|
+
<dt><code>-e</code>, <code>--environment STRING</code></dt><dd>Environment to run Merb under [development, production, testing]
|
123
|
+
(default is development).</dd>
|
124
|
+
<dt><code>-r</code>, <code>--script-runner ['RUBY CODE'| FULL_SCRIPT_PATH]</code></dt><dd>Command-line option to run scripts and/or code in the chef-server-webui
|
125
|
+
app.</dd>
|
126
|
+
<dt><code>-K</code>, <code>-graceful PORT or all</code></dt><dd>Gracefully kill chef-server-webui proceses by port number.
|
127
|
+
Use chef-server -K all to gracefully kill all merbs.</dd>
|
128
|
+
<dt><code>-k</code>, <code>--kill PORT</code></dt><dd>Force kill one merb worker by port number. This will cause the worker
|
129
|
+
to be respawned.</dd>
|
130
|
+
<dt><code>--fast-deploy</code></dt><dd>Reload the code, but not yourinit.rb or gems.</dd>
|
131
|
+
<dt><code>-X</code>, <code>--mutex on/off</code></dt><dd>This flag is for turning the mutex lock on and off.</dd>
|
132
|
+
<dt><code>-D</code>, <code>--debugger</code></dt><dd>Run chef-server-webui using rDebug.</dd>
|
133
|
+
<dt><code>-V</code>, <code>--verbose</code></dt><dd>Print extra information.</dd>
|
134
|
+
<dt><code>-C</code>, <code>--console-trap</code></dt><dd>Enter an irb console on ^C.</dd>
|
135
|
+
<dt><code>-?</code>, <code>-H</code>, <code>--help</code></dt><dd>Show this help message.</dd>
|
136
|
+
</dl>
|
137
|
+
|
138
|
+
|
139
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
140
|
+
|
141
|
+
<p>The Chef Server provides a central point for the distribution of Cookbooks,
|
142
|
+
management and authentication of Nodes, and the use of Search. It provides
|
143
|
+
a REST API.</p>
|
144
|
+
|
145
|
+
<p>The API service is what clients use to interact with the server to manage
|
146
|
+
node configuration in Chef. By default, the service is started on port 4000
|
147
|
+
as a Merb application slice running with the thin server adapter.</p>
|
148
|
+
|
149
|
+
<p>The two methods of interaction with the API for humans are the command-line
|
150
|
+
tool Knife and the Management Console. The Chef Client library is used for
|
151
|
+
interacting with the API for client nodes.</p>
|
152
|
+
|
153
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
154
|
+
|
155
|
+
<p><strong>chef-client</strong>(8)
|
156
|
+
<strong>chef-server-webui</strong>(8)
|
157
|
+
<strong>knife</strong>(1)</p>
|
158
|
+
|
159
|
+
<p>Full documentation for Chef and chef-server is located on the Chef
|
160
|
+
wiki, http://wiki.opscode.com/display/chef/Home.</p>
|
161
|
+
|
162
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
163
|
+
|
164
|
+
<p>Chef was written by Adam Jacob <a href="mailto:adam@ospcode.com" data-bare-link="true">adam@ospcode.com</a> of Opscode
|
165
|
+
(http://www.opscode.com), with contributions from the community. This
|
166
|
+
manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a> with
|
167
|
+
help2man. Permission is granted to copy, distribute and / or modify
|
168
|
+
this document under the terms of the Apache 2.0 License.</p>
|
169
|
+
|
170
|
+
<p>On Debian systems, the complete text of the Apache 2.0 License can be
|
171
|
+
found in /usr/share/common-licenses/Apache-2.0.</p>
|
172
|
+
|
173
|
+
|
174
|
+
<ol class='man-decor man-foot man foot'>
|
175
|
+
<li class='tl'>Chef 0.10.0.beta.10</li>
|
176
|
+
<li class='tc'>April 2011</li>
|
177
|
+
<li class='tr'>chef-server(8)</li>
|
178
|
+
</ol>
|
179
|
+
|
180
|
+
</div>
|
181
|
+
</body>
|
182
|
+
</html>
|
@@ -0,0 +1,191 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>chef-solo(8) - Runs chef in solo mode against a specified cookbook location.</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
65
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
66
|
+
<a href="#AUTHOR">AUTHOR</a>
|
67
|
+
</div>
|
68
|
+
|
69
|
+
<ol class='man-decor man-head man head'>
|
70
|
+
<li class='tl'>chef-solo(8)</li>
|
71
|
+
<li class='tc'>Chef Manual</li>
|
72
|
+
<li class='tr'>chef-solo(8)</li>
|
73
|
+
</ol>
|
74
|
+
|
75
|
+
<h2 id="NAME">NAME</h2>
|
76
|
+
<p class="man-name">
|
77
|
+
<code>chef-solo</code> - <span class="man-whatis">Runs chef in solo mode against a specified cookbook location.</span>
|
78
|
+
</p>
|
79
|
+
|
80
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
81
|
+
|
82
|
+
<p><strong>chef-solo</strong> <em>(options)</em></p>
|
83
|
+
|
84
|
+
<dl>
|
85
|
+
<dt><code>-c</code>, <code>--config CONFIG</code></dt><dd>The configuration file to use</dd>
|
86
|
+
<dt><code>-d</code>, <code>--daemonize</code></dt><dd>Daemonize the process</dd>
|
87
|
+
<dt><code>-g</code>, <code>--group GROUP</code></dt><dd>Group to set privilege to</dd>
|
88
|
+
<dt><code>-i</code>, <code>--interval SECONDS</code></dt><dd>Run chef-client periodically, in seconds</dd>
|
89
|
+
<dt><code>-j</code>, <code>--json-attributes JSON_ATTRIBS</code></dt><dd>Load attributes from a JSON file or URL</dd>
|
90
|
+
<dt><code>-l</code>, <code>--log_level LEVEL</code></dt><dd>Set the log level (debug, info, warn, error, fatal)</dd>
|
91
|
+
<dt><code>-L</code>, <code>--logfile LOGLOCATION</code></dt><dd>Set the log file location, defaults to STDOUT - recommended for
|
92
|
+
daemonizing</dd>
|
93
|
+
<dt><code>-N</code>, <code>--node-name NODE_NAME</code></dt><dd>The node name for this client</dd>
|
94
|
+
<dt><code>-r</code>, <code>--recipe-url RECIPE_URL</code></dt><dd>Pull down a remote gzipped tarball of recipes and untar it to the
|
95
|
+
cookbook cache.</dd>
|
96
|
+
<dt><code>-s</code>, <code>--splay SECONDS</code></dt><dd>The splay time for running at intervals, in seconds</dd>
|
97
|
+
<dt><code>-u</code>, <code>--user USER</code></dt><dd>User to set privilege to</dd>
|
98
|
+
<dt><code>-v</code>, <code>--version</code></dt><dd>Show chef version</dd>
|
99
|
+
<dt><code>-h</code>, <code>--help</code></dt><dd>Show this message</dd>
|
100
|
+
</dl>
|
101
|
+
|
102
|
+
|
103
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
104
|
+
|
105
|
+
<p>Chef Solo allows you to run Chef Cookbooks in the absence of a Chef Server.
|
106
|
+
To do this, the complete cookbook needs to be present on disk.</p>
|
107
|
+
|
108
|
+
<p>By default Chef Solo will look in /etc/chef/solo.rb for its configuration.
|
109
|
+
This configuration file has two required variables: file_cache_path and
|
110
|
+
cookbook_path.</p>
|
111
|
+
|
112
|
+
<p>For example:</p>
|
113
|
+
|
114
|
+
<pre><code>file_cache_path "/var/chef-solo"
|
115
|
+
cookbook_path "/var/chef-solo/cookbooks"
|
116
|
+
</code></pre>
|
117
|
+
|
118
|
+
<p>For your own systems, you can change this to reflect any directory you like,
|
119
|
+
but you'll need to specify absolute paths and the cookbook_path directory
|
120
|
+
should be a subdirectory of the file_cache_path.</p>
|
121
|
+
|
122
|
+
<p>You can also specify cookbook_path as an array, passing multiple locations
|
123
|
+
to search for cookbooks.</p>
|
124
|
+
|
125
|
+
<p>For example:</p>
|
126
|
+
|
127
|
+
<pre><code>file_cache_path "/var/chef-solo"
|
128
|
+
cookbook_path ["/var/chef-solo/cookbooks", "/var/chef-solo/site-cookbooks"]
|
129
|
+
</code></pre>
|
130
|
+
|
131
|
+
<p>Note that earlier entries are now overridden by later ones.</p>
|
132
|
+
|
133
|
+
<p>Since chef-solo doesn't have any interaction with a Chef Server, you'll need
|
134
|
+
to specify node-specifc attributes in a JSON file. This can be located on the
|
135
|
+
target system itself, or it can be stored on a remote server such as S3, or a
|
136
|
+
web server on your network.</p>
|
137
|
+
|
138
|
+
<p>Within the JSON file, you'll also specify the recipes that Chef should run in
|
139
|
+
the "run_list". An example JSON file, which sets a resolv.conf:</p>
|
140
|
+
|
141
|
+
<pre><code>{
|
142
|
+
"resolver": {
|
143
|
+
"nameservers": [ "10.0.0.1" ],
|
144
|
+
"search":"int.example.com"
|
145
|
+
},
|
146
|
+
"run_list": [ "recipe[resolver]" ]
|
147
|
+
}
|
148
|
+
</code></pre>
|
149
|
+
|
150
|
+
<p>Then you can run chef-solo with -j to specify the JSON file. It will look for
|
151
|
+
cookbooks in the cookbook_path configured in the configuration file, and apply
|
152
|
+
attributes and use the run_list from the JSON file specified.</p>
|
153
|
+
|
154
|
+
<p>You can use -c to specify the path to the configuration file (if you don't want
|
155
|
+
chef-solo to use the default). You can also specify -r for a cookbook tarball.</p>
|
156
|
+
|
157
|
+
<p>For example:</p>
|
158
|
+
|
159
|
+
<pre><code>chef-solo -c ~/solo.rb -j ~/node.json -r http://www.example.com/chef-solo.tar.gz
|
160
|
+
</code></pre>
|
161
|
+
|
162
|
+
<p>In the above case, chef-solo would extract the tarball to your specified
|
163
|
+
cookbook_path, use ~/solo.rb as the configuration file, and apply attributes
|
164
|
+
and use the run_list from ~/node.json.</p>
|
165
|
+
|
166
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
167
|
+
|
168
|
+
<p>Full documentation for Chef and chef-solo is located on the Chef wiki,
|
169
|
+
http://wiki.opscode.com/display/chef/Home.</p>
|
170
|
+
|
171
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
172
|
+
|
173
|
+
<p>Chef was written by Adam Jacob <a href="mailto:adam@ospcode.com" data-bare-link="true">adam@ospcode.com</a> of Opscode
|
174
|
+
(http://www.opscode.com), with contributions from the community. This
|
175
|
+
manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a> with
|
176
|
+
help2man. Permission is granted to copy, distribute and / or modify
|
177
|
+
this document under the terms of the Apache 2.0 License.</p>
|
178
|
+
|
179
|
+
<p>On Debian systems, the complete text of the Apache 2.0 License can be
|
180
|
+
found in /usr/share/common-licenses/Apache-2.0.</p>
|
181
|
+
|
182
|
+
|
183
|
+
<ol class='man-decor man-foot man foot'>
|
184
|
+
<li class='tl'>Chef 0.10.0.beta.10</li>
|
185
|
+
<li class='tc'>April 2011</li>
|
186
|
+
<li class='tr'>chef-solo(8)</li>
|
187
|
+
</ol>
|
188
|
+
|
189
|
+
</div>
|
190
|
+
</body>
|
191
|
+
</html>
|