chef 12.7.2-universal-mingw32 → 12.8.1-universal-mingw32

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