chef 12.8.1-universal-mingw32 → 12.9.38-universal-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (1862) hide show
  1. checksums.yaml +4 -4
  2. data/CONTRIBUTING.md +208 -208
  3. data/Gemfile +54 -49
  4. data/LICENSE +201 -201
  5. data/README.md +139 -139
  6. data/Rakefile +87 -86
  7. data/VERSION +1 -1
  8. data/acceptance/.gitignore +2 -2
  9. data/acceptance/.shared/kitchen_acceptance/.kitchen.digitalocean.yml +33 -33
  10. data/acceptance/.shared/kitchen_acceptance/.kitchen.ec2.yml +292 -290
  11. data/acceptance/.shared/kitchen_acceptance/.kitchen.vagrant.yml +59 -59
  12. data/acceptance/.shared/kitchen_acceptance/libraries/kitchen.rb +51 -51
  13. data/acceptance/.shared/kitchen_acceptance/metadata.rb +1 -1
  14. data/acceptance/Gemfile +13 -14
  15. data/acceptance/README.md +132 -132
  16. data/acceptance/basics/.acceptance/acceptance-cookbook/.gitignore +2 -2
  17. data/acceptance/basics/.acceptance/acceptance-cookbook/metadata.rb +3 -3
  18. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  19. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  20. data/acceptance/basics/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  21. data/acceptance/basics/.kitchen.yml +4 -4
  22. data/acceptance/basics/test/integration/chef-current-install/serverspec/chef_client_spec.rb +19 -19
  23. data/acceptance/basics/test/integration/chef-current-install/serverspec/spec_helper.rb +6 -6
  24. data/acceptance/fips/.acceptance/acceptance-cookbook/.gitignore +2 -2
  25. data/acceptance/fips/.acceptance/acceptance-cookbook/metadata.rb +2 -2
  26. data/acceptance/fips/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  27. data/acceptance/fips/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  28. data/acceptance/fips/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  29. data/acceptance/fips/.kitchen.yml +4 -4
  30. data/acceptance/fips/test/integration/fips/serverspec/Gemfile +3 -3
  31. data/acceptance/fips/test/integration/fips/serverspec/fips_spec.rb +39 -39
  32. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/.gitignore +2 -0
  33. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/metadata.rb +1 -0
  34. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -0
  35. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -0
  36. data/acceptance/omnitruck/.acceptance/acceptance-cookbook/recipes/verify.rb +61 -0
  37. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/.gitignore +2 -2
  38. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/cookbook_kitchen.rb +43 -43
  39. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/libraries/top_cookbooks.rb +45 -23
  40. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/metadata.rb +3 -3
  41. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  42. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  43. data/acceptance/top-cookbooks/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  44. data/acceptance/top-cookbooks/.gitignore +1 -1
  45. data/acceptance/top-cookbooks/.kitchen.chocolatey.yml +6 -0
  46. data/acceptance/top-cookbooks/.kitchen.docker.yml +12 -12
  47. data/acceptance/top-cookbooks/.kitchen.git.yml +11 -11
  48. data/acceptance/top-cookbooks/.kitchen.iis.yml +4 -0
  49. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-rhel.yml +7 -7
  50. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-ubuntu.yml +7 -7
  51. data/acceptance/top-cookbooks/.kitchen.learn-the-basics-windows.yml +7 -7
  52. data/acceptance/top-cookbooks/.kitchen.powershell.yml +4 -0
  53. data/acceptance/top-cookbooks/.kitchen.sql_server.yml +5 -0
  54. data/acceptance/top-cookbooks/.kitchen.winbox.yml +8 -0
  55. data/acceptance/top-cookbooks/.kitchen.windows.yml +38 -0
  56. data/acceptance/trivial/.acceptance/acceptance-cookbook/.gitignore +2 -2
  57. data/acceptance/trivial/.acceptance/acceptance-cookbook/metadata.rb +2 -2
  58. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  59. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  60. data/acceptance/trivial/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  61. data/acceptance/trivial/.kitchen.yml +7 -7
  62. data/acceptance/trivial/test/integration/chef-current-install/inspec/chef_client_spec.rb +5 -5
  63. data/acceptance/windows-service/.acceptance/acceptance-cookbook/.gitignore +2 -2
  64. data/acceptance/windows-service/.acceptance/acceptance-cookbook/metadata.rb +2 -2
  65. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/destroy.rb +1 -1
  66. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/provision.rb +1 -1
  67. data/acceptance/windows-service/.acceptance/acceptance-cookbook/recipes/verify.rb +1 -1
  68. data/acceptance/windows-service/.kitchen.yml +7 -7
  69. data/acceptance/windows-service/test/integration/chef-windows-service/inspec/chef_windows_service_spec.rb +58 -58
  70. data/bin/chef-apply +25 -25
  71. data/bin/chef-client +26 -26
  72. data/bin/chef-service-manager +38 -38
  73. data/bin/chef-shell +34 -34
  74. data/bin/chef-solo +25 -25
  75. data/bin/chef-windows-service +35 -35
  76. data/bin/knife +25 -25
  77. data/chef-windows.gemspec +24 -24
  78. data/chef.gemspec +64 -63
  79. data/distro/common/html/_sources/ctl_chef_client.txt +35 -35
  80. data/distro/common/html/_sources/ctl_chef_server.txt +341 -341
  81. data/distro/common/html/_sources/ctl_chef_shell.txt +15 -15
  82. data/distro/common/html/_sources/ctl_chef_solo.txt +25 -25
  83. data/distro/common/html/_sources/index.txt +135 -135
  84. data/distro/common/html/_sources/knife.txt +74 -74
  85. data/distro/common/html/_sources/knife_bootstrap.txt +56 -56
  86. data/distro/common/html/_sources/knife_client.txt +150 -150
  87. data/distro/common/html/_sources/knife_common_options.txt +6 -6
  88. data/distro/common/html/_sources/knife_configure.txt +29 -29
  89. data/distro/common/html/_sources/knife_cookbook.txt +236 -236
  90. data/distro/common/html/_sources/knife_cookbook_site.txt +157 -157
  91. data/distro/common/html/_sources/knife_data_bag.txt +159 -159
  92. data/distro/common/html/_sources/knife_delete.txt +26 -26
  93. data/distro/common/html/_sources/knife_deps.txt +61 -61
  94. data/distro/common/html/_sources/knife_diff.txt +34 -34
  95. data/distro/common/html/_sources/knife_download.txt +44 -44
  96. data/distro/common/html/_sources/knife_edit.txt +26 -26
  97. data/distro/common/html/_sources/knife_environment.txt +158 -158
  98. data/distro/common/html/_sources/knife_exec.txt +47 -47
  99. data/distro/common/html/_sources/knife_index_rebuild.txt +20 -20
  100. data/distro/common/html/_sources/knife_list.txt +33 -33
  101. data/distro/common/html/_sources/knife_node.txt +250 -250
  102. data/distro/common/html/_sources/knife_raw.txt +35 -35
  103. data/distro/common/html/_sources/knife_recipe_list.txt +23 -23
  104. data/distro/common/html/_sources/knife_role.txt +157 -157
  105. data/distro/common/html/_sources/knife_search.txt +53 -53
  106. data/distro/common/html/_sources/knife_serve.txt +18 -18
  107. data/distro/common/html/_sources/knife_show.txt +26 -26
  108. data/distro/common/html/_sources/knife_ssh.txt +43 -43
  109. data/distro/common/html/_sources/knife_ssl_check.txt +41 -41
  110. data/distro/common/html/_sources/knife_ssl_fetch.txt +41 -41
  111. data/distro/common/html/_sources/knife_status.txt +37 -37
  112. data/distro/common/html/_sources/knife_tag.txt +69 -69
  113. data/distro/common/html/_sources/knife_upload.txt +49 -49
  114. data/distro/common/html/_sources/knife_user.txt +127 -127
  115. data/distro/common/html/_sources/knife_using.txt +43 -43
  116. data/distro/common/html/_sources/knife_xargs.txt +30 -30
  117. data/distro/common/html/_static/basic.css +536 -536
  118. data/distro/common/html/_static/doctools.js +238 -238
  119. data/distro/common/html/_static/guide.css +504 -504
  120. data/distro/common/html/_static/pygments.css +61 -61
  121. data/distro/common/html/_static/searchtools.js +621 -621
  122. data/distro/common/html/_static/underscore.js +31 -31
  123. data/distro/common/html/_static/websupport.js +808 -808
  124. data/distro/common/html/ctl_chef_client.html +269 -269
  125. data/distro/common/html/ctl_chef_server.html +727 -727
  126. data/distro/common/html/ctl_chef_shell.html +162 -162
  127. data/distro/common/html/ctl_chef_solo.html +193 -193
  128. data/distro/common/html/index.html +201 -201
  129. data/distro/common/html/knife.html +169 -169
  130. data/distro/common/html/knife_bootstrap.html +284 -284
  131. data/distro/common/html/knife_client.html +284 -284
  132. data/distro/common/html/knife_common_options.html +95 -95
  133. data/distro/common/html/knife_configure.html +104 -104
  134. data/distro/common/html/knife_cookbook.html +486 -486
  135. data/distro/common/html/knife_cookbook_site.html +375 -375
  136. data/distro/common/html/knife_data_bag.html +373 -373
  137. data/distro/common/html/knife_delete.html +92 -92
  138. data/distro/common/html/knife_deps.html +142 -142
  139. data/distro/common/html/knife_diff.html +122 -122
  140. data/distro/common/html/knife_download.html +144 -144
  141. data/distro/common/html/knife_edit.html +88 -88
  142. data/distro/common/html/knife_environment.html +325 -325
  143. data/distro/common/html/knife_exec.html +219 -219
  144. data/distro/common/html/knife_index_rebuild.html +82 -82
  145. data/distro/common/html/knife_list.html +113 -113
  146. data/distro/common/html/knife_node.html +457 -457
  147. data/distro/common/html/knife_raw.html +109 -109
  148. data/distro/common/html/knife_recipe_list.html +90 -90
  149. data/distro/common/html/knife_role.html +294 -294
  150. data/distro/common/html/knife_search.html +202 -202
  151. data/distro/common/html/knife_serve.html +78 -78
  152. data/distro/common/html/knife_show.html +103 -103
  153. data/distro/common/html/knife_ssh.html +176 -176
  154. data/distro/common/html/knife_ssl_check.html +150 -150
  155. data/distro/common/html/knife_ssl_fetch.html +150 -150
  156. data/distro/common/html/knife_status.html +143 -143
  157. data/distro/common/html/knife_tag.html +137 -137
  158. data/distro/common/html/knife_upload.html +152 -152
  159. data/distro/common/html/knife_user.html +241 -241
  160. data/distro/common/html/knife_using.html +209 -209
  161. data/distro/common/html/knife_xargs.html +121 -121
  162. data/distro/common/html/search.html +81 -81
  163. data/distro/common/man/man1/README.md +58 -58
  164. data/distro/common/man/man1/chef-shell.1 +194 -194
  165. data/distro/common/man/man1/knife-bootstrap.1 +215 -215
  166. data/distro/common/man/man1/knife-client.1 +443 -443
  167. data/distro/common/man/man1/knife-configure.1 +161 -161
  168. data/distro/common/man/man1/knife-cookbook-site.1 +552 -552
  169. data/distro/common/man/man1/knife-cookbook.1 +770 -770
  170. data/distro/common/man/man1/knife-data-bag.1 +617 -617
  171. data/distro/common/man/man1/knife-delete.1 +127 -127
  172. data/distro/common/man/man1/knife-deps.1 +246 -246
  173. data/distro/common/man/man1/knife-diff.1 +226 -226
  174. data/distro/common/man/man1/knife-download.1 +258 -258
  175. data/distro/common/man/man1/knife-edit.1 +121 -121
  176. data/distro/common/man/man1/knife-environment.1 +508 -508
  177. data/distro/common/man/man1/knife-exec.1 +362 -362
  178. data/distro/common/man/man1/knife-index-rebuild.1 +63 -63
  179. data/distro/common/man/man1/knife-list.1 +174 -174
  180. data/distro/common/man/man1/knife-node.1 +716 -716
  181. data/distro/common/man/man1/knife-raw.1 +172 -172
  182. data/distro/common/man/man1/knife-recipe-list.1 +85 -85
  183. data/distro/common/man/man1/knife-role.1 +426 -426
  184. data/distro/common/man/man1/knife-search.1 +359 -359
  185. data/distro/common/man/man1/knife-serve.1 +109 -109
  186. data/distro/common/man/man1/knife-show.1 +160 -160
  187. data/distro/common/man/man1/knife-ssh.1 +284 -284
  188. data/distro/common/man/man1/knife-ssl-check.1 +207 -207
  189. data/distro/common/man/man1/knife-ssl-fetch.1 +207 -207
  190. data/distro/common/man/man1/knife-status.1 +234 -234
  191. data/distro/common/man/man1/knife-tag.1 +189 -189
  192. data/distro/common/man/man1/knife-upload.1 +280 -280
  193. data/distro/common/man/man1/knife-user.1 +356 -356
  194. data/distro/common/man/man1/knife-xargs.1 +189 -189
  195. data/distro/common/man/man1/knife.1 +332 -332
  196. data/distro/common/man/man8/chef-apply.8 +86 -86
  197. data/distro/common/man/man8/chef-client.8 +398 -398
  198. data/distro/common/man/man8/chef-solo.8 +260 -260
  199. data/distro/common/markdown/README +3 -3
  200. data/distro/common/markdown/man1/chef-shell.mkd +195 -195
  201. data/distro/common/markdown/man1/knife-bootstrap.mkd +141 -141
  202. data/distro/common/markdown/man1/knife-client.mkd +103 -103
  203. data/distro/common/markdown/man1/knife-configure.mkd +70 -70
  204. data/distro/common/markdown/man1/knife-cookbook-site.mkd +123 -123
  205. data/distro/common/markdown/man1/knife-cookbook.mkd +263 -263
  206. data/distro/common/markdown/man1/knife-data-bag.mkd +121 -121
  207. data/distro/common/markdown/man1/knife-environment.mkd +151 -151
  208. data/distro/common/markdown/man1/knife-exec.mkd +42 -42
  209. data/distro/common/markdown/man1/knife-index.mkd +30 -30
  210. data/distro/common/markdown/man1/knife-node.mkd +130 -130
  211. data/distro/common/markdown/man1/knife-role.mkd +85 -85
  212. data/distro/common/markdown/man1/knife-search.mkd +180 -180
  213. data/distro/common/markdown/man1/knife-ssh.mkd +69 -69
  214. data/distro/common/markdown/man1/knife-status.mkd +36 -36
  215. data/distro/common/markdown/man1/knife-tag.mkd +39 -39
  216. data/distro/common/markdown/man1/knife.mkd +213 -213
  217. data/distro/common/markdown/man8/chef-client.mkd +75 -75
  218. data/distro/common/markdown/man8/chef-expander.mkd +81 -81
  219. data/distro/common/markdown/man8/chef-expanderctl.mkd +57 -57
  220. data/distro/common/markdown/man8/chef-server-webui.mkd +121 -121
  221. data/distro/common/markdown/man8/chef-server.mkd +120 -120
  222. data/distro/common/markdown/man8/chef-solo.mkd +107 -107
  223. data/distro/common/markdown/man8/chef-solr.mkd +89 -89
  224. data/distro/powershell/chef/chef.psm1 +327 -327
  225. data/ext/win32-eventlog/Rakefile +53 -53
  226. data/ext/win32-eventlog/chef-log.man +56 -56
  227. data/lib-backcompat/chef/chef_fs/file_system/acl_entry.rb +5 -5
  228. data/lib-backcompat/chef/chef_fs/file_system/chef_repository_file_system_root_dir.rb +5 -5
  229. data/lib-backcompat/chef/chef_fs/file_system/chef_server_root_dir.rb +5 -5
  230. data/lib/chef.rb +35 -35
  231. data/lib/chef/api_client.rb +233 -233
  232. data/lib/chef/api_client/registration.rb +192 -192
  233. data/lib/chef/api_client_v1.rb +325 -325
  234. data/lib/chef/application.rb +357 -342
  235. data/lib/chef/application/apply.rb +221 -221
  236. data/lib/chef/application/client.rb +520 -513
  237. data/lib/chef/application/knife.rb +208 -208
  238. data/lib/chef/application/solo.rb +334 -334
  239. data/lib/chef/application/windows_service.rb +338 -338
  240. data/lib/chef/application/windows_service_manager.rb +202 -202
  241. data/lib/chef/applications.rb +4 -4
  242. data/lib/chef/audit/audit_event_proxy.rb +93 -93
  243. data/lib/chef/audit/audit_reporter.rb +172 -172
  244. data/lib/chef/audit/control_group_data.rb +139 -139
  245. data/lib/chef/audit/logger.rb +36 -36
  246. data/lib/chef/audit/rspec_formatter.rb +37 -37
  247. data/lib/chef/audit/runner.rb +196 -196
  248. data/lib/chef/chef_class.rb +228 -228
  249. data/lib/chef/chef_fs.rb +59 -59
  250. data/lib/chef/chef_fs/chef_fs_data_store.rb +871 -871
  251. data/lib/chef/chef_fs/command_line.rb +285 -285
  252. data/lib/chef/chef_fs/config.rb +284 -283
  253. data/lib/chef/chef_fs/data_handler/acl_data_handler.rb +26 -26
  254. data/lib/chef/chef_fs/data_handler/client_data_handler.rb +39 -39
  255. data/lib/chef/chef_fs/data_handler/client_key_data_handler.rb +11 -11
  256. data/lib/chef/chef_fs/data_handler/container_data_handler.rb +35 -35
  257. data/lib/chef/chef_fs/data_handler/cookbook_data_handler.rb +38 -38
  258. data/lib/chef/chef_fs/data_handler/data_bag_item_data_handler.rb +62 -62
  259. data/lib/chef/chef_fs/data_handler/data_handler_base.rb +204 -204
  260. data/lib/chef/chef_fs/data_handler/environment_data_handler.rb +40 -40
  261. data/lib/chef/chef_fs/data_handler/group_data_handler.rb +55 -55
  262. data/lib/chef/chef_fs/data_handler/node_data_handler.rb +36 -36
  263. data/lib/chef/chef_fs/data_handler/organization_data_handler.rb +36 -36
  264. data/lib/chef/chef_fs/data_handler/organization_invites_data_handler.rb +17 -17
  265. data/lib/chef/chef_fs/data_handler/organization_members_data_handler.rb +17 -17
  266. data/lib/chef/chef_fs/data_handler/policy_data_handler.rb +48 -48
  267. data/lib/chef/chef_fs/data_handler/policy_group_data_handler.rb +33 -33
  268. data/lib/chef/chef_fs/data_handler/role_data_handler.rb +40 -40
  269. data/lib/chef/chef_fs/data_handler/user_data_handler.rb +29 -29
  270. data/lib/chef/chef_fs/file_pattern.rb +301 -301
  271. data/lib/chef/chef_fs/file_system.rb +429 -429
  272. data/lib/chef/chef_fs/file_system/already_exists_error.rb +28 -28
  273. data/lib/chef/chef_fs/file_system/base_fs_dir.rb +47 -47
  274. data/lib/chef/chef_fs/file_system/base_fs_object.rb +183 -183
  275. data/lib/chef/chef_fs/file_system/chef_server/acl_dir.rb +65 -65
  276. data/lib/chef/chef_fs/file_system/chef_server/acl_entry.rb +60 -60
  277. data/lib/chef/chef_fs/file_system/chef_server/acls_dir.rb +75 -75
  278. data/lib/chef/chef_fs/file_system/chef_server/chef_server_root_dir.rb +196 -196
  279. data/lib/chef/chef_fs/file_system/chef_server/cookbook_artifact_dir.rb +38 -38
  280. data/lib/chef/chef_fs/file_system/chef_server/cookbook_artifacts_dir.rb +102 -102
  281. data/lib/chef/chef_fs/file_system/chef_server/cookbook_dir.rb +222 -222
  282. data/lib/chef/chef_fs/file_system/chef_server/cookbook_file.rb +84 -84
  283. data/lib/chef/chef_fs/file_system/chef_server/cookbook_subdir.rb +61 -61
  284. data/lib/chef/chef_fs/file_system/chef_server/cookbooks_acl_dir.rb +42 -42
  285. data/lib/chef/chef_fs/file_system/chef_server/cookbooks_dir.rb +102 -102
  286. data/lib/chef/chef_fs/file_system/chef_server/data_bag_dir.rb +71 -71
  287. data/lib/chef/chef_fs/file_system/chef_server/data_bags_dir.rb +69 -69
  288. data/lib/chef/chef_fs/file_system/chef_server/environments_dir.rb +57 -57
  289. data/lib/chef/chef_fs/file_system/chef_server/nodes_dir.rb +53 -53
  290. data/lib/chef/chef_fs/file_system/chef_server/org_entry.rb +31 -31
  291. data/lib/chef/chef_fs/file_system/chef_server/organization_invites_entry.rb +61 -61
  292. data/lib/chef/chef_fs/file_system/chef_server/organization_members_entry.rb +60 -60
  293. data/lib/chef/chef_fs/file_system/chef_server/policies_acl_dir.rb +41 -41
  294. data/lib/chef/chef_fs/file_system/chef_server/policies_dir.rb +160 -160
  295. data/lib/chef/chef_fs/file_system/chef_server/policy_group_entry.rb +137 -137
  296. data/lib/chef/chef_fs/file_system/chef_server/policy_groups_dir.rb +43 -43
  297. data/lib/chef/chef_fs/file_system/chef_server/policy_revision_entry.rb +34 -34
  298. data/lib/chef/chef_fs/file_system/chef_server/rest_list_dir.rb +178 -178
  299. data/lib/chef/chef_fs/file_system/chef_server/rest_list_entry.rb +187 -187
  300. data/lib/chef/chef_fs/file_system/chef_server/versioned_cookbook_dir.rb +45 -45
  301. data/lib/chef/chef_fs/file_system/chef_server/versioned_cookbooks_dir.rb +107 -107
  302. data/lib/chef/chef_fs/file_system/cookbook_frozen_error.rb +28 -28
  303. data/lib/chef/chef_fs/file_system/default_environment_cannot_be_modified_error.rb +32 -32
  304. data/lib/chef/chef_fs/file_system/file_system_error.rb +44 -44
  305. data/lib/chef/chef_fs/file_system/memory/memory_dir.rb +53 -53
  306. data/lib/chef/chef_fs/file_system/memory/memory_file.rb +20 -20
  307. data/lib/chef/chef_fs/file_system/memory/memory_root.rb +23 -23
  308. data/lib/chef/chef_fs/file_system/multiplexed_dir.rb +64 -64
  309. data/lib/chef/chef_fs/file_system/must_delete_recursively_error.rb +28 -28
  310. data/lib/chef/chef_fs/file_system/nonexistent_fs_object.rb +36 -36
  311. data/lib/chef/chef_fs/file_system/not_found_error.rb +28 -28
  312. data/lib/chef/chef_fs/file_system/operation_failed_error.rb +42 -42
  313. data/lib/chef/chef_fs/file_system/operation_not_allowed_error.rb +46 -46
  314. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_acls_dir.rb +39 -39
  315. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_client_keys_dir.rb +38 -38
  316. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_cookbook_artifact_dir.rb +41 -41
  317. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_cookbook_dir.rb +146 -146
  318. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_cookbook_entry.rb +176 -176
  319. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_entry.rb +83 -83
  320. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_policies_dir.rb +38 -38
  321. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_root_dir.rb +214 -214
  322. data/lib/chef/chef_fs/file_system/repository/chef_repository_file_system_versioned_cookbook_dir.rb +42 -42
  323. data/lib/chef/chef_fs/file_system/repository/cookbook_artifacts_dir.rb +36 -36
  324. data/lib/chef/chef_fs/file_system/repository/cookbooks_dir.rb +52 -52
  325. data/lib/chef/chef_fs/file_system/repository/data_bag.rb +39 -39
  326. data/lib/chef/chef_fs/file_system/repository/data_bag_item.rb +114 -114
  327. data/lib/chef/chef_fs/file_system/repository/data_bags_dir.rb +39 -39
  328. data/lib/chef/chef_fs/file_system/repository/directory.rb +139 -139
  329. data/lib/chef/chef_fs/file_system/repository/file_system_entry.rb +117 -117
  330. data/lib/chef/chef_fs/file_system/repository/file_system_root_dir.rb +33 -33
  331. data/lib/chef/chef_fs/file_system/repository/versioned_cookbooks_dir.rb +34 -34
  332. data/lib/chef/chef_fs/knife.rb +161 -161
  333. data/lib/chef/chef_fs/parallelizer.rb +105 -105
  334. data/lib/chef/chef_fs/parallelizer/flatten_enumerable.rb +35 -35
  335. data/lib/chef/chef_fs/parallelizer/parallel_enumerable.rb +281 -281
  336. data/lib/chef/chef_fs/path_utils.rb +127 -127
  337. data/lib/chef/client.rb +966 -967
  338. data/lib/chef/config.rb +85 -85
  339. data/lib/chef/config_fetcher.rb +72 -72
  340. data/lib/chef/constants.rb +28 -28
  341. data/lib/chef/cookbook/chefignore.rb +74 -74
  342. data/lib/chef/cookbook/cookbook_collection.rb +63 -63
  343. data/lib/chef/cookbook/cookbook_version_loader.rb +352 -352
  344. data/lib/chef/cookbook/file_system_file_vendor.rb +59 -59
  345. data/lib/chef/cookbook/file_vendor.rb +71 -71
  346. data/lib/chef/cookbook/gem_installer.rb +83 -118
  347. data/lib/chef/cookbook/metadata.rb +904 -904
  348. data/lib/chef/cookbook/remote_file_vendor.rb +87 -87
  349. data/lib/chef/cookbook/synchronizer.rb +298 -298
  350. data/lib/chef/cookbook/syntax_check.rb +260 -260
  351. data/lib/chef/cookbook_loader.rb +200 -200
  352. data/lib/chef/cookbook_manifest.rb +290 -290
  353. data/lib/chef/cookbook_site_streaming_uploader.rb +243 -244
  354. data/lib/chef/cookbook_uploader.rb +157 -157
  355. data/lib/chef/cookbook_version.rb +637 -631
  356. data/lib/chef/daemon.rb +131 -131
  357. data/lib/chef/data_bag.rb +176 -176
  358. data/lib/chef/data_bag_item.rb +218 -218
  359. data/lib/chef/delayed_evaluator.rb +21 -21
  360. data/lib/chef/deprecation/mixin/template.rb +48 -48
  361. data/lib/chef/deprecation/provider/cookbook_file.rb +54 -54
  362. data/lib/chef/deprecation/provider/file.rb +198 -198
  363. data/lib/chef/deprecation/provider/remote_directory.rb +52 -52
  364. data/lib/chef/deprecation/provider/remote_file.rb +85 -85
  365. data/lib/chef/deprecation/provider/template.rb +63 -63
  366. data/lib/chef/deprecation/warnings.rb +37 -38
  367. data/lib/chef/digester.rb +74 -74
  368. data/lib/chef/dsl.rb +6 -6
  369. data/lib/chef/dsl/audit.rb +51 -51
  370. data/lib/chef/dsl/chef_provisioning.rb +57 -57
  371. data/lib/chef/dsl/cheffish.rb +64 -64
  372. data/lib/chef/dsl/core.rb +42 -0
  373. data/lib/chef/dsl/data_query.rb +89 -89
  374. data/lib/chef/dsl/declare_resource.rb +106 -108
  375. data/lib/chef/dsl/definitions.rb +43 -43
  376. data/lib/chef/dsl/include_attribute.rb +61 -61
  377. data/lib/chef/dsl/include_recipe.rb +44 -44
  378. data/lib/chef/dsl/method_missing.rb +75 -0
  379. data/lib/chef/dsl/platform_introspection.rb +254 -254
  380. data/lib/chef/dsl/powershell.rb +29 -29
  381. data/lib/chef/dsl/reboot_pending.rb +64 -64
  382. data/lib/chef/dsl/recipe.rb +89 -134
  383. data/lib/chef/dsl/registry_helper.rb +63 -63
  384. data/lib/chef/dsl/resources.rb +58 -58
  385. data/lib/chef/encrypted_data_bag_item.rb +155 -155
  386. data/lib/chef/encrypted_data_bag_item/assertions.rb +54 -54
  387. data/lib/chef/encrypted_data_bag_item/check_encrypted.rb +56 -56
  388. data/lib/chef/encrypted_data_bag_item/decryption_failure.rb +22 -22
  389. data/lib/chef/encrypted_data_bag_item/decryptor.rb +227 -227
  390. data/lib/chef/encrypted_data_bag_item/encrypted_data_bag_item_assertions.rb +37 -37
  391. data/lib/chef/encrypted_data_bag_item/encryption_failure.rb +22 -22
  392. data/lib/chef/encrypted_data_bag_item/encryptor.rb +225 -225
  393. data/lib/chef/encrypted_data_bag_item/unacceptable_encrypted_data_bag_item_format.rb +22 -22
  394. data/lib/chef/encrypted_data_bag_item/unsupported_cipher.rb +22 -22
  395. data/lib/chef/encrypted_data_bag_item/unsupported_encrypted_data_bag_item_format.rb +22 -22
  396. data/lib/chef/environment.rb +326 -326
  397. data/lib/chef/event_dispatch/base.rb +426 -420
  398. data/lib/chef/event_dispatch/dispatcher.rb +62 -62
  399. data/lib/chef/event_dispatch/dsl.rb +65 -65
  400. data/lib/chef/event_dispatch/events_output_stream.rb +37 -37
  401. data/lib/chef/event_loggers/base.rb +62 -62
  402. data/lib/chef/event_loggers/windows_eventlog.rb +101 -101
  403. data/lib/chef/exceptions.rb +504 -504
  404. data/lib/chef/file_access_control.rb +75 -75
  405. data/lib/chef/file_access_control/unix.rb +290 -290
  406. data/lib/chef/file_access_control/windows.rb +335 -335
  407. data/lib/chef/file_cache.rb +221 -221
  408. data/lib/chef/file_content_management/content_base.rb +56 -56
  409. data/lib/chef/file_content_management/deploy.rb +37 -37
  410. data/lib/chef/file_content_management/deploy/cp.rb +48 -48
  411. data/lib/chef/file_content_management/deploy/mv_unix.rb +76 -76
  412. data/lib/chef/file_content_management/deploy/mv_windows.rb +103 -103
  413. data/lib/chef/file_content_management/tempfile.rb +97 -97
  414. data/lib/chef/formatters/base.rb +237 -237
  415. data/lib/chef/formatters/doc.rb +438 -422
  416. data/lib/chef/formatters/{error_descriptor.rb → error_description.rb} +69 -67
  417. data/lib/chef/formatters/error_inspectors.rb +19 -19
  418. data/lib/chef/formatters/error_inspectors/api_error_formatting.rb +184 -184
  419. data/lib/chef/formatters/error_inspectors/compile_error_inspector.rb +154 -154
  420. data/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb +168 -168
  421. data/lib/chef/formatters/error_inspectors/cookbook_sync_error_inspector.rb +82 -82
  422. data/lib/chef/formatters/error_inspectors/node_load_error_inspector.rb +128 -128
  423. data/lib/chef/formatters/error_inspectors/registration_error_inspector.rb +147 -147
  424. data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +124 -124
  425. data/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb +121 -121
  426. data/lib/chef/formatters/error_mapper.rb +85 -85
  427. data/lib/chef/formatters/indentable_output_stream.rb +170 -170
  428. data/lib/chef/formatters/minimal.rb +233 -233
  429. data/lib/chef/guard_interpreter.rb +32 -32
  430. data/lib/chef/guard_interpreter/default_guard_interpreter.rb +43 -43
  431. data/lib/chef/guard_interpreter/resource_guard_interpreter.rb +138 -138
  432. data/lib/chef/handler.rb +235 -235
  433. data/lib/chef/handler/error_report.rb +33 -33
  434. data/lib/chef/handler/json_file.rb +63 -63
  435. data/lib/chef/http.rb +460 -430
  436. data/lib/chef/http/auth_credentials.rb +57 -57
  437. data/lib/chef/http/authenticator.rb +106 -106
  438. data/lib/chef/http/basic_client.rb +149 -169
  439. data/lib/chef/http/cookie_jar.rb +31 -31
  440. data/lib/chef/http/cookie_manager.rb +59 -59
  441. data/lib/chef/http/decompressor.rb +142 -142
  442. data/lib/chef/http/http_request.rb +186 -186
  443. data/lib/chef/http/json_input.rb +73 -73
  444. data/lib/chef/http/json_output.rb +78 -78
  445. data/lib/chef/http/json_to_model_output.rb +34 -34
  446. data/lib/chef/http/remote_request_id.rb +46 -46
  447. data/lib/chef/http/simple.rb +40 -40
  448. data/lib/chef/http/simple_json.rb +43 -43
  449. data/lib/chef/http/socketless_chef_zero_client.rb +208 -207
  450. data/lib/chef/http/ssl_policies.rb +130 -130
  451. data/lib/chef/http/validate_content_length.rb +114 -115
  452. data/lib/chef/json_compat.rb +164 -164
  453. data/lib/chef/key.rb +273 -273
  454. data/lib/chef/knife.rb +587 -587
  455. data/lib/chef/knife/bootstrap.rb +480 -480
  456. data/lib/chef/knife/bootstrap/chef_vault_handler.rb +159 -159
  457. data/lib/chef/knife/bootstrap/client_builder.rb +208 -208
  458. data/lib/chef/knife/bootstrap/templates/README.md +11 -11
  459. data/lib/chef/knife/bootstrap/templates/chef-full.erb +236 -236
  460. data/lib/chef/knife/client_bulk_delete.rb +104 -104
  461. data/lib/chef/knife/client_create.rb +111 -111
  462. data/lib/chef/knife/client_delete.rb +60 -60
  463. data/lib/chef/knife/client_edit.rb +53 -53
  464. data/lib/chef/knife/client_key_create.rb +67 -67
  465. data/lib/chef/knife/client_key_delete.rb +76 -76
  466. data/lib/chef/knife/client_key_edit.rb +79 -79
  467. data/lib/chef/knife/client_key_list.rb +69 -69
  468. data/lib/chef/knife/client_key_show.rb +76 -76
  469. data/lib/chef/knife/client_list.rb +42 -42
  470. data/lib/chef/knife/client_reregister.rb +59 -59
  471. data/lib/chef/knife/client_show.rb +49 -49
  472. data/lib/chef/knife/configure.rb +171 -171
  473. data/lib/chef/knife/configure_client.rb +50 -50
  474. data/lib/chef/knife/cookbook_bulk_delete.rb +71 -71
  475. data/lib/chef/knife/cookbook_create.rb +458 -448
  476. data/lib/chef/knife/cookbook_delete.rb +151 -151
  477. data/lib/chef/knife/cookbook_download.rb +143 -143
  478. data/lib/chef/knife/cookbook_list.rb +47 -47
  479. data/lib/chef/knife/cookbook_metadata.rb +107 -108
  480. data/lib/chef/knife/cookbook_metadata_from_file.rb +44 -44
  481. data/lib/chef/knife/cookbook_show.rb +98 -98
  482. data/lib/chef/knife/cookbook_site_download.rb +109 -109
  483. data/lib/chef/knife/cookbook_site_install.rb +192 -192
  484. data/lib/chef/knife/cookbook_site_list.rb +58 -58
  485. data/lib/chef/knife/cookbook_site_search.rb +46 -46
  486. data/lib/chef/knife/cookbook_site_share.rb +169 -169
  487. data/lib/chef/knife/cookbook_site_show.rb +55 -55
  488. data/lib/chef/knife/cookbook_site_unshare.rb +56 -56
  489. data/lib/chef/knife/cookbook_site_vendor.rb +46 -46
  490. data/lib/chef/knife/cookbook_test.rb +95 -95
  491. data/lib/chef/knife/cookbook_upload.rb +308 -308
  492. data/lib/chef/knife/core/bootstrap_context.rb +233 -233
  493. data/lib/chef/knife/core/cookbook_scm_repo.rb +159 -159
  494. data/lib/chef/knife/core/custom_manifest_loader.rb +69 -69
  495. data/lib/chef/knife/core/gem_glob_loader.rb +138 -138
  496. data/lib/chef/knife/core/generic_presenter.rb +222 -222
  497. data/lib/chef/knife/core/hashed_command_loader.rb +99 -99
  498. data/lib/chef/knife/core/node_editor.rb +130 -130
  499. data/lib/chef/knife/core/node_presenter.rb +159 -159
  500. data/lib/chef/knife/core/object_loader.rb +115 -115
  501. data/lib/chef/knife/core/status_presenter.rb +157 -157
  502. data/lib/chef/knife/core/subcommand_loader.rb +212 -212
  503. data/lib/chef/knife/core/text_formatter.rb +85 -85
  504. data/lib/chef/knife/core/ui.rb +284 -284
  505. data/lib/chef/knife/data_bag_create.rb +78 -78
  506. data/lib/chef/knife/data_bag_delete.rb +49 -49
  507. data/lib/chef/knife/data_bag_edit.rb +74 -74
  508. data/lib/chef/knife/data_bag_from_file.rb +114 -114
  509. data/lib/chef/knife/data_bag_list.rb +42 -42
  510. data/lib/chef/knife/data_bag_secret_options.rb +142 -142
  511. data/lib/chef/knife/data_bag_show.rb +69 -69
  512. data/lib/chef/knife/delete.rb +107 -107
  513. data/lib/chef/knife/deps.rb +140 -140
  514. data/lib/chef/knife/diff.rb +68 -68
  515. data/lib/chef/knife/download.rb +68 -68
  516. data/lib/chef/knife/edit.rb +72 -72
  517. data/lib/chef/knife/environment_compare.rb +127 -127
  518. data/lib/chef/knife/environment_create.rb +53 -53
  519. data/lib/chef/knife/environment_delete.rb +45 -45
  520. data/lib/chef/knife/environment_edit.rb +45 -45
  521. data/lib/chef/knife/environment_from_file.rb +82 -82
  522. data/lib/chef/knife/environment_list.rb +42 -42
  523. data/lib/chef/knife/environment_show.rb +48 -48
  524. data/lib/chef/knife/exec.rb +87 -87
  525. data/lib/chef/knife/help.rb +101 -101
  526. data/lib/chef/knife/help_topics.rb +4 -4
  527. data/lib/chef/knife/index_rebuild.rb +133 -133
  528. data/lib/chef/knife/key_create.rb +112 -112
  529. data/lib/chef/knife/key_create_base.rb +50 -50
  530. data/lib/chef/knife/key_delete.rb +55 -55
  531. data/lib/chef/knife/key_edit.rb +118 -118
  532. data/lib/chef/knife/key_edit_base.rb +55 -55
  533. data/lib/chef/knife/key_list.rb +88 -88
  534. data/lib/chef/knife/key_list_base.rb +45 -45
  535. data/lib/chef/knife/key_show.rb +53 -53
  536. data/lib/chef/knife/list.rb +157 -157
  537. data/lib/chef/knife/node_bulk_delete.rb +74 -74
  538. data/lib/chef/knife/node_create.rb +47 -47
  539. data/lib/chef/knife/node_delete.rb +46 -46
  540. data/lib/chef/knife/node_edit.rb +70 -70
  541. data/lib/chef/knife/node_environment_set.rb +54 -54
  542. data/lib/chef/knife/node_from_file.rb +51 -51
  543. data/lib/chef/knife/node_list.rb +44 -44
  544. data/lib/chef/knife/node_run_list_add.rb +104 -104
  545. data/lib/chef/knife/node_run_list_remove.rb +67 -67
  546. data/lib/chef/knife/node_run_list_set.rb +66 -66
  547. data/lib/chef/knife/node_show.rb +66 -66
  548. data/lib/chef/knife/null.rb +10 -10
  549. data/lib/chef/knife/osc_user_create.rb +97 -97
  550. data/lib/chef/knife/osc_user_delete.rb +51 -51
  551. data/lib/chef/knife/osc_user_edit.rb +58 -58
  552. data/lib/chef/knife/osc_user_list.rb +47 -47
  553. data/lib/chef/knife/osc_user_reregister.rb +64 -64
  554. data/lib/chef/knife/osc_user_show.rb +54 -54
  555. data/lib/chef/knife/raw.rb +103 -103
  556. data/lib/chef/knife/recipe_list.rb +32 -32
  557. data/lib/chef/knife/rehash.rb +65 -65
  558. data/lib/chef/knife/role_bulk_delete.rb +65 -65
  559. data/lib/chef/knife/role_create.rb +53 -53
  560. data/lib/chef/knife/role_delete.rb +46 -46
  561. data/lib/chef/knife/role_edit.rb +45 -45
  562. data/lib/chef/knife/role_env_run_list_add.rb +86 -86
  563. data/lib/chef/knife/role_env_run_list_clear.rb +55 -55
  564. data/lib/chef/knife/role_env_run_list_remove.rb +57 -57
  565. data/lib/chef/knife/role_env_run_list_replace.rb +59 -59
  566. data/lib/chef/knife/role_env_run_list_set.rb +70 -70
  567. data/lib/chef/knife/role_from_file.rb +51 -51
  568. data/lib/chef/knife/role_list.rb +42 -42
  569. data/lib/chef/knife/role_run_list_add.rb +86 -86
  570. data/lib/chef/knife/role_run_list_clear.rb +55 -55
  571. data/lib/chef/knife/role_run_list_remove.rb +57 -57
  572. data/lib/chef/knife/role_run_list_replace.rb +59 -59
  573. data/lib/chef/knife/role_run_list_set.rb +70 -70
  574. data/lib/chef/knife/role_show.rb +49 -49
  575. data/lib/chef/knife/search.rb +201 -201
  576. data/lib/chef/knife/serve.rb +48 -48
  577. data/lib/chef/knife/show.rb +56 -56
  578. data/lib/chef/knife/ssh.rb +582 -572
  579. data/lib/chef/knife/ssl_check.rb +282 -281
  580. data/lib/chef/knife/ssl_fetch.rb +157 -157
  581. data/lib/chef/knife/status.rb +110 -110
  582. data/lib/chef/knife/tag_create.rb +52 -52
  583. data/lib/chef/knife/tag_delete.rb +60 -60
  584. data/lib/chef/knife/tag_list.rb +47 -47
  585. data/lib/chef/knife/upload.rb +70 -70
  586. data/lib/chef/knife/user_create.rb +150 -150
  587. data/lib/chef/knife/user_delete.rb +95 -95
  588. data/lib/chef/knife/user_edit.rb +81 -81
  589. data/lib/chef/knife/user_key_create.rb +69 -69
  590. data/lib/chef/knife/user_key_delete.rb +76 -76
  591. data/lib/chef/knife/user_key_edit.rb +79 -79
  592. data/lib/chef/knife/user_key_list.rb +69 -69
  593. data/lib/chef/knife/user_key_show.rb +76 -76
  594. data/lib/chef/knife/user_list.rb +45 -45
  595. data/lib/chef/knife/user_reregister.rb +89 -89
  596. data/lib/chef/knife/user_show.rb +78 -78
  597. data/lib/chef/knife/xargs.rb +266 -266
  598. data/lib/chef/local_mode.rb +128 -128
  599. data/lib/chef/log.rb +68 -68
  600. data/lib/chef/log/syslog.rb +45 -45
  601. data/lib/chef/log/winevt.rb +99 -99
  602. data/lib/chef/mash.rb +226 -226
  603. data/lib/chef/mixin/api_version_request_handling.rb +66 -66
  604. data/lib/chef/mixin/checksum.rb +32 -32
  605. data/lib/chef/mixin/command.rb +193 -193
  606. data/lib/chef/mixin/command/unix.rb +220 -220
  607. data/lib/chef/mixin/command/windows.rb +71 -71
  608. data/lib/chef/mixin/convert_to_class_name.rb +126 -126
  609. data/lib/chef/mixin/create_path.rb +73 -73
  610. data/lib/chef/mixin/deep_merge.rb +140 -140
  611. data/lib/chef/mixin/deprecation.rb +123 -123
  612. data/lib/chef/mixin/descendants_tracker.rb +81 -81
  613. data/lib/chef/mixin/enforce_ownership_and_permissions.rb +39 -39
  614. data/lib/chef/mixin/file_class.rb +35 -35
  615. data/lib/chef/mixin/from_file.rb +50 -50
  616. data/lib/chef/mixin/get_source_from_package.rb +47 -47
  617. data/lib/chef/mixin/homebrew_user.rb +68 -68
  618. data/lib/chef/mixin/language.rb +48 -48
  619. data/lib/chef/mixin/language_include_attribute.rb +34 -34
  620. data/lib/chef/mixin/language_include_recipe.rb +31 -31
  621. data/lib/chef/mixin/lazy_module_include.rb +77 -0
  622. data/lib/chef/mixin/params_validate.rb +489 -489
  623. data/lib/chef/mixin/path_sanity.rb +68 -68
  624. data/lib/chef/mixin/powershell_out.rb +98 -98
  625. data/lib/chef/mixin/powershell_type_coercions.rb +84 -84
  626. data/lib/chef/mixin/properties.rb +303 -303
  627. data/lib/chef/mixin/provides.rb +28 -28
  628. data/lib/chef/mixin/proxified_socket.rb +42 -38
  629. data/lib/chef/mixin/recipe_definition_dsl_core.rb +35 -35
  630. data/lib/chef/mixin/securable.rb +196 -196
  631. data/lib/chef/mixin/shell_out.rb +117 -117
  632. data/lib/chef/mixin/subclass_directive.rb +37 -37
  633. data/lib/chef/mixin/template.rb +262 -262
  634. data/lib/chef/mixin/unformatter.rb +32 -32
  635. data/lib/chef/mixin/uris.rb +43 -43
  636. data/lib/chef/mixin/which.rb +37 -37
  637. data/lib/chef/mixin/why_run.rb +331 -331
  638. data/lib/chef/mixin/wide_string.rb +72 -72
  639. data/lib/chef/mixin/windows_architecture_helper.rb +114 -114
  640. data/lib/chef/mixin/windows_env_helper.rb +67 -67
  641. data/lib/chef/mixin/xml_escape.rb +140 -140
  642. data/lib/chef/mixins.rb +13 -13
  643. data/lib/chef/monkey_patches/net-ssh-multi.rb +141 -140
  644. data/lib/chef/monkey_patches/net_http.rb +60 -60
  645. data/lib/chef/monkey_patches/webrick-utils.rb +51 -51
  646. data/lib/chef/monkey_patches/win32/registry.rb +75 -72
  647. data/lib/chef/monologger.rb +88 -88
  648. data/lib/chef/nil_argument.rb +3 -3
  649. data/lib/chef/node.rb +700 -700
  650. data/lib/chef/node/attribute.rb +586 -586
  651. data/lib/chef/node/attribute_collections.rb +323 -323
  652. data/lib/chef/node/immutable_collections.rb +219 -219
  653. data/lib/chef/node_map.rb +222 -222
  654. data/lib/chef/null_logger.rb +72 -72
  655. data/lib/chef/org.rb +149 -149
  656. data/lib/chef/platform.rb +30 -30
  657. data/lib/chef/platform/handler_map.rb +40 -40
  658. data/lib/chef/platform/priority_map.rb +41 -41
  659. data/lib/chef/platform/provider_handler_map.rb +29 -29
  660. data/lib/chef/platform/provider_mapping.rb +214 -214
  661. data/lib/chef/platform/provider_priority_map.rb +11 -11
  662. data/lib/chef/platform/query_helpers.rb +112 -112
  663. data/lib/chef/platform/rebooter.rb +54 -54
  664. data/lib/chef/platform/resource_handler_map.rb +29 -29
  665. data/lib/chef/platform/resource_priority_map.rb +11 -11
  666. data/lib/chef/platform/service_helpers.rb +122 -122
  667. data/lib/chef/policy_builder.rb +42 -42
  668. data/lib/chef/policy_builder/dynamic.rb +185 -185
  669. data/lib/chef/policy_builder/expand_node_object.rb +278 -278
  670. data/lib/chef/policy_builder/policyfile.rb +523 -527
  671. data/lib/chef/property.rb +674 -673
  672. data/lib/chef/provider.rb +458 -461
  673. data/lib/chef/provider/apt_repository.rb +255 -0
  674. data/lib/chef/provider/apt_update.rb +80 -79
  675. data/lib/chef/provider/batch.rb +45 -45
  676. data/lib/chef/provider/breakpoint.rb +38 -38
  677. data/lib/chef/provider/cookbook_file.rb +53 -53
  678. data/lib/chef/provider/cookbook_file/content.rb +49 -49
  679. data/lib/chef/provider/cron.rb +263 -263
  680. data/lib/chef/provider/cron/aix.rb +50 -50
  681. data/lib/chef/provider/cron/solaris.rb +22 -22
  682. data/lib/chef/provider/cron/unix.rb +83 -83
  683. data/lib/chef/provider/deploy.rb +476 -476
  684. data/lib/chef/provider/deploy/revision.rb +109 -109
  685. data/lib/chef/provider/deploy/timestamped.rb +34 -34
  686. data/lib/chef/provider/directory.rb +152 -152
  687. data/lib/chef/provider/dsc_resource.rb +197 -197
  688. data/lib/chef/provider/dsc_script.rb +185 -185
  689. data/lib/chef/provider/env.rb +169 -169
  690. data/lib/chef/provider/env/windows.rb +72 -72
  691. data/lib/chef/provider/erl_call.rb +108 -108
  692. data/lib/chef/provider/execute.rb +125 -125
  693. data/lib/chef/provider/file.rb +495 -495
  694. data/lib/chef/provider/file/content.rb +39 -39
  695. data/lib/chef/provider/git.rb +332 -332
  696. data/lib/chef/provider/group.rb +183 -183
  697. data/lib/chef/provider/group/aix.rb +86 -86
  698. data/lib/chef/provider/group/dscl.rb +170 -170
  699. data/lib/chef/provider/group/gpasswd.rb +58 -58
  700. data/lib/chef/provider/group/groupadd.rb +137 -137
  701. data/lib/chef/provider/group/groupmod.rb +128 -128
  702. data/lib/chef/provider/group/pw.rb +140 -140
  703. data/lib/chef/provider/group/suse.rb +64 -62
  704. data/lib/chef/provider/group/usermod.rb +91 -91
  705. data/lib/chef/provider/group/windows.rb +98 -98
  706. data/lib/chef/provider/http_request.rb +122 -122
  707. data/lib/chef/provider/ifconfig.rb +226 -226
  708. data/lib/chef/provider/ifconfig/aix.rb +99 -99
  709. data/lib/chef/provider/ifconfig/debian.rb +84 -84
  710. data/lib/chef/provider/ifconfig/redhat.rb +48 -48
  711. data/lib/chef/provider/launchd.rb +208 -208
  712. data/lib/chef/provider/link.rb +159 -159
  713. data/lib/chef/provider/log.rb +57 -57
  714. data/lib/chef/provider/lwrp_base.rb +99 -99
  715. data/lib/chef/provider/mdadm.rb +92 -92
  716. data/lib/chef/provider/mount.rb +169 -173
  717. data/lib/chef/provider/mount/aix.rb +180 -180
  718. data/lib/chef/provider/mount/mount.rb +270 -270
  719. data/lib/chef/provider/mount/solaris.rb +271 -271
  720. data/lib/chef/provider/mount/windows.rb +92 -86
  721. data/lib/chef/provider/noop.rb +37 -0
  722. data/lib/chef/provider/ohai.rb +49 -49
  723. data/lib/chef/provider/osx_profile.rb +256 -256
  724. data/lib/chef/provider/package.rb +565 -565
  725. data/lib/chef/provider/package/aix.rb +136 -136
  726. data/lib/chef/provider/package/apt.rb +185 -185
  727. data/lib/chef/provider/package/chocolatey.rb +275 -275
  728. data/lib/chef/provider/package/dpkg.rb +226 -226
  729. data/lib/chef/provider/package/easy_install.rb +133 -133
  730. data/lib/chef/provider/package/freebsd/base.rb +89 -89
  731. data/lib/chef/provider/package/freebsd/pkg.rb +114 -114
  732. data/lib/chef/provider/package/freebsd/pkgng.rb +78 -78
  733. data/lib/chef/provider/package/freebsd/port.rb +60 -60
  734. data/lib/chef/provider/package/homebrew.rb +137 -137
  735. data/lib/chef/provider/package/ips.rb +91 -91
  736. data/lib/chef/provider/package/macports.rb +101 -101
  737. data/lib/chef/provider/package/openbsd.rb +136 -136
  738. data/lib/chef/provider/package/pacman.rb +104 -104
  739. data/lib/chef/provider/package/paludis.rb +86 -86
  740. data/lib/chef/provider/package/portage.rb +140 -140
  741. data/lib/chef/provider/package/rpm.rb +123 -123
  742. data/lib/chef/provider/package/rubygems.rb +586 -586
  743. data/lib/chef/provider/package/smartos.rb +92 -92
  744. data/lib/chef/provider/package/solaris.rb +138 -138
  745. data/lib/chef/provider/package/windows.rb +269 -269
  746. data/lib/chef/provider/package/windows/exe.rb +117 -117
  747. data/lib/chef/provider/package/windows/msi.rb +93 -93
  748. data/lib/chef/provider/package/windows/registry_uninstall_entry.rb +89 -89
  749. data/lib/chef/provider/package/yum-dump.py +307 -307
  750. data/lib/chef/provider/package/yum.rb +1421 -1421
  751. data/lib/chef/provider/package/zypper.rb +143 -143
  752. data/lib/chef/provider/powershell_script.rb +215 -215
  753. data/lib/chef/provider/reboot.rb +70 -70
  754. data/lib/chef/provider/registry_key.rb +155 -155
  755. data/lib/chef/provider/remote_directory.rb +281 -281
  756. data/lib/chef/provider/remote_file.rb +53 -53
  757. data/lib/chef/provider/remote_file/cache_control_data.rb +195 -195
  758. data/lib/chef/provider/remote_file/content.rb +81 -81
  759. data/lib/chef/provider/remote_file/fetcher.rb +57 -55
  760. data/lib/chef/provider/remote_file/ftp.rb +172 -183
  761. data/lib/chef/provider/remote_file/http.rb +135 -117
  762. data/lib/chef/provider/remote_file/local_file.rb +60 -60
  763. data/lib/chef/provider/remote_file/network_file.rb +48 -48
  764. data/lib/chef/provider/remote_file/sftp.rb +105 -0
  765. data/lib/chef/provider/resource_update.rb +52 -52
  766. data/lib/chef/provider/route.rb +229 -229
  767. data/lib/chef/provider/ruby_block.rb +44 -44
  768. data/lib/chef/provider/script.rb +85 -85
  769. data/lib/chef/provider/service.rb +259 -250
  770. data/lib/chef/provider/service/aix.rb +129 -129
  771. data/lib/chef/provider/service/aixinit.rb +117 -117
  772. data/lib/chef/provider/service/arch.rb +118 -118
  773. data/lib/chef/provider/service/debian.rb +182 -182
  774. data/lib/chef/provider/service/freebsd.rb +195 -195
  775. data/lib/chef/provider/service/gentoo.rb +71 -71
  776. data/lib/chef/provider/service/init.rb +94 -94
  777. data/lib/chef/provider/service/insserv.rb +59 -59
  778. data/lib/chef/provider/service/invokercd.rb +41 -41
  779. data/lib/chef/provider/service/macosx.rb +250 -250
  780. data/lib/chef/provider/service/openbsd.rb +217 -217
  781. data/lib/chef/provider/service/redhat.rb +126 -120
  782. data/lib/chef/provider/service/simple.rb +175 -175
  783. data/lib/chef/provider/service/solaris.rb +122 -117
  784. data/lib/chef/provider/service/systemd.rb +188 -155
  785. data/lib/chef/provider/service/upstart.rb +242 -242
  786. data/lib/chef/provider/service/windows.rb +313 -313
  787. data/lib/chef/provider/subversion.rb +233 -221
  788. data/lib/chef/provider/template.rb +65 -65
  789. data/lib/chef/provider/template/content.rb +70 -70
  790. data/lib/chef/provider/template_finder.rb +62 -62
  791. data/lib/chef/provider/user.rb +211 -211
  792. data/lib/chef/provider/user/aix.rb +97 -97
  793. data/lib/chef/provider/user/dscl.rb +710 -710
  794. data/lib/chef/provider/user/pw.rb +114 -114
  795. data/lib/chef/provider/user/solaris.rb +121 -121
  796. data/lib/chef/provider/user/useradd.rb +163 -163
  797. data/lib/chef/provider/user/windows.rb +128 -128
  798. data/lib/chef/provider/whyrun_safe_ruby_block.rb +32 -32
  799. data/lib/chef/provider/windows_script.rb +72 -72
  800. data/lib/chef/provider_resolver.rb +170 -170
  801. data/lib/chef/providers.rb +145 -142
  802. data/lib/chef/recipe.rb +118 -119
  803. data/lib/chef/request_id.rb +37 -37
  804. data/lib/chef/reserved_names.rb +9 -9
  805. data/lib/chef/resource.rb +1581 -1581
  806. data/lib/chef/resource/action_class.rb +90 -87
  807. data/lib/chef/resource/apt_package.rb +32 -32
  808. data/lib/chef/resource/apt_repository.rb +47 -0
  809. data/lib/chef/resource/apt_update.rb +33 -33
  810. data/lib/chef/resource/bash.rb +33 -33
  811. data/lib/chef/resource/batch.rb +33 -33
  812. data/lib/chef/resource/bff_package.rb +27 -27
  813. data/lib/chef/resource/breakpoint.rb +32 -32
  814. data/lib/chef/resource/chef_gem.rb +51 -51
  815. data/lib/chef/resource/chocolatey_package.rb +39 -39
  816. data/lib/chef/resource/conditional.rb +127 -127
  817. data/lib/chef/resource/conditional_action_not_nothing.rb +48 -48
  818. data/lib/chef/resource/cookbook_file.rb +49 -49
  819. data/lib/chef/resource/cron.rb +216 -216
  820. data/lib/chef/resource/csh.rb +33 -33
  821. data/lib/chef/resource/deploy.rb +443 -443
  822. data/lib/chef/resource/deploy_revision.rb +31 -31
  823. data/lib/chef/resource/directory.rb +62 -62
  824. data/lib/chef/resource/dpkg_package.rb +30 -30
  825. data/lib/chef/resource/dsc_resource.rb +121 -121
  826. data/lib/chef/resource/dsc_script.rb +140 -140
  827. data/lib/chef/resource/easy_install_package.rb +32 -32
  828. data/lib/chef/resource/env.rb +65 -65
  829. data/lib/chef/resource/erl_call.rb +85 -85
  830. data/lib/chef/resource/execute.rb +172 -172
  831. data/lib/chef/resource/file.rb +83 -83
  832. data/lib/chef/resource/file/verification.rb +128 -128
  833. data/lib/chef/resource/freebsd_package.rb +62 -62
  834. data/lib/chef/resource/gem_package.rb +41 -41
  835. data/lib/chef/resource/git.rb +44 -44
  836. data/lib/chef/resource/group.rb +102 -102
  837. data/lib/chef/resource/homebrew_package.rb +34 -34
  838. data/lib/chef/resource/http_request.rb +66 -66
  839. data/lib/chef/resource/ifconfig.rb +147 -147
  840. data/lib/chef/resource/ips_package.rb +34 -34
  841. data/lib/chef/resource/ksh.rb +32 -32
  842. data/lib/chef/resource/launchd.rb +104 -104
  843. data/lib/chef/resource/link.rb +107 -107
  844. data/lib/chef/resource/log.rb +76 -76
  845. data/lib/chef/resource/lwrp_base.rb +124 -124
  846. data/lib/chef/resource/macosx_service.rb +58 -58
  847. data/lib/chef/resource/macports_package.rb +27 -27
  848. data/lib/chef/resource/mdadm.rb +103 -103
  849. data/lib/chef/resource/mount.rb +187 -187
  850. data/lib/chef/resource/ohai.rb +53 -53
  851. data/lib/chef/resource/openbsd_package.rb +35 -35
  852. data/lib/chef/resource/osx_profile.rb +74 -74
  853. data/lib/chef/resource/package.rb +47 -47
  854. data/lib/chef/resource/pacman_package.rb +28 -28
  855. data/lib/chef/resource/paludis_package.rb +33 -33
  856. data/lib/chef/resource/perl.rb +32 -32
  857. data/lib/chef/resource/portage_package.rb +32 -32
  858. data/lib/chef/resource/powershell_script.rb +50 -50
  859. data/lib/chef/resource/python.rb +31 -31
  860. data/lib/chef/resource/reboot.rb +48 -48
  861. data/lib/chef/resource/registry_key.rb +144 -144
  862. data/lib/chef/resource/remote_directory.rb +122 -122
  863. data/lib/chef/resource/remote_file.rb +158 -149
  864. data/lib/chef/resource/resource_notification.rb +122 -122
  865. data/lib/chef/resource/route.rb +137 -137
  866. data/lib/chef/resource/rpm_package.rb +32 -32
  867. data/lib/chef/resource/ruby.rb +31 -31
  868. data/lib/chef/resource/ruby_block.rb +53 -53
  869. data/lib/chef/resource/scm.rb +185 -185
  870. data/lib/chef/resource/script.rb +74 -74
  871. data/lib/chef/resource/service.rb +217 -208
  872. data/lib/chef/resource/smartos_package.rb +29 -29
  873. data/lib/chef/resource/solaris_package.rb +31 -31
  874. data/lib/chef/resource/subversion.rb +44 -44
  875. data/lib/chef/resource/template.rb +215 -215
  876. data/lib/chef/resource/timestamped_deploy.rb +26 -26
  877. data/lib/chef/resource/user.rb +160 -160
  878. data/lib/chef/resource/whyrun_safe_ruby_block.rb +24 -24
  879. data/lib/chef/resource/windows_package.rb +55 -55
  880. data/lib/chef/resource/windows_script.rb +65 -65
  881. data/lib/chef/resource/windows_service.rb +71 -71
  882. data/lib/chef/resource/yum_package.rb +47 -47
  883. data/lib/chef/resource/zypper_package.rb +28 -28
  884. data/lib/chef/resource_builder.rb +151 -151
  885. data/lib/chef/resource_collection.rb +131 -89
  886. data/lib/chef/resource_collection/resource_collection_serialization.rb +59 -59
  887. data/lib/chef/resource_collection/resource_list.rb +90 -90
  888. data/lib/chef/resource_collection/resource_set.rb +170 -170
  889. data/lib/chef/resource_collection/stepable_iterator.rb +124 -124
  890. data/lib/chef/resource_definition.rb +68 -68
  891. data/lib/chef/resource_definition_list.rb +38 -38
  892. data/lib/chef/resource_reporter.rb +327 -327
  893. data/lib/chef/resource_resolver.rb +185 -185
  894. data/lib/chef/resources.rb +89 -88
  895. data/lib/chef/rest.rb +209 -209
  896. data/lib/chef/role.rb +280 -280
  897. data/lib/chef/run_context.rb +694 -670
  898. data/lib/chef/run_context/cookbook_compiler.rb +290 -289
  899. data/lib/chef/run_list.rb +168 -168
  900. data/lib/chef/run_list/run_list_expansion.rb +234 -234
  901. data/lib/chef/run_list/run_list_item.rb +98 -98
  902. data/lib/chef/run_list/versioned_recipe_list.rb +102 -102
  903. data/lib/chef/run_lock.rb +197 -197
  904. data/lib/chef/run_status.rb +125 -125
  905. data/lib/chef/runner.rb +143 -141
  906. data/lib/chef/sandbox.rb +20 -20
  907. data/lib/chef/scan_access_control.rb +138 -138
  908. data/lib/chef/search/query.rb +180 -180
  909. data/lib/chef/server_api.rb +78 -78
  910. data/lib/chef/shell.rb +327 -327
  911. data/lib/chef/shell/ext.rb +593 -593
  912. data/lib/chef/shell/model_wrapper.rb +120 -120
  913. data/lib/chef/shell/shell_session.rb +299 -299
  914. data/lib/chef/shell_out.rb +13 -13
  915. data/lib/chef/tasks/chef_repo.rake +200 -200
  916. data/lib/chef/user.rb +199 -199
  917. data/lib/chef/user_v1.rb +330 -330
  918. data/lib/chef/util/backup.rb +94 -94
  919. data/lib/chef/util/diff.rb +184 -184
  920. data/lib/chef/util/dsc/configuration_generator.rb +139 -139
  921. data/lib/chef/util/dsc/lcm_output_parser.rb +137 -137
  922. data/lib/chef/util/dsc/local_configuration_manager.rb +141 -141
  923. data/lib/chef/util/dsc/resource_info.rb +26 -26
  924. data/lib/chef/util/dsc/resource_store.rb +109 -109
  925. data/lib/chef/util/editor.rb +91 -91
  926. data/lib/chef/util/file_edit.rb +100 -100
  927. data/lib/chef/util/path_helper.rb +25 -25
  928. data/lib/chef/util/powershell/cmdlet.rb +170 -170
  929. data/lib/chef/util/powershell/cmdlet_result.rb +61 -61
  930. data/lib/chef/util/powershell/ps_credential.rb +41 -41
  931. data/lib/chef/util/selinux.rb +92 -92
  932. data/lib/chef/util/threaded_job_queue.rb +61 -61
  933. data/lib/chef/util/windows.rb +24 -24
  934. data/lib/chef/util/windows/net_group.rb +84 -84
  935. data/lib/chef/util/windows/net_use.rb +85 -85
  936. data/lib/chef/util/windows/net_user.rb +170 -170
  937. data/lib/chef/util/windows/volume.rb +59 -59
  938. data/lib/chef/version.rb +34 -34
  939. data/lib/chef/version/platform.rb +44 -44
  940. data/lib/chef/version_class.rb +70 -70
  941. data/lib/chef/version_constraint.rb +118 -118
  942. data/lib/chef/version_constraint/platform.rb +26 -26
  943. data/lib/chef/whitelist.rb +86 -86
  944. data/lib/chef/win32/api.rb +374 -374
  945. data/lib/chef/win32/api/crypto.rb +63 -63
  946. data/lib/chef/win32/api/error.rb +953 -953
  947. data/lib/chef/win32/api/file.rb +625 -625
  948. data/lib/chef/win32/api/installer.rb +165 -165
  949. data/lib/chef/win32/api/memory.rb +105 -105
  950. data/lib/chef/win32/api/net.rb +312 -312
  951. data/lib/chef/win32/api/process.rb +42 -42
  952. data/lib/chef/win32/api/psapi.rb +51 -51
  953. data/lib/chef/win32/api/registry.rb +51 -51
  954. data/lib/chef/win32/api/security.rb +460 -460
  955. data/lib/chef/win32/api/synchronization.rb +89 -89
  956. data/lib/chef/win32/api/system.rb +238 -238
  957. data/lib/chef/win32/api/unicode.rb +135 -135
  958. data/lib/chef/win32/crypto.rb +50 -50
  959. data/lib/chef/win32/error.rb +86 -86
  960. data/lib/chef/win32/eventlog.rb +31 -31
  961. data/lib/chef/win32/file.rb +218 -218
  962. data/lib/chef/win32/file/info.rb +99 -99
  963. data/lib/chef/win32/file/version_info.rb +93 -93
  964. data/lib/chef/win32/handle.rb +55 -55
  965. data/lib/chef/win32/memory.rb +101 -101
  966. data/lib/chef/win32/mutex.rb +116 -116
  967. data/lib/chef/win32/net.rb +311 -311
  968. data/lib/chef/win32/process.rb +97 -97
  969. data/lib/chef/win32/registry.rb +374 -372
  970. data/lib/chef/win32/security.rb +665 -665
  971. data/lib/chef/win32/security/ace.rb +123 -123
  972. data/lib/chef/win32/security/acl.rb +103 -103
  973. data/lib/chef/win32/security/securable_object.rb +109 -109
  974. data/lib/chef/win32/security/security_descriptor.rb +93 -93
  975. data/lib/chef/win32/security/sid.rb +304 -304
  976. data/lib/chef/win32/security/token.rb +72 -72
  977. data/lib/chef/win32/system.rb +62 -62
  978. data/lib/chef/win32/unicode.rb +60 -60
  979. data/lib/chef/win32/version.rb +158 -158
  980. data/lib/chef/workstation_config_loader.rb +23 -23
  981. data/spec/data/apt/chef-integration-test-1.0/debian/changelog +5 -5
  982. data/spec/data/apt/chef-integration-test-1.0/debian/compat +1 -1
  983. data/spec/data/apt/chef-integration-test-1.0/debian/control +13 -13
  984. data/spec/data/apt/chef-integration-test-1.0/debian/copyright +34 -34
  985. data/spec/data/apt/chef-integration-test-1.0/debian/files +1 -1
  986. data/spec/data/apt/chef-integration-test-1.0/debian/rules +13 -13
  987. data/spec/data/apt/chef-integration-test-1.0/debian/source/format +1 -1
  988. data/spec/data/apt/chef-integration-test-1.1/debian/changelog +11 -11
  989. data/spec/data/apt/chef-integration-test-1.1/debian/compat +1 -1
  990. data/spec/data/apt/chef-integration-test-1.1/debian/control +13 -13
  991. data/spec/data/apt/chef-integration-test-1.1/debian/copyright +34 -34
  992. data/spec/data/apt/chef-integration-test-1.1/debian/files +1 -1
  993. data/spec/data/apt/chef-integration-test-1.1/debian/rules +13 -13
  994. data/spec/data/apt/chef-integration-test-1.1/debian/source/format +1 -1
  995. data/spec/data/apt/chef-integration-test2-1.0/debian/changelog +5 -5
  996. data/spec/data/apt/chef-integration-test2-1.0/debian/chef-integration-test2.debhelper.log +45 -45
  997. data/spec/data/apt/chef-integration-test2-1.0/debian/chef-integration-test2.substvars +1 -1
  998. data/spec/data/apt/chef-integration-test2-1.0/debian/chef-integration-test2/DEBIAN/conffiles +1 -1
  999. data/spec/data/apt/chef-integration-test2-1.0/debian/chef-integration-test2/DEBIAN/control +10 -10
  1000. data/spec/data/apt/chef-integration-test2-1.0/debian/chef-integration-test2/DEBIAN/md5sums +1 -1
  1001. data/spec/data/apt/chef-integration-test2-1.0/debian/compat +1 -1
  1002. data/spec/data/apt/chef-integration-test2-1.0/debian/conffiles +1 -1
  1003. data/spec/data/apt/chef-integration-test2-1.0/debian/control +13 -13
  1004. data/spec/data/apt/chef-integration-test2-1.0/debian/copyright +34 -34
  1005. data/spec/data/apt/chef-integration-test2-1.0/debian/files +1 -1
  1006. data/spec/data/apt/chef-integration-test2-1.0/debian/rules +13 -13
  1007. data/spec/data/apt/chef-integration-test2-1.0/debian/source/format +1 -1
  1008. data/spec/data/apt/chef-integration-test2_1.0-1.dsc +18 -18
  1009. data/spec/data/apt/chef-integration-test2_1.0-1_amd64.build +91 -91
  1010. data/spec/data/apt/chef-integration-test2_1.0-1_amd64.changes +31 -31
  1011. data/spec/data/apt/chef-integration-test_1.0-1_amd64.changes +22 -22
  1012. data/spec/data/apt/chef-integration-test_1.1-1_amd64.changes +22 -22
  1013. data/spec/data/apt/var/www/apt/conf/distributions +7 -7
  1014. data/spec/data/apt/var/www/apt/conf/incoming +4 -4
  1015. data/spec/data/apt/var/www/apt/conf/pulls +3 -3
  1016. data/spec/data/apt/var/www/apt/db/version +4 -4
  1017. data/spec/data/apt/var/www/apt/dists/sid/Release +19 -19
  1018. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Packages +16 -16
  1019. data/spec/data/apt/var/www/apt/dists/sid/main/binary-amd64/Release +5 -5
  1020. data/spec/data/bootstrap/encrypted_data_bag_secret +1 -1
  1021. data/spec/data/bootstrap/no_proxy.erb +2 -2
  1022. data/spec/data/bootstrap/secret.erb +9 -9
  1023. data/spec/data/bootstrap/test-hints.erb +12 -12
  1024. data/spec/data/bootstrap/test.erb +1 -1
  1025. data/spec/data/cb_version_cookbooks/tatft/README.rdoc +2 -2
  1026. data/spec/data/cb_version_cookbooks/tatft/attributes/default.rb +1 -1
  1027. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-600hhz-0 +1 -1
  1028. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ahd2gq-0 +1 -1
  1029. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-api8ux-0 +1 -1
  1030. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-b0r1m1-0 +1 -1
  1031. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-bfygsi-0 +1 -1
  1032. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-el14l6-0 +1 -1
  1033. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ivrl3y-0 +1 -1
  1034. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-kkbs85-0 +1 -1
  1035. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ory1ux-0 +1 -1
  1036. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-pgsq76-0 +1 -1
  1037. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ra8uim-0 +1 -1
  1038. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t7k1g-0 +1 -1
  1039. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-t8g0sv-0 +1 -1
  1040. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-ufy6g3-0 +1 -1
  1041. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-x2d6j9-0 +1 -1
  1042. data/spec/data/checksum_cache/chef-file--tmp-chef-rendered-template20100929-10863-xi0l6h-0 +1 -1
  1043. data/spec/data/client.d_00/00-foo.rb +2 -2
  1044. data/spec/data/client.d_00/01-bar.rb +1 -1
  1045. data/spec/data/client.d_00/bar +1 -1
  1046. data/spec/data/client.d_01/foo/bar.rb +1 -1
  1047. data/spec/data/client.d_02/foo.rb/foo.txt +1 -1
  1048. data/spec/data/config.rb +6 -6
  1049. data/spec/data/cookbooks/angrybash/metadata.rb +2 -2
  1050. data/spec/data/cookbooks/angrybash/recipes/default.rb +8 -8
  1051. data/spec/data/cookbooks/apache2/files/default/apache2_module_conf_generate.pl +2 -2
  1052. data/spec/data/cookbooks/apache2/metadata.rb +2 -2
  1053. data/spec/data/cookbooks/apache2/recipes/default.rb +2 -2
  1054. data/spec/data/cookbooks/borken/metadata.rb +2 -2
  1055. data/spec/data/cookbooks/borken/recipes/default.rb +1 -1
  1056. data/spec/data/cookbooks/borken/templates/default/borken.erb +1 -1
  1057. data/spec/data/cookbooks/chefignore +8 -8
  1058. data/spec/data/cookbooks/ignorken/files/default/not_me.rb +2 -2
  1059. data/spec/data/cookbooks/ignorken/metadata.rb +2 -2
  1060. data/spec/data/cookbooks/ignorken/recipes/ignoreme.rb +1 -1
  1061. data/spec/data/cookbooks/ignorken/templates/ubuntu-12.10/not_me.rb +2 -2
  1062. data/spec/data/cookbooks/java/files/default/java.response +1 -1
  1063. data/spec/data/cookbooks/java/metadata.rb +2 -2
  1064. data/spec/data/cookbooks/name-mismatch-versionnumber/README.md +4 -4
  1065. data/spec/data/cookbooks/name-mismatch-versionnumber/metadata.rb +8 -8
  1066. data/spec/data/cookbooks/name-mismatch-versionnumber/recipes/default.rb +8 -8
  1067. data/spec/data/cookbooks/openldap/attributes/default.rb +16 -16
  1068. data/spec/data/cookbooks/openldap/attributes/smokey.rb +1 -1
  1069. data/spec/data/cookbooks/openldap/definitions/client.rb +5 -5
  1070. data/spec/data/cookbooks/openldap/definitions/server.rb +5 -5
  1071. data/spec/data/cookbooks/openldap/files/default/.dotfile +1 -1
  1072. data/spec/data/cookbooks/openldap/files/default/remotedir/.a_dotdir/.a_dotfile_in_a_dotdir +1 -1
  1073. data/spec/data/cookbooks/openldap/files/default/remotedir/not_a_template.erb +2 -2
  1074. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file1.txt +2 -2
  1075. data/spec/data/cookbooks/openldap/files/default/remotedir/remote_dir_file2.txt +2 -2
  1076. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/.a_dotfile +1 -1
  1077. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file1.txt +2 -2
  1078. data/spec/data/cookbooks/openldap/files/default/remotedir/remotesubdir/remote_subdir_file2.txt +2 -2
  1079. data/spec/data/cookbooks/openldap/files/default/remotedir/subdir_with_no_file_just_a_subsubdir/the_subsubdir/some_file.txt +3 -3
  1080. data/spec/data/cookbooks/openldap/libraries/openldap.rb +4 -4
  1081. data/spec/data/cookbooks/openldap/libraries/openldap/version.rb +3 -3
  1082. data/spec/data/cookbooks/openldap/metadata.rb +8 -8
  1083. data/spec/data/cookbooks/openldap/recipes/default.rb +4 -4
  1084. data/spec/data/cookbooks/openldap/recipes/gigantor.rb +3 -3
  1085. data/spec/data/cookbooks/openldap/recipes/one.rb +15 -15
  1086. data/spec/data/cookbooks/openldap/recipes/return.rb +2 -2
  1087. data/spec/data/cookbooks/openldap/templates/default/helper_test.erb +1 -1
  1088. data/spec/data/cookbooks/openldap/templates/default/helpers.erb +14 -14
  1089. data/spec/data/cookbooks/openldap/templates/default/helpers_via_partial_test.erb +1 -1
  1090. data/spec/data/cookbooks/openldap/templates/default/nested_openldap_partials.erb +1 -1
  1091. data/spec/data/cookbooks/openldap/templates/default/nested_partial.erb +1 -1
  1092. data/spec/data/cookbooks/openldap/templates/default/no_windows_line_endings.erb +4 -4
  1093. data/spec/data/cookbooks/openldap/templates/default/openldap_variable_stuff.conf.erb +1 -1
  1094. data/spec/data/cookbooks/openldap/templates/default/test.erb +1 -1
  1095. data/spec/data/cookbooks/preseed/files/default/preseed-file.seed +1 -1
  1096. data/spec/data/cookbooks/preseed/files/default/preseed-template.seed +4 -4
  1097. data/spec/data/cookbooks/preseed/metadata.rb +2 -2
  1098. data/spec/data/cookbooks/preseed/templates/default/preseed-template-variables.seed +1 -1
  1099. data/spec/data/cookbooks/preseed/templates/default/preseed-template.seed +1 -1
  1100. data/spec/data/cookbooks/supports-platform-constraints/metadata.rb +5 -5
  1101. data/spec/data/definitions/test.rb +4 -4
  1102. data/spec/data/environment-config.rb +4 -4
  1103. data/spec/data/file-providers-method-snapshot-chef-11-4.json +127 -127
  1104. data/spec/data/fileedit/hosts +4 -4
  1105. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/README.md +4 -4
  1106. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/metadata.rb +13 -13
  1107. data/spec/data/incomplete-metadata-chef-repo/incomplete-metadata/recipes/default.rb +8 -8
  1108. data/spec/data/invalid-metadata-chef-repo/invalid-metadata/README.md +4 -4
  1109. data/spec/data/invalid-metadata-chef-repo/invalid-metadata/metadata.rb +9 -9
  1110. data/spec/data/invalid-metadata-chef-repo/invalid-metadata/recipes/default.rb +8 -8
  1111. data/spec/data/kitchen/chefignore +6 -6
  1112. data/spec/data/kitchen/openldap/attributes/default.rb +3 -3
  1113. data/spec/data/kitchen/openldap/attributes/robinson.rb +2 -2
  1114. data/spec/data/kitchen/openldap/definitions/client.rb +3 -3
  1115. data/spec/data/kitchen/openldap/definitions/drewbarrymore.rb +2 -2
  1116. data/spec/data/kitchen/openldap/recipes/gigantor.rb +2 -2
  1117. data/spec/data/kitchen/openldap/recipes/ignoreme.rb +2 -2
  1118. data/spec/data/kitchen/openldap/recipes/woot.rb +3 -3
  1119. data/spec/data/knife_subcommand/test_explicit_category.rb +6 -6
  1120. data/spec/data/knife_subcommand/test_name_mapping.rb +4 -4
  1121. data/spec/data/knife_subcommand/test_yourself.rb +21 -21
  1122. data/spec/data/lwrp/providers/buck_passer.rb +28 -28
  1123. data/spec/data/lwrp/providers/buck_passer_2.rb +26 -26
  1124. data/spec/data/lwrp/providers/embedded_resource_accesses_providers_scope.rb +28 -28
  1125. data/spec/data/lwrp/providers/inline_compiler.rb +26 -26
  1126. data/spec/data/lwrp/providers/monkey_name_printer.rb +5 -5
  1127. data/spec/data/lwrp/providers/paint_drying_watcher.rb +7 -7
  1128. data/spec/data/lwrp/providers/thumb_twiddler.rb +7 -7
  1129. data/spec/data/lwrp/resources/bar.rb +2 -2
  1130. data/spec/data/lwrp/resources/foo.rb +4 -4
  1131. data/spec/data/lwrp/resources_with_default_attributes/nodeattr.rb +1 -1
  1132. data/spec/data/lwrp_override/providers/buck_passer.rb +5 -5
  1133. data/spec/data/lwrp_override/resources/foo.rb +10 -10
  1134. data/spec/data/mac_users/10.7-8.plist.xml +559 -559
  1135. data/spec/data/mac_users/10.7-8.shadow.xml +11 -11
  1136. data/spec/data/mac_users/10.7.plist.xml +559 -559
  1137. data/spec/data/mac_users/10.7.shadow.xml +11 -11
  1138. data/spec/data/mac_users/10.8.plist.xml +559 -559
  1139. data/spec/data/mac_users/10.8.shadow.xml +21 -21
  1140. data/spec/data/mac_users/10.9.plist.xml +560 -560
  1141. data/spec/data/mac_users/10.9.shadow.xml +21 -21
  1142. data/spec/data/metadata/quick_start/metadata.rb +19 -19
  1143. data/spec/data/nested.json +2 -2
  1144. data/spec/data/nodes/default.rb +15 -15
  1145. data/spec/data/nodes/test.example.com.rb +17 -17
  1146. data/spec/data/nodes/test.rb +15 -15
  1147. data/spec/data/null_config.rb +1 -1
  1148. data/spec/data/object_loader/environments/test.json +7 -7
  1149. data/spec/data/object_loader/environments/test.rb +2 -2
  1150. data/spec/data/object_loader/environments/test_json_class.json +8 -8
  1151. data/spec/data/object_loader/nodes/test.json +7 -7
  1152. data/spec/data/object_loader/nodes/test.rb +2 -2
  1153. data/spec/data/object_loader/nodes/test_json_class.json +8 -8
  1154. data/spec/data/object_loader/roles/test.json +7 -7
  1155. data/spec/data/object_loader/roles/test.rb +2 -2
  1156. data/spec/data/object_loader/roles/test_json_class.json +8 -8
  1157. data/spec/data/partial_one.erb +1 -1
  1158. data/spec/data/recipes/test.rb +7 -7
  1159. data/spec/data/run_context/cookbooks/circular-dep1/attributes/default.rb +4 -4
  1160. data/spec/data/run_context/cookbooks/circular-dep1/definitions/circular_dep1_res.rb +1 -1
  1161. data/spec/data/run_context/cookbooks/circular-dep1/libraries/lib.rb +2 -2
  1162. data/spec/data/run_context/cookbooks/circular-dep1/metadata.rb +2 -2
  1163. data/spec/data/run_context/cookbooks/circular-dep1/providers/provider.rb +1 -1
  1164. data/spec/data/run_context/cookbooks/circular-dep1/resources/resource.rb +1 -1
  1165. data/spec/data/run_context/cookbooks/circular-dep2/attributes/default.rb +3 -3
  1166. data/spec/data/run_context/cookbooks/circular-dep2/definitions/circular_dep2_res.rb +1 -1
  1167. data/spec/data/run_context/cookbooks/circular-dep2/libraries/lib.rb +2 -2
  1168. data/spec/data/run_context/cookbooks/circular-dep2/metadata.rb +2 -2
  1169. data/spec/data/run_context/cookbooks/circular-dep2/providers/provider.rb +1 -1
  1170. data/spec/data/run_context/cookbooks/circular-dep2/resources/resource.rb +1 -1
  1171. data/spec/data/run_context/cookbooks/dependency1/attributes/aa_first.rb +2 -2
  1172. data/spec/data/run_context/cookbooks/dependency1/attributes/default.rb +2 -2
  1173. data/spec/data/run_context/cookbooks/dependency1/attributes/zz_last.rb +3 -3
  1174. data/spec/data/run_context/cookbooks/dependency1/definitions/dependency1_res.rb +1 -1
  1175. data/spec/data/run_context/cookbooks/dependency1/libraries/lib.rb +2 -2
  1176. data/spec/data/run_context/cookbooks/dependency1/providers/provider.rb +1 -1
  1177. data/spec/data/run_context/cookbooks/dependency1/resources/resource.rb +1 -1
  1178. data/spec/data/run_context/cookbooks/dependency2/attributes/default.rb +3 -3
  1179. data/spec/data/run_context/cookbooks/dependency2/definitions/dependency2_res.rb +1 -1
  1180. data/spec/data/run_context/cookbooks/dependency2/libraries/lib.rb +2 -2
  1181. data/spec/data/run_context/cookbooks/dependency2/providers/provider.rb +1 -1
  1182. data/spec/data/run_context/cookbooks/dependency2/resources/resource.rb +1 -1
  1183. data/spec/data/run_context/cookbooks/include/recipes/default.rb +24 -24
  1184. data/spec/data/run_context/cookbooks/include/recipes/includee.rb +3 -3
  1185. data/spec/data/run_context/cookbooks/no-default-attr/attributes/server.rb +3 -3
  1186. data/spec/data/run_context/cookbooks/no-default-attr/definitions/no_default-attr_res.rb +1 -1
  1187. data/spec/data/run_context/cookbooks/no-default-attr/providers/provider.rb +1 -1
  1188. data/spec/data/run_context/cookbooks/no-default-attr/resources/resource.rb +1 -1
  1189. data/spec/data/run_context/cookbooks/test-with-circular-deps/attributes/default.rb +3 -3
  1190. data/spec/data/run_context/cookbooks/test-with-circular-deps/definitions/test_with-circular-deps_res.rb +1 -1
  1191. data/spec/data/run_context/cookbooks/test-with-circular-deps/libraries/lib.rb +2 -2
  1192. data/spec/data/run_context/cookbooks/test-with-circular-deps/metadata.rb +2 -2
  1193. data/spec/data/run_context/cookbooks/test-with-circular-deps/providers/provider.rb +1 -1
  1194. data/spec/data/run_context/cookbooks/test-with-circular-deps/resources/resource.rb +1 -1
  1195. data/spec/data/run_context/cookbooks/test-with-deps/attributes/default.rb +3 -3
  1196. data/spec/data/run_context/cookbooks/test-with-deps/definitions/test_with-deps_res.rb +1 -1
  1197. data/spec/data/run_context/cookbooks/test-with-deps/libraries/lib.rb +1 -1
  1198. data/spec/data/run_context/cookbooks/test-with-deps/metadata.rb +3 -3
  1199. data/spec/data/run_context/cookbooks/test-with-deps/providers/provider.rb +1 -1
  1200. data/spec/data/run_context/cookbooks/test-with-deps/resources/resource.rb +1 -1
  1201. data/spec/data/run_context/cookbooks/test/attributes/george.rb +1 -1
  1202. data/spec/data/run_context/cookbooks/test/definitions/new_animals.rb +9 -9
  1203. data/spec/data/run_context/cookbooks/test/definitions/new_cat.rb +5 -5
  1204. data/spec/data/run_context/cookbooks/test/definitions/test_res.rb +1 -1
  1205. data/spec/data/run_context/cookbooks/test/providers/provider.rb +1 -1
  1206. data/spec/data/run_context/cookbooks/test/recipes/default.rb +5 -5
  1207. data/spec/data/run_context/cookbooks/test/recipes/one.rb +7 -7
  1208. data/spec/data/run_context/cookbooks/test/recipes/two.rb +7 -7
  1209. data/spec/data/run_context/cookbooks/test/resources/resource.rb +1 -1
  1210. data/spec/data/run_context/nodes/run_context.rb +5 -5
  1211. data/spec/data/search_queries_to_transform.txt +98 -98
  1212. data/spec/data/shef-config.rb +10 -10
  1213. data/spec/data/ssl/5e707473.0 +18 -18
  1214. data/spec/data/ssl/chef-rspec.cert +27 -27
  1215. data/spec/data/ssl/chef-rspec.key +27 -27
  1216. data/spec/data/ssl/key.pem +15 -15
  1217. data/spec/data/ssl/private_key.pem +27 -27
  1218. data/spec/data/ssl/private_key_with_whitespace.pem +32 -32
  1219. data/spec/data/standalone_cookbook/chefignore +9 -9
  1220. data/spec/data/standalone_cookbook/recipes/default.rb +2 -2
  1221. data/spec/data/trusted_certs/example.crt +22 -22
  1222. data/spec/data/trusted_certs/intermediate.pem +27 -27
  1223. data/spec/data/trusted_certs/opscode.pem +57 -57
  1224. data/spec/data/trusted_certs/root.pem +22 -22
  1225. data/spec/functional/application_spec.rb +58 -58
  1226. data/spec/functional/assets/chefinittest +34 -34
  1227. data/spec/functional/assets/testchefsubsys +10 -10
  1228. data/spec/functional/audit/rspec_formatter_spec.rb +54 -54
  1229. data/spec/functional/audit/runner_spec.rb +121 -121
  1230. data/spec/functional/dsl/reboot_pending_spec.rb +106 -106
  1231. data/spec/functional/dsl/registry_helper_spec.rb +61 -61
  1232. data/spec/functional/event_loggers/windows_eventlog_spec.rb +101 -101
  1233. data/spec/functional/file_content_management/deploy_strategies_spec.rb +229 -229
  1234. data/spec/functional/http/simple_spec.rb +140 -140
  1235. data/spec/functional/knife/configure_spec.rb +33 -33
  1236. data/spec/functional/knife/cookbook_delete_spec.rb +167 -167
  1237. data/spec/functional/knife/exec_spec.rb +55 -55
  1238. data/spec/functional/knife/rehash_spec.rb +39 -39
  1239. data/spec/functional/knife/smoke_test.rb +42 -42
  1240. data/spec/functional/knife/ssh_spec.rb +284 -284
  1241. data/spec/functional/mixin/powershell_out_spec.rb +43 -43
  1242. data/spec/functional/mixin/shell_out_spec.rb +48 -48
  1243. data/spec/functional/notifications_spec.rb +238 -238
  1244. data/spec/functional/provider/remote_file/cache_control_data_spec.rb +100 -100
  1245. data/spec/functional/provider/whyrun_safe_ruby_block_spec.rb +51 -51
  1246. data/spec/functional/rebooter_spec.rb +105 -105
  1247. data/spec/functional/resource/aix_service_spec.rb +138 -138
  1248. data/spec/functional/resource/aixinit_service_spec.rb +211 -211
  1249. data/spec/functional/resource/base.rb +28 -28
  1250. data/spec/functional/resource/bash_spec.rb +88 -88
  1251. data/spec/functional/resource/batch_spec.rb +30 -30
  1252. data/spec/functional/resource/bff_spec.rb +120 -120
  1253. data/spec/functional/resource/chocolatey_package_spec.rb +130 -130
  1254. data/spec/functional/resource/cookbook_file_spec.rb +81 -81
  1255. data/spec/functional/resource/cron_spec.rb +172 -172
  1256. data/spec/functional/resource/deploy_revision_spec.rb +881 -881
  1257. data/spec/functional/resource/directory_spec.rb +43 -43
  1258. data/spec/functional/resource/dpkg_package_spec.rb +339 -339
  1259. data/spec/functional/resource/dsc_resource_spec.rb +90 -90
  1260. data/spec/functional/resource/dsc_script_spec.rb +479 -479
  1261. data/spec/functional/resource/env_spec.rb +192 -192
  1262. data/spec/functional/resource/execute_spec.rb +154 -154
  1263. data/spec/functional/resource/file_spec.rb +167 -167
  1264. data/spec/functional/resource/git_spec.rb +259 -259
  1265. data/spec/functional/resource/group_spec.rb +461 -461
  1266. data/spec/functional/resource/ifconfig_spec.rb +165 -165
  1267. data/spec/functional/resource/link_spec.rb +613 -613
  1268. data/spec/functional/resource/mount_spec.rb +203 -203
  1269. data/spec/functional/resource/ohai_spec.rb +62 -62
  1270. data/spec/functional/resource/package_spec.rb +386 -386
  1271. data/spec/functional/resource/powershell_script_spec.rb +601 -601
  1272. data/spec/functional/resource/reboot_spec.rb +103 -103
  1273. data/spec/functional/resource/registry_spec.rb +560 -560
  1274. data/spec/functional/resource/remote_directory_spec.rb +220 -220
  1275. data/spec/functional/resource/remote_file_spec.rb +240 -240
  1276. data/spec/functional/resource/rpm_spec.rb +123 -123
  1277. data/spec/functional/resource/template_spec.rb +212 -212
  1278. data/spec/functional/resource/user/dscl_spec.rb +198 -198
  1279. data/spec/functional/resource/user/useradd_spec.rb +692 -692
  1280. data/spec/functional/resource/user/windows_spec.rb +133 -133
  1281. data/spec/functional/resource/windows_package_spec.rb +168 -168
  1282. data/spec/functional/resource/windows_service_spec.rb +102 -102
  1283. data/spec/functional/rest_spec.rb +95 -95
  1284. data/spec/functional/run_lock_spec.rb +466 -466
  1285. data/spec/functional/shell_spec.rb +148 -148
  1286. data/spec/functional/tiny_server_spec.rb +78 -78
  1287. data/spec/functional/util/path_helper_spec.rb +37 -37
  1288. data/spec/functional/util/powershell/cmdlet_spec.rb +111 -111
  1289. data/spec/functional/version_spec.rb +35 -35
  1290. data/spec/functional/win32/crypto_spec.rb +54 -54
  1291. data/spec/functional/win32/registry_spec.rb +623 -623
  1292. data/spec/functional/win32/security_spec.rb +100 -100
  1293. data/spec/functional/win32/service_manager_spec.rb +220 -220
  1294. data/spec/functional/win32/sid_spec.rb +55 -55
  1295. data/spec/functional/win32/version_info_spec.rb +50 -50
  1296. data/spec/functional/win32/versions_spec.rb +117 -117
  1297. data/spec/integration/client/client_spec.rb +500 -500
  1298. data/spec/integration/client/ipv6_spec.rb +134 -134
  1299. data/spec/integration/knife/chef_fs_data_store_spec.rb +556 -556
  1300. data/spec/integration/knife/chef_repo_path_spec.rb +890 -890
  1301. data/spec/integration/knife/chef_repository_file_system_spec.rb +296 -292
  1302. data/spec/integration/knife/chefignore_spec.rb +300 -300
  1303. data/spec/integration/knife/common_options_spec.rb +155 -155
  1304. data/spec/integration/knife/cookbook_api_ipv6_spec.rb +112 -112
  1305. data/spec/integration/knife/delete_spec.rb +1017 -1017
  1306. data/spec/integration/knife/deps_spec.rb +706 -706
  1307. data/spec/integration/knife/diff_spec.rb +602 -602
  1308. data/spec/integration/knife/download_spec.rb +1314 -1314
  1309. data/spec/integration/knife/list_spec.rb +1067 -1067
  1310. data/spec/integration/knife/raw_spec.rb +242 -242
  1311. data/spec/integration/knife/redirection_spec.rb +52 -52
  1312. data/spec/integration/knife/serve_spec.rb +57 -57
  1313. data/spec/integration/knife/show_spec.rb +167 -167
  1314. data/spec/integration/knife/upload_spec.rb +1529 -1529
  1315. data/spec/integration/recipes/lwrp_inline_resources_spec.rb +175 -148
  1316. data/spec/integration/recipes/lwrp_spec.rb +53 -53
  1317. data/spec/integration/recipes/noop_resource_spec.rb +24 -0
  1318. data/spec/integration/recipes/notifies_spec.rb +334 -0
  1319. data/spec/integration/recipes/provider_choice.rb +37 -37
  1320. data/spec/integration/recipes/recipe_dsl_spec.rb +1519 -1519
  1321. data/spec/integration/recipes/remote_directory.rb +74 -74
  1322. data/spec/integration/recipes/resource_action_spec.rb +569 -569
  1323. data/spec/integration/recipes/resource_converge_if_changed_spec.rb +496 -496
  1324. data/spec/integration/recipes/resource_load_spec.rb +208 -208
  1325. data/spec/integration/solo/solo_spec.rb +176 -176
  1326. data/spec/rcov.opts +2 -2
  1327. data/spec/scripts/ssl-serve.rb +47 -47
  1328. data/spec/spec_helper.rb +248 -248
  1329. data/spec/stress/win32/file_spec.rb +37 -37
  1330. data/spec/stress/win32/memory_spec.rb +22 -22
  1331. data/spec/stress/win32/security_spec.rb +69 -69
  1332. data/spec/support/chef_helpers.rb +95 -95
  1333. data/spec/support/key_helpers.rb +104 -104
  1334. data/spec/support/lib/chef/provider/easy.rb +35 -35
  1335. data/spec/support/lib/chef/provider/openldap_includer.rb +29 -29
  1336. data/spec/support/lib/chef/provider/snakeoil.rb +41 -41
  1337. data/spec/support/lib/chef/resource/cat.rb +38 -38
  1338. data/spec/support/lib/chef/resource/one_two_three_four.rb +37 -37
  1339. data/spec/support/lib/chef/resource/openldap_includer.rb +26 -26
  1340. data/spec/support/lib/chef/resource/with_state.rb +28 -28
  1341. data/spec/support/lib/chef/resource/zen_follower.rb +35 -35
  1342. data/spec/support/lib/chef/resource/zen_master.rb +41 -41
  1343. data/spec/support/lib/library_load_order.rb +20 -20
  1344. data/spec/support/matchers/leak.rb +98 -98
  1345. data/spec/support/mock/constant.rb +52 -52
  1346. data/spec/support/mock/platform.rb +25 -25
  1347. data/spec/support/platform_helpers.rb +214 -214
  1348. data/spec/support/platforms/prof/gc.rb +53 -53
  1349. data/spec/support/platforms/prof/win32.rb +45 -45
  1350. data/spec/support/platforms/win32/spec_service.rb +59 -59
  1351. data/spec/support/shared/context/client.rb +285 -285
  1352. data/spec/support/shared/context/config.rb +21 -21
  1353. data/spec/support/shared/context/win32.rb +34 -34
  1354. data/spec/support/shared/examples/client.rb +53 -53
  1355. data/spec/support/shared/functional/diff_disabled.rb +10 -10
  1356. data/spec/support/shared/functional/directory_resource.rb +176 -176
  1357. data/spec/support/shared/functional/file_resource.rb +1049 -1049
  1358. data/spec/support/shared/functional/http.rb +248 -248
  1359. data/spec/support/shared/functional/knife.rb +37 -37
  1360. data/spec/support/shared/functional/securable_resource.rb +547 -547
  1361. data/spec/support/shared/functional/securable_resource_with_reporting.rb +394 -394
  1362. data/spec/support/shared/functional/win32_service.rb +59 -59
  1363. data/spec/support/shared/functional/windows_script.rb +202 -202
  1364. data/spec/support/shared/integration/app_server_support.rb +42 -42
  1365. data/spec/support/shared/integration/integration_helper.rb +154 -154
  1366. data/spec/support/shared/integration/knife_support.rb +173 -173
  1367. data/spec/support/shared/matchers/exit_with_code.rb +32 -32
  1368. data/spec/support/shared/matchers/match_environment_variable.rb +17 -17
  1369. data/spec/support/shared/shared_examples.rb +14 -14
  1370. data/spec/support/shared/unit/api_error_inspector.rb +190 -190
  1371. data/spec/support/shared/unit/api_versioning.rb +77 -77
  1372. data/spec/support/shared/unit/application_dot_d.rb +70 -70
  1373. data/spec/support/shared/unit/execute_resource.rb +133 -133
  1374. data/spec/support/shared/unit/file_system_support.rb +69 -69
  1375. data/spec/support/shared/unit/knife_shared.rb +39 -39
  1376. data/spec/support/shared/unit/mock_shellout.rb +49 -49
  1377. data/spec/support/shared/unit/platform_introspector.rb +189 -189
  1378. data/spec/support/shared/unit/provider/file.rb +835 -835
  1379. data/spec/support/shared/unit/provider/useradd_based_user_provider.rb +433 -433
  1380. data/spec/support/shared/unit/resource/static_provider_resolution.rb +63 -63
  1381. data/spec/support/shared/unit/script_resource.rb +98 -98
  1382. data/spec/support/shared/unit/user_and_client_shared.rb +114 -114
  1383. data/spec/support/shared/unit/windows_script_resource.rb +80 -80
  1384. data/spec/tiny_server.rb +207 -207
  1385. data/spec/unit/api_client/registration_spec.rb +278 -278
  1386. data/spec/unit/api_client_spec.rb +341 -341
  1387. data/spec/unit/api_client_v1_spec.rb +455 -455
  1388. data/spec/unit/application/apply_spec.rb +110 -110
  1389. data/spec/unit/application/client_spec.rb +495 -435
  1390. data/spec/unit/application/knife_spec.rb +229 -229
  1391. data/spec/unit/application/solo_spec.rb +170 -170
  1392. data/spec/unit/application_spec.rb +411 -384
  1393. data/spec/unit/audit/audit_event_proxy_spec.rb +311 -311
  1394. data/spec/unit/audit/audit_reporter_spec.rb +430 -430
  1395. data/spec/unit/audit/control_group_data_spec.rb +477 -477
  1396. data/spec/unit/audit/logger_spec.rb +42 -42
  1397. data/spec/unit/audit/rspec_formatter_spec.rb +29 -29
  1398. data/spec/unit/audit/runner_spec.rb +144 -144
  1399. data/spec/unit/chef_class_spec.rb +110 -110
  1400. data/spec/unit/chef_fs/config_spec.rb +106 -106
  1401. data/spec/unit/chef_fs/data_handler/group_handler_spec.rb +63 -63
  1402. data/spec/unit/chef_fs/diff_spec.rb +328 -328
  1403. data/spec/unit/chef_fs/file_pattern_spec.rb +512 -512
  1404. data/spec/unit/chef_fs/file_system/cookbook_subdir_spec.rb +34 -34
  1405. data/spec/unit/chef_fs/file_system/operation_failed_error_spec.rb +47 -47
  1406. data/spec/unit/chef_fs/file_system_spec.rb +148 -148
  1407. data/spec/unit/chef_fs/parallelizer.rb +479 -479
  1408. data/spec/unit/chef_fs/path_util_spec.rb +108 -108
  1409. data/spec/unit/chef_spec.rb +25 -25
  1410. data/spec/unit/client_spec.rb +544 -544
  1411. data/spec/unit/config_fetcher_spec.rb +125 -125
  1412. data/spec/unit/config_spec.rb +31 -31
  1413. data/spec/unit/cookbook/chefignore_spec.rb +49 -49
  1414. data/spec/unit/cookbook/cookbook_version_loader_spec.rb +198 -198
  1415. data/spec/unit/cookbook/file_vendor_spec.rb +97 -97
  1416. data/spec/unit/cookbook/metadata_spec.rb +952 -952
  1417. data/spec/unit/cookbook/synchronizer_spec.rb +520 -520
  1418. data/spec/unit/cookbook/syntax_check_spec.rb +219 -219
  1419. data/spec/unit/cookbook_loader_spec.rb +299 -299
  1420. data/spec/unit/cookbook_manifest_spec.rb +243 -243
  1421. data/spec/unit/cookbook_site_streaming_uploader_spec.rb +203 -203
  1422. data/spec/unit/cookbook_spec.rb +66 -66
  1423. data/spec/unit/cookbook_uploader_spec.rb +199 -199
  1424. data/spec/unit/cookbook_version_file_specificity_spec.rb +576 -553
  1425. data/spec/unit/cookbook_version_spec.rb +359 -359
  1426. data/spec/unit/daemon_spec.rb +174 -174
  1427. data/spec/unit/data_bag_item_spec.rb +388 -388
  1428. data/spec/unit/data_bag_spec.rb +260 -260
  1429. data/spec/unit/deprecation_spec.rb +150 -150
  1430. data/spec/unit/digester_spec.rb +49 -49
  1431. data/spec/unit/dsl/audit_spec.rb +43 -43
  1432. data/spec/unit/dsl/data_query_spec.rb +106 -106
  1433. data/spec/unit/dsl/platform_introspection_spec.rb +129 -129
  1434. data/spec/unit/dsl/reboot_pending_spec.rb +100 -100
  1435. data/spec/unit/dsl/recipe_spec.rb +93 -80
  1436. data/spec/unit/dsl/{regsitry_helper_spec.rb → registry_helper_spec.rb} +52 -52
  1437. data/spec/unit/dsl/resources_spec.rb +85 -85
  1438. data/spec/unit/encrypted_data_bag_item/check_encrypted_spec.rb +95 -95
  1439. data/spec/unit/encrypted_data_bag_item_spec.rb +437 -437
  1440. data/spec/unit/environment_spec.rb +470 -470
  1441. data/spec/unit/event_dispatch/dispatcher_spec.rb +122 -122
  1442. data/spec/unit/event_dispatch/dsl_spec.rb +83 -83
  1443. data/spec/unit/exceptions_spec.rb +130 -130
  1444. data/spec/unit/file_access_control_spec.rb +308 -308
  1445. data/spec/unit/file_cache_spec.rb +114 -114
  1446. data/spec/unit/file_content_management/deploy/cp_spec.rb +44 -44
  1447. data/spec/unit/file_content_management/deploy/mv_unix_spec.rb +101 -101
  1448. data/spec/unit/file_content_management/deploy/mv_windows_spec.rb +232 -232
  1449. data/spec/unit/file_content_management/tempfile_spec.rb +85 -85
  1450. data/spec/unit/formatters/base_spec.rb +71 -71
  1451. data/spec/unit/formatters/doc_spec.rb +92 -78
  1452. data/spec/unit/formatters/error_description_spec.rb +96 -0
  1453. data/spec/unit/formatters/error_inspectors/api_error_formatting_spec.rb +76 -76
  1454. data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +265 -265
  1455. data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +126 -126
  1456. data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +43 -43
  1457. data/spec/unit/formatters/error_inspectors/node_load_error_inspector_spec.rb +26 -26
  1458. data/spec/unit/formatters/error_inspectors/registration_error_inspector_spec.rb +26 -26
  1459. data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +191 -191
  1460. data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +91 -91
  1461. data/spec/unit/guard_interpreter/resource_guard_interpreter_spec.rb +155 -155
  1462. data/spec/unit/guard_interpreter_spec.rb +41 -41
  1463. data/spec/unit/handler/json_file_spec.rb +63 -63
  1464. data/spec/unit/handler_spec.rb +215 -215
  1465. data/spec/unit/http/authenticator_spec.rb +80 -80
  1466. data/spec/unit/http/basic_client_spec.rb +52 -129
  1467. data/spec/unit/http/http_request_spec.rb +91 -91
  1468. data/spec/unit/http/json_input_spec.rb +128 -128
  1469. data/spec/unit/http/simple_spec.rb +32 -32
  1470. data/spec/unit/http/socketless_chef_zero_client_spec.rb +173 -173
  1471. data/spec/unit/http/ssl_policies_spec.rb +169 -169
  1472. data/spec/unit/http/validate_content_length_spec.rb +207 -207
  1473. data/spec/unit/http_spec.rb +206 -206
  1474. data/spec/unit/json_compat_spec.rb +105 -105
  1475. data/spec/unit/key_spec.rb +631 -631
  1476. data/spec/unit/knife/bootstrap/chef_vault_handler_spec.rb +152 -152
  1477. data/spec/unit/knife/bootstrap/client_builder_spec.rb +207 -207
  1478. data/spec/unit/knife/bootstrap_spec.rb +822 -822
  1479. data/spec/unit/knife/client_bulk_delete_spec.rb +166 -166
  1480. data/spec/unit/knife/client_create_spec.rb +186 -186
  1481. data/spec/unit/knife/client_delete_spec.rb +83 -83
  1482. data/spec/unit/knife/client_edit_spec.rb +53 -53
  1483. data/spec/unit/knife/client_list_spec.rb +34 -34
  1484. data/spec/unit/knife/client_reregister_spec.rb +62 -62
  1485. data/spec/unit/knife/client_show_spec.rb +52 -52
  1486. data/spec/unit/knife/configure_client_spec.rb +83 -83
  1487. data/spec/unit/knife/configure_spec.rb +241 -241
  1488. data/spec/unit/knife/cookbook_bulk_delete_spec.rb +87 -87
  1489. data/spec/unit/knife/cookbook_create_spec.rb +260 -260
  1490. data/spec/unit/knife/cookbook_delete_spec.rb +239 -239
  1491. data/spec/unit/knife/cookbook_download_spec.rb +237 -237
  1492. data/spec/unit/knife/cookbook_list_spec.rb +88 -88
  1493. data/spec/unit/knife/cookbook_metadata_from_file_spec.rb +65 -65
  1494. data/spec/unit/knife/cookbook_metadata_spec.rb +179 -179
  1495. data/spec/unit/knife/cookbook_show_spec.rb +222 -222
  1496. data/spec/unit/knife/cookbook_site_download_spec.rb +149 -149
  1497. data/spec/unit/knife/cookbook_site_install_spec.rb +197 -197
  1498. data/spec/unit/knife/cookbook_site_share_spec.rb +209 -209
  1499. data/spec/unit/knife/cookbook_site_unshare_spec.rb +77 -77
  1500. data/spec/unit/knife/cookbook_test_spec.rb +84 -84
  1501. data/spec/unit/knife/cookbook_upload_spec.rb +331 -331
  1502. data/spec/unit/knife/core/bootstrap_context_spec.rb +257 -257
  1503. data/spec/unit/knife/core/cookbook_scm_repo_spec.rb +187 -187
  1504. data/spec/unit/knife/core/custom_manifest_loader_spec.rb +41 -41
  1505. data/spec/unit/knife/core/gem_glob_loader_spec.rb +209 -209
  1506. data/spec/unit/knife/core/hashed_command_loader_spec.rb +109 -109
  1507. data/spec/unit/knife/core/node_editor_spec.rb +211 -211
  1508. data/spec/unit/knife/core/object_loader_spec.rb +81 -81
  1509. data/spec/unit/knife/core/subcommand_loader_spec.rb +70 -70
  1510. data/spec/unit/knife/core/ui_spec.rb +598 -598
  1511. data/spec/unit/knife/data_bag_create_spec.rb +109 -109
  1512. data/spec/unit/knife/data_bag_edit_spec.rb +127 -127
  1513. data/spec/unit/knife/data_bag_from_file_spec.rb +172 -172
  1514. data/spec/unit/knife/data_bag_secret_options_spec.rb +165 -165
  1515. data/spec/unit/knife/data_bag_show_spec.rb +123 -123
  1516. data/spec/unit/knife/environment_compare_spec.rb +112 -112
  1517. data/spec/unit/knife/environment_create_spec.rb +91 -91
  1518. data/spec/unit/knife/environment_delete_spec.rb +71 -71
  1519. data/spec/unit/knife/environment_edit_spec.rb +79 -79
  1520. data/spec/unit/knife/environment_from_file_spec.rb +90 -90
  1521. data/spec/unit/knife/environment_list_spec.rb +54 -54
  1522. data/spec/unit/knife/environment_show_spec.rb +52 -52
  1523. data/spec/unit/knife/index_rebuild_spec.rb +125 -125
  1524. data/spec/unit/knife/key_create_spec.rb +223 -223
  1525. data/spec/unit/knife/key_delete_spec.rb +133 -133
  1526. data/spec/unit/knife/key_edit_spec.rb +264 -264
  1527. data/spec/unit/knife/key_helper.rb +74 -74
  1528. data/spec/unit/knife/key_list_spec.rb +216 -216
  1529. data/spec/unit/knife/key_show_spec.rb +126 -126
  1530. data/spec/unit/knife/knife_help.rb +92 -92
  1531. data/spec/unit/knife/node_bulk_delete_spec.rb +94 -94
  1532. data/spec/unit/knife/node_delete_spec.rb +68 -68
  1533. data/spec/unit/knife/node_edit_spec.rb +114 -114
  1534. data/spec/unit/knife/node_environment_set_spec.rb +80 -80
  1535. data/spec/unit/knife/node_from_file_spec.rb +59 -59
  1536. data/spec/unit/knife/node_list_spec.rb +62 -62
  1537. data/spec/unit/knife/node_run_list_add_spec.rb +145 -145
  1538. data/spec/unit/knife/node_run_list_remove_spec.rb +106 -106
  1539. data/spec/unit/knife/node_run_list_set_spec.rb +140 -140
  1540. data/spec/unit/knife/node_show_spec.rb +65 -65
  1541. data/spec/unit/knife/osc_user_create_spec.rb +93 -93
  1542. data/spec/unit/knife/osc_user_delete_spec.rb +44 -44
  1543. data/spec/unit/knife/osc_user_edit_spec.rb +52 -52
  1544. data/spec/unit/knife/osc_user_list_spec.rb +37 -37
  1545. data/spec/unit/knife/osc_user_reregister_spec.rb +58 -58
  1546. data/spec/unit/knife/osc_user_show_spec.rb +46 -46
  1547. data/spec/unit/knife/raw_spec.rb +43 -43
  1548. data/spec/unit/knife/role_bulk_delete_spec.rb +80 -80
  1549. data/spec/unit/knife/role_create_spec.rb +80 -80
  1550. data/spec/unit/knife/role_delete_spec.rb +67 -67
  1551. data/spec/unit/knife/role_edit_spec.rb +77 -77
  1552. data/spec/unit/knife/role_env_run_list_add_spec.rb +217 -217
  1553. data/spec/unit/knife/role_env_run_list_clear_spec.rb +94 -94
  1554. data/spec/unit/knife/role_env_run_list_remove_spec.rb +102 -102
  1555. data/spec/unit/knife/role_env_run_list_replace_spec.rb +105 -105
  1556. data/spec/unit/knife/role_env_run_list_set_spec.rb +99 -99
  1557. data/spec/unit/knife/role_from_file_spec.rb +69 -69
  1558. data/spec/unit/knife/role_list_spec.rb +54 -54
  1559. data/spec/unit/knife/role_run_list_add_spec.rb +179 -179
  1560. data/spec/unit/knife/role_run_list_clear_spec.rb +84 -84
  1561. data/spec/unit/knife/role_run_list_remove_spec.rb +92 -92
  1562. data/spec/unit/knife/role_run_list_replace_spec.rb +98 -98
  1563. data/spec/unit/knife/role_run_list_set_spec.rb +89 -89
  1564. data/spec/unit/knife/role_show_spec.rb +59 -59
  1565. data/spec/unit/knife/ssh_spec.rb +428 -410
  1566. data/spec/unit/knife/ssl_check_spec.rb +240 -240
  1567. data/spec/unit/knife/ssl_fetch_spec.rb +184 -184
  1568. data/spec/unit/knife/status_spec.rb +108 -108
  1569. data/spec/unit/knife/tag_create_spec.rb +23 -23
  1570. data/spec/unit/knife/tag_delete_spec.rb +25 -25
  1571. data/spec/unit/knife/tag_list_spec.rb +23 -23
  1572. data/spec/unit/knife/user_create_spec.rb +214 -214
  1573. data/spec/unit/knife/user_delete_spec.rb +65 -65
  1574. data/spec/unit/knife/user_edit_spec.rb +66 -66
  1575. data/spec/unit/knife/user_list_spec.rb +36 -36
  1576. data/spec/unit/knife/user_reregister_spec.rb +74 -74
  1577. data/spec/unit/knife/user_show_spec.rb +65 -65
  1578. data/spec/unit/knife_spec.rb +529 -529
  1579. data/spec/unit/lib_backcompat_spec.rb +34 -34
  1580. data/spec/unit/log/syslog_spec.rb +53 -53
  1581. data/spec/unit/log/winevt_spec.rb +55 -55
  1582. data/spec/unit/log_spec.rb +24 -24
  1583. data/spec/unit/lwrp_spec.rb +778 -720
  1584. data/spec/unit/mash_spec.rb +51 -51
  1585. data/spec/unit/mixin/api_version_request_handling_spec.rb +126 -126
  1586. data/spec/unit/mixin/checksum_spec.rb +40 -40
  1587. data/spec/unit/mixin/command_spec.rb +104 -104
  1588. data/spec/unit/mixin/convert_to_class_name_spec.rb +54 -54
  1589. data/spec/unit/mixin/deep_merge_spec.rb +342 -342
  1590. data/spec/unit/mixin/deprecation_spec.rb +57 -57
  1591. data/spec/unit/mixin/enforce_ownership_and_permissions_spec.rb +96 -96
  1592. data/spec/unit/mixin/homebrew_user_spec.rb +100 -100
  1593. data/spec/unit/mixin/lazy_module_include.rb +71 -0
  1594. data/spec/unit/mixin/params_validate_spec.rb +409 -409
  1595. data/spec/unit/mixin/path_sanity_spec.rb +92 -92
  1596. data/spec/unit/mixin/powershell_out_spec.rb +70 -70
  1597. data/spec/unit/mixin/powershell_type_coercions_spec.rb +83 -83
  1598. data/spec/unit/mixin/properties_spec.rb +97 -97
  1599. data/spec/unit/mixin/proxified_socket_spec.rb +97 -94
  1600. data/spec/unit/mixin/securable_spec.rb +314 -314
  1601. data/spec/unit/mixin/shell_out_spec.rb +299 -299
  1602. data/spec/unit/mixin/subclass_directive_spec.rb +45 -45
  1603. data/spec/unit/mixin/template_spec.rb +276 -276
  1604. data/spec/unit/mixin/unformatter_spec.rb +61 -61
  1605. data/spec/unit/mixin/uris_spec.rb +57 -57
  1606. data/spec/unit/mixin/windows_architecture_helper_spec.rb +85 -85
  1607. data/spec/unit/mixin/xml_escape_spec.rb +54 -54
  1608. data/spec/unit/monkey_patches/uri_spec.rb +34 -34
  1609. data/spec/unit/monologger_spec.rb +45 -45
  1610. data/spec/unit/node/attribute_spec.rb +1179 -1179
  1611. data/spec/unit/node/immutable_collections_spec.rb +197 -197
  1612. data/spec/unit/node_map_spec.rb +170 -170
  1613. data/spec/unit/node_spec.rb +1565 -1565
  1614. data/spec/unit/org_spec.rb +196 -196
  1615. data/spec/unit/platform/query_helpers_spec.rb +220 -220
  1616. data/spec/unit/platform_spec.rb +241 -241
  1617. data/spec/unit/policy_builder/dynamic_spec.rb +273 -273
  1618. data/spec/unit/policy_builder/expand_node_object_spec.rb +336 -336
  1619. data/spec/unit/policy_builder/policyfile_spec.rb +745 -745
  1620. data/spec/unit/policy_builder_spec.rb +26 -26
  1621. data/spec/unit/property/state_spec.rb +508 -508
  1622. data/spec/unit/property/validation_spec.rb +704 -704
  1623. data/spec/unit/property_spec.rb +1227 -1227
  1624. data/spec/unit/provider/apt_repository_spec.rb +178 -0
  1625. data/spec/unit/provider/apt_update_spec.rb +113 -113
  1626. data/spec/unit/provider/breakpoint_spec.rb +53 -53
  1627. data/spec/unit/provider/cookbook_file/content_spec.rb +39 -39
  1628. data/spec/unit/provider/cookbook_file_spec.rb +58 -58
  1629. data/spec/unit/provider/cron/unix_spec.rb +139 -139
  1630. data/spec/unit/provider/cron_spec.rb +1010 -1010
  1631. data/spec/unit/provider/deploy/revision_spec.rb +110 -110
  1632. data/spec/unit/provider/deploy/timestamped_spec.rb +40 -40
  1633. data/spec/unit/provider/deploy_spec.rb +641 -641
  1634. data/spec/unit/provider/directory_spec.rb +287 -287
  1635. data/spec/unit/provider/dsc_resource_spec.rb +167 -167
  1636. data/spec/unit/provider/dsc_script_spec.rb +173 -173
  1637. data/spec/unit/provider/env/windows_spec.rb +103 -103
  1638. data/spec/unit/provider/env_spec.rb +310 -310
  1639. data/spec/unit/provider/erl_call_spec.rb +85 -85
  1640. data/spec/unit/provider/execute_spec.rb +243 -243
  1641. data/spec/unit/provider/file/content_spec.rb +114 -114
  1642. data/spec/unit/provider/file_spec.rb +56 -56
  1643. data/spec/unit/provider/git_spec.rb +668 -668
  1644. data/spec/unit/provider/group/dscl_spec.rb +331 -331
  1645. data/spec/unit/provider/group/gpasswd_spec.rb +116 -116
  1646. data/spec/unit/provider/group/groupadd_spec.rb +174 -174
  1647. data/spec/unit/provider/group/groupmod_spec.rb +133 -133
  1648. data/spec/unit/provider/group/pw_spec.rb +138 -138
  1649. data/spec/unit/provider/group/usermod_spec.rb +115 -115
  1650. data/spec/unit/provider/group/windows_spec.rb +101 -101
  1651. data/spec/unit/provider/group_spec.rb +286 -286
  1652. data/spec/unit/provider/http_request_spec.rb +159 -159
  1653. data/spec/unit/provider/ifconfig/aix_spec.rb +180 -180
  1654. data/spec/unit/provider/ifconfig/debian_spec.rb +344 -344
  1655. data/spec/unit/provider/ifconfig/redhat_spec.rb +73 -73
  1656. data/spec/unit/provider/ifconfig_spec.rb +200 -200
  1657. data/spec/unit/provider/launchd_spec.rb +189 -189
  1658. data/spec/unit/provider/link_spec.rb +252 -252
  1659. data/spec/unit/provider/log_spec.rb +75 -75
  1660. data/spec/unit/provider/mdadm_spec.rb +131 -131
  1661. data/spec/unit/provider/mount/aix_spec.rb +237 -238
  1662. data/spec/unit/provider/mount/mount_spec.rb +474 -480
  1663. data/spec/unit/provider/mount/solaris_spec.rb +822 -822
  1664. data/spec/unit/provider/mount/windows_spec.rb +149 -151
  1665. data/spec/unit/provider/mount_spec.rb +184 -203
  1666. data/spec/unit/provider/ohai_spec.rb +84 -84
  1667. data/spec/unit/provider/osx_profile_spec.rb +249 -249
  1668. data/spec/unit/provider/package/aix_spec.rb +172 -172
  1669. data/spec/unit/provider/package/apt_spec.rb +386 -386
  1670. data/spec/unit/provider/package/chocolatey_spec.rb +501 -501
  1671. data/spec/unit/provider/package/dpkg_spec.rb +287 -287
  1672. data/spec/unit/provider/package/easy_install_spec.rb +108 -108
  1673. data/spec/unit/provider/package/freebsd/pkg_spec.rb +274 -274
  1674. data/spec/unit/provider/package/freebsd/pkgng_spec.rb +148 -148
  1675. data/spec/unit/provider/package/freebsd/port_spec.rb +163 -163
  1676. data/spec/unit/provider/package/homebrew_spec.rb +292 -292
  1677. data/spec/unit/provider/package/ips_spec.rb +227 -227
  1678. data/spec/unit/provider/package/macports_spec.rb +203 -203
  1679. data/spec/unit/provider/package/openbsd_spec.rb +132 -132
  1680. data/spec/unit/provider/package/pacman_spec.rb +194 -194
  1681. data/spec/unit/provider/package/paludis_spec.rb +134 -134
  1682. data/spec/unit/provider/package/portage_spec.rb +310 -310
  1683. data/spec/unit/provider/package/rpm_spec.rb +429 -429
  1684. data/spec/unit/provider/package/rubygems_spec.rb +782 -782
  1685. data/spec/unit/provider/package/smartos_spec.rb +110 -110
  1686. data/spec/unit/provider/package/solaris_spec.rb +167 -167
  1687. data/spec/unit/provider/package/windows/exe_spec.rb +187 -187
  1688. data/spec/unit/provider/package/windows/msi_spec.rb +159 -159
  1689. data/spec/unit/provider/package/windows_spec.rb +397 -397
  1690. data/spec/unit/provider/package/yum_spec.rb +2267 -2267
  1691. data/spec/unit/provider/package/zypper_spec.rb +268 -268
  1692. data/spec/unit/provider/package_spec.rb +870 -870
  1693. data/spec/unit/provider/powershell_script_spec.rb +106 -106
  1694. data/spec/unit/provider/registry_key_spec.rb +295 -295
  1695. data/spec/unit/provider/remote_directory_spec.rb +221 -221
  1696. data/spec/unit/provider/remote_file/cache_control_data_spec.rb +245 -245
  1697. data/spec/unit/provider/remote_file/content_spec.rb +252 -252
  1698. data/spec/unit/provider/remote_file/fetcher_spec.rb +94 -94
  1699. data/spec/unit/provider/remote_file/ftp_spec.rb +217 -219
  1700. data/spec/unit/provider/remote_file/http_spec.rb +322 -301
  1701. data/spec/unit/provider/remote_file/local_file_spec.rb +103 -103
  1702. data/spec/unit/provider/remote_file/network_file_spec.rb +45 -45
  1703. data/spec/unit/provider/remote_file/sftp_spec.rb +150 -0
  1704. data/spec/unit/provider/remote_file_spec.rb +61 -61
  1705. data/spec/unit/provider/route_spec.rb +242 -242
  1706. data/spec/unit/provider/ruby_block_spec.rb +45 -45
  1707. data/spec/unit/provider/script_spec.rb +114 -114
  1708. data/spec/unit/provider/service/aix_service_spec.rb +195 -195
  1709. data/spec/unit/provider/service/aixinit_service_spec.rb +272 -272
  1710. data/spec/unit/provider/service/arch_service_spec.rb +324 -324
  1711. data/spec/unit/provider/service/debian_service_spec.rb +375 -375
  1712. data/spec/unit/provider/service/freebsd_service_spec.rb +613 -613
  1713. data/spec/unit/provider/service/gentoo_service_spec.rb +144 -144
  1714. data/spec/unit/provider/service/init_service_spec.rb +235 -235
  1715. data/spec/unit/provider/service/insserv_service_spec.rb +75 -75
  1716. data/spec/unit/provider/service/invokercd_service_spec.rb +211 -211
  1717. data/spec/unit/provider/service/macosx_spec.rb +335 -335
  1718. data/spec/unit/provider/service/openbsd_service_spec.rb +545 -545
  1719. data/spec/unit/provider/service/redhat_spec.rb +250 -236
  1720. data/spec/unit/provider/service/simple_service_spec.rb +169 -169
  1721. data/spec/unit/provider/service/solaris_smf_service_spec.rb +255 -255
  1722. data/spec/unit/provider/service/systemd_service_spec.rb +370 -344
  1723. data/spec/unit/provider/service/upstart_service_spec.rb +342 -342
  1724. data/spec/unit/provider/service/windows_spec.rb +463 -463
  1725. data/spec/unit/provider/service_spec.rb +168 -168
  1726. data/spec/unit/provider/subversion_spec.rb +352 -298
  1727. data/spec/unit/provider/template/content_spec.rb +169 -169
  1728. data/spec/unit/provider/template_spec.rb +89 -89
  1729. data/spec/unit/provider/user/dscl_spec.rb +901 -901
  1730. data/spec/unit/provider/user/pw_spec.rb +252 -252
  1731. data/spec/unit/provider/user/solaris_spec.rb +139 -139
  1732. data/spec/unit/provider/user/useradd_spec.rb +51 -51
  1733. data/spec/unit/provider/user/windows_spec.rb +185 -185
  1734. data/spec/unit/provider/user_spec.rb +474 -474
  1735. data/spec/unit/provider/whyrun_safe_ruby_block_spec.rb +46 -46
  1736. data/spec/unit/provider_resolver_spec.rb +893 -893
  1737. data/spec/unit/provider_spec.rb +198 -198
  1738. data/spec/unit/pure_application_spec.rb +32 -32
  1739. data/spec/unit/recipe_spec.rb +699 -699
  1740. data/spec/unit/resource/apt_package_spec.rb +38 -38
  1741. data/spec/unit/resource/apt_repository_spec.rb +34 -0
  1742. data/spec/unit/resource/apt_update_spec.rb +38 -38
  1743. data/spec/unit/resource/bash_spec.rb +40 -40
  1744. data/spec/unit/resource/batch_spec.rb +49 -49
  1745. data/spec/unit/resource/breakpoint_spec.rb +47 -47
  1746. data/spec/unit/resource/chef_gem_spec.rb +157 -157
  1747. data/spec/unit/resource/chocolatey_package_spec.rb +67 -67
  1748. data/spec/unit/resource/conditional_action_not_nothing_spec.rb +45 -45
  1749. data/spec/unit/resource/conditional_spec.rb +208 -208
  1750. data/spec/unit/resource/cookbook_file_spec.rb +88 -88
  1751. data/spec/unit/resource/cron_spec.rb +186 -186
  1752. data/spec/unit/resource/csh_spec.rb +40 -40
  1753. data/spec/unit/resource/deploy_revision_spec.rb +42 -42
  1754. data/spec/unit/resource/deploy_spec.rb +283 -283
  1755. data/spec/unit/resource/directory_spec.rb +82 -82
  1756. data/spec/unit/resource/dpkg_package_spec.rb +32 -32
  1757. data/spec/unit/resource/dsc_resource_spec.rb +96 -96
  1758. data/spec/unit/resource/dsc_script_spec.rb +134 -134
  1759. data/spec/unit/resource/easy_install_package_spec.rb +39 -39
  1760. data/spec/unit/resource/env_spec.rb +85 -85
  1761. data/spec/unit/resource/erl_call_spec.rb +81 -81
  1762. data/spec/unit/resource/execute_spec.rb +35 -35
  1763. data/spec/unit/resource/file/verification_spec.rb +139 -139
  1764. data/spec/unit/resource/file_spec.rb +130 -130
  1765. data/spec/unit/resource/freebsd_package_spec.rb +87 -87
  1766. data/spec/unit/resource/gem_package_spec.rb +42 -42
  1767. data/spec/unit/resource/git_spec.rb +50 -50
  1768. data/spec/unit/resource/group_spec.rb +162 -162
  1769. data/spec/unit/resource/homebrew_package_spec.rb +50 -50
  1770. data/spec/unit/resource/http_request_spec.rb +59 -59
  1771. data/spec/unit/resource/ifconfig_spec.rb +109 -109
  1772. data/spec/unit/resource/ips_package_spec.rb +40 -40
  1773. data/spec/unit/resource/ksh_spec.rb +40 -40
  1774. data/spec/unit/resource/launchd_spec.rb +31 -31
  1775. data/spec/unit/resource/link_spec.rb +134 -134
  1776. data/spec/unit/resource/log_spec.rb +73 -73
  1777. data/spec/unit/resource/macports_package_spec.rb +32 -32
  1778. data/spec/unit/resource/mdadm_spec.rb +102 -102
  1779. data/spec/unit/resource/mount_spec.rb +214 -214
  1780. data/spec/unit/resource/ohai_spec.rb +61 -61
  1781. data/spec/unit/resource/openbsd_package_spec.rb +48 -48
  1782. data/spec/unit/resource/osx_profile_spec.rb +61 -61
  1783. data/spec/unit/resource/package_spec.rb +93 -93
  1784. data/spec/unit/resource/pacman_package_spec.rb +32 -32
  1785. data/spec/unit/resource/perl_spec.rb +40 -40
  1786. data/spec/unit/resource/portage_package_spec.rb +38 -38
  1787. data/spec/unit/resource/powershell_script_spec.rb +136 -136
  1788. data/spec/unit/resource/python_spec.rb +40 -40
  1789. data/spec/unit/resource/registry_key_spec.rb +199 -199
  1790. data/spec/unit/resource/remote_directory_spec.rb +97 -97
  1791. data/spec/unit/resource/remote_file_spec.rb +207 -207
  1792. data/spec/unit/resource/resource_notification_spec.rb +169 -169
  1793. data/spec/unit/resource/route_spec.rb +107 -107
  1794. data/spec/unit/resource/rpm_package_spec.rb +46 -46
  1795. data/spec/unit/resource/ruby_block_spec.rb +61 -61
  1796. data/spec/unit/resource/ruby_spec.rb +40 -40
  1797. data/spec/unit/resource/scm_spec.rb +193 -193
  1798. data/spec/unit/resource/script_spec.rb +44 -44
  1799. data/spec/unit/resource/service_spec.rb +179 -179
  1800. data/spec/unit/resource/smartos_package_spec.rb +33 -33
  1801. data/spec/unit/resource/solaris_package_spec.rb +42 -42
  1802. data/spec/unit/resource/subversion_spec.rb +71 -71
  1803. data/spec/unit/resource/template_spec.rb +210 -210
  1804. data/spec/unit/resource/timestamped_deploy_spec.rb +32 -32
  1805. data/spec/unit/resource/user_spec.rb +133 -133
  1806. data/spec/unit/resource/windows_package_spec.rb +95 -95
  1807. data/spec/unit/resource/windows_service_spec.rb +49 -49
  1808. data/spec/unit/resource/yum_package_spec.rb +89 -89
  1809. data/spec/unit/resource_builder_spec.rb +1 -1
  1810. data/spec/unit/resource_collection/resource_list_spec.rb +137 -137
  1811. data/spec/unit/resource_collection/resource_set_spec.rb +199 -199
  1812. data/spec/unit/resource_collection/stepable_iterator_spec.rb +144 -144
  1813. data/spec/unit/resource_collection_spec.rb +369 -299
  1814. data/spec/unit/resource_definition_spec.rb +117 -117
  1815. data/spec/unit/resource_reporter_spec.rb +758 -758
  1816. data/spec/unit/resource_resolver_spec.rb +52 -52
  1817. data/spec/unit/resource_spec.rb +1101 -1101
  1818. data/spec/unit/rest/auth_credentials_spec.rb +292 -296
  1819. data/spec/unit/rest_spec.rb +753 -753
  1820. data/spec/unit/role_spec.rb +358 -358
  1821. data/spec/unit/run_context/child_run_context_spec.rb +133 -133
  1822. data/spec/unit/run_context/cookbook_compiler_spec.rb +184 -184
  1823. data/spec/unit/run_context_spec.rb +241 -241
  1824. data/spec/unit/run_list/run_list_expansion_spec.rb +144 -144
  1825. data/spec/unit/run_list/run_list_item_spec.rb +117 -117
  1826. data/spec/unit/run_list/versioned_recipe_list_spec.rb +194 -194
  1827. data/spec/unit/run_list_spec.rb +312 -312
  1828. data/spec/unit/run_lock_spec.rb +140 -140
  1829. data/spec/unit/run_status_spec.rb +144 -144
  1830. data/spec/unit/runner_spec.rb +411 -411
  1831. data/spec/unit/scan_access_control_spec.rb +183 -183
  1832. data/spec/unit/search/query_spec.rb +289 -289
  1833. data/spec/unit/shell/model_wrapper_spec.rb +96 -96
  1834. data/spec/unit/shell/shell_ext_spec.rb +153 -153
  1835. data/spec/unit/shell/shell_session_spec.rb +195 -195
  1836. data/spec/unit/shell_out_spec.rb +18 -18
  1837. data/spec/unit/shell_spec.rb +162 -162
  1838. data/spec/unit/user_spec.rb +275 -275
  1839. data/spec/unit/user_v1_spec.rb +583 -583
  1840. data/spec/unit/util/backup_spec.rb +141 -141
  1841. data/spec/unit/util/diff_spec.rb +576 -576
  1842. data/spec/unit/util/dsc/configuration_generator_spec.rb +193 -193
  1843. data/spec/unit/util/dsc/lcm_output_parser_spec.rb +164 -164
  1844. data/spec/unit/util/dsc/local_configuration_manager_spec.rb +138 -138
  1845. data/spec/unit/util/dsc/resource_store.rb +76 -76
  1846. data/spec/unit/util/editor_spec.rb +152 -152
  1847. data/spec/unit/util/file_edit_spec.rb +224 -224
  1848. data/spec/unit/util/powershell/cmdlet_spec.rb +106 -106
  1849. data/spec/unit/util/powershell/ps_credential_spec.rb +44 -44
  1850. data/spec/unit/util/selinux_spec.rb +171 -171
  1851. data/spec/unit/util/threaded_job_queue_spec.rb +51 -51
  1852. data/spec/unit/version/platform_spec.rb +60 -60
  1853. data/spec/unit/version_class_spec.rb +171 -171
  1854. data/spec/unit/version_constraint/platform_spec.rb +45 -45
  1855. data/spec/unit/version_constraint_spec.rb +179 -179
  1856. data/spec/unit/win32/registry_spec.rb +394 -394
  1857. data/spec/unit/windows_service_spec.rb +116 -116
  1858. data/tasks/cbgb.rb +84 -84
  1859. data/tasks/external_tests.rb +64 -64
  1860. data/tasks/maintainers.rb +210 -210
  1861. data/tasks/rspec.rb +89 -89
  1862. metadata +55 -464
data/distro/common/html/ctl_chef_server.html CHANGED
@@ -1,728 +1,728 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
-
4
-
5
- <html xmlns="http://www.w3.org/1999/xhtml">
6
- <head>
7
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
-
9
- <title>chef-server-ctl (executable) &mdash; chef-client Man Pages</title>
10
-
11
- <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
-
14
- <script type="text/javascript">
15
- var DOCUMENTATION_OPTIONS = {
16
- URL_ROOT: './',
17
- VERSION: '',
18
- COLLAPSE_INDEX: false,
19
- FILE_SUFFIX: '.html',
20
- HAS_SOURCE: true
21
- };
22
- </script>
23
- <script type="text/javascript" src="_static/jquery.js"></script>
24
- <script type="text/javascript" src="_static/underscore.js"></script>
25
- <script type="text/javascript" src="_static/doctools.js"></script>
26
-
27
-
28
- </head>
29
- <body>
30
- <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
- <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
- </div>
33
-
34
-
35
-
36
-
37
- <div class="document">
38
- <div class="documentwrapper">
39
-
40
- <div class="body">
41
-
42
- <div class="section" id="chef-server-ctl-executable">
43
- <h1>chef-server-ctl (executable)<a class="headerlink" href="#chef-server-ctl-executable" title="Permalink to this headline">¶</a></h1>
44
- <p>The Chef server includes a command-line utility named chef-server-ctl. This command-line tool is used to start and stop individual services, reconfigure the Chef server, run chef-pedant, and then tail Chef server log files.</p>
45
- <div class="section" id="backup-recover">
46
- <h2>backup-recover<a class="headerlink" href="#backup-recover" title="Permalink to this headline">¶</a></h2>
47
- <p>The <tt class="docutils literal"><span class="pre">backup-recover</span></tt> subcommand is used to force the Chef server to attempt to become the backup server. This is the opposite of the <tt class="docutils literal"><span class="pre">master-recover</span></tt> subcommand.</p>
48
- <div class="admonition warning">
49
- <p class="first admonition-title">Warning</p>
50
- <p class="last">If this command is run on both back-end servers, it will put the back-end cluster into a state where no server holds the DRBD resource.</p>
51
- </div>
52
- <p>This subcommand has the following syntax:</p>
53
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl backup-recover
54
- </pre></div>
55
- </div>
56
- </div>
57
- <div class="section" id="cleanse">
58
- <h2>cleanse<a class="headerlink" href="#cleanse" title="Permalink to this headline">¶</a></h2>
59
- <p>The <tt class="docutils literal"><span class="pre">cleanse</span></tt> subcommand is used to re-set the Chef server to the state it was in before the first time the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand is run to destroy all data, configuration files, and logs.</p>
60
- <p>This subcommand has the following syntax:</p>
61
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl cleanse
62
- </pre></div>
63
- </div>
64
- </div>
65
- <div class="section" id="gather-logs">
66
- <h2>gather-logs<a class="headerlink" href="#gather-logs" title="Permalink to this headline">¶</a></h2>
67
- <p>The <tt class="docutils literal"><span class="pre">gather-logs</span></tt> subcommand is used to gather the Chef server log files into a tarball that contains all of the important log files and system information.</p>
68
- <p>This subcommand has the following syntax:</p>
69
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl gather-logs
70
- </pre></div>
71
- </div>
72
- </div>
73
- <div class="section" id="ha-status">
74
- <h2>ha-status<a class="headerlink" href="#ha-status" title="Permalink to this headline">¶</a></h2>
75
- <p>The <tt class="docutils literal"><span class="pre">ha-status</span></tt> subcommand is used to check the status for services running in a High Availability topology. This command will verify the following:</p>
76
- <blockquote>
77
- <div><ul class="simple">
78
- <li>The Keepalived daemon is enabled in the config</li>
79
- <li>The DRBD process is enabled in the config</li>
80
- <li>The underlying block device or logical volume for DRBD has been created and configured</li>
81
- <li>The DRBD device exists</li>
82
- <li>The current state of the server is <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt>; any migration processes have completed</li>
83
- <li>The failover virtual IP address is correctly attached to only the <tt class="docutils literal"><span class="pre">master</span></tt> node</li>
84
- <li>The DRBD state is correct based on the state of the server being <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt></li>
85
- <li>The DRBD mount point is correctly mounted to only the <tt class="docutils literal"><span class="pre">master</span></tt> node</li>
86
- <li>The DRBD replication IP addresses are pingable</li>
87
- <li>The <tt class="docutils literal"><span class="pre">runit</span></tt> status of the services are correct (up or down) based on the <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt> state of the server</li>
88
- </ul>
89
- </div></blockquote>
90
- <p>This subcommand has the following syntax:</p>
91
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl ha-status
92
- </pre></div>
93
- </div>
94
- <p>If this command runs successfully, it will return the following:</p>
95
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="o">[</span>OK<span class="o">]</span> all checks passed.
96
- </pre></div>
97
- </div>
98
- <p>Otherwise it will print out a list of errors, similar to the following:</p>
99
- <div class="highlight-bash"><div class="highlight"><pre>...
100
- <span class="o">[</span>OK<span class="o">]</span> nginx is running correctly, and I am master.
101
- <span class="o">[</span>ERROR<span class="o">]</span> redis_lb is not running.
102
- <span class="o">[</span>OK<span class="o">]</span> opscode-erchef is running correctly, and I am master.
103
- ...
104
- <span class="o">[</span>ERROR<span class="o">]</span> ERRORS WERE DETECTED.
105
- </pre></div>
106
- </div>
107
- <p>For example:</p>
108
- <div class="highlight-bash"><div class="highlight"><pre><span class="o">[</span>OK<span class="o">]</span> keepalived HA services enabled
109
- <span class="o">[</span>OK<span class="o">]</span> DRBD disk replication enabled
110
- <span class="o">[</span>OK<span class="o">]</span> DRBD partition /dev/opscode/drbd found
111
- <span class="o">[</span>OK<span class="o">]</span> DRBD device /dev/drbd0 found
112
- <span class="o">[</span>OK<span class="o">]</span> cluster <span class="nv">status</span> <span class="o">=</span> master
113
- <span class="o">[</span>OK<span class="o">]</span> found VIP IP address and I am master
114
- <span class="o">[</span>OK<span class="o">]</span> found VRRP communications interface eth1
115
- <span class="o">[</span>OK<span class="o">]</span> my DRBD status is Connected/Primary/UpToDate and I am master
116
- <span class="o">[</span>OK<span class="o">]</span> my DRBD partition is mounted and I am master
117
- <span class="o">[</span>OK<span class="o">]</span> DRBD primary IP address pings
118
- <span class="o">[</span>OK<span class="o">]</span> DRBD secondary IP address pings
119
- ...
120
- <span class="o">[</span>OK<span class="o">]</span> all checks passed.
121
- </pre></div>
122
- </div>
123
- </div>
124
- <div class="section" id="help">
125
- <h2>help<a class="headerlink" href="#help" title="Permalink to this headline">¶</a></h2>
126
- <p>The <tt class="docutils literal"><span class="pre">help</span></tt> subcommand is used to print a list of all available chef-server-ctl commands.</p>
127
- <p>This subcommand has the following syntax:</p>
128
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl <span class="nb">help</span>
129
- </pre></div>
130
- </div>
131
- </div>
132
- <div class="section" id="install">
133
- <h2>install<a class="headerlink" href="#install" title="Permalink to this headline">¶</a></h2>
134
- <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand is used to install premium features of the Chef server: Chef management console, Chef analytics, chef-client run reporting, high availability configurations, Chef push jobs, and Chef server replication.</p>
135
- <p><strong>Syntax</strong></p>
136
- <p>This subcommand has the following syntax:</p>
137
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install name_of_premium_feature <span class="o">(</span>options<span class="o">)</span>
138
- </pre></div>
139
- </div>
140
- <p>where <tt class="docutils literal"><span class="pre">name_of_premium_feature</span></tt> represents the command line value associated with the premium feature:</p>
141
- <p><strong>Options</strong></p>
142
- <p>This subcommand has the following options:</p>
143
- <dl class="docutils">
144
- <dt><tt class="docutils literal"><span class="pre">--path</span> <span class="pre">PATH</span></tt></dt>
145
- <dd>Use to specify the location of a package. This option is not required when packages are downloaded from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>.</dd>
146
- </dl>
147
- <div class="section" id="use-downloads">
148
- <h3>Use Downloads<a class="headerlink" href="#use-downloads" title="Permalink to this headline">¶</a></h3>
149
- <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand downloads packages from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a> by default. For systems that are not behind a firewall (and have connectivity to <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>), these packages can be installed as described below.</p>
150
- <table border="1" class="docutils">
151
- <colgroup>
152
- <col width="20%" />
153
- <col width="80%" />
154
- </colgroup>
155
- <thead valign="bottom">
156
- <tr class="row-odd"><th class="head">Feature</th>
157
- <th class="head">Command</th>
158
- </tr>
159
- </thead>
160
- <tbody valign="top">
161
- <tr class="row-even"><td>Chef Manage</td>
162
- <td><p class="first">Use Chef management console to manage data bags, attributes, run-lists, roles, environments, and cookbooks from a web user interface.</p>
163
- <p>(Front end machines only.) Run:</p>
164
- <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-manage
165
- </pre></div>
166
- </div>
167
- <p>then:</p>
168
- <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-manage-ctl reconfigure
169
- </pre></div>
170
- </div>
171
- <p>and then:</p>
172
- <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
173
- </pre></div>
174
- </div>
175
- </td>
176
- </tr>
177
- <tr class="row-odd"><td>Chef Push Jobs</td>
178
- <td><p class="first">Use Chef push jobs to run jobs&#8212;an action or a command to be executed&#8212;against nodes independently of a chef-client run.</p>
179
- <p>Run:</p>
180
- <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-push-jobs-server
181
- </pre></div>
182
- </div>
183
- <p>then:</p>
184
- <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-push-jobs-server-ctl reconfigure
185
- </pre></div>
186
- </div>
187
- <p>and then:</p>
188
- <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
189
- </pre></div>
190
- </div>
191
- </td>
192
- </tr>
193
- <tr class="row-even"><td>Chef Replication</td>
194
- <td><p class="first">Use Chef replication to asynchronously distribute cookbook, environment, role, and data bag data from a single, primary Chef server to one (or more) replicas of that Chef server.</p>
195
- <p>Run:</p>
196
- <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install chef-sync
197
- </pre></div>
198
- </div>
199
- <p>and then:</p>
200
- <div class="highlight-ruby"><div class="highlight"><pre>$ chef-sync-ctl reconfigure
201
- </pre></div>
202
- </div>
203
- <p>and then:</p>
204
- <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
205
- </pre></div>
206
- </div>
207
- </td>
208
- </tr>
209
- <tr class="row-odd"><td>Reporting</td>
210
- <td><p class="first">Use Chef reporting to keep track of what happens during every chef-client runs across all of the infrastructure being managed by Chef. Run Chef reporting with Chef management console to view reports from a web user interface.</p>
211
- <p>(Front end machines only.) Run:</p>
212
- <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-reporting
213
- </pre></div>
214
- </div>
215
- <p>then:</p>
216
- <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-reporting-ctl reconfigure
217
- </pre></div>
218
- </div>
219
- <p>and then:</p>
220
- <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
221
- </pre></div>
222
- </div>
223
- </td>
224
- </tr>
225
- </tbody>
226
- </table>
227
- </div>
228
- <div class="section" id="use-local-packages">
229
- <h3>Use Local Packages<a class="headerlink" href="#use-local-packages" title="Permalink to this headline">¶</a></h3>
230
- <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand downloads packages from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a> by default. For systems that are behind a firewall (and do not have connectivity to <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>), these packages can be installed manually. First download the package that is appropriate for the platform and save it to a local path. Then run the <tt class="docutils literal"><span class="pre">install</span></tt> command using the <tt class="docutils literal"><span class="pre">--path</span></tt> option to specify the location for the package:</p>
231
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install NAME_OF_PACKAGE --path /path/to/package
232
- </pre></div>
233
- </div>
234
- <p>For example:</p>
235
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install opscode-manage-1.6.2-1.el6.x86_64 --path /home/vagrant
236
- </pre></div>
237
- </div>
238
- </div>
239
- </div>
240
- <div class="section" id="master-recover">
241
- <h2>master-recover<a class="headerlink" href="#master-recover" title="Permalink to this headline">¶</a></h2>
242
- <p>The <tt class="docutils literal"><span class="pre">master-recover</span></tt> subcommand is used to force the Chef server to attempt to become the master server. This command is typically run in tandem with the <tt class="docutils literal"><span class="pre">backup-recover</span></tt> subcommand on the back-end peer, unless the back-end peer is no longer available.</p>
243
- <p>This subcommand has the following syntax:</p>
244
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl master-recover
245
- </pre></div>
246
- </div>
247
- </div>
248
- <div class="section" id="org-create">
249
- <h2>org-create<a class="headerlink" href="#org-create" title="Permalink to this headline">¶</a></h2>
250
- <p>The <tt class="docutils literal"><span class="pre">org-create</span></tt> subcommand is used to create an organization. (The validation key for the organization is returned to <tt class="docutils literal"><span class="pre">STDOUT</span></tt> when creating an organization using this command.)</p>
251
- <p><strong>Syntax</strong></p>
252
- <p>This subcommand has the following syntax:</p>
253
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create ORG_NAME ORG_FULL_NAME <span class="o">(</span>options<span class="o">)</span>
254
- </pre></div>
255
- </div>
256
- <p><strong>Options</strong></p>
257
- <p>This subcommand has the following options:</p>
258
- <dl class="docutils">
259
- <dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">USER_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--association_user</span> <span class="pre">USER_NAME</span></tt></dt>
260
- <dd>Use to associate a user with an organization and add them to the <tt class="docutils literal"><span class="pre">admins</span></tt> and <tt class="docutils literal"><span class="pre">billing_admins</span></tt> security groups.</dd>
261
- <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--filename</span> <span class="pre">FILE_NAME</span></tt></dt>
262
- <dd>Use to write the private key to a file instead of <tt class="docutils literal"><span class="pre">STDOUT</span></tt>.</dd>
263
- </dl>
264
- <p><strong>Examples</strong></p>
265
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create prod Production
266
- </pre></div>
267
- </div>
268
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create staging Staging -a chef-admin
269
- </pre></div>
270
- </div>
271
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create dev Development -f /tmp/id-dev.key
272
- </pre></div>
273
- </div>
274
- </div>
275
- <div class="section" id="org-delete">
276
- <h2>org-delete<a class="headerlink" href="#org-delete" title="Permalink to this headline">¶</a></h2>
277
- <p>The <tt class="docutils literal"><span class="pre">org-delete</span></tt> subcommand is used to delete an organization.</p>
278
- <p><strong>Syntax</strong></p>
279
- <p>This subcommand has the following syntax:</p>
280
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete ORG_NAME
281
- </pre></div>
282
- </div>
283
- <p><strong>Examples</strong></p>
284
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete infra-testing-20140909
285
- </pre></div>
286
- </div>
287
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete pedant-testing-org
288
- </pre></div>
289
- </div>
290
- </div>
291
- <div class="section" id="org-list">
292
- <h2>org-list<a class="headerlink" href="#org-list" title="Permalink to this headline">¶</a></h2>
293
- <p>The <tt class="docutils literal"><span class="pre">org-list</span></tt> subcommand is used to list all of the organizations currently present on the Chef server.</p>
294
- <p><strong>Syntax</strong></p>
295
- <p>This subcommand has the following syntax:</p>
296
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-list <span class="o">(</span>options<span class="o">)</span>
297
- </pre></div>
298
- </div>
299
- <p><strong>Options</strong></p>
300
- <p>This subcommand has the following options:</p>
301
- <dl class="docutils">
302
- <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all-orgs</span></tt></dt>
303
- <dd>Use to show all organizations.</dd>
304
- <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
305
- <dd>Use to show the corresponding URIs.</dd>
306
- </dl>
307
- </div>
308
- <div class="section" id="org-show">
309
- <h2>org-show<a class="headerlink" href="#org-show" title="Permalink to this headline">¶</a></h2>
310
- <p>The <tt class="docutils literal"><span class="pre">org-show</span></tt> subcommand is used to show the details for an organization.</p>
311
- <p><strong>Syntax</strong></p>
312
- <p>This subcommand has the following syntax:</p>
313
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-show ORG_NAME
314
- </pre></div>
315
- </div>
316
- </div>
317
- <div class="section" id="org-user-add">
318
- <h2>org-user-add<a class="headerlink" href="#org-user-add" title="Permalink to this headline">¶</a></h2>
319
- <p>The <tt class="docutils literal"><span class="pre">org-user-add</span></tt> subcommand is used to add a user to an organization.</p>
320
- <p><strong>Syntax</strong></p>
321
- <p>This subcommand has the following syntax:</p>
322
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add ORG_NAME USER_NAME <span class="o">(</span>options<span class="o">)</span>
323
- </pre></div>
324
- </div>
325
- <p><strong>Options</strong></p>
326
- <p>This subcommand has the following options:</p>
327
- <dl class="docutils">
328
- <dt><tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
329
- <dd>Use to add the user to the <tt class="docutils literal"><span class="pre">admins</span></tt> group.</dd>
330
- </dl>
331
- <p><strong>Examples</strong></p>
332
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add prod john_smith
333
- </pre></div>
334
- </div>
335
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add preprod testmaster
336
- </pre></div>
337
- </div>
338
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add dev grantmc --admin
339
- </pre></div>
340
- </div>
341
- </div>
342
- <div class="section" id="org-user-remove">
343
- <h2>org-user-remove<a class="headerlink" href="#org-user-remove" title="Permalink to this headline">¶</a></h2>
344
- <p>The <tt class="docutils literal"><span class="pre">org-user-remove</span></tt> subcommand is used to remove a user from an organization.</p>
345
- <p><strong>Syntax</strong></p>
346
- <p>This subcommand has the following syntax:</p>
347
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove ORG_NAME USER_NAME
348
- </pre></div>
349
- </div>
350
- <p><strong>Examples</strong></p>
351
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove prod john_smith
352
- </pre></div>
353
- </div>
354
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove prod testmaster
355
- </pre></div>
356
- </div>
357
- </div>
358
- <div class="section" id="password">
359
- <h2>password<a class="headerlink" href="#password" title="Permalink to this headline">¶</a></h2>
360
- <div class="admonition warning">
361
- <p class="first admonition-title">Warning</p>
362
- <p class="last">This subcommand is currently disabled.</p>
363
- </div>
364
- </div>
365
- <div class="section" id="reconfigure">
366
- <h2>reconfigure<a class="headerlink" href="#reconfigure" title="Permalink to this headline">¶</a></h2>
367
- <p>The <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand is used when changes are made to the private-chef.rb file to reconfigure the server. When changes are made to the private-chef.rb file, they will not be applied to the Chef server configuration until after this command is run. This subcommand will also restart any services for which the <tt class="docutils literal"><span class="pre">service_name['enabled']</span></tt> setting is set to <tt class="docutils literal"><span class="pre">true</span></tt>.</p>
368
- <p>This subcommand has the following syntax:</p>
369
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl reconfigure
370
- </pre></div>
371
- </div>
372
- </div>
373
- <div class="section" id="show-config">
374
- <h2>show-config<a class="headerlink" href="#show-config" title="Permalink to this headline">¶</a></h2>
375
- <p>The <tt class="docutils literal"><span class="pre">show-config</span></tt> subcommand is used to view the configuration that will be generated by the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand. This command is most useful in the early stages of a deployment to ensure that everything is built properly prior to installation.</p>
376
- <p>This subcommand has the following syntax:</p>
377
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl show-config
378
- </pre></div>
379
- </div>
380
- </div>
381
- <div class="section" id="uninstall">
382
- <h2>uninstall<a class="headerlink" href="#uninstall" title="Permalink to this headline">¶</a></h2>
383
- <p>The <tt class="docutils literal"><span class="pre">uninstall</span></tt> subcommand is used to remove the Chef server application, but without removing any of the data. This subcommand will shut down all services (including the <tt class="docutils literal"><span class="pre">runit</span></tt> process supervisor).</p>
384
- <p>This subcommand has the following syntax:</p>
385
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl uninstall
386
- </pre></div>
387
- </div>
388
- <div class="admonition note">
389
- <p class="first admonition-title">Note</p>
390
- <p class="last">To revert the <tt class="docutils literal"><span class="pre">uninstall</span></tt> subcommand, run the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand (because the <tt class="docutils literal"><span class="pre">start</span></tt> subcommand is disabled by the <tt class="docutils literal"><span class="pre">uninstall</span></tt> command).</p>
391
- </div>
392
- </div>
393
- <div class="section" id="upgrade">
394
- <h2>upgrade<a class="headerlink" href="#upgrade" title="Permalink to this headline">¶</a></h2>
395
- <p>The <tt class="docutils literal"><span class="pre">upgrade</span></tt> subcommand is used to upgrade the Chef server.</p>
396
- <p><strong>Syntax</strong></p>
397
- <p>This subcommand has the following syntax:</p>
398
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl upgrade <span class="o">(</span>options<span class="o">)</span>
399
- </pre></div>
400
- </div>
401
- <p><strong>Options</strong></p>
402
- <div class="admonition note">
403
- <p class="first admonition-title">Note</p>
404
- <p class="last">Options for the <tt class="docutils literal"><span class="pre">upgrade</span></tt> subcommand may only be used when upgrading from Open Source Chef 11 to Chef server 12.</p>
405
- </div>
406
- <p>This subcommand has the following options:</p>
407
- <dl class="docutils">
408
- <dt><tt class="docutils literal"><span class="pre">-d</span> <span class="pre">DIRECTORY</span></tt>, <tt class="docutils literal"><span class="pre">--chef11-data-dir</span> <span class="pre">DIRECTORY</span></tt></dt>
409
- <dd>The directory in which Open Source Chef 11 data is located. Default value: a temporary directory.</dd>
410
- <dt><tt class="docutils literal"><span class="pre">-e</span> <span class="pre">DIRECTORY</span></tt>, <tt class="docutils literal"><span class="pre">--chef12-data-dir</span> <span class="pre">DIRECTORY</span></tt></dt>
411
- <dd>The directory in which Chef server 12 data is located. Default value: a temporary directory.</dd>
412
- <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FULL_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--full-org-name</span> <span class="pre">FULL_NAME</span></tt></dt>
413
- <dd>The full name of the Chef server organization. A full organization name must begin with a non-white space character and must be between 1 and 1023 characters. For example: <tt class="docutils literal"><span class="pre">Chef</span> <span class="pre">Software,</span> <span class="pre">Inc.</span></tt>. If this option is not specified, the <tt class="docutils literal"><span class="pre">upgrade</span></tt> command will prompt for it.</dd>
414
- <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
415
- <dd>Use to show help for the <tt class="docutils literal"><span class="pre">chef-server-ctl</span> <span class="pre">upgrade</span></tt> subcommand.</dd>
416
- <dt><tt class="docutils literal"><span class="pre">-k</span> <span class="pre">KEY</span></tt>, <tt class="docutils literal"><span class="pre">--key</span> <span class="pre">KEY</span></tt></dt>
417
- <dd>All users are assigned a public key. Use to write the public key to a file. Default value: <tt class="docutils literal"><span class="pre">/etc/chef-server/admin.pem</span></tt>.</dd>
418
- <dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">ORG_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--org-name</span> <span class="pre">ORG_NAME</span></tt></dt>
419
- <dd>The name of the Chef server organization. An organization name must begin with a lower-case letter or digit, may only contain lower-case letters, digits, hyphens, and underscores, and must be between 1 and 255 characters. For example: <tt class="docutils literal"><span class="pre">chef</span></tt>. If this option is not specified, the <tt class="docutils literal"><span class="pre">upgrade</span></tt> command will prompt for it.</dd>
420
- <dt><tt class="docutils literal"><span class="pre">-s</span> <span class="pre">URL</span></tt>, <tt class="docutils literal"><span class="pre">--chef11-server-url</span> <span class="pre">URL</span></tt></dt>
421
- <dd>The URL for the Open Source Chef or Enterprise Chef server, version 11. Default value: <tt class="docutils literal"><span class="pre">https://localhost</span></tt>.</dd>
422
- <dt><tt class="docutils literal"><span class="pre">-t</span> <span class="pre">NUMBER</span></tt>, <tt class="docutils literal"><span class="pre">--upload-threads</span> <span class="pre">NUMBER</span></tt></dt>
423
- <dd>The number of threads to use when migrating cookbooks. Default value: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
424
- <dt><tt class="docutils literal"><span class="pre">-u</span> <span class="pre">USER</span></tt>, <tt class="docutils literal"><span class="pre">--user</span></tt></dt>
425
- <dd>Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator.</dd>
426
- <dt><tt class="docutils literal"><span class="pre">-x</span> <span class="pre">URL</span></tt>, <tt class="docutils literal"><span class="pre">--chef12-server-url</span> <span class="pre">URL</span></tt></dt>
427
- <dd>The URL for the Chef server, version 12. Default value: <tt class="docutils literal"><span class="pre">https://localhost</span></tt>.</dd>
428
- <dt><tt class="docutils literal"><span class="pre">-y</span></tt>, <tt class="docutils literal"><span class="pre">--yes</span></tt></dt>
429
- <dd>Use to skip confirmation prompts during the upgrade process.</dd>
430
- </dl>
431
- </div>
432
- <div class="section" id="user-create">
433
- <h2>user-create<a class="headerlink" href="#user-create" title="Permalink to this headline">¶</a></h2>
434
- <p>The <tt class="docutils literal"><span class="pre">user-create</span></tt> subcommand is used to create a user.</p>
435
- <p><strong>Syntax</strong></p>
436
- <p>This subcommand has the following syntax:</p>
437
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create USER_NAME FIRST_NAME <span class="o">[</span>MIDDLE_NAME<span class="o">]</span> LAST_NAME EMAIL PASSWORD <span class="o">(</span>options<span class="o">)</span>
438
- </pre></div>
439
- </div>
440
- <p><strong>Options</strong></p>
441
- <p>This subcommand has the following options:</p>
442
- <dl class="docutils">
443
- <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--filename</span> <span class="pre">FILE_NAME</span></tt></dt>
444
- <dd>Use to write the private key to a file instead of <tt class="docutils literal"><span class="pre">STDOUT</span></tt>.</dd>
445
- </dl>
446
- <p><strong>Examples</strong></p>
447
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create john_smith John Smith john_smith@example.com insecure-passord
448
- </pre></div>
449
- </div>
450
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create jane_doe Jane Doe jane_doe@example.com PaSSword -f /tmp/jane_doe.key
451
- </pre></div>
452
- </div>
453
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create waldendude Henry David Thoreau waldendude@example.com excursions
454
- </pre></div>
455
- </div>
456
- </div>
457
- <div class="section" id="user-delete">
458
- <h2>user-delete<a class="headerlink" href="#user-delete" title="Permalink to this headline">¶</a></h2>
459
- <p>The <tt class="docutils literal"><span class="pre">user-delete</span></tt> subcommand is used to delete a user.</p>
460
- <p><strong>Syntax</strong></p>
461
- <p>This subcommand has the following syntax:</p>
462
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete USER_NAME
463
- </pre></div>
464
- </div>
465
- <p><strong>Examples</strong></p>
466
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete john_smith
467
- </pre></div>
468
- </div>
469
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete jane_doe
470
- </pre></div>
471
- </div>
472
- </div>
473
- <div class="section" id="user-edit">
474
- <h2>user-edit<a class="headerlink" href="#user-edit" title="Permalink to this headline">¶</a></h2>
475
- <p>The <tt class="docutils literal"><span class="pre">user-edit</span></tt> subcommand is used to edit the details for a user. The data will be made available in the $EDITOR for editing.</p>
476
- <p><strong>Syntax</strong></p>
477
- <p>This subcommand has the following syntax:</p>
478
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit USER_NAME
479
- </pre></div>
480
- </div>
481
- <p><strong>Examples</strong></p>
482
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit john_smith
483
- </pre></div>
484
- </div>
485
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit jane_doe
486
- </pre></div>
487
- </div>
488
- </div>
489
- <div class="section" id="user-list">
490
- <h2>user-list<a class="headerlink" href="#user-list" title="Permalink to this headline">¶</a></h2>
491
- <p>The <tt class="docutils literal"><span class="pre">user-list</span></tt> subcommand is used to view a list of users.</p>
492
- <p><strong>Syntax</strong></p>
493
- <p>This subcommand has the following syntax:</p>
494
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-list <span class="o">(</span>options<span class="o">)</span>
495
- </pre></div>
496
- </div>
497
- <p><strong>Options</strong></p>
498
- <p>This subcommand has the following options:</p>
499
- <dl class="docutils">
500
- <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
501
- <dd>Use to show the corresponding URIs.</dd>
502
- </dl>
503
- </div>
504
- <div class="section" id="user-show">
505
- <h2>user-show<a class="headerlink" href="#user-show" title="Permalink to this headline">¶</a></h2>
506
- <p>The <tt class="docutils literal"><span class="pre">user-show</span></tt> subcommand is used to show the details for a user.</p>
507
- <p><strong>Syntax</strong></p>
508
- <p>This subcommand has the following syntax:</p>
509
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-show USER_NAME <span class="o">(</span>options<span class="o">)</span>
510
- </pre></div>
511
- </div>
512
- <p><strong>Options</strong></p>
513
- <p>This subcommand has the following options:</p>
514
- <dl class="docutils">
515
- <dt><tt class="docutils literal"><span class="pre">-l</span></tt>, <tt class="docutils literal"><span class="pre">--with-orgs</span></tt></dt>
516
- <dd>Use to show the corresponding organizations.</dd>
517
- </dl>
518
- </div>
519
- <div class="section" id="service-subcommands">
520
- <h2>Service Subcommands<a class="headerlink" href="#service-subcommands" title="Permalink to this headline">¶</a></h2>
521
- <p>The Chef server has a built in process supervisor, which ensures that all of the required services are in the appropriate state at any given time. The supervisor starts two processes per service.</p>
522
- <div class="section" id="hup">
523
- <h3>hup<a class="headerlink" href="#hup" title="Permalink to this headline">¶</a></h3>
524
- <p>The <tt class="docutils literal"><span class="pre">hup</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGHUP</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
525
- <p>This subcommand has the following syntax:</p>
526
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl hup name_of_service
527
- </pre></div>
528
- </div>
529
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
530
- </div>
531
- <div class="section" id="int">
532
- <h3>int<a class="headerlink" href="#int" title="Permalink to this headline">¶</a></h3>
533
- <p>The <tt class="docutils literal"><span class="pre">int</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGINT</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
534
- <p>This subcommand has the following syntax:</p>
535
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl int name_of_service
536
- </pre></div>
537
- </div>
538
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
539
- </div>
540
- <div class="section" id="kill">
541
- <h3>kill<a class="headerlink" href="#kill" title="Permalink to this headline">¶</a></h3>
542
- <p>The <tt class="docutils literal"><span class="pre">kill</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGKILL</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
543
- <p>This subcommand has the following syntax:</p>
544
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl <span class="nb">kill </span>name_of_service
545
- </pre></div>
546
- </div>
547
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
548
- </div>
549
- <div class="section" id="once">
550
- <h3>once<a class="headerlink" href="#once" title="Permalink to this headline">¶</a></h3>
551
- <p>The supervisor for the Chef server is configured to restart any service that fails, unless that service has been asked to change its state. The <tt class="docutils literal"><span class="pre">once</span></tt> subcommand is used to tell the supervisor to not attempt to restart any service that fails.</p>
552
- <p>This command is useful when troubleshooting configuration errors that prevent a service from starting. Run the <tt class="docutils literal"><span class="pre">once</span></tt> subcommand followed by the <tt class="docutils literal"><span class="pre">status</span></tt> subcommand to look for services in a down state and/or to identify which services are in trouble. This command can also be run for an individual service by specifying the name of the service in the command.</p>
553
- <p>This subcommand has the following syntax:</p>
554
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl once name_of_service
555
- </pre></div>
556
- </div>
557
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
558
- </div>
559
- <div class="section" id="restart">
560
- <h3>restart<a class="headerlink" href="#restart" title="Permalink to this headline">¶</a></h3>
561
- <p>The <tt class="docutils literal"><span class="pre">restart</span></tt> subcommand is used to restart all services enabled on the Chef server or to restart an individual service by specifying the name of that service in the command.</p>
562
- <div class="admonition warning">
563
- <p class="first admonition-title">Warning</p>
564
- <p class="last">When running the Chef server in a high availability configuration, restarting all services may trigger failover.</p>
565
- </div>
566
- <p>This subcommand has the following syntax:</p>
567
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl restart name_of_service
568
- </pre></div>
569
- </div>
570
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully restarted the output should be similar to:</p>
571
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 1s
572
- </pre></div>
573
- </div>
574
- </div>
575
- <div class="section" id="service-list">
576
- <h3>service-list<a class="headerlink" href="#service-list" title="Permalink to this headline">¶</a></h3>
577
- <p>The <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand is used to display a list of all available services. A service that is enabled is labeled with an asterisk (*).</p>
578
- <p>This subcommand has the following syntax:</p>
579
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl service-list
580
- </pre></div>
581
- </div>
582
- </div>
583
- <div class="section" id="start">
584
- <h3>start<a class="headerlink" href="#start" title="Permalink to this headline">¶</a></h3>
585
- <p>The <tt class="docutils literal"><span class="pre">start</span></tt> subcommand is used to start all services that are enabled in the Chef server. This command can also be run for an individual service by specifying the name of the service in the command.</p>
586
- <p>This subcommand has the following syntax:</p>
587
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl start name_of_service
588
- </pre></div>
589
- </div>
590
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully started the output should be similar to:</p>
591
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 1s
592
- </pre></div>
593
- </div>
594
- <p>The supervisor for the Chef server is configured to wait seven seconds for a service to respond to a command from the supervisor. If you see output that references a timeout, it means that a signal has been sent to the process, but that the process has yet to actually comply. In general, processes that have timed out are not a big concern, unless they are failing to respond to the signals at all. If a process is not responding, use a command like the <tt class="docutils literal"><span class="pre">kill</span></tt> subcommand to stop the process, investigate the cause (if required), and then use the <tt class="docutils literal"><span class="pre">start</span></tt> subcommand to re-enable it.</p>
595
- </div>
596
- <div class="section" id="status">
597
- <h3>status<a class="headerlink" href="#status" title="Permalink to this headline">¶</a></h3>
598
- <p>The <tt class="docutils literal"><span class="pre">status</span></tt> subcommand is used to show the status of all services available to the Chef server. The results will vary based on the configuration of a given server. This subcommand has the following syntax:</p>
599
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl status
600
- </pre></div>
601
- </div>
602
- <p>and will return the status for all services. Status can be returned for individual services by specifying the name of the service as part of the command:</p>
603
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl status name_of_service
604
- </pre></div>
605
- </div>
606
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
607
- <p>When service status is requested, the output should be similar to:</p>
608
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 12345s; run: log: <span class="o">(</span>pid 1234<span class="o">)</span> 67890s
609
- </pre></div>
610
- </div>
611
- <p>where</p>
612
- <ul class="simple">
613
- <li><tt class="docutils literal"><span class="pre">run:</span></tt> is the state of the service (<tt class="docutils literal"><span class="pre">run:</span></tt> or <tt class="docutils literal"><span class="pre">down:</span></tt>)</li>
614
- <li><tt class="docutils literal"><span class="pre">service_name:</span></tt> is the name of the service for which status is returned</li>
615
- <li><tt class="docutils literal"><span class="pre">(pid</span> <span class="pre">12345)</span></tt> is the process identifier</li>
616
- <li><tt class="docutils literal"><span class="pre">12345s</span></tt> is the uptime of the service, in seconds</li>
617
- </ul>
618
- <p>For example:</p>
619
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>down: opscode-erchef: <span class="o">(</span>pid 35546<span class="o">)</span> 10s
620
- </pre></div>
621
- </div>
622
- <p>By default, runit will restart services automatically when the services fail. Therefore, runit may report the status of a service as <tt class="docutils literal"><span class="pre">run:</span></tt> even when there is an issue with that service. When investigating why a particular service is not running as it should be, look for the services with the shortest uptimes. For example, the list below indicates that the <strong>opscode-erchef</strong> should be investigated further:</p>
623
- <div class="highlight-bash"><div class="highlight"><pre>run: oc-id
624
- run: opscode-chef: <span class="o">(</span>pid 4327<span class="o">)</span> 13671s; run: log: <span class="o">(</span>pid 4326<span class="o">)</span> 13671s
625
- run: opscode-erchef: <span class="o">(</span>pid 5383<span class="o">)</span> 5s; run: log: <span class="o">(</span>pid 4382<span class="o">)</span> 13669s
626
- run: opscode-expander: <span class="o">(</span>pid 4078<span class="o">)</span> 13694s; run: log: <span class="o">(</span>pid 4077<span class="o">)</span> 13694s
627
- run: opscode-expander-reindexer: <span class="o">(</span>pid 4130<span class="o">)</span> 13692s; run: log: <span class="o">(</span>pid 4114<span class="o">)</span> 13692s
628
- </pre></div>
629
- </div>
630
- <div class="section" id="high-availability">
631
- <h4>High Availability<a class="headerlink" href="#high-availability" title="Permalink to this headline">¶</a></h4>
632
- <p>On back-end servers in a High Availability topology, Keepalived is used by the clustering service to determine whether a service should be running. If the <tt class="docutils literal"><span class="pre">status</span></tt> subcommand is run against any of these nodes, a few things change:</p>
633
- <ul class="simple">
634
- <li>On the back-end node that is currently the backup server, it is normal to see only one running process: Keepalived</li>
635
- <li>On the back-end node that is currently the master server, it is normal to see all services running. It is also normal to see some services in a down state if the server, on reboot, did not attempt to start the services because Keepalived determines which services are restarted based on the state of the cluster</li>
636
- </ul>
637
- <p>A sample status line for a service that is running on the master server in a High Availability topology:</p>
638
- <div class="highlight-bash"><div class="highlight"><pre>run: opscode-solr: <span class="o">(</span>pid 25341<span class="o">)</span> 239s, normally down; run: log: <span class="o">(</span>pid 5700<span class="o">)</span> 145308s
639
- </pre></div>
640
- </div>
641
- </div>
642
- <div class="section" id="log-files">
643
- <h4>Log Files<a class="headerlink" href="#log-files" title="Permalink to this headline">¶</a></h4>
644
- <p>A typical status line for a service that is running any of the Chef server front-end services is similar to the following:</p>
645
- <div class="highlight-bash"><div class="highlight"><pre>run: name_of_service: <span class="o">(</span>pid 1486<span class="o">)</span> 7819s; run: log: <span class="o">(</span>pid 1485<span class="o">)</span> 7819s
646
- </pre></div>
647
- </div>
648
- <p>where:</p>
649
- <ul class="simple">
650
- <li><tt class="docutils literal"><span class="pre">run</span></tt> describes the state in which the supervisor attempts to keep processes. This state is either <tt class="docutils literal"><span class="pre">run</span></tt> or <tt class="docutils literal"><span class="pre">down</span></tt>. If a service is in a <tt class="docutils literal"><span class="pre">down</span></tt> state, it should be stopped</li>
651
- <li><tt class="docutils literal"><span class="pre">name_of_service</span></tt> is the service name, for example: <tt class="docutils literal"><span class="pre">opscode-solr4</span></tt></li>
652
- <li><tt class="docutils literal"><span class="pre">(pid</span> <span class="pre">1486)</span> <span class="pre">7819s;</span></tt> is the process identifier followed by the amount of time (in seconds) the service has been running</li>
653
- <li><tt class="docutils literal"><span class="pre">run:</span> <span class="pre">log:</span> <span class="pre">(pid</span> <span class="pre">1485)</span> <span class="pre">7819s</span></tt> is the log process. It is typical for a log process to have a longer run time than a service; this is because the supervisor does not need to restart the log process in order to connect the supervised process</li>
654
- </ul>
655
- <p>If the service is down, the status line will appear similar to the following:</p>
656
- <div class="highlight-bash"><div class="highlight"><pre>down: opscode-solr4: 3s, normally up; run: log: <span class="o">(</span>pid 1485<span class="o">)</span> 8526s
657
- </pre></div>
658
- </div>
659
- <p>where</p>
660
- <ul class="simple">
661
- <li><tt class="docutils literal"><span class="pre">down</span></tt> indicates that the service is in a down state</li>
662
- <li><tt class="docutils literal"><span class="pre">3s,</span> <span class="pre">normally</span> <span class="pre">up;</span></tt> indicates that the service is normally in a run state and that the supervisor would attempt to restart this service after a reboot</li>
663
- </ul>
664
- </div>
665
- </div>
666
- <div class="section" id="stop">
667
- <h3>stop<a class="headerlink" href="#stop" title="Permalink to this headline">¶</a></h3>
668
- <p>The <tt class="docutils literal"><span class="pre">stop</span></tt> subcommand is used to stop all services enabled on the Chef server. This command can also be run for an individual service by specifying the name of the service in the command.</p>
669
- <p>This subcommand has the following syntax:</p>
670
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl stop name_of_service
671
- </pre></div>
672
- </div>
673
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully stopped the output should be similar to:</p>
674
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: diwb: service_name: 0s, normally up
675
- </pre></div>
676
- </div>
677
- <p>For example:</p>
678
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl stop
679
- </pre></div>
680
- </div>
681
- <p>will return something similar to:</p>
682
- <div class="highlight-bash"><div class="highlight"><pre>ok: down: nginx: 393s, normally up
683
- ok: down: opscode-chef: 391s, normally up
684
- ok: down: opscode-erchef: 391s, normally up
685
- ok: down: opscode-expander: 390s, normally up
686
- ok: down: opscode-expander-reindexer: 389s, normally up
687
- ok: down: opscode-solr4: 389s, normally up
688
- ok: down: postgresql: 388s, normally up
689
- ok: down: rabbitmq: 388s, normally up
690
- ok: down: redis_lb: 387s, normally up
691
- </pre></div>
692
- </div>
693
- </div>
694
- <div class="section" id="tail">
695
- <h3>tail<a class="headerlink" href="#tail" title="Permalink to this headline">¶</a></h3>
696
- <p>The <tt class="docutils literal"><span class="pre">tail</span></tt> subcommand is used to follow all of the Chef server logs for all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
697
- <p>This subcommand has the following syntax:</p>
698
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl tail name_of_service
699
- </pre></div>
700
- </div>
701
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
702
- </div>
703
- <div class="section" id="term">
704
- <h3>term<a class="headerlink" href="#term" title="Permalink to this headline">¶</a></h3>
705
- <p>The <tt class="docutils literal"><span class="pre">term</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGTERM</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
706
- <p>This subcommand has the following syntax:</p>
707
- <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl term name_of_service
708
- </pre></div>
709
- </div>
710
- <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
711
- </div>
712
- </div>
713
- </div>
714
-
715
-
716
- </div>
717
-
718
- </div>
719
-
720
-
721
- <div class="clearer"></div>
722
- </div>
723
-
724
-
725
-
726
-
727
- </body>
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+
4
+
5
+ <html xmlns="http://www.w3.org/1999/xhtml">
6
+ <head>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
+
9
+ <title>chef-server-ctl (executable) &mdash; chef-client Man Pages</title>
10
+
11
+ <link rel="stylesheet" href="_static/guide.css" type="text/css" />
12
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
13
+
14
+ <script type="text/javascript">
15
+ var DOCUMENTATION_OPTIONS = {
16
+ URL_ROOT: './',
17
+ VERSION: '',
18
+ COLLAPSE_INDEX: false,
19
+ FILE_SUFFIX: '.html',
20
+ HAS_SOURCE: true
21
+ };
22
+ </script>
23
+ <script type="text/javascript" src="_static/jquery.js"></script>
24
+ <script type="text/javascript" src="_static/underscore.js"></script>
25
+ <script type="text/javascript" src="_static/doctools.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
31
+ <a href="http://docs.getchef.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
32
+ </div>
33
+
34
+
35
+
36
+
37
+ <div class="document">
38
+ <div class="documentwrapper">
39
+
40
+ <div class="body">
41
+
42
+ <div class="section" id="chef-server-ctl-executable">
43
+ <h1>chef-server-ctl (executable)<a class="headerlink" href="#chef-server-ctl-executable" title="Permalink to this headline">¶</a></h1>
44
+ <p>The Chef server includes a command-line utility named chef-server-ctl. This command-line tool is used to start and stop individual services, reconfigure the Chef server, run chef-pedant, and then tail Chef server log files.</p>
45
+ <div class="section" id="backup-recover">
46
+ <h2>backup-recover<a class="headerlink" href="#backup-recover" title="Permalink to this headline">¶</a></h2>
47
+ <p>The <tt class="docutils literal"><span class="pre">backup-recover</span></tt> subcommand is used to force the Chef server to attempt to become the backup server. This is the opposite of the <tt class="docutils literal"><span class="pre">master-recover</span></tt> subcommand.</p>
48
+ <div class="admonition warning">
49
+ <p class="first admonition-title">Warning</p>
50
+ <p class="last">If this command is run on both back-end servers, it will put the back-end cluster into a state where no server holds the DRBD resource.</p>
51
+ </div>
52
+ <p>This subcommand has the following syntax:</p>
53
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl backup-recover
54
+ </pre></div>
55
+ </div>
56
+ </div>
57
+ <div class="section" id="cleanse">
58
+ <h2>cleanse<a class="headerlink" href="#cleanse" title="Permalink to this headline">¶</a></h2>
59
+ <p>The <tt class="docutils literal"><span class="pre">cleanse</span></tt> subcommand is used to re-set the Chef server to the state it was in before the first time the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand is run to destroy all data, configuration files, and logs.</p>
60
+ <p>This subcommand has the following syntax:</p>
61
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl cleanse
62
+ </pre></div>
63
+ </div>
64
+ </div>
65
+ <div class="section" id="gather-logs">
66
+ <h2>gather-logs<a class="headerlink" href="#gather-logs" title="Permalink to this headline">¶</a></h2>
67
+ <p>The <tt class="docutils literal"><span class="pre">gather-logs</span></tt> subcommand is used to gather the Chef server log files into a tarball that contains all of the important log files and system information.</p>
68
+ <p>This subcommand has the following syntax:</p>
69
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl gather-logs
70
+ </pre></div>
71
+ </div>
72
+ </div>
73
+ <div class="section" id="ha-status">
74
+ <h2>ha-status<a class="headerlink" href="#ha-status" title="Permalink to this headline">¶</a></h2>
75
+ <p>The <tt class="docutils literal"><span class="pre">ha-status</span></tt> subcommand is used to check the status for services running in a High Availability topology. This command will verify the following:</p>
76
+ <blockquote>
77
+ <div><ul class="simple">
78
+ <li>The Keepalived daemon is enabled in the config</li>
79
+ <li>The DRBD process is enabled in the config</li>
80
+ <li>The underlying block device or logical volume for DRBD has been created and configured</li>
81
+ <li>The DRBD device exists</li>
82
+ <li>The current state of the server is <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt>; any migration processes have completed</li>
83
+ <li>The failover virtual IP address is correctly attached to only the <tt class="docutils literal"><span class="pre">master</span></tt> node</li>
84
+ <li>The DRBD state is correct based on the state of the server being <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt></li>
85
+ <li>The DRBD mount point is correctly mounted to only the <tt class="docutils literal"><span class="pre">master</span></tt> node</li>
86
+ <li>The DRBD replication IP addresses are pingable</li>
87
+ <li>The <tt class="docutils literal"><span class="pre">runit</span></tt> status of the services are correct (up or down) based on the <tt class="docutils literal"><span class="pre">master</span></tt> or <tt class="docutils literal"><span class="pre">backup</span></tt> state of the server</li>
88
+ </ul>
89
+ </div></blockquote>
90
+ <p>This subcommand has the following syntax:</p>
91
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl ha-status
92
+ </pre></div>
93
+ </div>
94
+ <p>If this command runs successfully, it will return the following:</p>
95
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="o">[</span>OK<span class="o">]</span> all checks passed.
96
+ </pre></div>
97
+ </div>
98
+ <p>Otherwise it will print out a list of errors, similar to the following:</p>
99
+ <div class="highlight-bash"><div class="highlight"><pre>...
100
+ <span class="o">[</span>OK<span class="o">]</span> nginx is running correctly, and I am master.
101
+ <span class="o">[</span>ERROR<span class="o">]</span> redis_lb is not running.
102
+ <span class="o">[</span>OK<span class="o">]</span> opscode-erchef is running correctly, and I am master.
103
+ ...
104
+ <span class="o">[</span>ERROR<span class="o">]</span> ERRORS WERE DETECTED.
105
+ </pre></div>
106
+ </div>
107
+ <p>For example:</p>
108
+ <div class="highlight-bash"><div class="highlight"><pre><span class="o">[</span>OK<span class="o">]</span> keepalived HA services enabled
109
+ <span class="o">[</span>OK<span class="o">]</span> DRBD disk replication enabled
110
+ <span class="o">[</span>OK<span class="o">]</span> DRBD partition /dev/opscode/drbd found
111
+ <span class="o">[</span>OK<span class="o">]</span> DRBD device /dev/drbd0 found
112
+ <span class="o">[</span>OK<span class="o">]</span> cluster <span class="nv">status</span> <span class="o">=</span> master
113
+ <span class="o">[</span>OK<span class="o">]</span> found VIP IP address and I am master
114
+ <span class="o">[</span>OK<span class="o">]</span> found VRRP communications interface eth1
115
+ <span class="o">[</span>OK<span class="o">]</span> my DRBD status is Connected/Primary/UpToDate and I am master
116
+ <span class="o">[</span>OK<span class="o">]</span> my DRBD partition is mounted and I am master
117
+ <span class="o">[</span>OK<span class="o">]</span> DRBD primary IP address pings
118
+ <span class="o">[</span>OK<span class="o">]</span> DRBD secondary IP address pings
119
+ ...
120
+ <span class="o">[</span>OK<span class="o">]</span> all checks passed.
121
+ </pre></div>
122
+ </div>
123
+ </div>
124
+ <div class="section" id="help">
125
+ <h2>help<a class="headerlink" href="#help" title="Permalink to this headline">¶</a></h2>
126
+ <p>The <tt class="docutils literal"><span class="pre">help</span></tt> subcommand is used to print a list of all available chef-server-ctl commands.</p>
127
+ <p>This subcommand has the following syntax:</p>
128
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl <span class="nb">help</span>
129
+ </pre></div>
130
+ </div>
131
+ </div>
132
+ <div class="section" id="install">
133
+ <h2>install<a class="headerlink" href="#install" title="Permalink to this headline">¶</a></h2>
134
+ <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand is used to install premium features of the Chef server: Chef management console, Chef analytics, chef-client run reporting, high availability configurations, Chef push jobs, and Chef server replication.</p>
135
+ <p><strong>Syntax</strong></p>
136
+ <p>This subcommand has the following syntax:</p>
137
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install name_of_premium_feature <span class="o">(</span>options<span class="o">)</span>
138
+ </pre></div>
139
+ </div>
140
+ <p>where <tt class="docutils literal"><span class="pre">name_of_premium_feature</span></tt> represents the command line value associated with the premium feature:</p>
141
+ <p><strong>Options</strong></p>
142
+ <p>This subcommand has the following options:</p>
143
+ <dl class="docutils">
144
+ <dt><tt class="docutils literal"><span class="pre">--path</span> <span class="pre">PATH</span></tt></dt>
145
+ <dd>Use to specify the location of a package. This option is not required when packages are downloaded from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>.</dd>
146
+ </dl>
147
+ <div class="section" id="use-downloads">
148
+ <h3>Use Downloads<a class="headerlink" href="#use-downloads" title="Permalink to this headline">¶</a></h3>
149
+ <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand downloads packages from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a> by default. For systems that are not behind a firewall (and have connectivity to <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>), these packages can be installed as described below.</p>
150
+ <table border="1" class="docutils">
151
+ <colgroup>
152
+ <col width="20%" />
153
+ <col width="80%" />
154
+ </colgroup>
155
+ <thead valign="bottom">
156
+ <tr class="row-odd"><th class="head">Feature</th>
157
+ <th class="head">Command</th>
158
+ </tr>
159
+ </thead>
160
+ <tbody valign="top">
161
+ <tr class="row-even"><td>Chef Manage</td>
162
+ <td><p class="first">Use Chef management console to manage data bags, attributes, run-lists, roles, environments, and cookbooks from a web user interface.</p>
163
+ <p>(Front end machines only.) Run:</p>
164
+ <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-manage
165
+ </pre></div>
166
+ </div>
167
+ <p>then:</p>
168
+ <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-manage-ctl reconfigure
169
+ </pre></div>
170
+ </div>
171
+ <p>and then:</p>
172
+ <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
173
+ </pre></div>
174
+ </div>
175
+ </td>
176
+ </tr>
177
+ <tr class="row-odd"><td>Chef Push Jobs</td>
178
+ <td><p class="first">Use Chef push jobs to run jobs&#8212;an action or a command to be executed&#8212;against nodes independently of a chef-client run.</p>
179
+ <p>Run:</p>
180
+ <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-push-jobs-server
181
+ </pre></div>
182
+ </div>
183
+ <p>then:</p>
184
+ <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-push-jobs-server-ctl reconfigure
185
+ </pre></div>
186
+ </div>
187
+ <p>and then:</p>
188
+ <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
189
+ </pre></div>
190
+ </div>
191
+ </td>
192
+ </tr>
193
+ <tr class="row-even"><td>Chef Replication</td>
194
+ <td><p class="first">Use Chef replication to asynchronously distribute cookbook, environment, role, and data bag data from a single, primary Chef server to one (or more) replicas of that Chef server.</p>
195
+ <p>Run:</p>
196
+ <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install chef-sync
197
+ </pre></div>
198
+ </div>
199
+ <p>and then:</p>
200
+ <div class="highlight-ruby"><div class="highlight"><pre>$ chef-sync-ctl reconfigure
201
+ </pre></div>
202
+ </div>
203
+ <p>and then:</p>
204
+ <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
205
+ </pre></div>
206
+ </div>
207
+ </td>
208
+ </tr>
209
+ <tr class="row-odd"><td>Reporting</td>
210
+ <td><p class="first">Use Chef reporting to keep track of what happens during every chef-client runs across all of the infrastructure being managed by Chef. Run Chef reporting with Chef management console to view reports from a web user interface.</p>
211
+ <p>(Front end machines only.) Run:</p>
212
+ <div class="highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl install opscode-reporting
213
+ </pre></div>
214
+ </div>
215
+ <p>then:</p>
216
+ <div class="highlight-ruby"><div class="highlight"><pre>$ opscode-reporting-ctl reconfigure
217
+ </pre></div>
218
+ </div>
219
+ <p>and then:</p>
220
+ <div class="last highlight-ruby"><div class="highlight"><pre>$ chef-server-ctl reconfigure
221
+ </pre></div>
222
+ </div>
223
+ </td>
224
+ </tr>
225
+ </tbody>
226
+ </table>
227
+ </div>
228
+ <div class="section" id="use-local-packages">
229
+ <h3>Use Local Packages<a class="headerlink" href="#use-local-packages" title="Permalink to this headline">¶</a></h3>
230
+ <p>The <tt class="docutils literal"><span class="pre">install</span></tt> subcommand downloads packages from <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a> by default. For systems that are behind a firewall (and do not have connectivity to <a class="reference external" href="https://packagecloud.io/">https://packagecloud.io/</a>), these packages can be installed manually. First download the package that is appropriate for the platform and save it to a local path. Then run the <tt class="docutils literal"><span class="pre">install</span></tt> command using the <tt class="docutils literal"><span class="pre">--path</span></tt> option to specify the location for the package:</p>
231
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install NAME_OF_PACKAGE --path /path/to/package
232
+ </pre></div>
233
+ </div>
234
+ <p>For example:</p>
235
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl install opscode-manage-1.6.2-1.el6.x86_64 --path /home/vagrant
236
+ </pre></div>
237
+ </div>
238
+ </div>
239
+ </div>
240
+ <div class="section" id="master-recover">
241
+ <h2>master-recover<a class="headerlink" href="#master-recover" title="Permalink to this headline">¶</a></h2>
242
+ <p>The <tt class="docutils literal"><span class="pre">master-recover</span></tt> subcommand is used to force the Chef server to attempt to become the master server. This command is typically run in tandem with the <tt class="docutils literal"><span class="pre">backup-recover</span></tt> subcommand on the back-end peer, unless the back-end peer is no longer available.</p>
243
+ <p>This subcommand has the following syntax:</p>
244
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl master-recover
245
+ </pre></div>
246
+ </div>
247
+ </div>
248
+ <div class="section" id="org-create">
249
+ <h2>org-create<a class="headerlink" href="#org-create" title="Permalink to this headline">¶</a></h2>
250
+ <p>The <tt class="docutils literal"><span class="pre">org-create</span></tt> subcommand is used to create an organization. (The validation key for the organization is returned to <tt class="docutils literal"><span class="pre">STDOUT</span></tt> when creating an organization using this command.)</p>
251
+ <p><strong>Syntax</strong></p>
252
+ <p>This subcommand has the following syntax:</p>
253
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create ORG_NAME ORG_FULL_NAME <span class="o">(</span>options<span class="o">)</span>
254
+ </pre></div>
255
+ </div>
256
+ <p><strong>Options</strong></p>
257
+ <p>This subcommand has the following options:</p>
258
+ <dl class="docutils">
259
+ <dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">USER_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--association_user</span> <span class="pre">USER_NAME</span></tt></dt>
260
+ <dd>Use to associate a user with an organization and add them to the <tt class="docutils literal"><span class="pre">admins</span></tt> and <tt class="docutils literal"><span class="pre">billing_admins</span></tt> security groups.</dd>
261
+ <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--filename</span> <span class="pre">FILE_NAME</span></tt></dt>
262
+ <dd>Use to write the private key to a file instead of <tt class="docutils literal"><span class="pre">STDOUT</span></tt>.</dd>
263
+ </dl>
264
+ <p><strong>Examples</strong></p>
265
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create prod Production
266
+ </pre></div>
267
+ </div>
268
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create staging Staging -a chef-admin
269
+ </pre></div>
270
+ </div>
271
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-create dev Development -f /tmp/id-dev.key
272
+ </pre></div>
273
+ </div>
274
+ </div>
275
+ <div class="section" id="org-delete">
276
+ <h2>org-delete<a class="headerlink" href="#org-delete" title="Permalink to this headline">¶</a></h2>
277
+ <p>The <tt class="docutils literal"><span class="pre">org-delete</span></tt> subcommand is used to delete an organization.</p>
278
+ <p><strong>Syntax</strong></p>
279
+ <p>This subcommand has the following syntax:</p>
280
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete ORG_NAME
281
+ </pre></div>
282
+ </div>
283
+ <p><strong>Examples</strong></p>
284
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete infra-testing-20140909
285
+ </pre></div>
286
+ </div>
287
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-delete pedant-testing-org
288
+ </pre></div>
289
+ </div>
290
+ </div>
291
+ <div class="section" id="org-list">
292
+ <h2>org-list<a class="headerlink" href="#org-list" title="Permalink to this headline">¶</a></h2>
293
+ <p>The <tt class="docutils literal"><span class="pre">org-list</span></tt> subcommand is used to list all of the organizations currently present on the Chef server.</p>
294
+ <p><strong>Syntax</strong></p>
295
+ <p>This subcommand has the following syntax:</p>
296
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-list <span class="o">(</span>options<span class="o">)</span>
297
+ </pre></div>
298
+ </div>
299
+ <p><strong>Options</strong></p>
300
+ <p>This subcommand has the following options:</p>
301
+ <dl class="docutils">
302
+ <dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--all-orgs</span></tt></dt>
303
+ <dd>Use to show all organizations.</dd>
304
+ <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
305
+ <dd>Use to show the corresponding URIs.</dd>
306
+ </dl>
307
+ </div>
308
+ <div class="section" id="org-show">
309
+ <h2>org-show<a class="headerlink" href="#org-show" title="Permalink to this headline">¶</a></h2>
310
+ <p>The <tt class="docutils literal"><span class="pre">org-show</span></tt> subcommand is used to show the details for an organization.</p>
311
+ <p><strong>Syntax</strong></p>
312
+ <p>This subcommand has the following syntax:</p>
313
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-show ORG_NAME
314
+ </pre></div>
315
+ </div>
316
+ </div>
317
+ <div class="section" id="org-user-add">
318
+ <h2>org-user-add<a class="headerlink" href="#org-user-add" title="Permalink to this headline">¶</a></h2>
319
+ <p>The <tt class="docutils literal"><span class="pre">org-user-add</span></tt> subcommand is used to add a user to an organization.</p>
320
+ <p><strong>Syntax</strong></p>
321
+ <p>This subcommand has the following syntax:</p>
322
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add ORG_NAME USER_NAME <span class="o">(</span>options<span class="o">)</span>
323
+ </pre></div>
324
+ </div>
325
+ <p><strong>Options</strong></p>
326
+ <p>This subcommand has the following options:</p>
327
+ <dl class="docutils">
328
+ <dt><tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
329
+ <dd>Use to add the user to the <tt class="docutils literal"><span class="pre">admins</span></tt> group.</dd>
330
+ </dl>
331
+ <p><strong>Examples</strong></p>
332
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add prod john_smith
333
+ </pre></div>
334
+ </div>
335
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add preprod testmaster
336
+ </pre></div>
337
+ </div>
338
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-add dev grantmc --admin
339
+ </pre></div>
340
+ </div>
341
+ </div>
342
+ <div class="section" id="org-user-remove">
343
+ <h2>org-user-remove<a class="headerlink" href="#org-user-remove" title="Permalink to this headline">¶</a></h2>
344
+ <p>The <tt class="docutils literal"><span class="pre">org-user-remove</span></tt> subcommand is used to remove a user from an organization.</p>
345
+ <p><strong>Syntax</strong></p>
346
+ <p>This subcommand has the following syntax:</p>
347
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove ORG_NAME USER_NAME
348
+ </pre></div>
349
+ </div>
350
+ <p><strong>Examples</strong></p>
351
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove prod john_smith
352
+ </pre></div>
353
+ </div>
354
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl org-user-remove prod testmaster
355
+ </pre></div>
356
+ </div>
357
+ </div>
358
+ <div class="section" id="password">
359
+ <h2>password<a class="headerlink" href="#password" title="Permalink to this headline">¶</a></h2>
360
+ <div class="admonition warning">
361
+ <p class="first admonition-title">Warning</p>
362
+ <p class="last">This subcommand is currently disabled.</p>
363
+ </div>
364
+ </div>
365
+ <div class="section" id="reconfigure">
366
+ <h2>reconfigure<a class="headerlink" href="#reconfigure" title="Permalink to this headline">¶</a></h2>
367
+ <p>The <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand is used when changes are made to the private-chef.rb file to reconfigure the server. When changes are made to the private-chef.rb file, they will not be applied to the Chef server configuration until after this command is run. This subcommand will also restart any services for which the <tt class="docutils literal"><span class="pre">service_name['enabled']</span></tt> setting is set to <tt class="docutils literal"><span class="pre">true</span></tt>.</p>
368
+ <p>This subcommand has the following syntax:</p>
369
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl reconfigure
370
+ </pre></div>
371
+ </div>
372
+ </div>
373
+ <div class="section" id="show-config">
374
+ <h2>show-config<a class="headerlink" href="#show-config" title="Permalink to this headline">¶</a></h2>
375
+ <p>The <tt class="docutils literal"><span class="pre">show-config</span></tt> subcommand is used to view the configuration that will be generated by the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand. This command is most useful in the early stages of a deployment to ensure that everything is built properly prior to installation.</p>
376
+ <p>This subcommand has the following syntax:</p>
377
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl show-config
378
+ </pre></div>
379
+ </div>
380
+ </div>
381
+ <div class="section" id="uninstall">
382
+ <h2>uninstall<a class="headerlink" href="#uninstall" title="Permalink to this headline">¶</a></h2>
383
+ <p>The <tt class="docutils literal"><span class="pre">uninstall</span></tt> subcommand is used to remove the Chef server application, but without removing any of the data. This subcommand will shut down all services (including the <tt class="docutils literal"><span class="pre">runit</span></tt> process supervisor).</p>
384
+ <p>This subcommand has the following syntax:</p>
385
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl uninstall
386
+ </pre></div>
387
+ </div>
388
+ <div class="admonition note">
389
+ <p class="first admonition-title">Note</p>
390
+ <p class="last">To revert the <tt class="docutils literal"><span class="pre">uninstall</span></tt> subcommand, run the <tt class="docutils literal"><span class="pre">reconfigure</span></tt> subcommand (because the <tt class="docutils literal"><span class="pre">start</span></tt> subcommand is disabled by the <tt class="docutils literal"><span class="pre">uninstall</span></tt> command).</p>
391
+ </div>
392
+ </div>
393
+ <div class="section" id="upgrade">
394
+ <h2>upgrade<a class="headerlink" href="#upgrade" title="Permalink to this headline">¶</a></h2>
395
+ <p>The <tt class="docutils literal"><span class="pre">upgrade</span></tt> subcommand is used to upgrade the Chef server.</p>
396
+ <p><strong>Syntax</strong></p>
397
+ <p>This subcommand has the following syntax:</p>
398
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl upgrade <span class="o">(</span>options<span class="o">)</span>
399
+ </pre></div>
400
+ </div>
401
+ <p><strong>Options</strong></p>
402
+ <div class="admonition note">
403
+ <p class="first admonition-title">Note</p>
404
+ <p class="last">Options for the <tt class="docutils literal"><span class="pre">upgrade</span></tt> subcommand may only be used when upgrading from Open Source Chef 11 to Chef server 12.</p>
405
+ </div>
406
+ <p>This subcommand has the following options:</p>
407
+ <dl class="docutils">
408
+ <dt><tt class="docutils literal"><span class="pre">-d</span> <span class="pre">DIRECTORY</span></tt>, <tt class="docutils literal"><span class="pre">--chef11-data-dir</span> <span class="pre">DIRECTORY</span></tt></dt>
409
+ <dd>The directory in which Open Source Chef 11 data is located. Default value: a temporary directory.</dd>
410
+ <dt><tt class="docutils literal"><span class="pre">-e</span> <span class="pre">DIRECTORY</span></tt>, <tt class="docutils literal"><span class="pre">--chef12-data-dir</span> <span class="pre">DIRECTORY</span></tt></dt>
411
+ <dd>The directory in which Chef server 12 data is located. Default value: a temporary directory.</dd>
412
+ <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FULL_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--full-org-name</span> <span class="pre">FULL_NAME</span></tt></dt>
413
+ <dd>The full name of the Chef server organization. A full organization name must begin with a non-white space character and must be between 1 and 1023 characters. For example: <tt class="docutils literal"><span class="pre">Chef</span> <span class="pre">Software,</span> <span class="pre">Inc.</span></tt>. If this option is not specified, the <tt class="docutils literal"><span class="pre">upgrade</span></tt> command will prompt for it.</dd>
414
+ <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt>
415
+ <dd>Use to show help for the <tt class="docutils literal"><span class="pre">chef-server-ctl</span> <span class="pre">upgrade</span></tt> subcommand.</dd>
416
+ <dt><tt class="docutils literal"><span class="pre">-k</span> <span class="pre">KEY</span></tt>, <tt class="docutils literal"><span class="pre">--key</span> <span class="pre">KEY</span></tt></dt>
417
+ <dd>All users are assigned a public key. Use to write the public key to a file. Default value: <tt class="docutils literal"><span class="pre">/etc/chef-server/admin.pem</span></tt>.</dd>
418
+ <dt><tt class="docutils literal"><span class="pre">-o</span> <span class="pre">ORG_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--org-name</span> <span class="pre">ORG_NAME</span></tt></dt>
419
+ <dd>The name of the Chef server organization. An organization name must begin with a lower-case letter or digit, may only contain lower-case letters, digits, hyphens, and underscores, and must be between 1 and 255 characters. For example: <tt class="docutils literal"><span class="pre">chef</span></tt>. If this option is not specified, the <tt class="docutils literal"><span class="pre">upgrade</span></tt> command will prompt for it.</dd>
420
+ <dt><tt class="docutils literal"><span class="pre">-s</span> <span class="pre">URL</span></tt>, <tt class="docutils literal"><span class="pre">--chef11-server-url</span> <span class="pre">URL</span></tt></dt>
421
+ <dd>The URL for the Open Source Chef or Enterprise Chef server, version 11. Default value: <tt class="docutils literal"><span class="pre">https://localhost</span></tt>.</dd>
422
+ <dt><tt class="docutils literal"><span class="pre">-t</span> <span class="pre">NUMBER</span></tt>, <tt class="docutils literal"><span class="pre">--upload-threads</span> <span class="pre">NUMBER</span></tt></dt>
423
+ <dd>The number of threads to use when migrating cookbooks. Default value: <tt class="docutils literal"><span class="pre">10</span></tt>.</dd>
424
+ <dt><tt class="docutils literal"><span class="pre">-u</span> <span class="pre">USER</span></tt>, <tt class="docutils literal"><span class="pre">--user</span></tt></dt>
425
+ <dd>Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator.</dd>
426
+ <dt><tt class="docutils literal"><span class="pre">-x</span> <span class="pre">URL</span></tt>, <tt class="docutils literal"><span class="pre">--chef12-server-url</span> <span class="pre">URL</span></tt></dt>
427
+ <dd>The URL for the Chef server, version 12. Default value: <tt class="docutils literal"><span class="pre">https://localhost</span></tt>.</dd>
428
+ <dt><tt class="docutils literal"><span class="pre">-y</span></tt>, <tt class="docutils literal"><span class="pre">--yes</span></tt></dt>
429
+ <dd>Use to skip confirmation prompts during the upgrade process.</dd>
430
+ </dl>
431
+ </div>
432
+ <div class="section" id="user-create">
433
+ <h2>user-create<a class="headerlink" href="#user-create" title="Permalink to this headline">¶</a></h2>
434
+ <p>The <tt class="docutils literal"><span class="pre">user-create</span></tt> subcommand is used to create a user.</p>
435
+ <p><strong>Syntax</strong></p>
436
+ <p>This subcommand has the following syntax:</p>
437
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create USER_NAME FIRST_NAME <span class="o">[</span>MIDDLE_NAME<span class="o">]</span> LAST_NAME EMAIL PASSWORD <span class="o">(</span>options<span class="o">)</span>
438
+ </pre></div>
439
+ </div>
440
+ <p><strong>Options</strong></p>
441
+ <p>This subcommand has the following options:</p>
442
+ <dl class="docutils">
443
+ <dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--filename</span> <span class="pre">FILE_NAME</span></tt></dt>
444
+ <dd>Use to write the private key to a file instead of <tt class="docutils literal"><span class="pre">STDOUT</span></tt>.</dd>
445
+ </dl>
446
+ <p><strong>Examples</strong></p>
447
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create john_smith John Smith john_smith@example.com insecure-passord
448
+ </pre></div>
449
+ </div>
450
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create jane_doe Jane Doe jane_doe@example.com PaSSword -f /tmp/jane_doe.key
451
+ </pre></div>
452
+ </div>
453
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-create waldendude Henry David Thoreau waldendude@example.com excursions
454
+ </pre></div>
455
+ </div>
456
+ </div>
457
+ <div class="section" id="user-delete">
458
+ <h2>user-delete<a class="headerlink" href="#user-delete" title="Permalink to this headline">¶</a></h2>
459
+ <p>The <tt class="docutils literal"><span class="pre">user-delete</span></tt> subcommand is used to delete a user.</p>
460
+ <p><strong>Syntax</strong></p>
461
+ <p>This subcommand has the following syntax:</p>
462
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete USER_NAME
463
+ </pre></div>
464
+ </div>
465
+ <p><strong>Examples</strong></p>
466
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete john_smith
467
+ </pre></div>
468
+ </div>
469
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-delete jane_doe
470
+ </pre></div>
471
+ </div>
472
+ </div>
473
+ <div class="section" id="user-edit">
474
+ <h2>user-edit<a class="headerlink" href="#user-edit" title="Permalink to this headline">¶</a></h2>
475
+ <p>The <tt class="docutils literal"><span class="pre">user-edit</span></tt> subcommand is used to edit the details for a user. The data will be made available in the $EDITOR for editing.</p>
476
+ <p><strong>Syntax</strong></p>
477
+ <p>This subcommand has the following syntax:</p>
478
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit USER_NAME
479
+ </pre></div>
480
+ </div>
481
+ <p><strong>Examples</strong></p>
482
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit john_smith
483
+ </pre></div>
484
+ </div>
485
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-edit jane_doe
486
+ </pre></div>
487
+ </div>
488
+ </div>
489
+ <div class="section" id="user-list">
490
+ <h2>user-list<a class="headerlink" href="#user-list" title="Permalink to this headline">¶</a></h2>
491
+ <p>The <tt class="docutils literal"><span class="pre">user-list</span></tt> subcommand is used to view a list of users.</p>
492
+ <p><strong>Syntax</strong></p>
493
+ <p>This subcommand has the following syntax:</p>
494
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-list <span class="o">(</span>options<span class="o">)</span>
495
+ </pre></div>
496
+ </div>
497
+ <p><strong>Options</strong></p>
498
+ <p>This subcommand has the following options:</p>
499
+ <dl class="docutils">
500
+ <dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
501
+ <dd>Use to show the corresponding URIs.</dd>
502
+ </dl>
503
+ </div>
504
+ <div class="section" id="user-show">
505
+ <h2>user-show<a class="headerlink" href="#user-show" title="Permalink to this headline">¶</a></h2>
506
+ <p>The <tt class="docutils literal"><span class="pre">user-show</span></tt> subcommand is used to show the details for a user.</p>
507
+ <p><strong>Syntax</strong></p>
508
+ <p>This subcommand has the following syntax:</p>
509
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl user-show USER_NAME <span class="o">(</span>options<span class="o">)</span>
510
+ </pre></div>
511
+ </div>
512
+ <p><strong>Options</strong></p>
513
+ <p>This subcommand has the following options:</p>
514
+ <dl class="docutils">
515
+ <dt><tt class="docutils literal"><span class="pre">-l</span></tt>, <tt class="docutils literal"><span class="pre">--with-orgs</span></tt></dt>
516
+ <dd>Use to show the corresponding organizations.</dd>
517
+ </dl>
518
+ </div>
519
+ <div class="section" id="service-subcommands">
520
+ <h2>Service Subcommands<a class="headerlink" href="#service-subcommands" title="Permalink to this headline">¶</a></h2>
521
+ <p>The Chef server has a built in process supervisor, which ensures that all of the required services are in the appropriate state at any given time. The supervisor starts two processes per service.</p>
522
+ <div class="section" id="hup">
523
+ <h3>hup<a class="headerlink" href="#hup" title="Permalink to this headline">¶</a></h3>
524
+ <p>The <tt class="docutils literal"><span class="pre">hup</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGHUP</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
525
+ <p>This subcommand has the following syntax:</p>
526
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl hup name_of_service
527
+ </pre></div>
528
+ </div>
529
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
530
+ </div>
531
+ <div class="section" id="int">
532
+ <h3>int<a class="headerlink" href="#int" title="Permalink to this headline">¶</a></h3>
533
+ <p>The <tt class="docutils literal"><span class="pre">int</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGINT</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
534
+ <p>This subcommand has the following syntax:</p>
535
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl int name_of_service
536
+ </pre></div>
537
+ </div>
538
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
539
+ </div>
540
+ <div class="section" id="kill">
541
+ <h3>kill<a class="headerlink" href="#kill" title="Permalink to this headline">¶</a></h3>
542
+ <p>The <tt class="docutils literal"><span class="pre">kill</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGKILL</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
543
+ <p>This subcommand has the following syntax:</p>
544
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl <span class="nb">kill </span>name_of_service
545
+ </pre></div>
546
+ </div>
547
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
548
+ </div>
549
+ <div class="section" id="once">
550
+ <h3>once<a class="headerlink" href="#once" title="Permalink to this headline">¶</a></h3>
551
+ <p>The supervisor for the Chef server is configured to restart any service that fails, unless that service has been asked to change its state. The <tt class="docutils literal"><span class="pre">once</span></tt> subcommand is used to tell the supervisor to not attempt to restart any service that fails.</p>
552
+ <p>This command is useful when troubleshooting configuration errors that prevent a service from starting. Run the <tt class="docutils literal"><span class="pre">once</span></tt> subcommand followed by the <tt class="docutils literal"><span class="pre">status</span></tt> subcommand to look for services in a down state and/or to identify which services are in trouble. This command can also be run for an individual service by specifying the name of the service in the command.</p>
553
+ <p>This subcommand has the following syntax:</p>
554
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl once name_of_service
555
+ </pre></div>
556
+ </div>
557
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
558
+ </div>
559
+ <div class="section" id="restart">
560
+ <h3>restart<a class="headerlink" href="#restart" title="Permalink to this headline">¶</a></h3>
561
+ <p>The <tt class="docutils literal"><span class="pre">restart</span></tt> subcommand is used to restart all services enabled on the Chef server or to restart an individual service by specifying the name of that service in the command.</p>
562
+ <div class="admonition warning">
563
+ <p class="first admonition-title">Warning</p>
564
+ <p class="last">When running the Chef server in a high availability configuration, restarting all services may trigger failover.</p>
565
+ </div>
566
+ <p>This subcommand has the following syntax:</p>
567
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl restart name_of_service
568
+ </pre></div>
569
+ </div>
570
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully restarted the output should be similar to:</p>
571
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 1s
572
+ </pre></div>
573
+ </div>
574
+ </div>
575
+ <div class="section" id="service-list">
576
+ <h3>service-list<a class="headerlink" href="#service-list" title="Permalink to this headline">¶</a></h3>
577
+ <p>The <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand is used to display a list of all available services. A service that is enabled is labeled with an asterisk (*).</p>
578
+ <p>This subcommand has the following syntax:</p>
579
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl service-list
580
+ </pre></div>
581
+ </div>
582
+ </div>
583
+ <div class="section" id="start">
584
+ <h3>start<a class="headerlink" href="#start" title="Permalink to this headline">¶</a></h3>
585
+ <p>The <tt class="docutils literal"><span class="pre">start</span></tt> subcommand is used to start all services that are enabled in the Chef server. This command can also be run for an individual service by specifying the name of the service in the command.</p>
586
+ <p>This subcommand has the following syntax:</p>
587
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl start name_of_service
588
+ </pre></div>
589
+ </div>
590
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully started the output should be similar to:</p>
591
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 1s
592
+ </pre></div>
593
+ </div>
594
+ <p>The supervisor for the Chef server is configured to wait seven seconds for a service to respond to a command from the supervisor. If you see output that references a timeout, it means that a signal has been sent to the process, but that the process has yet to actually comply. In general, processes that have timed out are not a big concern, unless they are failing to respond to the signals at all. If a process is not responding, use a command like the <tt class="docutils literal"><span class="pre">kill</span></tt> subcommand to stop the process, investigate the cause (if required), and then use the <tt class="docutils literal"><span class="pre">start</span></tt> subcommand to re-enable it.</p>
595
+ </div>
596
+ <div class="section" id="status">
597
+ <h3>status<a class="headerlink" href="#status" title="Permalink to this headline">¶</a></h3>
598
+ <p>The <tt class="docutils literal"><span class="pre">status</span></tt> subcommand is used to show the status of all services available to the Chef server. The results will vary based on the configuration of a given server. This subcommand has the following syntax:</p>
599
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl status
600
+ </pre></div>
601
+ </div>
602
+ <p>and will return the status for all services. Status can be returned for individual services by specifying the name of the service as part of the command:</p>
603
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl status name_of_service
604
+ </pre></div>
605
+ </div>
606
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
607
+ <p>When service status is requested, the output should be similar to:</p>
608
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>run: service_name: <span class="o">(</span>pid 12345<span class="o">)</span> 12345s; run: log: <span class="o">(</span>pid 1234<span class="o">)</span> 67890s
609
+ </pre></div>
610
+ </div>
611
+ <p>where</p>
612
+ <ul class="simple">
613
+ <li><tt class="docutils literal"><span class="pre">run:</span></tt> is the state of the service (<tt class="docutils literal"><span class="pre">run:</span></tt> or <tt class="docutils literal"><span class="pre">down:</span></tt>)</li>
614
+ <li><tt class="docutils literal"><span class="pre">service_name:</span></tt> is the name of the service for which status is returned</li>
615
+ <li><tt class="docutils literal"><span class="pre">(pid</span> <span class="pre">12345)</span></tt> is the process identifier</li>
616
+ <li><tt class="docutils literal"><span class="pre">12345s</span></tt> is the uptime of the service, in seconds</li>
617
+ </ul>
618
+ <p>For example:</p>
619
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>down: opscode-erchef: <span class="o">(</span>pid 35546<span class="o">)</span> 10s
620
+ </pre></div>
621
+ </div>
622
+ <p>By default, runit will restart services automatically when the services fail. Therefore, runit may report the status of a service as <tt class="docutils literal"><span class="pre">run:</span></tt> even when there is an issue with that service. When investigating why a particular service is not running as it should be, look for the services with the shortest uptimes. For example, the list below indicates that the <strong>opscode-erchef</strong> should be investigated further:</p>
623
+ <div class="highlight-bash"><div class="highlight"><pre>run: oc-id
624
+ run: opscode-chef: <span class="o">(</span>pid 4327<span class="o">)</span> 13671s; run: log: <span class="o">(</span>pid 4326<span class="o">)</span> 13671s
625
+ run: opscode-erchef: <span class="o">(</span>pid 5383<span class="o">)</span> 5s; run: log: <span class="o">(</span>pid 4382<span class="o">)</span> 13669s
626
+ run: opscode-expander: <span class="o">(</span>pid 4078<span class="o">)</span> 13694s; run: log: <span class="o">(</span>pid 4077<span class="o">)</span> 13694s
627
+ run: opscode-expander-reindexer: <span class="o">(</span>pid 4130<span class="o">)</span> 13692s; run: log: <span class="o">(</span>pid 4114<span class="o">)</span> 13692s
628
+ </pre></div>
629
+ </div>
630
+ <div class="section" id="high-availability">
631
+ <h4>High Availability<a class="headerlink" href="#high-availability" title="Permalink to this headline">¶</a></h4>
632
+ <p>On back-end servers in a High Availability topology, Keepalived is used by the clustering service to determine whether a service should be running. If the <tt class="docutils literal"><span class="pre">status</span></tt> subcommand is run against any of these nodes, a few things change:</p>
633
+ <ul class="simple">
634
+ <li>On the back-end node that is currently the backup server, it is normal to see only one running process: Keepalived</li>
635
+ <li>On the back-end node that is currently the master server, it is normal to see all services running. It is also normal to see some services in a down state if the server, on reboot, did not attempt to start the services because Keepalived determines which services are restarted based on the state of the cluster</li>
636
+ </ul>
637
+ <p>A sample status line for a service that is running on the master server in a High Availability topology:</p>
638
+ <div class="highlight-bash"><div class="highlight"><pre>run: opscode-solr: <span class="o">(</span>pid 25341<span class="o">)</span> 239s, normally down; run: log: <span class="o">(</span>pid 5700<span class="o">)</span> 145308s
639
+ </pre></div>
640
+ </div>
641
+ </div>
642
+ <div class="section" id="log-files">
643
+ <h4>Log Files<a class="headerlink" href="#log-files" title="Permalink to this headline">¶</a></h4>
644
+ <p>A typical status line for a service that is running any of the Chef server front-end services is similar to the following:</p>
645
+ <div class="highlight-bash"><div class="highlight"><pre>run: name_of_service: <span class="o">(</span>pid 1486<span class="o">)</span> 7819s; run: log: <span class="o">(</span>pid 1485<span class="o">)</span> 7819s
646
+ </pre></div>
647
+ </div>
648
+ <p>where:</p>
649
+ <ul class="simple">
650
+ <li><tt class="docutils literal"><span class="pre">run</span></tt> describes the state in which the supervisor attempts to keep processes. This state is either <tt class="docutils literal"><span class="pre">run</span></tt> or <tt class="docutils literal"><span class="pre">down</span></tt>. If a service is in a <tt class="docutils literal"><span class="pre">down</span></tt> state, it should be stopped</li>
651
+ <li><tt class="docutils literal"><span class="pre">name_of_service</span></tt> is the service name, for example: <tt class="docutils literal"><span class="pre">opscode-solr4</span></tt></li>
652
+ <li><tt class="docutils literal"><span class="pre">(pid</span> <span class="pre">1486)</span> <span class="pre">7819s;</span></tt> is the process identifier followed by the amount of time (in seconds) the service has been running</li>
653
+ <li><tt class="docutils literal"><span class="pre">run:</span> <span class="pre">log:</span> <span class="pre">(pid</span> <span class="pre">1485)</span> <span class="pre">7819s</span></tt> is the log process. It is typical for a log process to have a longer run time than a service; this is because the supervisor does not need to restart the log process in order to connect the supervised process</li>
654
+ </ul>
655
+ <p>If the service is down, the status line will appear similar to the following:</p>
656
+ <div class="highlight-bash"><div class="highlight"><pre>down: opscode-solr4: 3s, normally up; run: log: <span class="o">(</span>pid 1485<span class="o">)</span> 8526s
657
+ </pre></div>
658
+ </div>
659
+ <p>where</p>
660
+ <ul class="simple">
661
+ <li><tt class="docutils literal"><span class="pre">down</span></tt> indicates that the service is in a down state</li>
662
+ <li><tt class="docutils literal"><span class="pre">3s,</span> <span class="pre">normally</span> <span class="pre">up;</span></tt> indicates that the service is normally in a run state and that the supervisor would attempt to restart this service after a reboot</li>
663
+ </ul>
664
+ </div>
665
+ </div>
666
+ <div class="section" id="stop">
667
+ <h3>stop<a class="headerlink" href="#stop" title="Permalink to this headline">¶</a></h3>
668
+ <p>The <tt class="docutils literal"><span class="pre">stop</span></tt> subcommand is used to stop all services enabled on the Chef server. This command can also be run for an individual service by specifying the name of the service in the command.</p>
669
+ <p>This subcommand has the following syntax:</p>
670
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl stop name_of_service
671
+ </pre></div>
672
+ </div>
673
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand. When a service is successfully stopped the output should be similar to:</p>
674
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>ok: diwb: service_name: 0s, normally up
675
+ </pre></div>
676
+ </div>
677
+ <p>For example:</p>
678
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl stop
679
+ </pre></div>
680
+ </div>
681
+ <p>will return something similar to:</p>
682
+ <div class="highlight-bash"><div class="highlight"><pre>ok: down: nginx: 393s, normally up
683
+ ok: down: opscode-chef: 391s, normally up
684
+ ok: down: opscode-erchef: 391s, normally up
685
+ ok: down: opscode-expander: 390s, normally up
686
+ ok: down: opscode-expander-reindexer: 389s, normally up
687
+ ok: down: opscode-solr4: 389s, normally up
688
+ ok: down: postgresql: 388s, normally up
689
+ ok: down: rabbitmq: 388s, normally up
690
+ ok: down: redis_lb: 387s, normally up
691
+ </pre></div>
692
+ </div>
693
+ </div>
694
+ <div class="section" id="tail">
695
+ <h3>tail<a class="headerlink" href="#tail" title="Permalink to this headline">¶</a></h3>
696
+ <p>The <tt class="docutils literal"><span class="pre">tail</span></tt> subcommand is used to follow all of the Chef server logs for all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
697
+ <p>This subcommand has the following syntax:</p>
698
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl tail name_of_service
699
+ </pre></div>
700
+ </div>
701
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
702
+ </div>
703
+ <div class="section" id="term">
704
+ <h3>term<a class="headerlink" href="#term" title="Permalink to this headline">¶</a></h3>
705
+ <p>The <tt class="docutils literal"><span class="pre">term</span></tt> subcommand is used to send a <tt class="docutils literal"><span class="pre">SIGTERM</span></tt> to all services. This command can also be run for an individual service by specifying the name of the service in the command.</p>
706
+ <p>This subcommand has the following syntax:</p>
707
+ <div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>chef-server-ctl term name_of_service
708
+ </pre></div>
709
+ </div>
710
+ <p>where <tt class="docutils literal"><span class="pre">name_of_service</span></tt> represents the name of any service that is listed after running the <tt class="docutils literal"><span class="pre">service-list</span></tt> subcommand.</p>
711
+ </div>
712
+ </div>
713
+ </div>
714
+
715
+
716
+ </div>
717
+
718
+ </div>
719
+
720
+
721
+ <div class="clearer"></div>
722
+ </div>
723
+
724
+
725
+
726
+
727
+ </body>
728
728
  </html>