chef 12.8.1 → 12.9.38

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