Uninstall

[edit on GitHub]

The following sections describe how to uninstall Chef, add-ons, and other components.

Chef Infra Server

The uninstall subcommand is used to remove the Chef Infra Server application, but without removing any of the data. This subcommand will shut down all services (including the runit process supervisor).

This subcommand has the following syntax:

chef-server-ctl uninstall

Note

To revert the uninstall subcommand, run the reconfigure subcommand (because the start subcommand is disabled by the uninstall command).

Chef Manage

To uninstall the Chef management console, do the following:

  1. Run the following command:

    chef-manage-ctl cleanse

  2. Use the package manager for the platform on which the Chef management console is installed, and then uninstall the package named chef-manage.

Note

This package used to be named opscode-manage and the command line tool used to be named opscode-manage-ctl.

Chef Analytics

The uninstall subcommand is used to remove the Chef Analytics application, but without removing any of the data. This subcommand will shut down all services (including the runit process supervisor).

This subcommand has the following syntax:

opscode-analytics-ctl uninstall

Note

To revert the uninstall subcommand, run the reconfigure subcommand (because the start subcommand is disabled by the uninstall command).

Reporting

The uninstall subcommand is used to remove the Reporting add-on to the Chef Infra Server, but without removing any of the data. This subcommand will shut down all services (including the runit process supervisor).

This subcommand has the following syntax:

opscode-reporting-ctl uninstall

Note

To revert the uninstall subcommand, run the reconfigure subcommand (because the start subcommand is disabled by the uninstall command).

Chef Push Jobs

To uninstall Chef Push Jobs, do the following:

  1. Shut down the Chef Push Jobs service.

  2. Uninstall the Chef Push Jobs package.

  3. Run the following command:

    chef-server-ctl reconfigure

Note

This will leave some data in PostgreSQL that is not used by any other Chef application or service.

push-jobs-client

Use the package manager for the platform on which Chef Push Jobs is installed to uninstall Chef Push Jobs.

Chef Workstation

Chef Workstation can be uninstalled using the steps below that are appropriate for the platform on which Chef Workstation is installed.

Debian

Use the following command to remove Chef Workstation on Debian-based platforms:

dpkg -P chef-workstation

macOS

Use the following commands to remove Chef Workstation on macOS.

To remove installed files:

sudo rm -rf `/opt/chef-workstation

To remove the system installation entry:

sudo pkgutil --forget com.getchef.pkg.chef-workstation

To remove symlinks:

sudo find /usr/local/bin -lname '`/opt/chef-workstation/*' -delete

Red Hat Enterprise Linux

Use the following commands to remove Chef Workstation on Red Hat Enterprise Linux-based platforms:

rpm -qa *chef-workstation*
sudo yum remove -y <package>

Microsoft Windows

Use Add / Remove Programs to remove Chef Workstation on the Microsoft Windows platform.

© Chef Software, Inc.
Licensed under the Creative Commons Attribution 3.0 Unported License.
The Chef™ Mark and Chef Logo are either registered trademarks/service marks or trademarks/servicemarks of Chef, in the United States and other countries and are used with Chef Inc's permission.
We are not affiliated with, endorsed or sponsored by Chef Inc.
https://docs.chef.io/uninstall/