RubyGems - chef - Versions diffs - 11.10.0.rc.0 → 11.10.0.rc.1 - Mend

chef 11.10.0.rc.0 → 11.10.0.rc.1

Files changed (401) hide show

data/Rakefile +0 -75
data/distro/common/html/_sources/ctl_chef_client.txt +36 -0
data/distro/common/html/_sources/ctl_chef_server.txt +26 -0
data/distro/common/html/_sources/ctl_chef_shell.txt +15 -0
data/distro/common/html/_sources/ctl_chef_solo.txt +25 -0
data/distro/common/html/_sources/index.txt +126 -0
data/distro/common/html/_sources/knife.txt +74 -0
data/distro/common/html/_sources/knife_bootstrap.txt +56 -0
data/distro/common/html/_sources/knife_client.txt +151 -0
data/distro/common/html/_sources/knife_common_options.txt +6 -0
data/distro/common/html/_sources/knife_configure.txt +29 -0
data/distro/common/html/_sources/knife_cookbook.txt +236 -0
data/distro/common/html/_sources/knife_cookbook_site.txt +157 -0
data/distro/common/html/_sources/knife_data_bag.txt +160 -0
data/distro/common/html/_sources/knife_delete.txt +26 -0
data/distro/common/html/_sources/knife_deps.txt +61 -0
data/distro/common/html/_sources/knife_diff.txt +34 -0
data/distro/common/html/_sources/knife_download.txt +44 -0
data/distro/common/html/_sources/knife_edit.txt +26 -0
data/distro/common/html/_sources/knife_environment.txt +158 -0
data/distro/common/html/_sources/knife_exec.txt +47 -0
data/distro/common/html/_sources/knife_index_rebuild.txt +21 -0
data/distro/common/html/_sources/knife_list.txt +33 -0
data/distro/common/html/_sources/knife_node.txt +250 -0
data/distro/common/html/_sources/knife_raw.txt +35 -0
data/distro/common/html/_sources/knife_recipe_list.txt +23 -0
data/distro/common/html/_sources/knife_role.txt +157 -0
data/distro/common/html/_sources/knife_search.txt +53 -0
data/distro/common/html/_sources/knife_show.txt +27 -0
data/distro/common/html/_sources/knife_ssh.txt +43 -0
data/distro/common/html/_sources/knife_status.txt +37 -0
data/distro/common/html/_sources/knife_tag.txt +69 -0
data/distro/common/html/_sources/knife_upload.txt +49 -0
data/distro/common/html/_sources/knife_user.txt +127 -0
data/distro/common/html/_sources/knife_using.txt +43 -0
data/distro/common/html/_sources/knife_xargs.txt +30 -0
data/distro/common/html/_static/ajax-loader.gif +0 -0
data/distro/common/html/_static/basic.css +540 -0
data/distro/common/html/_static/chef.css +507 -0
data/distro/common/html/_static/chef.ico +0 -0
data/distro/common/html/_static/chef_html_logo.png +0 -0
data/distro/common/html/_static/chef_logo.png +0 -0
data/distro/common/html/_static/comment-bright.png +0 -0
data/distro/common/html/_static/comment-close.png +0 -0
data/distro/common/html/_static/comment.png +0 -0
data/distro/common/html/_static/contents.png +0 -0
data/distro/common/html/_static/doctools.js +247 -0
data/distro/common/html/_static/down-pressed.png +0 -0
data/distro/common/html/_static/down.png +0 -0
data/distro/common/html/_static/file.png +0 -0
data/distro/common/html/_static/guide.css +505 -0
data/distro/common/html/_static/jquery.js +154 -0
data/distro/common/html/_static/minus.png +0 -0
data/distro/common/html/_static/navigation.png +0 -0
data/distro/common/html/_static/plus.png +0 -0
data/distro/common/html/_static/pygments.css +62 -0
data/distro/common/html/_static/searchtools.js +560 -0
data/distro/common/html/_static/underscore.js +23 -0
data/distro/common/html/_static/up-pressed.png +0 -0
data/distro/common/html/_static/up.png +0 -0
data/distro/common/html/_static/websupport.js +808 -0
data/distro/common/html/ctl_chef_client.html +219 -0
data/distro/common/html/ctl_chef_server.html +111 -0
data/distro/common/html/ctl_chef_shell.html +120 -0
data/distro/common/html/ctl_chef_solo.html +144 -0
data/distro/common/html/index.html +185 -0
data/distro/common/html/knife.html +172 -0
data/distro/common/html/knife_bootstrap.html +250 -0
data/distro/common/html/knife_client.html +283 -0
data/distro/common/html/knife_common_options.html +98 -0
data/distro/common/html/knife_configure.html +107 -0
data/distro/common/html/knife_cookbook.html +481 -0
data/distro/common/html/knife_cookbook_site.html +372 -0
data/distro/common/html/knife_data_bag.html +359 -0
data/distro/common/html/knife_delete.html +95 -0
data/distro/common/html/knife_deps.html +145 -0
data/distro/common/html/knife_diff.html +125 -0
data/distro/common/html/knife_download.html +147 -0
data/distro/common/html/knife_edit.html +91 -0
data/distro/common/html/knife_environment.html +328 -0
data/distro/common/html/knife_exec.html +222 -0
data/distro/common/html/knife_index_rebuild.html +85 -0
data/distro/common/html/knife_list.html +116 -0
data/distro/common/html/knife_node.html +450 -0
data/distro/common/html/knife_raw.html +112 -0
data/distro/common/html/knife_recipe_list.html +93 -0
data/distro/common/html/knife_role.html +295 -0
data/distro/common/html/knife_search.html +204 -0
data/distro/common/html/knife_show.html +106 -0
data/distro/common/html/knife_ssh.html +179 -0
data/distro/common/html/knife_status.html +142 -0
data/distro/common/html/knife_tag.html +140 -0
data/distro/common/html/knife_upload.html +155 -0
data/distro/common/html/knife_user.html +244 -0
data/distro/common/html/knife_using.html +211 -0
data/distro/common/html/knife_xargs.html +115 -0
data/distro/common/html/objects.inv +0 -0
data/distro/common/html/search.html +84 -0
data/distro/common/html/searchindex.js +1 -0
data/distro/common/man/man1/chef-shell.1 +5 -5
data/distro/common/man/man1/knife-bootstrap.1 +6 -9
data/distro/common/man/man1/knife-client.1 +1 -9
data/distro/common/man/man1/knife-configure.1 +10 -6
data/distro/common/man/man1/knife-cookbook-site.1 +1 -9
data/distro/common/man/man1/knife-cookbook.1 +11 -21
data/distro/common/man/man1/knife-data-bag.1 +8 -22
data/distro/common/man/man1/knife-delete.1 +1 -1
data/distro/common/man/man1/knife-deps.1 +4 -12
data/distro/common/man/man1/knife-diff.1 +1 -1
data/distro/common/man/man1/knife-download.1 +2 -2
data/distro/common/man/man1/knife-edit.1 +1 -1
data/distro/common/man/man1/knife-environment.1 +108 -9
data/distro/common/man/man1/knife-exec.1 +1 -15
data/distro/common/man/man1/knife-index-rebuild.1 +1 -1
data/distro/common/man/man1/knife-list.1 +1 -1
data/distro/common/man/man1/knife-node.1 +3 -13
data/distro/common/man/man1/knife-raw.1 +1 -1
data/distro/common/man/man1/knife-recipe-list.1 +1 -1
data/distro/common/man/man1/knife-role.1 +2 -12
data/distro/common/man/man1/knife-search.1 +5 -5
data/distro/common/man/man1/knife-show.1 +1 -3
data/distro/common/man/man1/knife-ssh.1 +1 -5
data/distro/common/man/man1/knife-status.1 +1 -1
data/distro/common/man/man1/knife-tag.1 +1 -9
data/distro/common/man/man1/knife-upload.1 +7 -9
data/distro/common/man/man1/knife-user.1 +3 -17
data/distro/common/man/man1/knife-xargs.1 +1 -3
data/distro/common/man/man8/chef-client.8 +18 -18
data/distro/common/man/man8/chef-solo.8 +12 -6
data/lib/chef/client.rb +9 -5
data/lib/chef/cookbook_uploader.rb +1 -1
data/lib/chef/dsl/recipe.rb +119 -38
data/lib/chef/exceptions.rb +4 -0
data/lib/chef/policy_builder/expand_node_object.rb +11 -4
data/lib/chef/policy_builder/policyfile.rb +7 -1
data/lib/chef/provider/file.rb +1 -0
data/lib/chef/resource_platform_map.rb +1 -1
data/lib/chef/resource_reporter.rb +2 -2
data/lib/chef/version.rb +1 -1
data/spec/functional/knife/cookbook_delete_spec.rb +9 -9
data/spec/functional/knife/ssh_spec.rb +1 -1
data/spec/functional/resource/link_spec.rb +6 -6
data/spec/functional/resource/registry_spec.rb +7 -7
data/spec/functional/run_lock_spec.rb +1 -1
data/spec/integration/knife/download_spec.rb +1 -1
data/spec/integration/solo/solo_spec.rb +1 -1
data/spec/spec_helper.rb +0 -1
data/spec/stress/win32/file_spec.rb +6 -0
data/spec/support/lib/chef/resource/zen_master.rb +1 -1
data/spec/support/mock/platform.rb +1 -1
data/spec/support/shared/functional/file_resource.rb +0 -2
data/spec/support/shared/functional/securable_resource.rb +2 -2
data/spec/support/shared/unit/api_error_inspector.rb +7 -7
data/spec/support/shared/unit/provider/file.rb +47 -8
data/spec/support/shared/unit/provider/useradd_based_user_provider.rb +23 -23
data/spec/unit/api_client/registration_spec.rb +5 -5
data/spec/unit/api_client_spec.rb +2 -2
data/spec/unit/application/apply.rb +6 -6
data/spec/unit/application/client_spec.rb +6 -6
data/spec/unit/application/knife_spec.rb +5 -5
data/spec/unit/application/solo_spec.rb +13 -13
data/spec/unit/application_spec.rb +19 -19
data/spec/unit/checksum/storage/filesystem_spec.rb +2 -2
data/spec/unit/client_spec.rb +23 -23
data/spec/unit/config_spec.rb +4 -4
data/spec/unit/cookbook/metadata_spec.rb +22 -22
data/spec/unit/cookbook/synchronizer_spec.rb +17 -17
data/spec/unit/daemon_spec.rb +21 -22
data/spec/unit/data_bag_item_spec.rb +8 -8
data/spec/unit/data_bag_spec.rb +6 -6
data/spec/unit/deprecation_spec.rb +1 -1
data/spec/unit/dsl/data_query_spec.rb +1 -1
data/spec/unit/environment_spec.rb +5 -5
data/spec/unit/file_access_control_spec.rb +5 -5
data/spec/unit/file_cache_spec.rb +1 -1
data/spec/unit/file_content_management/deploy/mv_unix_spec.rb +1 -1
data/spec/unit/file_content_management/deploy/mv_windows_spec.rb +12 -12
data/spec/unit/formatters/error_inspectors/compile_error_inspector_spec.rb +4 -4
data/spec/unit/formatters/error_inspectors/cookbook_resolve_error_inspector_spec.rb +4 -4
data/spec/unit/formatters/error_inspectors/cookbook_sync_error_inspector_spec.rb +1 -1
data/spec/unit/formatters/error_inspectors/resource_failure_inspector_spec.rb +6 -6
data/spec/unit/formatters/error_inspectors/run_list_expansion_error_inspector_spec.rb +4 -4
data/spec/unit/handler/json_file_spec.rb +1 -1
data/spec/unit/handler_spec.rb +3 -3
data/spec/unit/knife/bootstrap_spec.rb +17 -17
data/spec/unit/knife/client_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/client_create_spec.rb +7 -7
data/spec/unit/knife/client_reregister_spec.rb +2 -2
data/spec/unit/knife/client_show_spec.rb +1 -1
data/spec/unit/knife/config_file_selection_spec.rb +4 -4
data/spec/unit/knife/configure_client_spec.rb +4 -4
data/spec/unit/knife/configure_spec.rb +16 -16
data/spec/unit/knife/cookbook_bulk_delete_spec.rb +10 -10
data/spec/unit/knife/cookbook_create_spec.rb +5 -5
data/spec/unit/knife/cookbook_delete_spec.rb +6 -6
data/spec/unit/knife/cookbook_download_spec.rb +10 -10
data/spec/unit/knife/cookbook_list_spec.rb +3 -3
data/spec/unit/knife/cookbook_metadata_from_file_spec.rb +2 -2
data/spec/unit/knife/cookbook_metadata_spec.rb +8 -8
data/spec/unit/knife/cookbook_show_spec.rb +4 -4
data/spec/unit/knife/cookbook_site_download_spec.rb +3 -3
data/spec/unit/knife/cookbook_site_install_spec.rb +8 -8
data/spec/unit/knife/cookbook_site_share_spec.rb +22 -22
data/spec/unit/knife/cookbook_site_unshare_spec.rb +8 -8
data/spec/unit/knife/cookbook_test_spec.rb +7 -7
data/spec/unit/knife/cookbook_upload_spec.rb +20 -20
data/spec/unit/knife/core/cookbook_scm_repo_spec.rb +6 -6
data/spec/unit/knife/core/object_loader_spec.rb +1 -1
data/spec/unit/knife/core/ui_spec.rb +19 -21
data/spec/unit/knife/data_bag_create_spec.rb +4 -4
data/spec/unit/knife/data_bag_edit_spec.rb +7 -7
data/spec/unit/knife/data_bag_from_file_spec.rb +15 -15
data/spec/unit/knife/data_bag_show_spec.rb +5 -5
data/spec/unit/knife/environment_create_spec.rb +6 -6
data/spec/unit/knife/environment_delete_spec.rb +6 -6
data/spec/unit/knife/environment_edit_spec.rb +5 -5
data/spec/unit/knife/environment_from_file_spec.rb +7 -7
data/spec/unit/knife/environment_list_spec.rb +4 -4
data/spec/unit/knife/environment_show_spec.rb +4 -4
data/spec/unit/knife/index_rebuild_spec.rb +2 -2
data/spec/unit/knife/knife_help.rb +11 -11
data/spec/unit/knife/node_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/node_delete_spec.rb +5 -5
data/spec/unit/knife/node_edit_spec.rb +2 -2
data/spec/unit/knife/node_from_file_spec.rb +5 -5
data/spec/unit/knife/node_list_spec.rb +3 -3
data/spec/unit/knife/node_run_list_add_spec.rb +3 -3
data/spec/unit/knife/node_run_list_remove_spec.rb +4 -4
data/spec/unit/knife/node_run_list_set_spec.rb +5 -5
data/spec/unit/knife/node_show_spec.rb +2 -2
data/spec/unit/knife/role_bulk_delete_spec.rb +4 -4
data/spec/unit/knife/role_create_spec.rb +5 -5
data/spec/unit/knife/role_delete_spec.rb +5 -5
data/spec/unit/knife/role_edit_spec.rb +5 -5
data/spec/unit/knife/role_from_file_spec.rb +5 -5
data/spec/unit/knife/role_list_spec.rb +2 -2
data/spec/unit/knife/ssh_spec.rb +6 -6
data/spec/unit/knife/status_spec.rb +4 -4
data/spec/unit/knife/tag_create_spec.rb +3 -3
data/spec/unit/knife/tag_delete_spec.rb +3 -3
data/spec/unit/knife/tag_list_spec.rb +2 -2
data/spec/unit/knife/user_create_spec.rb +7 -7
data/spec/unit/knife/user_reregister_spec.rb +3 -3
data/spec/unit/knife/user_show_spec.rb +1 -1
data/spec/unit/knife_spec.rb +29 -29
data/spec/unit/lwrp_spec.rb +2 -2
data/spec/unit/mixin/checksum_spec.rb +2 -2
data/spec/unit/mixin/command_spec.rb +1 -1
data/spec/unit/mixin/enforce_ownership_and_permissions_spec.rb +4 -4
data/spec/unit/mixin/params_validate_spec.rb +17 -17
data/spec/unit/mixin/path_sanity_spec.rb +8 -8
data/spec/unit/mixin/securable_spec.rb +87 -87
data/spec/unit/mixin/shell_out_spec.rb +1 -1
data/spec/unit/mixin/template_spec.rb +2 -2
data/spec/unit/node/attribute_spec.rb +3 -3
data/spec/unit/node_spec.rb +12 -12
data/spec/unit/platform_spec.rb +1 -1
data/spec/unit/policy_builder/expand_node_object_spec.rb +16 -0
data/spec/unit/policy_builder/policyfile_spec.rb +4 -0
data/spec/unit/provider/breakpoint_spec.rb +8 -8
data/spec/unit/provider/cookbook_file/content_spec.rb +4 -4
data/spec/unit/provider/cookbook_file_spec.rb +1 -1
data/spec/unit/provider/cron/unix_spec.rb +11 -11
data/spec/unit/provider/cron_spec.rb +40 -40
data/spec/unit/provider/deploy/revision_spec.rb +11 -12
data/spec/unit/provider/deploy/timestamped_spec.rb +3 -3
data/spec/unit/provider/deploy_spec.rb +50 -50
data/spec/unit/provider/directory_spec.rb +18 -18
data/spec/unit/provider/env_spec.rb +15 -15
data/spec/unit/provider/erl_call_spec.rb +1 -1
data/spec/unit/provider/execute_spec.rb +5 -5
data/spec/unit/provider/file/content_spec.rb +5 -5
data/spec/unit/provider/file_spec.rb +1 -1
data/spec/unit/provider/git_spec.rb +47 -47
data/spec/unit/provider/group/dscl_spec.rb +16 -15
data/spec/unit/provider/group/gpasswd_spec.rb +6 -5
data/spec/unit/provider/group/groupadd_spec.rb +10 -10
data/spec/unit/provider/group/groupmod_spec.rb +3 -3
data/spec/unit/provider/group/pw_spec.rb +9 -8
data/spec/unit/provider/group/usermod_spec.rb +13 -12
data/spec/unit/provider/group/windows_spec.rb +9 -9
data/spec/unit/provider/group_spec.rb +31 -31
data/spec/unit/provider/http_request_spec.rb +3 -3
data/spec/unit/provider/ifconfig/aix_spec.rb +7 -7
data/spec/unit/provider/ifconfig/debian_spec.rb +3 -3
data/spec/unit/provider/ifconfig/redhat_spec.rb +5 -5
data/spec/unit/provider/ifconfig_spec.rb +13 -13
data/spec/unit/provider/link_spec.rb +33 -33
data/spec/unit/provider/mdadm_spec.rb +4 -4
data/spec/unit/provider/mount/aix_spec.rb +5 -5
data/spec/unit/provider/mount/mount_spec.rb +49 -50
data/spec/unit/provider/mount/windows_spec.rb +18 -18
data/spec/unit/provider/mount_spec.rb +12 -12
data/spec/unit/provider/ohai_spec.rb +6 -6
data/spec/unit/provider/package/aix_spec.rb +14 -14
data/spec/unit/provider/package/apt_spec.rb +10 -10
data/spec/unit/provider/package/dpkg_spec.rb +13 -13
data/spec/unit/provider/package/easy_install_spec.rb +6 -6
data/spec/unit/provider/package/freebsd_spec.rb +29 -29
data/spec/unit/provider/package/ips_spec.rb +4 -4
data/spec/unit/provider/package/macports_spec.rb +6 -6
data/spec/unit/provider/package/pacman_spec.rb +17 -17
data/spec/unit/provider/package/portage_spec.rb +18 -18
data/spec/unit/provider/package/rpm_spec.rb +7 -7
data/spec/unit/provider/package/rubygems_spec.rb +31 -31
data/spec/unit/provider/package/smartos_spec.rb +4 -4
data/spec/unit/provider/package/solaris_spec.rb +15 -15
data/spec/unit/provider/package/yum_spec.rb +100 -100
data/spec/unit/provider/package/zypper_spec.rb +10 -10
data/spec/unit/provider/package_spec.rb +21 -21
data/spec/unit/provider/registry_key_spec.rb +2 -2
data/spec/unit/provider/remote_file/content_spec.rb +31 -31
data/spec/unit/provider/remote_file/fetcher_spec.rb +8 -8
data/spec/unit/provider/remote_file/ftp_spec.rb +10 -10
data/spec/unit/provider/remote_file/http_spec.rb +4 -4
data/spec/unit/provider/remote_file/local_file_spec.rb +2 -2
data/spec/unit/provider/remote_file_spec.rb +1 -1
data/spec/unit/provider/route_spec.rb +23 -23
data/spec/unit/provider/script_spec.rb +5 -5
data/spec/unit/provider/service/arch_service_spec.rb +41 -41
data/spec/unit/provider/service/debian_service_spec.rb +23 -23
data/spec/unit/provider/service/freebsd_service_spec.rb +33 -33
data/spec/unit/provider/service/gentoo_service_spec.rb +16 -16
data/spec/unit/provider/service/init_service_spec.rb +13 -13
data/spec/unit/provider/service/insserv_service_spec.rb +4 -4
data/spec/unit/provider/service/invokercd_service_spec.rb +12 -12
data/spec/unit/provider/service/macosx_spec.rb +20 -20
data/spec/unit/provider/service/redhat_spec.rb +15 -15
data/spec/unit/provider/service/simple_service_spec.rb +9 -9
data/spec/unit/provider/service/solaris_smf_service_spec.rb +13 -13
data/spec/unit/provider/service/systemd_service_spec.rb +28 -28
data/spec/unit/provider/service/upstart_service_spec.rb +41 -41
data/spec/unit/provider/service/windows_spec.rb +37 -37
data/spec/unit/provider/service_spec.rb +9 -9
data/spec/unit/provider/subversion_spec.rb +36 -36
data/spec/unit/provider/template/content_spec.rb +8 -8
data/spec/unit/provider/template_spec.rb +1 -1
data/spec/unit/provider/user/dscl_spec.rb +9 -9
data/spec/unit/provider/user/pw_spec.rb +20 -20
data/spec/unit/provider/user/solaris_spec.rb +5 -5
data/spec/unit/provider/user/windows_spec.rb +8 -8
data/spec/unit/provider/user_spec.rb +34 -34
data/spec/unit/provider_spec.rb +3 -3
data/spec/unit/recipe_spec.rb +79 -4
data/spec/unit/registry_helper_spec.rb +2 -2
data/spec/unit/resource/cron_spec.rb +2 -2
data/spec/unit/resource/directory_spec.rb +5 -5
data/spec/unit/resource/env_spec.rb +2 -2
data/spec/unit/resource/erl_call_spec.rb +1 -1
data/spec/unit/resource/file_spec.rb +8 -8
data/spec/unit/resource/group_spec.rb +3 -3
data/spec/unit/resource/link_spec.rb +8 -8
data/spec/unit/resource/mdadm_spec.rb +3 -3
data/spec/unit/resource/mount_spec.rb +3 -3
data/spec/unit/resource/route_spec.rb +2 -2
data/spec/unit/resource/user_spec.rb +2 -2
data/spec/unit/resource/yum_package_spec.rb +2 -2
data/spec/unit/resource_collection_spec.rb +1 -1
data/spec/unit/resource_definition_spec.rb +2 -2
data/spec/unit/resource_reporter_spec.rb +71 -16
data/spec/unit/resource_spec.rb +3 -3
data/spec/unit/rest/auth_credentials_spec.rb +2 -2
data/spec/unit/rest_spec.rb +3 -40
data/spec/unit/run_list/run_list_expansion_spec.rb +3 -3
data/spec/unit/run_list_spec.rb +9 -9
data/spec/unit/run_status_spec.rb +1 -1
data/spec/unit/runner_spec.rb +8 -8
data/spec/unit/scan_access_control_spec.rb +3 -3
data/spec/unit/search/query_spec.rb +7 -7
data/spec/unit/shell/model_wrapper_spec.rb +2 -2
data/spec/unit/shell/shell_ext_spec.rb +15 -15
data/spec/unit/shell/shell_session_spec.rb +9 -9
data/spec/unit/shell_spec.rb +1 -2
data/spec/unit/user_spec.rb +4 -4
data/spec/unit/util/backup_spec.rb +1 -1
data/spec/unit/util/selinux_spec.rb +7 -7
metadata +106 -51
data/distro/common/html/chef-client.8.html +0 -145
data/distro/common/html/chef-expander.8.html +0 -164
data/distro/common/html/chef-expanderctl.8.html +0 -146
data/distro/common/html/chef-server-webui.8.html +0 -185
data/distro/common/html/chef-server.8.html +0 -182
data/distro/common/html/chef-shell.1.html +0 -286
data/distro/common/html/chef-solo.8.html +0 -185
data/distro/common/html/chef-solr.8.html +0 -165
data/distro/common/html/knife-bootstrap.1.html +0 -241
data/distro/common/html/knife-client.1.html +0 -219
data/distro/common/html/knife-configure.1.html +0 -170
data/distro/common/html/knife-cookbook-site.1.html +0 -241
data/distro/common/html/knife-cookbook.1.html +0 -381
data/distro/common/html/knife-data-bag.1.html +0 -235
data/distro/common/html/knife-environment.1.html +0 -265
data/distro/common/html/knife-exec.1.html +0 -134
data/distro/common/html/knife-index.1.html +0 -125
data/distro/common/html/knife-node.1.html +0 -250
data/distro/common/html/knife-role.1.html +0 -200
data/distro/common/html/knife-search.1.html +0 -288
data/distro/common/html/knife-ssh.1.html +0 -156
data/distro/common/html/knife-status.1.html +0 -128
data/distro/common/html/knife-tag.1.html +0 -137
data/distro/common/html/knife.1.html +0 -315

data/distro/common/html/knife_bootstrap.html ADDED

@@ -0,0 +1,250 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>knife bootstrap &mdash; chef-client Man Pages</title>
+    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="shortcut icon" href="_static/chef.ico"/>
+  </head>
+  <body>
+<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
+<a href="http://docs.opscode.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
+</div>
+    <div class="document">
+      <div class="documentwrapper">
+          <div class="body">
+  <div class="section" id="knife-bootstrap">
+<h1>knife bootstrap<a class="headerlink" href="#knife-bootstrap" title="Permalink to this headline">¶</a></h1>
+<p>A bootstrap is a process that installs the chef-client on a target system so that it can run as a chef-client and communicate with a server.</p>
+<p>The <strong>knife bootstrap</strong> subcommand is used to run a bootstrap operation that installs the chef-client on the target system. The bootstrap operation must specify the IP address or FQDN of the target system.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">To bootstrap the chef-client on Microsoft Windows machines, the <a class="reference external" href="http://docs.opscode.com/plugin_knife_windows.html">knife-windows</a> plugins is required, which includes the necessary bootstrap scripts that are used to do the actual installation.</p>
+</div>
+<div class="section" id="syntax">
+<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap FQDN_or_IP_ADDRESS <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="options">
+<h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
+</div>
+<p>This subcommand has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-A</span></tt>, <tt class="docutils literal"><span class="pre">--forward-agent</span></tt></dt>
+<dd>Indicates that SSH agent forwarding is enabled.</dd>
+<dt><tt class="docutils literal"><span class="pre">--bootstrap-no-proxy</span> <span class="pre">NO_PROXY_URL_or_IP</span></tt></dt>
+<dd>A URL or IP address that specifies a location that should not be proxied. Note: This option is used internally by Chef to help verify bootstrap operations during testing and should never be used during an actual bootstrap operation.</dd>
+<dt><tt class="docutils literal"><span class="pre">--bootstrap-proxy</span> <span class="pre">PROXY_URL</span></tt></dt>
+<dd>The proxy server for the node that is the target of a bootstrap operation.</dd>
+<dt><tt class="docutils literal"><span class="pre">--bootstrap-version</span> <span class="pre">VERSION</span></tt></dt>
+<dd>The version of the chef-client to install.</dd>
+<dt><tt class="docutils literal"><span class="pre">-d</span> <span class="pre">DISTRO</span></tt>, <tt class="docutils literal"><span class="pre">--distro</span> <span class="pre">DISTRO</span></tt></dt>
+<dd><div class="first admonition warning">
+<p class="first admonition-title">Warning</p>
+<p class="last">The default bootstrap operation uses the omnibus installer, which means the default template file (<tt class="docutils literal"><span class="pre">chef-full</span></tt>) should work on all supported platforms. It is recommended to use custom bootstrap templates only when the omnibus installer cannot be used.</p>
+</div>
+<p class="last">The template file to be used during a bootstrap operation. The following distributions are supported: <tt class="docutils literal"><span class="pre">chef-full</span></tt> (the default bootstrap), <tt class="docutils literal"><span class="pre">centos5-gems</span></tt>, <tt class="docutils literal"><span class="pre">fedora13-gems</span></tt>, <tt class="docutils literal"><span class="pre">ubuntu10.04-gems</span></tt>, <tt class="docutils literal"><span class="pre">ubuntu10.04-apt</span></tt>, <tt class="docutils literal"><span class="pre">ubuntu12.04-gems</span></tt>, and the name of a custom bootstrap template file. When this option is used, Knife will search for the template file in the following order: the <tt class="docutils literal"><span class="pre">bootstrap/</span></tt> folder in the current working directory, the <tt class="docutils literal"><span class="pre">bootstrap/</span></tt> folder in the chef-repo, the <tt class="docutils literal"><span class="pre">bootstrap/</span></tt> folder in the <tt class="docutils literal"><span class="pre">~/.chef/</span></tt> directory, or a default bootstrap file. Do not use the <tt class="docutils literal"><span class="pre">--template-file</span></tt> option when <tt class="docutils literal"><span class="pre">--distro</span></tt> is specified.</p>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">-G</span> <span class="pre">GATEWAY</span></tt>, <tt class="docutils literal"><span class="pre">--ssh-gateway</span> <span class="pre">GATEWAY</span></tt></dt>
+<dd>The SSH tunnel or gateway that is used to run a bootstrap action on a machine that is not accessible from the workstation.</dd>
+<dt><tt class="docutils literal"><span class="pre">--hint</span> <span class="pre">HINT_NAME[=HINT_FILE]</span></tt></dt>
+<dd>An Ohai hint to be set on the target of the bootstrap. The hint is contained in a file and is formatted as JSON: <tt class="docutils literal"><span class="pre">{&quot;attribute&quot;:&quot;value&quot;,&quot;attribute&quot;:&quot;value&quot;...}</span></tt>. <tt class="docutils literal"><span class="pre">HINT_NAME</span></tt> is the name of the hint and <tt class="docutils literal"><span class="pre">HINT_FILE</span></tt> is the name of the hint file located at <tt class="docutils literal"><span class="pre">/etc/chef/ohai/hints/HINT_FILE.json</span></tt>. Use multiple <tt class="docutils literal"><span class="pre">--hint</span></tt> options in the command to specify multiple hints.</dd>
+<dt><tt class="docutils literal"><span class="pre">-i</span> <span class="pre">IDENTITY_FILE</span></tt>, <tt class="docutils literal"><span class="pre">--identity-file</span> <span class="pre">IDENTITY_FILE</span></tt></dt>
+<dd>The SSH identity file used for authentication. Key-based authentication is recommended.</dd>
+<dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">JSON_ATTRIBS</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">JSON_ATTRIBS</span></tt></dt>
+<dd>A JSON string that is added to the first run of a chef-client.</dd>
+<dt><tt class="docutils literal"><span class="pre">-N</span> <span class="pre">NAME</span></tt>, <tt class="docutils literal"><span class="pre">--node-name</span> <span class="pre">NAME</span></tt></dt>
+<dd>The name of the node.</dd>
+<dt><tt class="docutils literal"><span class="pre">--[no-]host-key-verify</span></tt></dt>
+<dd>Use <tt class="docutils literal"><span class="pre">--no-host-key-verify</span></tt> to disable host key verification. Default setting: <tt class="docutils literal"><span class="pre">--host-key-verify</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">-p</span> <span class="pre">PORT</span></tt>, <tt class="docutils literal"><span class="pre">--ssh-port</span> <span class="pre">PORT</span></tt></dt>
+<dd>The SSH port.</dd>
+<dt><tt class="docutils literal"><span class="pre">-P</span> <span class="pre">PASSWORD</span></tt>, <tt class="docutils literal"><span class="pre">--ssh-password</span> <span class="pre">PASSWORD</span></tt></dt>
+<dd>The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) Knife will prompt for the password.</dd>
+<dt><tt class="docutils literal"><span class="pre">--prerelease</span></tt></dt>
+<dd>Indicates that pre-release gems should be installed.</dd>
+<dt><tt class="docutils literal"><span class="pre">-r</span> <span class="pre">RUN_LIST</span></tt>, <tt class="docutils literal"><span class="pre">--run-list</span> <span class="pre">RUN_LIST</span></tt></dt>
+<dd>A comma-separated list of roles and/or recipes to be applied.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret</span> <span class="pre">SECRET</span></tt></dt>
+<dd>The encryption key that is used for values contained within a data bag item.</dd>
+<dt><tt class="docutils literal"><span class="pre">--secret-file</span> <span class="pre">FILE</span></tt></dt>
+<dd>The path to the file that contains the encryption key.</dd>
+<dt><tt class="docutils literal"><span class="pre">--sudo</span></tt></dt>
+<dd>Indicates that a bootstrap operation should be executed using sudo.</dd>
+<dt><tt class="docutils literal"><span class="pre">--template-file</span> <span class="pre">TEMPLATE</span></tt></dt>
+<dd>The path to a template file that will be used during a bootstrap operation. Do not use the <tt class="docutils literal"><span class="pre">--distro</span></tt> option when <tt class="docutils literal"><span class="pre">--template-file</span></tt> is specified.</dd>
+<dt><tt class="docutils literal"><span class="pre">--use-sudo-password</span></tt></dt>
+<dd>Indicates that a bootstrap operation is done using sudo, with the password specified by the <tt class="docutils literal"><span class="pre">-P</span></tt> (or <tt class="docutils literal"><span class="pre">--ssh-password</span></tt>) option.</dd>
+<dt><tt class="docutils literal"><span class="pre">-x</span> <span class="pre">USERNAME</span></tt>, <tt class="docutils literal"><span class="pre">--ssh-user</span> <span class="pre">USERNAME</span></tt></dt>
+<dd>The SSH user name.</dd>
+</dl>
+</div>
+<div class="section" id="custom-templates">
+<h2>Custom Templates<a class="headerlink" href="#custom-templates" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">chef-full</span></tt> distribution uses the omnibus installer. For most bootstrap operations, regardless of the platform on which the target node is running, using the <tt class="docutils literal"><span class="pre">chef-full</span></tt> distribution is the best approach for installing the chef-client on a target node. In some situations, using another supported distribution is necessary. And in some situations, a custom template may be required. For example, the default bootstrap operation relies on an Internet connection to get the distribution to the target node. If a target node cannot access the Internet, then a custom template can be used to define a specific location for the distribution so that the target node may access it during the bootstrap operation.</p>
+<p>A custom bootstrap template file (<tt class="docutils literal"><span class="pre">template_filename.erb</span></tt>) must be located in a <tt class="docutils literal"><span class="pre">bootstrap/</span></tt> directory. Use the <tt class="docutils literal"><span class="pre">--distro</span></tt> option with the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">bootstrap</span></tt> subcommand to specify the bootstrap template file. For example, a bootstrap template file named &#8220;british_sea_power.erb&#8221;:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap 123.456.7.8 -x username -P password --sudo --distro <span class="s2">&quot;british_sea_power.erb&quot;</span>
+</pre></div>
+</div>
+<p>The following examples show how a bootstrap template file can be customized for various platforms.</p>
+<div class="section" id="ubuntu-12-04">
+<h3>Ubuntu 12.04<a class="headerlink" href="#ubuntu-12-04" title="Permalink to this headline">¶</a></h3>
+<p>The following example shows how to modify the default script for Ubuntu 12.04. First, copy the bootstrap template from the default location. If the chef-client is installed from a RubyGems, the full path can be found in the gem contents:</p>
+<div class="highlight-bash"><div class="highlight"><pre>% gem contents chef | grep ubuntu12.04-gems
+/Users/jtimberman/.rvm/gems/ruby-1.9.2-p180/gems/chef-0.10.2/lib/chef/knife/bootstrap/ubuntu12.04-gems.erb
+</pre></div>
+</div>
+<p>Copy the template to the chef-repo in the <tt class="docutils literal"><span class="pre">.chef/bootstrap</span></tt> directory:</p>
+<div class="highlight-bash"><div class="highlight"><pre>% cp /Users/jtimberman/.rvm/gems/ruby-1.9.2-p180/gems/chef-0.10.2/
+   lib/chef/knife/bootstrap/ubuntu12.04-gems.erb ~/chef-repo/.chef/
+   bootstrap/ubuntu12.04-gems-mine.erb
+</pre></div>
+</div>
+<p>Modify the template with any editor, then use it with the <tt class="docutils literal"><span class="pre">-d</span></tt> or <tt class="docutils literal"><span class="pre">--distro</span></tt> option in the <tt class="docutils literal"><span class="pre">knife</span> <span class="pre">bootstrap</span></tt> operation, or use any of the Knife plug-ins that support cloud computing.</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap 192.168.1.100 -r <span class="s1">&#39;role[webserver]&#39;</span> -d ubuntu12.04-gems-mine
+</pre></div>
+</div>
+<p>Alternatively, an example bootstrap template can be found in the git source for the chef-repo: <a class="reference external" href="https://github.com/opscode/chef/blob/master/lib/chef/knife/bootstrap/ubuntu12.04-gems.erb">https://github.com/opscode/chef/blob/master/lib/chef/knife/bootstrap/ubuntu12.04-gems.erb</a>. Copy the template to <tt class="docutils literal"><span class="pre">~/.chef-repo/.chef/bootstrap/ubuntu12.04-apt.erb</span></tt> and modify the template appropriately.</p>
+</div>
+<div class="section" id="debian-and-apt">
+<h3>Debian and Apt<a class="headerlink" href="#debian-and-apt" title="Permalink to this headline">¶</a></h3>
+<p>The following example shows how to use the <strong>knife bootstrap</strong> sub-command to create a client configuration file (/etc/chef/client.rb) that uses Hosted Chef as the server. The configuration file will look something like:</p>
+<div class="highlight-ruby"><div class="highlight"><pre><span class="n">log_level</span>        <span class="ss">:info</span>
+<span class="n">log_location</span>     <span class="no">STDOUT</span>
+<span class="n">chef_server_url</span>  <span class="s1">&#39;https://api.opscode.com/organizations/ORGNAME&#39;</span>
+<span class="n">validation_client_name</span> <span class="s1">&#39;ORGNAME-validator&#39;</span>
+</pre></div>
+</div>
+<p>The <strong>knife bootstrap</strong> sub-command will look in three locations for the template that is used during the bootstrap operation. The locations are:</p>
+<ol class="arabic simple">
+<li>A bootstrap directory in the installed Knife library; the actual location may vary, depending how the chef-client is installed</li>
+<li>A bootstrap directory in the <tt class="docutils literal"><span class="pre">$PWD/.chef</span></tt>, e.g. in <tt class="docutils literal"><span class="pre">~/chef-repo/.chef</span></tt></li>
+<li>A bootstrap directory in the users <tt class="docutils literal"><span class="pre">$HOME/.chef</span></tt></li>
+</ol>
+<p>If, in the example above, the second location was used, then create the <tt class="docutils literal"><span class="pre">.chef/bootstrap/</span></tt> directory in the chef-repo, and then create the Embedded Ruby (ERB) template file by running commands similar to the following:</p>
+<div class="highlight-bash"><div class="highlight"><pre>mkdir ~/.chef/bootstrap
+vi ~/.chef/bootstrap/debian5.0-apt.erb
+</pre></div>
+</div>
+<p>When finished creating the directory and the Embedded Ruby (ERB) template file, edit the template to run the SSH commands. Then set up the validation certificate and the client configuration file.</p>
+<p>Finally, run the chef-client on the node using a <strong>knife bootstrap</strong> command that specifies a run-list (the <tt class="docutils literal"><span class="pre">-r</span></tt> option). The bootstrap template can be called using a command similar to the following:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap mynode.example.com -r <span class="s1">&#39;role[webserver]&#39;</span>,<span class="s1">&#39;role[production]&#39;</span> --distro debian5.0-apt
+</pre></div>
+</div>
+</div>
+<div class="section" id="microsoft-windows">
+<h3>Microsoft Windows<a class="headerlink" href="#microsoft-windows" title="Permalink to this headline">¶</a></h3>
+<p>The following example shows how to modify the default script for Microsoft Windows and Windows PowerShell:</p>
+<div class="highlight-bash"><div class="highlight"><pre>@setlocal
+&lt;%<span class="o">=</span> <span class="s2">&quot;SETX HTTP_PROXY \&quot;#{knife_config[:bootstrap_proxy]}\&quot;&quot;</span> <span class="k">if </span>knife_config<span class="o">[</span>:bootstrap_proxy<span class="o">]</span> %&gt;
+@mkdir &lt;%<span class="o">=</span> bootstrap_directory %&gt;
+&gt; &lt;%<span class="o">=</span> bootstrap_directory %&gt;<span class="se">\w</span>get.ps1 <span class="o">(</span>
+ &lt;%<span class="o">=</span> win_wget_ps %&gt;
+<span class="o">)</span>
+:install
+@rem Install Chef using chef-client MSI installer
+&lt;% <span class="nv">url</span><span class="o">=</span><span class="s2">&quot;http://reposerver.example.com/chef-client-11.6.0.rc.1-1.windows.msi&quot;</span> -%&gt;
+@set <span class="s2">&quot;REMOTE_SOURCE_MSI_URL=&lt;%= url %&gt;&quot;</span>
+@set <span class="s2">&quot;LOCAL_DESTINATION_MSI_PATH=&lt;%= local_download_path %&gt;&quot;</span>
+@powershell -ExecutionPolicy Unrestricted -NoProfile -NonInteractive <span class="s2">&quot;&amp; &#39;&lt;%= bootstrap_directory %&gt;\wget.ps1&#39; &#39;%REMOTE_SOURCE_MSI_URL%&#39; &#39;%LOCAL_DESTINATION_MSI_PATH%&#39;&quot;</span>
+@REM Replace install_chef from knife-windows Gem with one that has extra flags to turn on Chef service feature -- only available in Chef &gt;<span class="o">=</span> 11.6.x
+@REM &lt;%<span class="o">=</span> install_chef %&gt;
+@echo Installing Chef Client 11.6.0.rc1 with msiexec
+@msiexec /q /i <span class="s2">&quot;%LOCAL_DESTINATION_MSI_PATH%&quot;</span> <span class="nv">ADDLOCAL</span><span class="o">=</span><span class="s2">&quot;ChefClientFeature,ChefServiceFeature&quot;</span>
+@endlocal
+@echo Writing validation key...
+&gt; &lt;%<span class="o">=</span> bootstrap_directory %&gt;<span class="se">\v</span>alidation.pem <span class="o">(</span>
+ &lt;%<span class="o">=</span> validation_key %&gt;
+<span class="o">)</span>
+@echo Validation key written.
+&lt;% <span class="k">if</span> @config<span class="o">[</span>:encrypted_data_bag_secret<span class="o">]</span> -%&gt;
+&gt; &lt;%<span class="o">=</span> bootstrap_directory %&gt;<span class="se">\e</span>ncrypted_data_bag_secret <span class="o">(</span>
+ &lt;%<span class="o">=</span> encrypted_data_bag_secret %&gt;
+<span class="o">)</span>
+&lt;% end -%&gt;
+&gt; &lt;%<span class="o">=</span> bootstrap_directory %&gt;<span class="se">\c</span>lient.rb <span class="o">(</span>
+ &lt;%<span class="o">=</span> config_content %&gt;
+<span class="o">)</span>
+&gt; &lt;%<span class="o">=</span> bootstrap_directory %&gt;<span class="se">\f</span>irst-boot.json <span class="o">(</span>
+ &lt;%<span class="o">=</span> run_list %&gt;
+<span class="o">)</span>
+&lt;%<span class="o">=</span> start_chef %&gt;
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="examples">
+<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Use an SSH password</strong></p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap 192.168.1.1 -x username -P PASSWORD --sudo
+</pre></div>
+</div>
+<p><strong>Use a file that contains a private key</strong></p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife bootstrap 192.168.1.1 -x username -i ~/.ssh/id_rsa --sudo
+</pre></div>
+</div>
+</div>
+</div>
+          </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+  </body>
+</html>

data/distro/common/html/knife_client.html ADDED

@@ -0,0 +1,283 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>knife client &mdash; chef-client Man Pages</title>
+    <link rel="stylesheet" href="_static/guide.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="shortcut icon" href="_static/chef.ico"/>
+  </head>
+  <body>
+<div style="background-color: #212c35; text-align: left; padding: 0px 0px 0px 0px">
+<a href="http://docs.opscode.com/"><img src="_static/chef_html_logo.png" border="0" alt="Chef"/></a>
+</div>
+    <div class="document">
+      <div class="documentwrapper">
+          <div class="body">
+  <div class="section" id="knife-client">
+<h1>knife client<a class="headerlink" href="#knife-client" title="Permalink to this headline">¶</a></h1>
+<p>The <strong>knife client</strong> subcommand is used to manage an API client list and their associated RSA public key-pairs. This allows authentication requests to be made to the server by any entity that uses the Chef Server API, such as the chef-client and Knife.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Review the list of <a class="reference internal" href="knife_common_options.html"><em>common options</em></a> available to this (and all) Knife subcommands and plugins.</p>
+</div>
+<div class="section" id="bulk-delete">
+<h2>bulk delete<a class="headerlink" href="#bulk-delete" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">bulk</span> <span class="pre">delete</span></tt> argument is used to delete any API client that matches a pattern defined by a regular expression. The regular expression must be within quotes and not be surrounded by forward slashes (/).</p>
+<div class="section" id="syntax">
+<h3>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client bulk delete REGEX
+</pre></div>
+</div>
+</div>
+<div class="section" id="options">
+<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
+<p>This command does not have any specific options.</p>
+</div>
+<div class="section" id="examples">
+<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
+<p>None.</p>
+</div>
+</div>
+<div class="section" id="create">
+<h2>create<a class="headerlink" href="#create" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">create</span></tt> argument is used to create a new API client. This process will generate an RSA key pair for the named API client. The public key will be stored on the server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
+<ul class="simple">
+<li>For the chef-client, the private key should be copied to the system as <tt class="docutils literal"><span class="pre">/etc/chef/client.pem</span></tt>.</li>
+<li>For Knife, the private key is typically copied to <tt class="docutils literal"><span class="pre">~/.chef/client_name.pem</span></tt> and referenced in the knife.rb configuration file.</li>
+</ul>
+<div class="section" id="id1">
+<h3>Syntax<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client create CLIENT_NAME <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id2">
+<h3>Options<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-a</span></tt>, <tt class="docutils literal"><span class="pre">--admin</span></tt></dt>
+<dd>Indicates that a client will be created as an admin client. This is required when users of the open source server need to access the Chef Server API as an administrator. This option only works when used with the open source server and will have no effect when used with Enterprise Chef.</dd>
+</dl>
+</div>
+<div class="section" id="id3">
+<h3>Examples<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Create an admin client</strong></p>
+<p>To create a Chef Admin client with the name &#8220;exampleorg&#8221; and save its private key to a file, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client create exampleorg -a -f <span class="s2">&quot;/etc/chef/client.pem&quot;</span>
+</pre></div>
+</div>
+<p><strong>Create an admin client for Enterprise Chef</strong></p>
+<p>When running the <tt class="docutils literal"><span class="pre">create</span></tt> argument on Enterprise Chef, be sure to omit the <tt class="docutils literal"><span class="pre">-a</span></tt> option:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client create exampleorg -f <span class="s2">&quot;/etc/chef/client.pem&quot;</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="delete">
+<h2>delete<a class="headerlink" href="#delete" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">delete</span></tt> argument is used to delete a registered API client.</p>
+<div class="section" id="id4">
+<h3>Syntax<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client delete CLIENT_NAME
+</pre></div>
+</div>
+</div>
+<div class="section" id="id5">
+<h3>Options<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
+<p>This command does not have any specific options.</p>
+</div>
+<div class="section" id="id6">
+<h3>Examples<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Delete a client</strong></p>
+<p>To delete a client with the name &#8220;client_foo&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client delete client_foo
+</pre></div>
+</div>
+<p>Type <tt class="docutils literal"><span class="pre">Y</span></tt> to confirm a deletion.</p>
+</div>
+</div>
+<div class="section" id="edit">
+<h2>edit<a class="headerlink" href="#edit" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">edit</span></tt> argument is used to edit the details of a registered API client. When this argument is run, Knife will open $EDITOR to enable editing of the <tt class="docutils literal"><span class="pre">admin</span></tt> attribute. (None of the other attributes should be changed using this argument.) When finished, Knife will update the server with those changes.</p>
+<div class="section" id="id7">
+<h3>Syntax<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client edit CLIENT_NAME
+</pre></div>
+</div>
+</div>
+<div class="section" id="id8">
+<h3>Options<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
+<p>This command does not have any specific options.</p>
+</div>
+<div class="section" id="id9">
+<h3>Examples<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Edit a client</strong></p>
+<p>To edit a client with the name &#8220;exampleorg&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client edit exampleorg
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="list">
+<h2>list<a class="headerlink" href="#list" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">list</span></tt> argument is used to view a list of registered API client.</p>
+<div class="section" id="id10">
+<h3>Syntax<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client list <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id11">
+<h3>Options<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-w</span></tt>, <tt class="docutils literal"><span class="pre">--with-uri</span></tt></dt>
+<dd>Indicates that the corresponding URIs will be shown.</dd>
+</dl>
+</div>
+<div class="section" id="id12">
+<h3>Examples<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>View a list of clients</strong></p>
+<p>To verify the API client list for the server, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client list
+</pre></div>
+</div>
+<p>to return something similar to:</p>
+<div class="highlight-bash"><div class="highlight"><pre>exampleorg
+i-12345678
+rs-123456
+</pre></div>
+</div>
+<p>To verify that an API client can authenticate to the
+server correctly, try getting a list of clients using <tt class="docutils literal"><span class="pre">-u</span></tt> and <tt class="docutils literal"><span class="pre">-k</span></tt> options to specify its name and private key:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client list -u ORGNAME -k .chef/ORGNAME.pem
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="reregister">
+<h2>reregister<a class="headerlink" href="#reregister" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">reregister</span></tt> argument is used to regenerate an RSA key pair for an API client. The public key will be stored on the server and the private key will be displayed on <tt class="docutils literal"><span class="pre">STDOUT</span></tt> or written to a named file.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">Running this argument will invalidate the previous RSA key pair, making it unusable during authentication to the server.</p>
+</div>
+<div class="section" id="id13">
+<h3>Syntax<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client reregister CLIENT_NAME <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id14">
+<h3>Options<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-f</span> <span class="pre">FILE_NAME</span></tt>, <tt class="docutils literal"><span class="pre">--file</span> <span class="pre">FILE_NAME</span></tt></dt>
+<dd>Indicates that the private key will be saved to a specified file name.</dd>
+</dl>
+</div>
+<div class="section" id="id15">
+<h3>Examples<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Reregister clients</strong></p>
+<p>To regenerate the RSA key pair for a client named &#8220;testclient&#8221; and save it to a file named &#8220;rsa_key&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client regenerate testclient -f rsa_key
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="show">
+<h2>show<a class="headerlink" href="#show" title="Permalink to this headline">¶</a></h2>
+<p>The <tt class="docutils literal"><span class="pre">show</span></tt> argument is used to show the details of an API client.</p>
+<div class="section" id="id16">
+<h3>Syntax<a class="headerlink" href="#id16" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following syntax:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client show CLIENT_NAME <span class="o">(</span>options<span class="o">)</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="id17">
+<h3>Options<a class="headerlink" href="#id17" title="Permalink to this headline">¶</a></h3>
+<p>This argument has the following options:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">-a</span> <span class="pre">ATTR</span></tt>, <tt class="docutils literal"><span class="pre">--attribute</span> <span class="pre">ATTR</span></tt></dt>
+<dd>The attribute (or attributes) to show.</dd>
+</dl>
+</div>
+<div class="section" id="id18">
+<h3>Examples<a class="headerlink" href="#id18" title="Permalink to this headline">¶</a></h3>
+<p>The following examples show how to use this Knife subcommand:</p>
+<p><strong>Show clients</strong></p>
+<p>To view a client named &#8220;testclient&#8221;, enter:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife client show testclient
+</pre></div>
+</div>
+<p>to return something like:</p>
+<div class="highlight-bash"><div class="highlight"><pre>admin:       <span class="nb">false</span>
+chef_type:   client
+json_class:  Chef::ApiClient
+name:        testclient
+public_key:
+</pre></div>
+</div>
+<p>To view information in JSON format, use the <tt class="docutils literal"><span class="pre">-F</span></tt> common option as part of the command like this:</p>
+<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>knife role show devops -F json
+</pre></div>
+</div>
+<p>Other formats available include <tt class="docutils literal"><span class="pre">text</span></tt>, <tt class="docutils literal"><span class="pre">yaml</span></tt>, and <tt class="docutils literal"><span class="pre">pp</span></tt>.</p>
+</div>
+</div>
+</div>
+          </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+  </body>
+</html>