diff --git a/content/install.md b/content/install.md index bd3350b..c1eccbd 100644 --- a/content/install.md +++ b/content/install.md @@ -11,8 +11,8 @@ draft = false {{< readfile file="/content/reusable/md/workstation_modularize.md" >}} -The Chef Workstation native installers provide an efficient way to install Chef Workstation on Windows, Debian, or RPM-based Linux distributions. -You can download and install the pre-built `.msi`, `.deb`, or `.rpm` packages using your existing package management tools, simplifying the deployment process for managing system configurations. +The Chef Workstation native installers provide an efficient way to install Chef Workstation on Windows, Debian, RPM-based Linux distributions, and macOS. +You can download and install the pre-built `.msi`, `.deb`, `.rpm`, or `.dmg` packages using your existing package management tools, simplifying the deployment process for managing system configurations. ## Supported platforms @@ -20,6 +20,7 @@ Chef Workstation is supported on: - Currently supported Linux distributions and versions running Linux kernel 2.6.32 and later on x86-64 (amd64) - Currently supported Windows versions greater than or equal to Windows 10 and Windows Server 2016 +- macOS 14 (Sonoma) on Apple Silicon (ARM64/aarch64) ## Chef Workstation requirements @@ -27,6 +28,7 @@ Chef Workstation is supported on: - **Disk space for binaries**: - Linux: The Chef Workstation binaries are stored in `/hab` and require a minimum of 2.8 GB of disk space. - Windows: The Chef Workstation binaries are stored in `C:\hab` and require a minimum of 3.3 GB of disk space. + - macOS: The Chef Workstation binaries are stored in `/opt/hab` and require a minimum of 2.4 GB of disk space. ## Prerequisites @@ -131,6 +133,42 @@ To install Chef Workstation on Windows, follow these steps: Replace `` with the version number of the downloaded package, for example `chef-workstation-enterprise-26.1.0-1_x86_64.msi`. +### Install Chef Workstation on macOS + +To install Chef Workstation on macOS (Apple Silicon), follow these steps: + +1. Download the installer using one of the following methods: + + - Download using `curl`: + + ```shell + curl -o "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + - Download using `wget`: + + ```shell + wget -O "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + Replace: + - `` with the version number to install. + - `` with your Chef license ID. + +1. Install Chef Workstation using one of the following methods: + + - Double-click the `.dmg` file, then double-click the `.pkg` file inside and follow the on-screen installation wizard. + + - Run the following commands: + + ```shell + hdiutil attach chef-workstation-enterprise--darwin.dmg + sudo installer -pkg "/Volumes/Chef Workstation Enterprise /chef-workstation-enterprise--1_arm64.pkg" -target / + hdiutil detach "/Volumes/Chef Workstation Enterprise " + ``` + + Replace `` with the version number of the downloaded package, for example `chef-workstation-enterprise-26.1.0-1`. + ## Verify the installation After installation, verify that Chef Workstation is installed correctly by running one of the following commands: diff --git a/content/uninstall.md b/content/uninstall.md index 633060e..51f876a 100644 --- a/content/uninstall.md +++ b/content/uninstall.md @@ -7,7 +7,7 @@ draft = false identifier = "uninstall" +++ -Use these steps to remove Chef Workstation from Debian-based, RPM-based, or Windows systems. +Use these steps to remove Chef Workstation from Debian-based, RPM-based, Windows, or macOS systems. ## Uninstall Chef Workstation on Debian-based distributions @@ -61,6 +61,22 @@ msiexec /x chef-workstation-enterprise-_x86_64.msi Replace `` with the version number of the currently installed package. +## Uninstall Chef Workstation on macOS + +To uninstall Chef Workstation on macOS, run the uninstaller script: + +```shell +sudo /opt/hab/chef-workstation/uninstall.sh +``` + +This script will: + +- Remove all Chef Workstation binaries from `/usr/local/bin/` +- Remove the installation directory `/opt/hab/` +- Remove the PATH configuration from `/etc/paths.d/chef-workstation-enterprise` +- Remove the installation metadata from `/Library/Application Support/chef-workstation-enterprise/` +- Forget the package receipt using `pkgutil` + ## See also - [Install Chef Workstation](install) diff --git a/content/upgrade.md b/content/upgrade.md index ef58e41..afe93c4 100644 --- a/content/upgrade.md +++ b/content/upgrade.md @@ -6,7 +6,7 @@ title = "Upgrade" identifier = "upgrade" +++ -Chef Workstation 26.1 and later uses native installers for Debian, RPM, and Windows. +Chef Workstation 26.1 and later uses native installers for Debian, RPM, Windows, and macOS. To upgrade, install the latest version for your operating system. ## Upgrade on Debian-based systems @@ -97,6 +97,36 @@ To upgrade Chef Workstation on Windows, follow these steps: Replace `` with the version number of the downloaded package. +## Upgrade on macOS + +To upgrade Chef Workstation on macOS, follow these steps: + +1. Download the latest installer: + + ```shell + curl -o "chef-workstation-enterprise--darwin.dmg" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=&m=aarch64&p=mac_os_x&pm=dmg&v=" + ``` + + Replace: + - `` with the version number to upgrade to. + - `` with your Chef license ID. + +1. Install the new version using one of the following methods: + + - Double-click the `.dmg` file, then double-click the `.pkg` file inside and follow the on-screen installation wizard. + + - Run the following commands: + + ```shell + hdiutil attach chef-workstation-enterprise--darwin.dmg + sudo installer -pkg "/Volumes/Chef Workstation Enterprise /chef-workstation-enterprise--1_arm64.pkg" -target / + hdiutil detach "/Volumes/Chef Workstation Enterprise " + ``` + + The installer will automatically detect and upgrade your existing installation. + + Replace `` with the version number of the downloaded package. + ## Next steps - [Set up Workstation](/set_up/)