Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated the doc to point to latest CW version #3227

Merged
merged 9 commits into from
Apr 25, 2024
68 changes: 49 additions & 19 deletions docs-chef-io/content/workstation/install_workstation.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ aliases = ["/install_workstation.html", "/install_dk.html", "/workstation_window

{{< readfile file="content/workstation/reusable/md/chef_workstation.md" >}}

For general information about downloading Chef products, see the [Chef download documentation](/download/).

## Supported Platforms

The following table lists the commercially supported platforms and versions for Chef Workstation:
Expand All @@ -41,7 +43,7 @@ Minimum system requirements:

Additional Chef Workstation App Requirements:

- On Linux you must have a graphical window manager running with support for system tray icons. For some distributions you may also need to install additional libraries. After you install the Chef Workstation package from the terminal, the post-install message will tell you which, if any, additional libraries are required to run the Chef Workstation App.
- On Linux, you must have a graphical window manager running with support for system tray icons. For some distributions you may also need to install additional libraries. After you install the Chef Workstation package from the terminal, the post-install message will tell you which, if any, additional libraries are required to run the Chef Workstation App.

## Installation

Expand All @@ -57,7 +59,7 @@ applications that may be running on the target machine.
1. Visit [Chef Downloads](https://www.chef.io/downloads) to download a Chef Workstation package.
1. Follow the steps to accept the license and install Chef Workstation.

Alternately, install Chef Workstation using the [Homebrew](https://brew.sh/) package manager:
Alternatively, install Chef Workstation using the [Homebrew](https://brew.sh/) package manager:

`brew install --cask chef-workstation`

Expand All @@ -67,7 +69,7 @@ Alternately, install Chef Workstation using the [Homebrew](https://brew.sh/) pac
1. Follow the steps to accept the license and install Chef Workstation. You will have the option to change your install location; by default the installer uses the `C:\opscode\chef-workstation\` directory.
1. **Optional:** Set the default shell. On Windows it is strongly recommended to use Windows PowerShell instead of `cmd.exe`.

Alternately, install Chef Workstation using the [Chocolatey](https://chocolatey.org/) package manager:
Alternatively, install Chef Workstation using the [Chocolatey](https://chocolatey.org/) package manager:

`choco install chef-workstation`

Expand All @@ -91,32 +93,60 @@ msiexec /q /i MsiPath ADDLOCAL=ALL REMOVE=ChefWSApp

### Linux

1. Visit the [Chef Downloads page](https://www.chef.io/downloads) and download the appropriate package for your distribution:
1. Visit the [Chef Downloads page](https://www.chef.io/downloads) or download the appropriate package for your distribution:

- Red Hat Enterprise Linux

```bash
wget https://packages.chef.io/files/stable/chef-workstation/21.10.640/el/8/chef-workstation-21.10.640-1.el8.x86_64.rpm
wget https://packages.chef.io/files/stable/chef-workstation/<WORKSTATION_VERSION>/el/<RHEL_VERSION>/chef-workstation-<WORKSTATION_VERSION>-1.el<RHEL_VERSION>.x86_64.rpm
```

For example:

```sh
wget https://packages.chef.io/files/stable/chef-workstation/24.4.1064/el/8/chef-workstation-24.4.1064-1.el8.x86_64.rpm
```


- Debian/Ubuntu

``` bash
wget https://packages.chef.io/files/stable/chef-workstation/21.10.640/ubuntu/20.04/chef-workstation_21.10.640-1_amd64.deb
wget https://packages.chef.io/files/stable/chef-workstation/<WORKSTATION_VERSION>/ubuntu/<UBUNTU_VERSION>/chef-workstation_<WORKSTATION_VERSION>-1_amd64.deb
```

For example:

```sh
wget https://packages.chef.io/files/stable/chef-workstation/24.4.1064/ubuntu/20.04/chef-workstation_24.4.1064-1_amd64.deb
```

1. Use your distribution's package manager to install Chef Workstation:

- Red Hat Enterprise Linux:

``` bash
yum localinstall chef-workstation-21.10.640-1.el8.x86_64.rpm
```
``` bash
yum localinstall chef-workstation-<WORKSTATION_VERSION>-1.el<RHEL_VERSION>.x86_64.rpm
```

For example:

``` bash
yum localinstall chef-workstation-24.4.1064-1.el8.x86_64.rpm
```

- Debian/Ubuntu:

``` bash
dpkg -i chef-workstation_21.10.640-1_amd64.deb
```
``` bash
dpkg -i chef-workstation_<WORKSTATION_VERSION>-1_amd64.deb
```

For example:

```sh
dpkg -i chef-workstation_24.4.1064-1_amd64.deb
```

See the [Chef Workstation release notes](/release_notes_workstation/) or the [Omnitruck API](https://omnitruck.chef.io/stable/chef-workstation/versions/all) for supported version numbers.

## Verify the Installation

Expand All @@ -129,13 +159,13 @@ chef -v
Which returns the versions of all installed Chef tools:

``` shell
Chef Workstation version: 21.10.640
Chef Infra Client version: 17.6.18
Chef InSpec version: 4.46.13
Chef CLI version: 5.4.2
Chef Habitat version: 1.6.351
Test Kitchen version: 3.1.0
Cookstyle version: 7.25.6
Chef Workstation version: 24.4.1064
Chef Infra Client version: 18.4.12
Chef InSpec version: 5.22.40
Chef CLI version: 5.6.14
Chef Habitat version: 1.6.652
Test Kitchen version: 3.6.0
Cookstyle version: 7.32.8
```

## Upgrading
Expand Down
Loading