chef 12.7.2 → 12.8.1

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