microwave 11.400.5 → 11.400.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (118) hide show
  1. data/VERSION +1 -1
  2. data/lib/chef/daemon.rb +0 -2
  3. metadata +3 -118
  4. data/distro/README +0 -2
  5. data/distro/arch/etc/conf.d/chef-client.conf +0 -5
  6. data/distro/arch/etc/conf.d/chef-expander.conf +0 -8
  7. data/distro/arch/etc/conf.d/chef-server-webui.conf +0 -10
  8. data/distro/arch/etc/conf.d/chef-server.conf +0 -10
  9. data/distro/arch/etc/conf.d/chef-solr.conf +0 -8
  10. data/distro/arch/etc/rc.d/chef-client +0 -90
  11. data/distro/arch/etc/rc.d/chef-expander +0 -78
  12. data/distro/arch/etc/rc.d/chef-server +0 -78
  13. data/distro/arch/etc/rc.d/chef-server-webui +0 -78
  14. data/distro/arch/etc/rc.d/chef-solr +0 -78
  15. data/distro/common/html/chef-client.8.html +0 -145
  16. data/distro/common/html/chef-expander.8.html +0 -164
  17. data/distro/common/html/chef-expanderctl.8.html +0 -146
  18. data/distro/common/html/chef-server-webui.8.html +0 -185
  19. data/distro/common/html/chef-server.8.html +0 -182
  20. data/distro/common/html/chef-shell.1.html +0 -286
  21. data/distro/common/html/chef-solo.8.html +0 -191
  22. data/distro/common/html/chef-solr.8.html +0 -165
  23. data/distro/common/html/knife-bootstrap.1.html +0 -241
  24. data/distro/common/html/knife-client.1.html +0 -219
  25. data/distro/common/html/knife-configure.1.html +0 -170
  26. data/distro/common/html/knife-cookbook-site.1.html +0 -241
  27. data/distro/common/html/knife-cookbook.1.html +0 -384
  28. data/distro/common/html/knife-data-bag.1.html +0 -238
  29. data/distro/common/html/knife-environment.1.html +0 -267
  30. data/distro/common/html/knife-exec.1.html +0 -134
  31. data/distro/common/html/knife-index.1.html +0 -125
  32. data/distro/common/html/knife-node.1.html +0 -250
  33. data/distro/common/html/knife-role.1.html +0 -200
  34. data/distro/common/html/knife-search.1.html +0 -288
  35. data/distro/common/html/knife-ssh.1.html +0 -156
  36. data/distro/common/html/knife-status.1.html +0 -128
  37. data/distro/common/html/knife-tag.1.html +0 -137
  38. data/distro/common/html/knife.1.html +0 -315
  39. data/distro/common/man/man1/chef-shell.1 +0 -220
  40. data/distro/common/man/man1/knife-bootstrap.1 +0 -201
  41. data/distro/common/man/man1/knife-client.1 +0 -99
  42. data/distro/common/man/man1/knife-configure.1 +0 -88
  43. data/distro/common/man/man1/knife-cookbook-site.1 +0 -145
  44. data/distro/common/man/man1/knife-cookbook.1 +0 -345
  45. data/distro/common/man/man1/knife-data-bag.1 +0 -136
  46. data/distro/common/man/man1/knife-environment.1 +0 -178
  47. data/distro/common/man/man1/knife-exec.1 +0 -43
  48. data/distro/common/man/man1/knife-index.1 +0 -29
  49. data/distro/common/man/man1/knife-node.1 +0 -134
  50. data/distro/common/man/man1/knife-role.1 +0 -88
  51. data/distro/common/man/man1/knife-search.1 +0 -280
  52. data/distro/common/man/man1/knife-ssh.1 +0 -79
  53. data/distro/common/man/man1/knife-status.1 +0 -29
  54. data/distro/common/man/man1/knife-tag.1 +0 -43
  55. data/distro/common/man/man1/knife.1 +0 -285
  56. data/distro/common/man/man8/chef-client.8 +0 -104
  57. data/distro/common/man/man8/chef-expander.8 +0 -97
  58. data/distro/common/man/man8/chef-expanderctl.8 +0 -62
  59. data/distro/common/man/man8/chef-server-webui.8 +0 -155
  60. data/distro/common/man/man8/chef-server.8 +0 -147
  61. data/distro/common/man/man8/chef-solo.8 +0 -158
  62. data/distro/common/man/man8/chef-solr.8 +0 -122
  63. data/distro/common/markdown/README +0 -3
  64. data/distro/common/markdown/man1/chef-shell.mkd +0 -195
  65. data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
  66. data/distro/common/markdown/man1/knife-client.mkd +0 -103
  67. data/distro/common/markdown/man1/knife-configure.mkd +0 -70
  68. data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
  69. data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
  70. data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
  71. data/distro/common/markdown/man1/knife-environment.mkd +0 -151
  72. data/distro/common/markdown/man1/knife-exec.mkd +0 -42
  73. data/distro/common/markdown/man1/knife-index.mkd +0 -30
  74. data/distro/common/markdown/man1/knife-node.mkd +0 -130
  75. data/distro/common/markdown/man1/knife-role.mkd +0 -85
  76. data/distro/common/markdown/man1/knife-search.mkd +0 -180
  77. data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
  78. data/distro/common/markdown/man1/knife-status.mkd +0 -36
  79. data/distro/common/markdown/man1/knife-tag.mkd +0 -39
  80. data/distro/common/markdown/man1/knife.mkd +0 -213
  81. data/distro/common/markdown/man8/chef-client.mkd +0 -74
  82. data/distro/common/markdown/man8/chef-expander.mkd +0 -82
  83. data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -58
  84. data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
  85. data/distro/common/markdown/man8/chef-server.mkd +0 -121
  86. data/distro/common/markdown/man8/chef-solo.mkd +0 -107
  87. data/distro/common/markdown/man8/chef-solr.mkd +0 -89
  88. data/distro/debian/etc/default/chef-client +0 -4
  89. data/distro/debian/etc/default/chef-expander +0 -8
  90. data/distro/debian/etc/default/chef-server +0 -9
  91. data/distro/debian/etc/default/chef-server-webui +0 -9
  92. data/distro/debian/etc/default/chef-solr +0 -8
  93. data/distro/debian/etc/init.d/chef-client +0 -210
  94. data/distro/debian/etc/init.d/chef-expander +0 -176
  95. data/distro/debian/etc/init.d/chef-server +0 -122
  96. data/distro/debian/etc/init.d/chef-server-webui +0 -123
  97. data/distro/debian/etc/init.d/chef-solr +0 -176
  98. data/distro/debian/etc/init/chef-client.conf +0 -17
  99. data/distro/debian/etc/init/chef-expander.conf +0 -17
  100. data/distro/debian/etc/init/chef-server-webui.conf +0 -17
  101. data/distro/debian/etc/init/chef-server.conf +0 -17
  102. data/distro/debian/etc/init/chef-solr.conf +0 -17
  103. data/distro/redhat/etc/init.d/chef-client +0 -121
  104. data/distro/redhat/etc/init.d/chef-expander +0 -104
  105. data/distro/redhat/etc/init.d/chef-server +0 -112
  106. data/distro/redhat/etc/init.d/chef-server-webui +0 -112
  107. data/distro/redhat/etc/init.d/chef-solr +0 -104
  108. data/distro/redhat/etc/logrotate.d/chef-client +0 -8
  109. data/distro/redhat/etc/logrotate.d/chef-expander +0 -8
  110. data/distro/redhat/etc/logrotate.d/chef-server +0 -8
  111. data/distro/redhat/etc/logrotate.d/chef-server-webui +0 -8
  112. data/distro/redhat/etc/logrotate.d/chef-solr +0 -8
  113. data/distro/redhat/etc/sysconfig/chef-client +0 -15
  114. data/distro/redhat/etc/sysconfig/chef-expander +0 -7
  115. data/distro/redhat/etc/sysconfig/chef-server +0 -14
  116. data/distro/redhat/etc/sysconfig/chef-server-webui +0 -14
  117. data/distro/redhat/etc/sysconfig/chef-solr +0 -8
  118. data/distro/windows/service_manager.rb +0 -164
@@ -1,200 +0,0 @@
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>knife-role(1) - Group common configuration settings</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="#ROLE-SUB-COMMANDS">ROLE SUB-COMMANDS</a>
65
- <a href="#LIST">LIST</a>
66
- <a href="#SHOW">SHOW</a>
67
- <a href="#CREATE">CREATE</a>
68
- <a href="#EDIT">EDIT</a>
69
- <a href="#FROM-FILE">FROM FILE</a>
70
- <a href="#DELETE">DELETE</a>
71
- <a href="#BULK-DELETE">BULK DELETE</a>
72
- <a href="#DESCRIPTION">DESCRIPTION</a>
73
- <a href="#SEE-ALSO">SEE ALSO</a>
74
- <a href="#AUTHOR">AUTHOR</a>
75
- <a href="#DOCUMENTATION">DOCUMENTATION</a>
76
- <a href="#CHEF">CHEF</a>
77
- </div>
78
-
79
- <ol class='man-decor man-head man head'>
80
- <li class='tl'>knife-role(1)</li>
81
- <li class='tc'>Chef Manual</li>
82
- <li class='tr'>knife-role(1)</li>
83
- </ol>
84
-
85
- <h2 id="NAME">NAME</h2>
86
- <p class="man-name">
87
- <code>knife-role</code> - <span class="man-whatis">Group common configuration settings</span>
88
- </p>
89
-
90
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
91
-
92
- <p><strong>knife</strong> <strong>role</strong> <em>sub-command</em> <em>(options)</em></p>
93
-
94
- <h2 id="ROLE-SUB-COMMANDS">ROLE SUB-COMMANDS</h2>
95
-
96
- <p>The following <code>role</code> subcommands are available:</p>
97
-
98
- <h2 id="LIST">LIST</h2>
99
-
100
- <p><strong>knife role list</strong> <em>(options)</em></p>
101
-
102
- <dl>
103
- <dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
104
- </dl>
105
-
106
-
107
- <p>List roles.</p>
108
-
109
- <h2 id="SHOW">SHOW</h2>
110
-
111
- <p><strong>knife role show ROLE</strong> <em>(options)</em></p>
112
-
113
- <dl>
114
- <dt><code>-a</code>, <code>--attribute ATTR</code></dt><dd>Show only one attribute</dd>
115
- </dl>
116
-
117
-
118
- <p>Show a specific role.</p>
119
-
120
- <h2 id="CREATE">CREATE</h2>
121
-
122
- <p><strong>knife role create ROLE</strong> <em>(options)</em></p>
123
-
124
- <dl>
125
- <dt><code>-d</code>, <code>--description</code></dt><dd>The role description</dd>
126
- </dl>
127
-
128
-
129
- <p>Create a new role.</p>
130
-
131
- <h2 id="EDIT">EDIT</h2>
132
-
133
- <p><strong>knife role edit ROLE</strong> <em>(options)</em></p>
134
-
135
- <p>Edit a role.</p>
136
-
137
- <h2 id="FROM-FILE">FROM FILE</h2>
138
-
139
- <p><strong>knife role from file FILE</strong> <em>(options)</em></p>
140
-
141
- <p>Create or update a role from a role Ruby DSL (<code>.rb</code>) or JSON file.</p>
142
-
143
- <h2 id="DELETE">DELETE</h2>
144
-
145
- <p><strong>knife role delete ROLE</strong> <em>(options)</em></p>
146
-
147
- <p>Delete a role.</p>
148
-
149
- <h2 id="BULK-DELETE">BULK DELETE</h2>
150
-
151
- <p><strong>knife role bulk delete REGEX</strong> <em>(options)</em></p>
152
-
153
- <p>Delete roles on the Chef Server based on a regular expression. The regular expression (<em>REGEX</em>) should be in quotes, not in //'s.</p>
154
-
155
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
156
-
157
- <p>Roles provide a mechanism to group repeated configuration settings.
158
- Roles are data structures that contain <strong>default_attributes</strong>, and
159
- <strong>override_attributes</strong>, which are nested hashes of configuration
160
- settings, and a <strong>run_list</strong>, which is an ordered list of recipes and
161
- roles that should be applied to a host by chef-client.</p>
162
-
163
- <p><strong>default_attributes</strong> will be overridden if they conflict with a value
164
- on a node that includes the role. Conversely, <strong>override_attributes</strong>
165
- will override any values set on nodes that apply them.</p>
166
-
167
- <p>When <strong>chef-client</strong>(8) configures a host, it will "expand" the
168
- <strong>run_list</strong> included in that host's node data. The expansion process
169
- will recursively replace any roles in the run_list with that role's
170
- run_list.</p>
171
-
172
- <h2 id="SEE-ALSO">SEE ALSO</h2>
173
-
174
- <p> <strong><span class="man-ref">knife-node<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-environment<span class="s">(1)</span></span></strong>
175
- <a href="http://wiki.opscode.com/display/chef/Roles" data-bare-link="true">http://wiki.opscode.com/display/chef/Roles</a>
176
- <a href="http://wiki.opscode.com/display/chef/Attributes" data-bare-link="true">http://wiki.opscode.com/display/chef/Attributes</a></p>
177
-
178
- <h2 id="AUTHOR">AUTHOR</h2>
179
-
180
- <p> Chef was written by Adam Jacob <a href="&#109;&#97;&#x69;&#108;&#116;&#x6f;&#58;&#97;&#x64;&#97;&#x6d;&#x40;&#111;&#x70;&#x73;&#x63;&#x6f;&#x64;&#x65;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#x61;&#100;&#x61;&#109;&#x40;&#111;&#112;&#115;&#x63;&#111;&#100;&#x65;&#46;&#x63;&#111;&#109;</a> with many contributions from the community.</p>
181
-
182
- <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
183
-
184
- <p> This manual page was written by Joshua Timberman <a href="&#109;&#97;&#x69;&#108;&#x74;&#111;&#x3a;&#106;&#x6f;&#x73;&#104;&#117;&#97;&#x40;&#x6f;&#112;&#x73;&#99;&#111;&#x64;&#101;&#46;&#x63;&#x6f;&#x6d;" data-bare-link="true">&#x6a;&#x6f;&#x73;&#x68;&#x75;&#97;&#x40;&#x6f;&#x70;&#x73;&#99;&#111;&#x64;&#x65;&#x2e;&#99;&#x6f;&#109;</a>.
185
- Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
186
-
187
- <h2 id="CHEF">CHEF</h2>
188
-
189
- <p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
190
-
191
-
192
- <ol class='man-decor man-foot man foot'>
193
- <li class='tl'>Chef 11.2.0</li>
194
- <li class='tc'>February 2013</li>
195
- <li class='tr'>knife-role(1)</li>
196
- </ol>
197
-
198
- </div>
199
- </body>
200
- </html>
@@ -1,288 +0,0 @@
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>knife-search(1) - Find objects on a Chef Server by query</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="#INDEXES">INDEXES</a>
66
- <a href="#QUERY-SYNTAX">QUERY SYNTAX</a>
67
- <a href="#EXAMPLES">EXAMPLES</a>
68
- <a href="#KNOWN-BUGS">KNOWN BUGS</a>
69
- <a href="#SEE-ALSO">SEE ALSO</a>
70
- <a href="#AUTHOR">AUTHOR</a>
71
- <a href="#DOCUMENTATION">DOCUMENTATION</a>
72
- <a href="#CHEF">CHEF</a>
73
- </div>
74
-
75
- <ol class='man-decor man-head man head'>
76
- <li class='tl'>knife-search(1)</li>
77
- <li class='tc'>Chef Manual</li>
78
- <li class='tr'>knife-search(1)</li>
79
- </ol>
80
-
81
- <h2 id="NAME">NAME</h2>
82
- <p class="man-name">
83
- <code>knife-search</code> - <span class="man-whatis">Find objects on a Chef Server by query</span>
84
- </p>
85
-
86
- <h2 id="SYNOPSIS">SYNOPSIS</h2>
87
-
88
- <p><strong>knife</strong> <strong>search INDEX QUERY</strong> <em>(options)</em></p>
89
-
90
- <dl>
91
- <dt><code>-a</code>, <code>--attribute ATTR</code></dt><dd>Show only one attribute</dd>
92
- <dt><code>-i</code>, <code>--id-only</code></dt><dd>Show only the ID of matching objects</dd>
93
- <dt><code>-q</code>, <code>--query QUERY</code></dt><dd>The search query; useful to protect queries starting with -</dd>
94
- <dt><code>-R</code>, <code>--rows INT</code></dt><dd>The number of rows to return</dd>
95
- <dt><code>-r</code>, <code>--run-list</code></dt><dd>Show only the run list</dd>
96
- <dt><code>-o</code>, <code>--sort SORT</code></dt><dd>The order to sort the results in</dd>
97
- <dt><code>-b</code>, <code>--start ROW</code></dt><dd>The row to start returning results at</dd>
98
- <dt><code>-m</code>, <code>--medium</code></dt><dd>Display medium sized output when searching nodes using the default
99
- summary format</dd>
100
- <dt><code>-l</code>, <code>--long</code></dt><dd>Display long output when searching nodes using the default summary
101
- format</dd>
102
- </dl>
103
-
104
-
105
- <h2 id="DESCRIPTION">DESCRIPTION</h2>
106
-
107
- <p>Search is a feature of the Chef Server that allows you to use a
108
- full-text search engine to query information about your infrastructure
109
- and applications. You can utilize this service via search calls in a
110
- recipe or the knife search command. The search syntax is based on
111
- Lucene.</p>
112
-
113
- <h2 id="INDEXES">INDEXES</h2>
114
-
115
- <p>Search indexes are a feature of the Chef Server and the search
116
- sub-command allows querying any of the available indexes using SOLR
117
- query syntax. The following data types are indexed for search:</p>
118
-
119
- <ul>
120
- <li><em>node</em></li>
121
- <li><em>role</em></li>
122
- <li><em>environment</em></li>
123
- <li><em>clients</em></li>
124
- <li><em>data bag</em></li>
125
- </ul>
126
-
127
-
128
- <p>Data bags are indexed by the data bag's name. For example, to search a
129
- data bag named "admins":</p>
130
-
131
- <pre><code>knife search admins "field:search_pattern"
132
- </code></pre>
133
-
134
- <h2 id="QUERY-SYNTAX">QUERY SYNTAX</h2>
135
-
136
- <p>Queries have the form <code>field:search_pattern</code> where <code>field</code> is a key in
137
- the JSON description of the relevant objects (nodes, roles,
138
- environments, or data bags). Both <code>field</code> and <code>search_pattern</code> are
139
- case-sensitive. <code>search_pattern</code> can be an exact, wildcard,
140
- range, or fuzzy match (see below). The <code>field</code> supports exact
141
- matching and limited wildcard matching.</p>
142
-
143
- <p>Searches will return the relevant objects (nodes, roles, environments,
144
- or data bags) where the <code>search_pattern</code> matches the object's value of
145
- <code>field</code>.</p>
146
-
147
- <h3 id="FIELD-NAMES">FIELD NAMES</h3>
148
-
149
- <p>Field names are the keys within the JSON description of the object
150
- being searched. Nested Keys can be searched by placing an underscore
151
- ("_") between key names.</p>
152
-
153
- <h3 id="WILDCARD-MATCHING-FOR-FIELD-NAMES">WILDCARD MATCHING FOR FIELD NAMES</h3>
154
-
155
- <p>The field name also has limited support for wildcard matching. Both
156
- the "*" and "?" wildcards (see below) can be used within a field name;
157
- however, they cannot be the first character of the field name.</p>
158
-
159
- <h3 id="EXACT-MATCHES">EXACT MATCHES</h3>
160
-
161
- <p>Without any search modifiers, a search returns those fields for which
162
- the <code>search_pattern</code> exactly matches the value of <code>field</code> in the JSON
163
- description of the object.</p>
164
-
165
- <h3 id="WILDCARD-MATCHES">WILDCARD MATCHES</h3>
166
-
167
- <p>Search support both single- and multi-character wildcard searches
168
- within a search pattern.</p>
169
-
170
- <p>'?' matches exactly one character.</p>
171
-
172
- <p>'*' matches zero or more characters.</p>
173
-
174
- <h3 id="RANGE-MATCHES">RANGE MATCHES</h3>
175
-
176
- <p>Range searches allows one to match values between two given values. To
177
- match values between X and Y, inclusively, use square brackets:</p>
178
-
179
- <pre><code>knife search INDEX 'field:[X TO Y]
180
- </code></pre>
181
-
182
- <p>To match values between X and Y, exclusively, use curly brackets:</p>
183
-
184
- <pre><code>knife search INDEX 'field:{X TO Y}'
185
- </code></pre>
186
-
187
- <p>Values are sorted in lexicographic order.</p>
188
-
189
- <h3 id="FUZZY-MATCHES">FUZZY MATCHES</h3>
190
-
191
- <p>Fuzzy searches allows one to match values based on the Levenshtein
192
- Distance algorithm. To perform a fuzzy match, append a tilda (~) to
193
- the search term:</p>
194
-
195
- <pre><code>knife search INDEX 'field:term~'
196
- </code></pre>
197
-
198
- <p>This search would return nodes whose <code>field</code> was 'perm' or 'germ'.</p>
199
-
200
- <h3 id="BOOLEAN-OPERATORS">BOOLEAN OPERATORS</h3>
201
-
202
- <p>The boolean operators NOT, AND, and OR are supported. To find values
203
- of <code>field</code> that are not X:</p>
204
-
205
- <pre><code>knife search INDEX 'field:(NOT X)'
206
- </code></pre>
207
-
208
- <p>To find records where <code>field1</code> is X and <code>field2</code> is Y:</p>
209
-
210
- <pre><code>knife search INDEX 'field1:X AND field2:Y'
211
- </code></pre>
212
-
213
- <p>To find records where <code>field</code> is X or Y:</p>
214
-
215
- <pre><code>knife search INDEX 'field:X OR field:Y'
216
- </code></pre>
217
-
218
- <h3 id="QUOTING-AND-SPECIAL-CHARACTERS">QUOTING AND SPECIAL CHARACTERS</h3>
219
-
220
- <p>In order to avoid having special characters and escape sequences
221
- within your search term interpreted by either Ruby or the shell,
222
- enclose them in single quotes.</p>
223
-
224
- <p>Search terms that include spaces should be enclosed in double-quotes:</p>
225
-
226
- <pre><code>knife search INDEX 'field:"term with spaces"'
227
- </code></pre>
228
-
229
- <p>The following characters must be escaped:</p>
230
-
231
- <pre><code>+ - &amp;&amp; || ! ( ) { } [ ] ^ " ~ * ? : \
232
- </code></pre>
233
-
234
- <h2 id="EXAMPLES">EXAMPLES</h2>
235
-
236
- <p>Find the nodes with the fully-qualified domain name (FQDN)
237
- www.example.com:</p>
238
-
239
- <pre><code>knife search node 'fqdn:www.example.com'
240
- </code></pre>
241
-
242
- <p>Find the nodes running a version of Ubuntu:</p>
243
-
244
- <pre><code>knife search node 'platform:ubuntu*'
245
- </code></pre>
246
-
247
- <p>Find all nodes running CentOS in the production environment:</p>
248
-
249
- <pre><code>knife search node 'chef_environment:production AND platform:centos'
250
- </code></pre>
251
-
252
- <h2 id="KNOWN-BUGS">KNOWN BUGS</h2>
253
-
254
- <ul>
255
- <li>Searches against the client index return no results in most cases. (CHEF-2477)</li>
256
- <li>Searches using the fuzzy match operator (~) produce an error. (CHEF-2478)</li>
257
- </ul>
258
-
259
-
260
- <h2 id="SEE-ALSO">SEE ALSO</h2>
261
-
262
- <p> <strong>knife-ssh</strong>(1)
263
- <a href="http://wiki.opscode.com/display/chef/Attributes" data-bare-link="true">http://wiki.opscode.com/display/chef/Attributes</a>
264
- <a href="http://lucene.apache.org/java/2_3_2/queryparsersyntax.html">Lucene Query Parser Syntax</a></p>
265
-
266
- <h2 id="AUTHOR">AUTHOR</h2>
267
-
268
- <p> Chef was written by Adam Jacob <a href="&#x6d;&#x61;&#x69;&#x6c;&#116;&#x6f;&#58;&#x61;&#100;&#97;&#x6d;&#x40;&#111;&#x70;&#x73;&#x63;&#x6f;&#x64;&#101;&#46;&#99;&#111;&#x6d;" data-bare-link="true">&#97;&#x64;&#x61;&#109;&#64;&#x6f;&#x70;&#x73;&#99;&#111;&#x64;&#x65;&#46;&#99;&#x6f;&#x6d;</a> with many contributions from the community.</p>
269
-
270
- <h2 id="DOCUMENTATION">DOCUMENTATION</h2>
271
-
272
- <p> This manual page was written by Joshua Timberman <a href="&#109;&#x61;&#105;&#x6c;&#x74;&#111;&#x3a;&#106;&#x6f;&#115;&#x68;&#x75;&#97;&#x40;&#x6f;&#112;&#115;&#99;&#111;&#100;&#x65;&#x2e;&#99;&#x6f;&#109;" data-bare-link="true">&#x6a;&#111;&#115;&#x68;&#x75;&#97;&#x40;&#111;&#112;&#115;&#x63;&#111;&#x64;&#x65;&#x2e;&#x63;&#111;&#x6d;</a>.
273
- Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
274
-
275
- <h2 id="CHEF">CHEF</h2>
276
-
277
- <p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
278
-
279
-
280
- <ol class='man-decor man-foot man foot'>
281
- <li class='tl'>Chef 11.2.0</li>
282
- <li class='tc'>February 2013</li>
283
- <li class='tr'>knife-search(1)</li>
284
- </ol>
285
-
286
- </div>
287
- </body>
288
- </html>