Uninstall¶
The following sections describe how to uninstall Chef, add-ons, and other components.
Chef Server¶
The uninstall
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 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:
Run the following command:
$ chef-manage-ctl cleanse
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 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:
Shut down the Chef push jobs service.
Uninstall the Chef push jobs package.
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.
ChefDK¶
The Chef development kit can be uninstalled using the steps below that are appropriate for the platform on which the Chef development kit is installed.
Debian¶
Use the following command to remove the Chef development kit on Debian-based platforms:
$ dpkg -P chefdk
macOS¶
Use the following commands to remove the Chef development kit on macOS.
To remove installed files:
$ sudo rm -rf /opt/chefdk
To remove the system installation entry:
$ sudo pkgutil --forget com.getchef.pkg.chefdk
To remove symlinks:
For chef-client version 12.x, under
/usr/local/bin
:$ sudo find /usr/local/bin -lname '/opt/chefdk/*' -delete
For chef-client version 11.x, under
/usr/bin
:$ sudo find /usr/bin -lname '/opt/chefdk/*' -delete
Red Hat Enterprise Linux¶
Use the following commands to remove the Chef development kit on Red Hat Enterprise Linux-based platforms:
$ rpm -qa *chefdk*
$ sudo yum remove -y <package>
Microsoft Windows¶
Use Add / Remove Programs to remove the Chef development kit on the Microsoft Windows platform.