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.
Files changed (86) hide show
  1. data/README.rdoc +2 -0
  2. data/distro/common/html/chef-client.8.html +141 -0
  3. data/distro/common/html/chef-expander-cluster.8.html +164 -0
  4. data/distro/common/html/chef-expanderctl.8.html +146 -0
  5. data/distro/common/html/chef-server-webui.8.html +185 -0
  6. data/distro/common/html/chef-server.8.html +182 -0
  7. data/distro/common/html/chef-solo.8.html +191 -0
  8. data/distro/common/html/chef-solr.8.html +163 -0
  9. data/distro/common/html/knife-bootstrap.1.html +3 -3
  10. data/distro/common/html/knife-client.1.html +3 -3
  11. data/distro/common/html/knife-configure.1.html +1 -1
  12. data/distro/common/html/knife-cookbook-site.1.html +3 -3
  13. data/distro/common/html/knife-cookbook.1.html +3 -3
  14. data/distro/common/html/knife-data-bag.1.html +1 -1
  15. data/distro/common/html/knife-environment.1.html +3 -3
  16. data/distro/common/html/knife-exec.1.html +3 -3
  17. data/distro/common/html/knife-index.1.html +1 -1
  18. data/distro/common/html/knife-node.1.html +3 -3
  19. data/distro/common/html/knife-recipe.1.html +1 -1
  20. data/distro/common/html/knife-role.1.html +3 -3
  21. data/distro/common/html/knife-search.1.html +3 -3
  22. data/distro/common/html/knife-ssh.1.html +3 -3
  23. data/distro/common/html/knife-status.1.html +3 -3
  24. data/distro/common/html/knife-tag.1.html +3 -3
  25. data/distro/common/html/knife.1.html +3 -3
  26. data/distro/common/html/shef.1.html +3 -3
  27. data/distro/common/man/man1/knife-bootstrap.1 +1 -1
  28. data/distro/common/man/man1/knife-client.1 +1 -1
  29. data/distro/common/man/man1/knife-configure.1 +1 -1
  30. data/distro/common/man/man1/knife-cookbook-site.1 +1 -1
  31. data/distro/common/man/man1/knife-cookbook.1 +1 -1
  32. data/distro/common/man/man1/knife-data-bag.1 +1 -1
  33. data/distro/common/man/man1/knife-environment.1 +1 -1
  34. data/distro/common/man/man1/knife-exec.1 +1 -1
  35. data/distro/common/man/man1/knife-index.1 +1 -1
  36. data/distro/common/man/man1/knife-node.1 +1 -1
  37. data/distro/common/man/man1/knife-role.1 +1 -1
  38. data/distro/common/man/man1/knife-search.1 +1 -1
  39. data/distro/common/man/man1/knife-ssh.1 +1 -1
  40. data/distro/common/man/man1/knife-status.1 +1 -1
  41. data/distro/common/man/man1/knife-tag.1 +1 -1
  42. data/distro/common/man/man1/knife.1 +1 -1
  43. data/distro/common/man/man1/shef.1 +1 -1
  44. data/distro/common/man/man8/chef-client.8 +53 -32
  45. data/distro/common/man/man8/chef-expander-cluster.8 +97 -0
  46. data/distro/common/man/man8/chef-expanderctl.8 +62 -0
  47. data/distro/common/man/man8/chef-server-webui.8 +121 -72
  48. data/distro/common/man/man8/chef-server.8 +113 -73
  49. data/distro/common/man/man8/chef-solo.8 +131 -30
  50. data/distro/common/man/man8/chef-solr.8 +85 -26
  51. data/distro/common/markdown/man8/chef-client.mkd +65 -0
  52. data/distro/common/markdown/man8/chef-expander-cluster.mkd +82 -0
  53. data/distro/common/markdown/man8/chef-expanderctl.mkd +58 -0
  54. data/distro/common/markdown/man8/chef-server-webui.mkd +121 -0
  55. data/distro/common/markdown/man8/chef-server.mkd +121 -0
  56. data/distro/common/markdown/man8/chef-solo.mkd +107 -0
  57. data/distro/common/markdown/man8/chef-solr.mkd +85 -0
  58. data/lib/chef/config.rb +1 -1
  59. data/lib/chef/cookbook/metadata.rb +1 -0
  60. data/lib/chef/cookbook_uploader.rb +12 -5
  61. data/lib/chef/couchdb.rb +21 -21
  62. data/lib/chef/file_access_control.rb +4 -4
  63. data/lib/chef/knife.rb +11 -3
  64. data/lib/chef/knife/bootstrap/centos5-gems.erb +13 -7
  65. data/lib/chef/knife/bootstrap/fedora13-gems.erb +1 -1
  66. data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +2 -2
  67. data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +1 -1
  68. data/lib/chef/knife/client_create.rb +1 -1
  69. data/lib/chef/knife/configure.rb +10 -1
  70. data/lib/chef/knife/cookbook_bulk_delete.rb +13 -3
  71. data/lib/chef/knife/cookbook_site_download.rb +5 -5
  72. data/lib/chef/knife/cookbook_site_install.rb +5 -5
  73. data/lib/chef/knife/cookbook_site_list.rb +6 -2
  74. data/lib/chef/knife/cookbook_site_search.rb +1 -1
  75. data/lib/chef/knife/cookbook_site_show.rb +3 -3
  76. data/lib/chef/knife/cookbook_upload.rb +7 -8
  77. data/lib/chef/knife/core/ui.rb +1 -1
  78. data/lib/chef/knife/node_bulk_delete.rb +37 -3
  79. data/lib/chef/knife/recipe_list.rb +0 -1
  80. data/lib/chef/knife/role_bulk_delete.rb +27 -4
  81. data/lib/chef/mixin/language.rb +2 -2
  82. data/lib/chef/resource/deploy_revision.rb +5 -0
  83. data/lib/chef/rest.rb +5 -8
  84. data/lib/chef/version.rb +1 -1
  85. data/lib/chef/version_class.rb +4 -4
  86. 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 &lt; info &lt; warn &lt; error &lt; 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="&#109;&#97;&#x69;&#x6c;&#x74;&#111;&#58;&#x61;&#100;&#x61;&#109;&#x40;&#x6f;&#x73;&#x70;&#x63;&#x6f;&#x64;&#101;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#97;&#x64;&#x61;&#109;&#x40;&#111;&#115;&#x70;&#99;&#111;&#100;&#x65;&#x2e;&#99;&#x6f;&#x6d;</a> of Opscode
167
+ (http://www.opscode.com), with contributions from the community. This
168
+ manual page was written by Joshua Timberman <a href="&#x6d;&#x61;&#x69;&#108;&#116;&#111;&#x3a;&#106;&#x6f;&#x73;&#104;&#117;&#97;&#x40;&#x6f;&#x70;&#115;&#99;&#x6f;&#x64;&#101;&#x2e;&#99;&#111;&#x6d;" data-bare-link="true">&#x6a;&#x6f;&#x73;&#x68;&#x75;&#97;&#64;&#111;&#x70;&#115;&#99;&#x6f;&#100;&#101;&#46;&#x63;&#111;&#109;</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 &lt; info &lt; warn &lt; error &lt; 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="&#109;&#x61;&#x69;&#x6c;&#116;&#x6f;&#x3a;&#97;&#100;&#97;&#x6d;&#64;&#x6f;&#115;&#112;&#99;&#111;&#x64;&#x65;&#46;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#100;&#97;&#109;&#x40;&#111;&#115;&#x70;&#99;&#x6f;&#100;&#x65;&#46;&#99;&#111;&#109;</a> of Opscode
165
+ (http://www.opscode.com), with contributions from the community. This
166
+ manual page was written by Joshua Timberman <a href="&#109;&#97;&#105;&#108;&#x74;&#111;&#58;&#x6a;&#111;&#115;&#x68;&#117;&#x61;&#64;&#x6f;&#x70;&#115;&#x63;&#x6f;&#x64;&#x65;&#x2e;&#99;&#x6f;&#109;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#117;&#x61;&#x40;&#111;&#x70;&#x73;&#x63;&#x6f;&#x64;&#101;&#x2e;&#x63;&#x6f;&#x6d;</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="&#109;&#97;&#x69;&#x6c;&#116;&#x6f;&#x3a;&#x61;&#x64;&#97;&#x6d;&#64;&#x6f;&#115;&#112;&#99;&#111;&#x64;&#101;&#46;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#97;&#100;&#97;&#x6d;&#64;&#111;&#115;&#x70;&#99;&#x6f;&#100;&#x65;&#x2e;&#99;&#x6f;&#109;</a> of Opscode
174
+ (http://www.opscode.com), with contributions from the community. This
175
+ manual page was written by Joshua Timberman <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#x6f;&#58;&#x6a;&#x6f;&#x73;&#x68;&#x75;&#97;&#x40;&#111;&#112;&#x73;&#x63;&#x6f;&#x64;&#x65;&#46;&#99;&#x6f;&#x6d;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#x75;&#97;&#64;&#x6f;&#x70;&#115;&#99;&#x6f;&#100;&#x65;&#46;&#x63;&#111;&#109;</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>