From 1eeddf5ba54571ca0e53c66463e9649e8bb5c254 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Thu, 11 Jul 2024 16:11:50 +0530 Subject: [PATCH 01/25] added updated for download script steps Signed-off-by: vviveksharma --- .../md/packages_install_script_examples.md | 4 ++-- .../md/packages_install_script_options.md | 5 ++--- .../md/packages_install_script_run_unix_linux.md | 15 +++++++++++++-- .../md/packages_install_script_run_windows.md | 12 +++++++++++- 4 files changed, 28 insertions(+), 8 deletions(-) diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md index 474202fb11..8e3622ca3c 100644 --- a/content/reusable/md/packages_install_script_examples.md +++ b/content/reusable/md/packages_install_script_examples.md @@ -3,12 +3,12 @@ The following examples show how to use the Chef Software Install script. To install Chef Infra Client 15.8.23: ```bash -curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 15.8.23 +curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=linux | sudo bash -s -- -v 6.6.0 ``` To install the latest version of Chef Workstation on Windows from the `current` channel: ```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -channel current -project chef-workstation +. { iwr -useb https://chefdownload-trial.chef.io/stable/downloadScript?os_type=windows } | iex; install -channel stable -project inspec -version 6.6.0 ``` diff --git a/content/reusable/md/packages_install_script_options.md b/content/reusable/md/packages_install_script_options.md index 94ea36616d..be1b12324e 100644 --- a/content/reusable/md/packages_install_script_options.md +++ b/content/reusable/md/packages_install_script_options.md @@ -23,9 +23,8 @@ supports the following options: `-P` (`-project` on Windows) : The product name to install. Supported versions of Chef products are - `automate`, `chef`, `chef-server`, `inspec`, `chef-workstation`, - `chefdk`, `supermarket`, `chef-backend`, `push-jobs-client`, and - `push-jobs-server`. Default value: `chef`. + `chef`,`chef-backend`,`chef-server`, `inspec`, `chef-workstation`, `manage` and + `supermarket`, and Default value: `chef`. `-s` (`-install_strategy` on Windows) diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index 011ddea3b9..6778b0e55e 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,7 +1,18 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: ```bash -curl -L https://omnitruck.chef.io/install.sh | sudo bash +For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/stable/downloadScript?os_type=linux&license_id= + +For Trial Persona use curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=linux + +For Opensource Persona use curl https://chefdownload-community.chef.io/stable/downloadScript?os_type=linux +``` + +and then enter your licenseId in the place of license_id. + +Once script is download install script + +```bash +bash downloadScript ``` -and then enter the local password when prompted. diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 163ea05bbd..485b0e0206 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -2,5 +2,15 @@ On Windows systems, invoke the Chef Software Install script using Windows PowerShell: ```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install +For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/stable/downloadScript?os_type=windows&license_id= + +For Trial Persona use curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=windows + +For Opensource Persona use curl https://chefdownload-community.chef.io/stable/downloadScript?os_type=windows ``` +enter your licenseId in place of licenseId + +Once the script is download install using +```powershell +.\downloadScript +``` \ No newline at end of file From ac86825e9470a0dbcfc4dec8db12f9c74f75718c Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Thu, 18 Jul 2024 13:44:47 +0530 Subject: [PATCH 02/25] Added the changes for omnitruck changes Signed-off-by: vviveksharma --- .../docs-chef-io/content/server/upgrades.md | 2 ++ .../inspec/docs-chef-io/content/inspec/install.md | 12 +++--------- .../reusable/md/packages_install_script_examples.md | 4 ++-- .../md/packages_install_script_run_unix_linux.md | 6 +++--- .../md/packages_install_script_run_windows.md | 6 +++--- content/upgrade_client.md | 8 ++------ 6 files changed, 15 insertions(+), 23 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md index ce96f31e88..52ea1404eb 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md @@ -201,6 +201,8 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. the topology of your setup, your OS and distribution, and a range of other factors). For example: + Follow the Install Script for downloading the products + [Chef Software Install Script](/install_omnibus/) ```bash apt-get update diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 17d1ed7b6e..79e2e0c203 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -21,9 +21,7 @@ To see which platforms and platform versions Chef InSpec is supported on, see th You can install Chef InSpec using a curl script. -```bash -curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec -``` +- [Chef Software Install Script](/install_omnibus/) ## Windows @@ -36,9 +34,7 @@ then double-click on the `.msi` file to launch the installer and follow the prom You can install Chef InSpec using the following Powershell script. -```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project inspec -``` +- [Chef Software Install Script](/install_omnibus/) Once you have installed Chef InSpec, run `inspec version` to verify that the installation was successful. @@ -49,9 +45,7 @@ was successful. The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux: -```bash -curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec -``` +- [Chef Software Install Script](/install_omnibus/) If you prefer, you can use a package manager to install Chef InSpec. Once you downloaded the latest [Chef InSpec package](https://www.chef.io/downloads) diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md index 8e3622ca3c..29e8e18464 100644 --- a/content/reusable/md/packages_install_script_examples.md +++ b/content/reusable/md/packages_install_script_examples.md @@ -3,12 +3,12 @@ The following examples show how to use the Chef Software Install script. To install Chef Infra Client 15.8.23: ```bash -curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=linux | sudo bash -s -- -v 6.6.0 +curl -L https://chefdownload-trial.chef.io/install.sh | sudo bash -s -- -v 6.6.0 ``` To install the latest version of Chef Workstation on Windows from the `current` channel: ```powershell -. { iwr -useb https://chefdownload-trial.chef.io/stable/downloadScript?os_type=windows } | iex; install -channel stable -project inspec -version 6.6.0 +. { iwr -useb https://chefdownload-trial.chef.io/install.ps1 } | iex; install -channel stable -project inspec -version 6.6.0 ``` diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index 6778b0e55e..a7ddf0fb63 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,11 +1,11 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: ```bash -For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/stable/downloadScript?os_type=linux&license_id= +For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= -For Trial Persona use curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=linux +For Trial Persona use curl -L https://chefdownload-trial.chef.io/install.sh -For Opensource Persona use curl https://chefdownload-community.chef.io/stable/downloadScript?os_type=linux +For Opensource Persona use curl https://chefdownload-community.chef.io/install.sh ``` and then enter your licenseId in the place of license_id. diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 485b0e0206..2f717982b7 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -2,11 +2,11 @@ On Windows systems, invoke the Chef Software Install script using Windows PowerShell: ```powershell -For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/stable/downloadScript?os_type=windows&license_id= +For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/install.ps1?license_id= -For Trial Persona use curl -L https://chefdownload-trial.chef.io/stable/downloadScript?os_type=windows +For Trial Persona use curl -L https://chefdownload-trial.chef.io/install.ps1 -For Opensource Persona use curl https://chefdownload-community.chef.io/stable/downloadScript?os_type=windows +For Opensource Persona use curl -L https://chefdownload-community.chef.io/install.ps1 ``` enter your licenseId in place of licenseId diff --git a/content/upgrade_client.md b/content/upgrade_client.md index 7197e622d9..e8237cca3e 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -22,15 +22,11 @@ To upgrade Chef Infra Client on a node from the command line, run the install sc Linux, macOS, and Unix-based hosts: -```bash -curl -L https://chef.io/chef/install.sh | sudo bash -``` +- [Chef Software Install Script](/install_omnibus/) Windows hosts: -```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -``` +- [Chef Software Install Script](/install_omnibus/) ### Specifying the Version to Install From 62bf18f394a1923a00754630c9c9759771000a24 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 22 Jul 2024 13:14:32 +0530 Subject: [PATCH 03/25] removing linting issues Signed-off-by: vviveksharma --- content/reusable/md/packages_install_script_options.md | 2 +- content/reusable/md/packages_install_script_run_unix_linux.md | 1 - content/reusable/md/packages_install_script_run_windows.md | 4 +++- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/content/reusable/md/packages_install_script_options.md b/content/reusable/md/packages_install_script_options.md index be1b12324e..e8b05deb6b 100644 --- a/content/reusable/md/packages_install_script_options.md +++ b/content/reusable/md/packages_install_script_options.md @@ -23,7 +23,7 @@ supports the following options: `-P` (`-project` on Windows) : The product name to install. Supported versions of Chef products are - `chef`,`chef-backend`,`chef-server`, `inspec`, `chef-workstation`, `manage` and + `chef`,`chef-backend`,`chef-server`,`inspec`,`chef-workstation`,`manage` and `supermarket`, and Default value: `chef`. `-s` (`-install_strategy` on Windows) diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index a7ddf0fb63..040e02e47a 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -15,4 +15,3 @@ Once script is download install script ```bash bash downloadScript ``` - diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 2f717982b7..aee46ff471 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -8,9 +8,11 @@ For Trial Persona use curl -L https://chefdownload-trial.chef.io/install.ps1 For Opensource Persona use curl -L https://chefdownload-community.chef.io/install.ps1 ``` + enter your licenseId in place of licenseId Once the script is download install using + ```powershell .\downloadScript -``` \ No newline at end of file +``` From d7d2c59535dc51b275e2e366d09010d5289eddd9 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 22 Jul 2024 14:34:04 +0530 Subject: [PATCH 04/25] added refactored changes Signed-off-by: vviveksharma --- .../docs-chef-io/content/inspec/install.md | 18 ++++++++++++------ .../md/packages_install_script_examples.md | 8 +++++--- .../packages_install_script_run_unix_linux.md | 19 +++++++++++-------- .../md/packages_install_script_run_windows.md | 18 +++++++++++------- 4 files changed, 39 insertions(+), 24 deletions(-) diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 79e2e0c203..5553546a10 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -19,9 +19,11 @@ To see which platforms and platform versions Chef InSpec is supported on, see th ### CLI -You can install Chef InSpec using a curl script. +You can install Chef InSpec using a curl script. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) -- [Chef Software Install Script](/install_omnibus/) +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +``` ## Windows @@ -32,9 +34,11 @@ then double-click on the `.msi` file to launch the installer and follow the prom ### Powershell -You can install Chef InSpec using the following Powershell script. +You can install Chef InSpec using a powershell script. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) -- [Chef Software Install Script](/install_omnibus/) +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project inspec +``` Once you have installed Chef InSpec, run `inspec version` to verify that the installation was successful. @@ -43,9 +47,11 @@ was successful. ### CLI -The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux: +The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) -- [Chef Software Install Script](/install_omnibus/) +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 6.6.0 ``` To install the latest version of Chef Workstation on Windows from the `current` channel: ```powershell -. { iwr -useb https://chefdownload-trial.chef.io/install.ps1 } | iex; install -channel stable -project inspec -version 6.6.0 +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel stable -project inspec -version 6.6.0 ``` + +enter your licenseId in the place of YOUR LICENSE ID \ No newline at end of file diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index 040e02e47a..c31d2d0d48 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,17 +1,20 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: +- For Commercial Persona use ```bash -For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= - -For Trial Persona use curl -L https://chefdownload-trial.chef.io/install.sh - -For Opensource Persona use curl https://chefdownload-community.chef.io/install.sh +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash ``` -and then enter your licenseId in the place of license_id. +- For Trial Persona use -Once script is download install script +```bash +curl -L https://chefdownload-trial.chef.io/install.sh | sudo bash +``` +- For Commnunity Persona use ```bash -bash downloadScript +curl -L https://chefdownload-community.chef.io/install.sh | sudo bash ``` + +enter your licenseId in the place of YOUR LICENSE ID + diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index aee46ff471..3918dd5085 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -1,18 +1,22 @@ On Windows systems, invoke the Chef Software Install script using Windows PowerShell: +- For Commercial Persona use + ```powershell -For Commercial Persona use curl -L https://chefdownload-commercial.chef.io/install.ps1?license_id= +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install +``` -For Trial Persona use curl -L https://chefdownload-trial.chef.io/install.ps1 +- For Trial Persona use -For Opensource Persona use curl -L https://chefdownload-community.chef.io/install.ps1 +```powershell +. { iwr -useb https://chefdownload-trial.chef.io/install.ps1 } | iex; install ``` -enter your licenseId in place of licenseId - -Once the script is download install using +- For Commnunity Persona use ```powershell -.\downloadScript +. { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install ``` + +enter your licenseId in the place of YOUR LICENSE ID From 5ca583fdb227a7851c6214327fd73496b5c0ecb3 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 22 Jul 2024 14:44:24 +0530 Subject: [PATCH 05/25] added refactored changes Signed-off-by: vviveksharma --- content/reusable/md/packages_install_script_examples.md | 2 +- .../reusable/md/packages_install_script_run_unix_linux.md | 7 ++++--- content/reusable/md/packages_install_script_run_windows.md | 2 +- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md index f88f392d1e..1f7dc628e1 100644 --- a/content/reusable/md/packages_install_script_examples.md +++ b/content/reusable/md/packages_install_script_examples.md @@ -13,4 +13,4 @@ from the `current` channel: . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel stable -project inspec -version 6.6.0 ``` -enter your licenseId in the place of YOUR LICENSE ID \ No newline at end of file +enter your licenseId in the place of YOUR LICENSE ID diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index c31d2d0d48..3b6697a649 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,6 +1,7 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: -- For Commercial Persona use +- For Commercial Persona use + ```bash curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash ``` @@ -11,10 +12,10 @@ curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= Date: Thu, 25 Jul 2024 17:07:30 +0530 Subject: [PATCH 06/25] updated the docs with latest script changes Signed-off-by: vviveksharma --- .../docs-chef-io/content/server/upgrades.md | 6 ++---- content/install_chef_air_gap.md | 4 +++- content/upgrade_client.md | 20 ++++++++++++++----- 3 files changed, 20 insertions(+), 10 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md index 52ea1404eb..0007f911fc 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md @@ -194,15 +194,13 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. 1. Log into the Chef Infra Server machine. -1. Consult the documentation on [`knife-ec-backup`](https://blog.chef.io/migrating-chef-server-knife-ec-backup-knife-tidy). +1. Consult the documentation on [`knife-ec-backup`](https://blog.chef.io/migrating-chef-server-knife-ec-backup-knife-tidy).Please follow steps memntioned in this document for installing the product using the install.sh [Chef Software Install Script](/install_omnibus/) Install `knife-ec-backup`, if it not already installed. A sample session follows (note that your steps could differ, depending on the versions of your software, the topology of your setup, your OS and distribution, and a range of other factors). For example: - Follow the Install Script for downloading the products - [Chef Software Install Script](/install_omnibus/) ```bash apt-get update @@ -450,7 +448,7 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. Example: ```bash - /opt/chefdk/embedded/bin/knife ec restore /backup/ + /opt/chef/embedded/bin/knife ec restore /backup/ ``` 1. Do not continue upgrading PostgreSQL until you have an uncorrupted Chef Infra Server and an uncorrupted PostgreSQL database. diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index 473f4f37b8..645d4f37b9 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,13 +161,15 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `omnitruck.chef.io` with the URL of +4. Update `airgap.erb` to replace `https://chefdownload-commercial.chef.io/install.sh?license_id=` with the URL of `install.sh` on your artifact store: ```ruby install_sh="<%= knife_config[:bootstrap_url] ? knife_config[:bootstrap_url] : "http://packages.example.com/install.sh" %>" ``` + enter your licenseId in the place of YOUR LICENSE ID + 5. Still in your text editor, locate the following line near the bottom of your `airgap.erb` file: diff --git a/content/upgrade_client.md b/content/upgrade_client.md index e8237cca3e..7d7cb43942 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -20,28 +20,36 @@ The following sections describe the upgrade process for Chef Infra Client. If yo To upgrade Chef Infra Client on a node from the command line, run the install script to install the latest Chef Infra Client release: +Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/) + Linux, macOS, and Unix-based hosts: -- [Chef Software Install Script](/install_omnibus/) +```bash +curl -L https://chef.io/chef/install.sh | sudo bash +``` Windows hosts: -- [Chef Software Install Script](/install_omnibus/) +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install +``` ### Specifying the Version to Install The install script accepts arguments to allow installing specific versions of Chef Infra Client on systems. +Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/) + Linux, macOS, and Unix-based hosts: ```bash -curl -L https://chef.io/chef/install.sh | sudo bash -s -- -v 17.9.26 +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 ``` Windows hosts: ```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -version 17.9.26 +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 ``` ### Upgrading Multiple Hosts with Knife @@ -49,9 +57,11 @@ Windows hosts: The `knife ssh` command in Chef Workstation can be used to execute the install script on multiple Linux, macOS, and Unix-based hosts at once: ```bash -knife ssh 'name:*' 'curl -L https://chef.io/chef/install.sh | sudo bash' +knife ssh 'name:*' 'curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash' ``` +enter your licenseId in the place of YOUR LICENSE ID + ## Cookbook-Based Upgrade The [chef_client_updater](https://supermarket.chef.io/cookbooks/chef_client_updater) cookbook can be used to install or upgrade Chef Infra Client package on a node. From 2eb13070245cef689fe27bad8df2812c9b301fe2 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Fri, 26 Jul 2024 14:50:52 +0530 Subject: [PATCH 07/25] added notes Signed-off-by: vviveksharma --- .../docs-chef-io/content/server/upgrades.md | 3 ++- .../docs-chef-io/content/inspec/install.md | 17 ++++++++----- content/install_chef_air_gap.md | 6 ++--- .../md/packages_install_script_examples.md | 12 ++++++---- .../packages_install_script_run_unix_linux.md | 10 ++++---- .../md/packages_install_script_run_windows.md | 10 ++++---- content/upgrade_client.md | 24 ++++++++++++------- 7 files changed, 50 insertions(+), 32 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md index 0007f911fc..529afcc840 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md @@ -194,7 +194,8 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. 1. Log into the Chef Infra Server machine. -1. Consult the documentation on [`knife-ec-backup`](https://blog.chef.io/migrating-chef-server-knife-ec-backup-knife-tidy).Please follow steps memntioned in this document for installing the product using the install.sh [Chef Software Install Script](/install_omnibus/) +1. Consult the documentation on [`knife-ec-backup`](https://blog.chef.io/migrating-chef-server-knife-ec-backup-knife-tidy). + {{< note >}} Please follow steps mentioned in this documentation [Chef Software Install Script](/install_omnibus/). Enter your license id in place of ``{{< /note >}} Install `knife-ec-backup`, if it not already installed. A sample session follows (note that your steps could differ, depending on the versions of your software, diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 5553546a10..048a6b4fa4 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -19,10 +19,12 @@ To see which platforms and platform versions Chef InSpec is supported on, see th ### CLI -You can install Chef InSpec using a curl script. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) +You can install Chef InSpec using a curl script. + +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} ```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` ## Windows @@ -34,10 +36,12 @@ then double-click on the `.msi` file to launch the installer and follow the prom ### Powershell -You can install Chef InSpec using a powershell script. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) +You can install Chef InSpec using a powershell script. + +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} ```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project inspec +. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -project inspec ``` Once you have installed Chef InSpec, run `inspec version` to verify that the installation @@ -47,10 +51,11 @@ was successful. ### CLI -The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux. For more information please refer to this Document [Chef Software Install Script](/install_omnibus/) +The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux. +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} ```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` If you prefer, you can use a package manager to install Chef InSpec. diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index 645d4f37b9..ed41dee0a0 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,15 +161,15 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `https://chefdownload-commercial.chef.io/install.sh?license_id=` with the URL of +4. Update `airgap.erb` to replace `https://chefdownload-commericial.chef.io/install.sh?license_id=` with the URL of `install.sh` on your artifact store: + {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} + ```ruby install_sh="<%= knife_config[:bootstrap_url] ? knife_config[:bootstrap_url] : "http://packages.example.com/install.sh" %>" ``` - enter your licenseId in the place of YOUR LICENSE ID - 5. Still in your text editor, locate the following line near the bottom of your `airgap.erb` file: diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md index 1f7dc628e1..2ddbc73694 100644 --- a/content/reusable/md/packages_install_script_examples.md +++ b/content/reusable/md/packages_install_script_examples.md @@ -1,16 +1,18 @@ The following examples show how to use the Chef Software Install script. -To install Chef Inspec 6.6.0: +To install Infra Client 15.8.23: + +{{< note >}}Please replace `` with your licenseId.{{< /note >}} ```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 6.6.0 +curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 ``` To install the latest version of Chef Workstation on Windows from the `current` channel: +{{< note >}}Please replace `` with your licenseId.{{< /note >}} + ```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel stable -project inspec -version 6.6.0 +. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation ``` - -enter your licenseId in the place of YOUR LICENSE ID diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index 3b6697a649..e61d551260 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -2,14 +2,18 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: - For Commercial Persona use +{{< note >}}Please replace `` with your licenseId.{{< /note >}} + ```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash +curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash ``` - For Trial Persona use +{{< note >}}For Trial Persona license Id is not mandatory please add if you have one. Please replace `` with your licenseId.{{< /note >}} + ```bash -curl -L https://chefdownload-trial.chef.io/install.sh | sudo bash +curl -L https://chefdownload-trial.chef.io/install.sh?license_id= | sudo bash ``` - For Community Persona use @@ -17,5 +21,3 @@ curl -L https://chefdownload-trial.chef.io/install.sh | sudo bash ```bash curl -L https://chefdownload-community.chef.io/install.sh | sudo bash ``` - -enter your licenseId in the place of YOUR LICENSE ID diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 44aa2ada22..395388263f 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -3,14 +3,18 @@ Windows PowerShell: - For Commercial Persona use +{{< note >}}Please replace `` with your licenseId.{{< /note >}} + ```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install +. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install ``` - For Trial Persona use +{{< note >}}For Trial Persona licene Id is not mandatory please add if you have one. Please replace `` with your licenseId.{{< /note >}} + ```powershell -. { iwr -useb https://chefdownload-trial.chef.io/install.ps1 } | iex; install +. { iwr -useb https://chefdownload-trial.chef.io/install.ps1?license_id= } | iex; install ``` - For Community Persona use @@ -18,5 +22,3 @@ Windows PowerShell: ```powershell . { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install ``` - -enter your licenseId in the place of YOUR LICENSE ID diff --git a/content/upgrade_client.md b/content/upgrade_client.md index 7d7cb43942..dfbe2c2e4d 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -24,44 +24,50 @@ Please follow steps mentioned in this document [Chef Software Install Script](/i Linux, macOS, and Unix-based hosts: +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} + ```bash -curl -L https://chef.io/chef/install.sh | sudo bash +curl -L https://chefdownload-commericial.chef.io/install.sh?license_id=| sudo bash ``` Windows hosts: +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} + ```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install +. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install ``` ### Specifying the Version to Install The install script accepts arguments to allow installing specific versions of Chef Infra Client on systems. -Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/) - Linux, macOS, and Unix-based hosts: +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} + ```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 +curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 ``` Windows hosts: +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} + ```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 +. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 ``` ### Upgrading Multiple Hosts with Knife The `knife ssh` command in Chef Workstation can be used to execute the install script on multiple Linux, macOS, and Unix-based hosts at once: +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} + ```bash -knife ssh 'name:*' 'curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash' +knife ssh 'name:*' 'curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash' ``` -enter your licenseId in the place of YOUR LICENSE ID - ## Cookbook-Based Upgrade The [chef_client_updater](https://supermarket.chef.io/cookbooks/chef_client_updater) cookbook can be used to install or upgrade Chef Infra Client package on a node. From 3f5ff720209740ab819d7a6b16d82f18ca716bf4 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 5 Aug 2024 11:35:23 +0530 Subject: [PATCH 08/25] updated the docs Signed-off-by: vviveksharma --- .../docs-chef-io/content/server/upgrades.md | 3 +-- .../inspec/docs-chef-io/content/inspec/install.md | 11 +++-------- 2 files changed, 4 insertions(+), 10 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md index 529afcc840..ce96f31e88 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md @@ -195,7 +195,6 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. 1. Log into the Chef Infra Server machine. 1. Consult the documentation on [`knife-ec-backup`](https://blog.chef.io/migrating-chef-server-knife-ec-backup-knife-tidy). - {{< note >}} Please follow steps mentioned in this documentation [Chef Software Install Script](/install_omnibus/). Enter your license id in place of ``{{< /note >}} Install `knife-ec-backup`, if it not already installed. A sample session follows (note that your steps could differ, depending on the versions of your software, @@ -449,7 +448,7 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. Example: ```bash - /opt/chef/embedded/bin/knife ec restore /backup/ + /opt/chefdk/embedded/bin/knife ec restore /backup/ ``` 1. Do not continue upgrading PostgreSQL until you have an uncorrupted Chef Infra Server and an uncorrupted PostgreSQL database. diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 048a6b4fa4..9eaf1de253 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -21,10 +21,8 @@ To see which platforms and platform versions Chef InSpec is supported on, see th You can install Chef InSpec using a curl script. -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} - ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec ``` ## Windows @@ -38,10 +36,8 @@ then double-click on the `.msi` file to launch the installer and follow the prom You can install Chef InSpec using a powershell script. -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} - ```powershell -. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -project inspec +. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project inspec ``` Once you have installed Chef InSpec, run `inspec version` to verify that the installation @@ -52,10 +48,9 @@ was successful. ### CLI The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux. -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec ``` If you prefer, you can use a package manager to install Chef InSpec. From 4836f3a06e88220eaa824e1541fe1008cd316cb6 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 5 Aug 2024 11:38:13 +0530 Subject: [PATCH 09/25] updated the docs Signed-off-by: vviveksharma --- .../inspec/inspec/docs-chef-io/content/inspec/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 9eaf1de253..17d1ed7b6e 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -34,7 +34,7 @@ then double-click on the `.msi` file to launch the installer and follow the prom ### Powershell -You can install Chef InSpec using a powershell script. +You can install Chef InSpec using the following Powershell script. ```powershell . { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project inspec @@ -47,7 +47,7 @@ was successful. ### CLI -The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux. +The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux: ```bash curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec From 6cb9f0904499020015b2a8af5466fcfe576f54ba Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 5 Aug 2024 16:50:12 +0530 Subject: [PATCH 10/25] updated the licenseId note Signed-off-by: vviveksharma --- .../reusable/md/packages_install_script_run_unix_linux.md | 6 ++---- content/reusable/md/packages_install_script_run_windows.md | 6 ++---- 2 files changed, 4 insertions(+), 8 deletions(-) diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index e61d551260..7cc183b4a4 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,8 +1,8 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: -- For Commercial Persona use +{{< note >}}Please replace `` with your licenseId. For example license_id=testLicense01{{< /note >}} -{{< note >}}Please replace `` with your licenseId.{{< /note >}} +- For Commercial Persona use ```bash curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash @@ -10,8 +10,6 @@ curl -L https://chefdownload-commericial.chef.io/install.sh?license_id=}}For Trial Persona license Id is not mandatory please add if you have one. Please replace `` with your licenseId.{{< /note >}} - ```bash curl -L https://chefdownload-trial.chef.io/install.sh?license_id= | sudo bash ``` diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 395388263f..bfa6408e93 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -1,9 +1,9 @@ On Windows systems, invoke the Chef Software Install script using Windows PowerShell: -- For Commercial Persona use +{{< note >}}Please replace `` with your licenseId. For example license_id=testLicense01{{< /note >}} -{{< note >}}Please replace `` with your licenseId.{{< /note >}} +- For Commercial Persona use ```powershell . { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install @@ -11,8 +11,6 @@ Windows PowerShell: - For Trial Persona use -{{< note >}}For Trial Persona licene Id is not mandatory please add if you have one. Please replace `` with your licenseId.{{< /note >}} - ```powershell . { iwr -useb https://chefdownload-trial.chef.io/install.ps1?license_id= } | iex; install ``` From d40218cc3794b843930543401230014c94b47b97 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Wed, 7 Aug 2024 14:23:10 +0530 Subject: [PATCH 11/25] added new docs changes Signed-off-by: vviveksharma --- .../md/packages_install_script_run_unix_linux.md | 12 +++++------- .../md/packages_install_script_run_windows.md | 12 +++++------- 2 files changed, 10 insertions(+), 14 deletions(-) diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index 7cc183b4a4..e78a9c5cef 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -1,6 +1,10 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: -{{< note >}}Please replace `` with your licenseId. For example license_id=testLicense01{{< /note >}} +{{< note >}} +Please replace `` with your licenseId. You can get your license id from the +download portal [Chef Download Portal](https://chef.io/downloads). +Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d +{{< /note >}} - For Commercial Persona use @@ -8,12 +12,6 @@ On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash ``` -- For Trial Persona use - -```bash -curl -L https://chefdownload-trial.chef.io/install.sh?license_id= | sudo bash -``` - - For Community Persona use ```bash diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index bfa6408e93..39e6ef9e42 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -1,7 +1,11 @@ On Windows systems, invoke the Chef Software Install script using Windows PowerShell: -{{< note >}}Please replace `` with your licenseId. For example license_id=testLicense01{{< /note >}} +{{< note >}} +Please replace `` with your licenseId. You can get your license id from the +download portal [Chef Download Portal](https://chef.io/downloads). +Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d +{{< /note >}} - For Commercial Persona use @@ -9,12 +13,6 @@ Windows PowerShell: . { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install ``` -- For Trial Persona use - -```powershell -. { iwr -useb https://chefdownload-trial.chef.io/install.ps1?license_id= } | iex; install -``` - - For Community Persona use ```powershell From 0d819d37470288ae8250ecc812192e6b49cec965 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Thu, 8 Aug 2024 12:21:05 +0530 Subject: [PATCH 12/25] removed lines Signed-off-by: vviveksharma --- content/reusable/md/packages_install_script_run.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/reusable/md/packages_install_script_run.md b/content/reusable/md/packages_install_script_run.md index c3f452fe43..bec50dbbf8 100644 --- a/content/reusable/md/packages_install_script_run.md +++ b/content/reusable/md/packages_install_script_run.md @@ -1 +1 @@ -The Chef Software Install script can be run on UNIX, Linux, and Windows platforms. The terms 'omnibus' and 'omnitruck' are only relevant to the build processes used internally at Chef Software. +The Chef Software Install script can be run on UNIX, Linux, and Windows platforms. From 87486d99b6c25a88938ecc2eb090aa4df39ca24f Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Fri, 9 Aug 2024 13:13:40 +0530 Subject: [PATCH 13/25] updated the typo Signed-off-by: vviveksharma --- content/install_chef_air_gap.md | 4 ++-- .../md/packages_install_script_examples.md | 4 ++-- .../md/packages_install_script_run_unix_linux.md | 2 +- .../md/packages_install_script_run_windows.md | 2 +- content/upgrade_client.md | 16 ++++++++-------- 5 files changed, 14 insertions(+), 14 deletions(-) diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index ed41dee0a0..622acaf5d8 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,10 +161,10 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `https://chefdownload-commericial.chef.io/install.sh?license_id=` with the URL of +4. Update `airgap.erb` to replace `https://chefdownload-commerical.chef.io/install.sh?license_id=` with the URL of `install.sh` on your artifact store: - {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} + {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} ```ruby install_sh="<%= knife_config[:bootstrap_url] ? knife_config[:bootstrap_url] : "http://packages.example.com/install.sh" %>" diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md index 2ddbc73694..8aa443e319 100644 --- a/content/reusable/md/packages_install_script_examples.md +++ b/content/reusable/md/packages_install_script_examples.md @@ -5,7 +5,7 @@ To install Infra Client 15.8.23: {{< note >}}Please replace `` with your licenseId.{{< /note >}} ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 +curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 ``` To install the latest version of Chef Workstation on Windows @@ -14,5 +14,5 @@ from the `current` channel: {{< note >}}Please replace `` with your licenseId.{{< /note >}} ```powershell -. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation +. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation ``` diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md index e78a9c5cef..afd0f376a3 100644 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ b/content/reusable/md/packages_install_script_run_unix_linux.md @@ -9,7 +9,7 @@ Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d - For Commercial Persona use ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash +curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash ``` - For Community Persona use diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md index 39e6ef9e42..f4c3312740 100644 --- a/content/reusable/md/packages_install_script_run_windows.md +++ b/content/reusable/md/packages_install_script_run_windows.md @@ -10,7 +10,7 @@ Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d - For Commercial Persona use ```powershell -. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install +. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install ``` - For Community Persona use diff --git a/content/upgrade_client.md b/content/upgrade_client.md index dfbe2c2e4d..b83ad36f57 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -27,7 +27,7 @@ Linux, macOS, and Unix-based hosts: {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id=| sudo bash +curl -L https://chefdownload-commerical.chef.io/install.sh?license_id=| sudo bash ``` Windows hosts: @@ -35,7 +35,7 @@ Windows hosts: {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} ```powershell -. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install +. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install ``` ### Specifying the Version to Install @@ -44,28 +44,28 @@ The install script accepts arguments to allow installing specific versions of Ch Linux, macOS, and Unix-based hosts: -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} ```bash -curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 +curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 ``` Windows hosts: -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} ```powershell -. { iwr -useb https://chefdownload-commericial.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 +. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 ``` ### Upgrading Multiple Hosts with Knife The `knife ssh` command in Chef Workstation can be used to execute the install script on multiple Linux, macOS, and Unix-based hosts at once: -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId..{{< /note >}} +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} ```bash -knife ssh 'name:*' 'curl -L https://chefdownload-commericial.chef.io/install.sh?license_id= | sudo bash' +knife ssh 'name:*' 'curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash' ``` ## Cookbook-Based Upgrade From 53b910ba5dcc5c3cc33a860dd60af4e665f40e41 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Wed, 14 Aug 2024 12:31:22 +0530 Subject: [PATCH 14/25] reverted changes in airgap file Signed-off-by: vviveksharma --- content/install_chef_air_gap.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index 622acaf5d8..62c357bd38 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,11 +161,9 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `https://chefdownload-commerical.chef.io/install.sh?license_id=` with the URL of +4. Update `airgap.erb` to replace `https://omnitruck.chef.io/install.sh` with the URL of `install.sh` on your artifact store: - {{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} - ```ruby install_sh="<%= knife_config[:bootstrap_url] ? knife_config[:bootstrap_url] : "http://packages.example.com/install.sh" %>" ``` From f4476d0ccd85e6d03a024e14a1d19c6aad96710d Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Wed, 14 Aug 2024 12:31:57 +0530 Subject: [PATCH 15/25] reverted changes in airgap file Signed-off-by: vviveksharma --- content/install_chef_air_gap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index 62c357bd38..260a0944aa 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,7 +161,7 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `https://omnitruck.chef.io/install.sh` with the URL of +4. Update `airgap.erb` to replace `omnitruck.chef.io` with the URL of `install.sh` on your artifact store: ```ruby From 26a34e22d747c29be053e328f04241e65613ab02 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Wed, 14 Aug 2024 12:32:18 +0530 Subject: [PATCH 16/25] reverted changes in airgap file Signed-off-by: vviveksharma --- content/install_chef_air_gap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/install_chef_air_gap.md b/content/install_chef_air_gap.md index 260a0944aa..473f4f37b8 100644 --- a/content/install_chef_air_gap.md +++ b/content/install_chef_air_gap.md @@ -161,7 +161,7 @@ custom template, and then modify the package and Ruby gem sources. template file name, be sure to replace `airgap.erb` with the template file you created during the last step. -4. Update `airgap.erb` to replace `omnitruck.chef.io` with the URL of +4. Update `airgap.erb` to replace `omnitruck.chef.io` with the URL of `install.sh` on your artifact store: ```ruby From 82c14b6d7082ec295d2123b20323b8e556941242 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Wed, 21 Aug 2024 14:16:40 -0400 Subject: [PATCH 17/25] Editing Signed-off-by: Ian Maddaus --- content/chef_install_script.md | 189 +++++++++++++++++- content/download/commercial.md | 27 ++- content/download/community.md | 8 +- content/packages.md | 111 +++------- .../reusable/md/packages_install_script.md | 8 - .../md/packages_install_script_examples.md | 18 -- .../md/packages_install_script_options.md | 49 ----- .../md/packages_install_script_run.md | 1 - .../packages_install_script_run_unix_linux.md | 19 -- .../md/packages_install_script_run_windows.md | 20 -- content/reusable/md/release_channels.md | 8 + content/upgrade_client.md | 69 ++++--- 12 files changed, 276 insertions(+), 251 deletions(-) delete mode 100644 content/reusable/md/packages_install_script.md delete mode 100644 content/reusable/md/packages_install_script_examples.md delete mode 100644 content/reusable/md/packages_install_script_options.md delete mode 100644 content/reusable/md/packages_install_script_run.md delete mode 100644 content/reusable/md/packages_install_script_run_unix_linux.md delete mode 100644 content/reusable/md/packages_install_script_run_windows.md create mode 100644 content/reusable/md/release_channels.md diff --git a/content/chef_install_script.md b/content/chef_install_script.md index 155be7c485..f0d4f0949d 100644 --- a/content/chef_install_script.md +++ b/content/chef_install_script.md @@ -2,35 +2,202 @@ title = "Chef Software Install Script" draft = false gh_repo = "chef-web-docs" -aliases = ["/install_omnibus.html", "/install_omnibus/"] +aliases = ["/install_omnibus.html", "/install_omnibus/", "/chef_install_script/"] product = ["automate", "client", "server", "habitat", "inspec", "supermarket", "workstation"] [menu] [menu.overview] - title = "Chef Software Install Script" - identifier = "overview/packages_&_platforms/chef_install_script.md Install using Chef Software Install Script" + title = "Install Script" + identifier = "overview/packages_&_platforms/Install Script" parent = "overview/packages_&_platforms" weight = 40 +++ -{{< readfile file="content/reusable/md/packages_install_script.md" >}} +You can use the Chef Software install script to install +any Chef software---including Chef Infra Client, Chef Infra Server, and Chef InSpec---on UNIX, Linux, and Windows platforms. -## Run the Chef Software Install Script +This script does the following: -{{< readfile file="content/reusable/md/packages_install_script_run.md" >}} +- detects the platform, version, and architecture of the machine on which the installer is being executed +- fetches the appropriate package, for the requested product and version +- validates the package content by comparing SHA-256 checksums +- installs the package + +## Install using the Commercial API + +Commercial users can use the install script from the [Chef Commercial API](/download/commercial/) to install Chef software. + +### Prerequisites + +You must have a license ID to use the install script from the Chef Commercial API. You can get your license ID from the [Chef Downloads portal](https://chef.io/downloads). ### UNIX, Linux, and macOS -{{< readfile file="content/reusable/md/packages_install_script_run_unix_linux.md" >}} +Use the Chef install script to install packages on UNIX, Linux, and macOS systems: + +- By default the script installs the latest version of Chef Infra Client: + + ```bash + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash + ``` + + Replace `` with your license ID. + +- Use the `-p` option to specify a Chef software application to install: + + ```bash + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -p + ``` + + Replace: + + - `` with your license ID + - `` with the application you want to install + +For additional script install options, see the [script options](#script-options). ### Windows -{{< readfile file="content/reusable/md/packages_install_script_run_windows.md" >}} +On Windows systems, you can install Chef software using the Powershell install script. + +- By default the script installs the latest version of Chef Infra Client: + + ```powershell + . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install + ``` + + Replace `` with your license ID. + +- Use the `-project` option to specify a Chef software application to install: + + ```powershell + . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -project + ``` + + Replace: + + - `` with your license ID + - `` with the application you want to install + +For additional script install options, see the [script options](#script-options). + +## Install using the Community API + +Community users can use the install script from the [Chef Community API](/download/community/) to install Chef software. + +### UNIX, Linux, and macOS + +Use the Chef install script to install packages on UNIX, Linux, and macOS systems: + +- By default the script installs the latest available version of Chef Infra Client: + + ```bash + curl -L https://chefdownload-community.chef.io/install.sh | sudo bash + ``` + +- Use the `-p` option to specify a Chef application to install: + + ```bash + curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -p + ``` + + Replace `` with the application you want to install + +For additional script install options, see the [script options](#script-options). + +### Windows -## Chef Software Install Script Options +On Windows systems, you can install Chef software using the Powershell install script. -{{< readfile file="content/reusable/md/packages_install_script_options.md" >}} +- By default the script installs the latest available version of Chef Infra Client: + + ```powershell + . { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install + ``` + +- Use the `-project` option to specify a Chef application to install: + + ```powershell + . { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install -project + ``` + +For additional script install options, see the [script options](#script-options). + +## Script options + +In addition to the default install behavior, the Chef Software install script supports the following options: + +`-c` (`-channel` on Windows) + +: The [release channel](#release-channels) from which a package is pulled. + + The Commercial Download API supports the `current` or `stable` channels. + The Community Download API only supports the `stable` channel. + + Default value: `stable`. + +`-d` (`-download_directory` on Windows) + +: The directory into which a package is downloaded. When a package + already exists in this directory and the checksum matches, the + package is not re-downloaded. When `-d` and `-f` are not specified, + a package is downloaded to a temporary directory. + +`-f` (`-filename` on Windows) + +: The name of the file and the path at which that file is located. + When a filename already exists at this path and the checksum + matches, the package is not re-downloaded. When `-d` and `-f` are + not specified, a package is downloaded to a temporary directory. + +`-P` (`-project` on Windows) + +: The product name to install. Supported versions of Chef products are + `chef`,`chef-backend`,`chef-server`,`inspec`,`chef-workstation`,`manage` and + `supermarket`. Default value: `chef`. + +`-s` (`-install_strategy` on Windows) + +: The method of package installations. The default strategy is to + always install when the install.sh script runs. Set to "once" to + skip installation if the product is already installed on the node. + +`-l` (`-download_url_override` on Windows) + +: Install package downloaded from a direct URL. + +`-a` (`-checksum` on Windows) + +: The SHA256 for download_url_override + +`-v` (`-version` on Windows) + +: The version of the package to be installed. A version always takes + the form x.y.z, where x, y, and z are decimal numbers that are used + to represent major (x), minor (y), and patch (z) versions. A + two-part version (x.y) is also allowed. For more information about + application versioning, see . + +## Release channels + +{{< readfile file="content/reusable/md/release_channels.md" >}} ## Examples -{{< readfile file="content/reusable/md/packages_install_script_examples.md" >}} +The following examples show how to use the Chef Software install script. + +- Use the `-v` option to install Chef Infra Client 15.8.23 on Unix, Linux, or macOS hosts: + + ```bash + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 + ``` + + Replace `` with your license ID. + +- To install the latest version of Chef Workstation on Windows from the `current` channel: + + ```powershell + . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation + ``` + + Replace `` with your license ID. diff --git a/content/download/commercial.md b/content/download/commercial.md index 253494f90f..e32d109916 100644 --- a/content/download/commercial.md +++ b/content/download/commercial.md @@ -14,10 +14,12 @@ Commercial customers can use Chef's Commercial API to download Chef software pac ## License -You must use a license to download packages and review metadata with this API. -If you don't already have one, [contact Chef](https://www.chef.io/contact-us) to get a license. +You must use a license ID to download packages and review metadata with this API. -See [Chef's licensing documentation]({{< relref "chef_license" >}}) for more information on the Chef license. +You can get your license ID from the [Chef Downloads portal](https://chef.io/downloads), +or [contact Chef](https://www.chef.io/contact-us) if you don't already have one. + +See [Chef's licensing documentation]({{< relref "licensing" >}}) for more information on the Chef license. ## Endpoints @@ -118,7 +120,7 @@ https://chefdownload-commerical.chef.io///download?p=` -: The release channel to install from. See [Chef Software Packages](/packages/) for full details on the available channels. +: The release channel to install from. For the available channels, see [release channels](#release-channels). `` : The Chef Software product to install. @@ -164,11 +166,10 @@ The API accepts the following parameters in a query string. ## Chef product names -See the [Supported Versions]({{< relref "versions" >}}) documentation for information about the support status of individual products. - -This is a list of currently supported products that you can install with this API. +Use the following product keys to download packages or retrieve data for different Chef products. +You can also use the [products endpoint](#products) -| Product | Product Key | +| Product | Product key | | ------- | ------------ | | Chef Automate | automate | | Chef Infra Client | chef | @@ -180,17 +181,23 @@ This is a list of currently supported products that you can install with this AP | Management Console | manage | | Supermarket | supermarket | +See the [supported versions]({{< relref "versions" >}}) documentation for information about the support status of individual products. + +### Release channels + +{{< readfile file="content/reusable/md/release_channels.md" >}} + ## Examples ### Get the latest build To get the latest supported build of Chef Infra Client for Ubuntu 20.04, enter the following: -```plain +```sh https://chefdownload-commerical.chef.io/stable/chef/metadata?p=ubuntu&pv=20.04&m=x86_64&license_id= ``` -which will return something like: +which returns something like: ```json sha1 "8e8ae315d4695f9c95efc0a1437d2d453f7ab116" diff --git a/content/download/community.md b/content/download/community.md index c56937b25e..090a001843 100644 --- a/content/download/community.md +++ b/content/download/community.md @@ -65,7 +65,7 @@ https://chefdownload-community.chef.io/products?eol=true ### packages -Use `packages` to get a list of all packages for a particular release channel and product. +Use `packages` to get a list of all packages for a particular product. By default, it returns packages for the latest version. @@ -81,7 +81,7 @@ https://chefdownload-community.chef.io/stable//packages?v=/versions/all @@ -89,7 +89,7 @@ https://chefdownload-community.chef.io/stable//versions/all ### versions/latest -Use `versions/latest` to return the latest version of a product from a particular release channel. +Use `versions/latest` to return the latest version of a product. ```plain https://chefdownload-community.chef.io/stable//versions/latest @@ -153,7 +153,7 @@ The API accepts the following parameters in a query string. ## Chef product names -See the [Supported Versions]({{< relref "versions" >}}) documentation for information about the support status of individual products. +See the [Supported Versions documentation]({{< relref "versions" >}}) for information about the support status of individual products. This is a list of currently supported products that you can install with this API. diff --git a/content/packages.md b/content/packages.md index 1daee68705..bc0fd3a527 100644 --- a/content/packages.md +++ b/content/packages.md @@ -13,86 +13,61 @@ product = ["automate", "client", "server", "habitat", "inspec", "supermarket", " weight = 10 +++ -Packages for Chef Software products may be installed using -platform-native package repositories or the Chef Software Install script. Both -installation methods support the following release channels: - - ---- - - - - - - - - - - - - - - - - -
ChannelDescription
stableA build from this channel is an "official" release that has passed full user acceptance testing. Artifacts in this channel are retained indefinitely.
currentA build from this channel is an "integration" build that has passed full testing, but has not been officially released. Artifacts in this channel are retained for 30 days and then removed automatically.
- -Chef recommends using the stable channel when installing any of these -products on production systems. - -## Package Repositories - -The `stable` and `current` release channels support the following -package repositories: - -- Apt (Debian and Ubuntu platforms) +You can install packages for Chef Software products using platform-native package repositories. + +## Release channels + +{{< readfile file="content/reusable/md/release_channels.md" >}} + +## Package repositories + +The `stable` and `current` release channels support the following package repositories: + +- APT (Debian and Ubuntu platforms) - Yum (Enterprise Linux platforms) -Chef Software's GPG public key can be downloaded -[here](https://packages.chef.io/chef.asc). +You can download Chef Software's GPG public key from [packages.chef.io](https://packages.chef.io/chef.asc). ### Debian / Ubuntu -To set up an Apt package repository for Debian and Ubuntu platforms: +To set up an APT package repository for Debian and Ubuntu platforms: -1. Enable Apt to fetch packages over HTTPS: +1. Enable APT to fetch packages over HTTPS: ```bash sudo apt-get install apt-transport-https ``` -2. Install the public key for Chef Software: +1. Install the public key for Chef Software: ```bash wget -qO - https://packages.chef.io/chef.asc | sudo apt-key add - ``` -3. Create the Apt repository source file: +1. Create the APT repository source file: ```bash echo "deb https://packages.chef.io/repos/apt/ main" > chef-.list ``` - Replace `` with the release channel: `stable` or `current`. + Replace: - Replace `` with the appropriate distribution name: + - `` with the release channel: `stable` or `current`. + - `` with the appropriate distribution name. For example: - - For Debian 9: `stretch` - - For Debian 10: `buster` - - For Debian 11: `bullseye` - - For Ubuntu 18.04: `bionic` - - For Ubuntu 20.04: `focal` + - for Debian 9: `stretch` + - for Debian 10: `buster` + - for Debian 11: `bullseye` + - for Ubuntu 18.04: `bionic` + - for Ubuntu 20.04: `focal` -4. Update the package repository list: +1. Update the package repository list: ```bash sudo mv chef-stable.list /etc/apt/sources.list.d/ ``` -5. Update the cache for the package repository: +1. Update the cache for the package repository: ```bash sudo apt-get update @@ -108,7 +83,7 @@ To set up a Yum package repository for Enterprise Linux platforms: sudo rpm --import https://packages.chef.io/chef.asc ``` -2. Create the Yum repository source file: +1. Create the Yum repository source file: ```bash cat >chef-.repo <` with the release channel: `stable` or `current`. + Replace: - Replace `` with your Enterprise Linux version; the - allowable versions are `6`, `7`, or `8`. + - `` with the release channel: `stable` or `current`. + - `` with the version Enterprise Linux version. -3. Update the package repository list: +1. Update the package repository list: ```bash sudo yum-config-manager --add-repo chef-stable.repo @@ -141,27 +116,3 @@ To set up a Yum package repository for Enterprise Linux platforms: ```bash sudo mv chef-stable.repo /etc/yum.repos.d/ ``` - -## Chef Software Install Script - -{{< readfile file="content/reusable/md/packages_install_script.md" >}} - -### Run the Chef Software Install Script - -{{< readfile file="content/reusable/md/packages_install_script_run.md" >}} - -#### UNIX and Linux - -{{< readfile file="content/reusable/md/packages_install_script_run_unix_linux.md" >}} - -#### Windows - -{{< readfile file="content/reusable/md/packages_install_script_run_windows.md" >}} - -### Chef Software Install Script Options - -{{< readfile file="content/reusable/md/packages_install_script_options.md" >}} - -### Examples - -{{< readfile file="content/reusable/md/packages_install_script_examples.md" >}} diff --git a/content/reusable/md/packages_install_script.md b/content/reusable/md/packages_install_script.md deleted file mode 100644 index 86b331db55..0000000000 --- a/content/reusable/md/packages_install_script.md +++ /dev/null @@ -1,8 +0,0 @@ -The Chef Software install script can be used to install any Chef Software, including things like Chef Infra Client, Chef Infra Server, Chef InSpec. This script does the following: - -- Detects the platform, version, and architecture of the machine on - which the installer is being executed -- Fetches the appropriate package, for the requested product and - version -- Validates the package content by comparing SHA-256 checksums -- Installs the package diff --git a/content/reusable/md/packages_install_script_examples.md b/content/reusable/md/packages_install_script_examples.md deleted file mode 100644 index 8aa443e319..0000000000 --- a/content/reusable/md/packages_install_script_examples.md +++ /dev/null @@ -1,18 +0,0 @@ -The following examples show how to use the Chef Software Install script. - -To install Infra Client 15.8.23: - -{{< note >}}Please replace `` with your licenseId.{{< /note >}} - -```bash -curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 -``` - -To install the latest version of Chef Workstation on Windows -from the `current` channel: - -{{< note >}}Please replace `` with your licenseId.{{< /note >}} - -```powershell -. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation -``` diff --git a/content/reusable/md/packages_install_script_options.md b/content/reusable/md/packages_install_script_options.md deleted file mode 100644 index e8b05deb6b..0000000000 --- a/content/reusable/md/packages_install_script_options.md +++ /dev/null @@ -1,49 +0,0 @@ -In addition to the default install behavior, the Chef Software Install script -supports the following options: - -`-c` (`-channel` on Windows) - -: The release channel from which a package is pulled. Possible values: - `current` or `stable`. Default value: `stable`. - -`-d` (`-download_directory` on Windows) - -: The directory into which a package is downloaded. When a package - already exists in this directory and the checksum matches, the - package is not re-downloaded. When `-d` and `-f` are not specified, - a package is downloaded to a temporary directory. - -`-f` (`-filename` on Windows) - -: The name of the file and the path at which that file is located. - When a filename already exists at this path and the checksum - matches, the package is not re-downloaded. When `-d` and `-f` are - not specified, a package is downloaded to a temporary directory. - -`-P` (`-project` on Windows) - -: The product name to install. Supported versions of Chef products are - `chef`,`chef-backend`,`chef-server`,`inspec`,`chef-workstation`,`manage` and - `supermarket`, and Default value: `chef`. - -`-s` (`-install_strategy` on Windows) - -: The method of package installations. The default strategy is to - always install when the install.sh script runs. Set to "once" to - skip installation if the product is already installed on the node. - -`-l` (`-download_url_override` on Windows) - -: Install package downloaded from a direct URL. - -`-a` (`-checksum` on Windows) - -: The SHA256 for download_url_override - -`-v` (`-version` on Windows) - -: The version of the package to be installed. A version always takes - the form x.y.z, where x, y, and z are decimal numbers that are used - to represent major (x), minor (y), and patch (z) versions. A - two-part version (x.y) is also allowed. For more information about - application versioning, see . diff --git a/content/reusable/md/packages_install_script_run.md b/content/reusable/md/packages_install_script_run.md deleted file mode 100644 index bec50dbbf8..0000000000 --- a/content/reusable/md/packages_install_script_run.md +++ /dev/null @@ -1 +0,0 @@ -The Chef Software Install script can be run on UNIX, Linux, and Windows platforms. diff --git a/content/reusable/md/packages_install_script_run_unix_linux.md b/content/reusable/md/packages_install_script_run_unix_linux.md deleted file mode 100644 index afd0f376a3..0000000000 --- a/content/reusable/md/packages_install_script_run_unix_linux.md +++ /dev/null @@ -1,19 +0,0 @@ -On UNIX, Linux, and macOS systems, invoke the Chef Software Install script with: - -{{< note >}} -Please replace `` with your licenseId. You can get your license id from the -download portal [Chef Download Portal](https://chef.io/downloads). -Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d -{{< /note >}} - -- For Commercial Persona use - -```bash -curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -``` - -- For Community Persona use - -```bash -curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -``` diff --git a/content/reusable/md/packages_install_script_run_windows.md b/content/reusable/md/packages_install_script_run_windows.md deleted file mode 100644 index f4c3312740..0000000000 --- a/content/reusable/md/packages_install_script_run_windows.md +++ /dev/null @@ -1,20 +0,0 @@ -On Windows systems, invoke the Chef Software Install script using -Windows PowerShell: - -{{< note >}} -Please replace `` with your licenseId. You can get your license id from the -download portal [Chef Download Portal](https://chef.io/downloads). -Sample license Id example: de89a1c4-5fde-4fd7-9fd0-6e8307ca913d -{{< /note >}} - -- For Commercial Persona use - -```powershell -. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -``` - -- For Community Persona use - -```powershell -. { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install -``` diff --git a/content/reusable/md/release_channels.md b/content/reusable/md/release_channels.md new file mode 100644 index 0000000000..6c9efd0a2c --- /dev/null +++ b/content/reusable/md/release_channels.md @@ -0,0 +1,8 @@ +Chef releases packages from the following release channels: + +| Channel | Description | +|--- |--- | +| `stable` | A build from this channel is an "official" release that has passed full user acceptance testing. Artifacts in this channel are retained indefinitely. | +| `current`| A build from this channel is an "integration" build that has passed full testing, but has not been officially released. Artifacts in this channel are retained for 30 days and then removed automatically. | + +Chef recommends using the stable channel when installing any of these products on production systems. diff --git a/content/upgrade_client.md b/content/upgrade_client.md index b83ad36f57..db174f0077 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -16,58 +16,65 @@ aliases = ["/upgrade_client.html"] The following sections describe the upgrade process for Chef Infra Client. If you are also [upgrading the Chef Infra Server]({{< relref "/server/upgrades" >}}) complete that process **first** and **then** upgrade the Chef Infra Client. -## Command Line Upgrades +## Prerequisites -To upgrade Chef Infra Client on a node from the command line, run the install script to install the latest Chef Infra Client release: +Commercial users must have a license ID. You can get your license ID from the [Chef Downloads portal](https://chef.io/downloads). -Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/) +For community users, see the [Chef install script documentation](/chef_install_script/). -Linux, macOS, and Unix-based hosts: +## Command line upgrades -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} +Use the [Chef install script](/chef_install_script/) to upgrade to the latest version of Chef Infra Client on a node from the command line. -```bash -curl -L https://chefdownload-commerical.chef.io/install.sh?license_id=| sudo bash -``` +- On Linux, macOS, and Unix-based hosts: -Windows hosts: + ```bash + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash + ``` -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/).Please replace `` with your licenseId.{{< /note >}} + Replace `` with your license ID. -```powershell -. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -``` +- On Windows hosts: -### Specifying the Version to Install + ```powershell + . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install + ``` -The install script accepts arguments to allow installing specific versions of Chef Infra Client on systems. + Replace `` with your license ID. -Linux, macOS, and Unix-based hosts: +### Specify the install version -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} +You can install a specific version of Chef Infra Client using the [Chef install script](/chef_install_script/). -```bash -curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 -``` +- Use the `-v` option to install a specific version on Linux, macOS, and Unix-based hosts. For example: -Windows hosts: + ```bash + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 + ``` -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} + Replace `` with your license ID. -```powershell -. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 -``` +- Use the `-version` option to install a specific version on Windows hosts. For example: + + ```powershell + . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 + ``` -### Upgrading Multiple Hosts with Knife + Replace `` with your license ID. -The `knife ssh` command in Chef Workstation can be used to execute the install script on multiple Linux, macOS, and Unix-based hosts at once: +### Upgrade multiple hosts with knife -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} +You can use the [`knife ssh` command](/workstation/knife_ssh/) in Chef Workstation to execute the install script on multiple Linux, macOS, and Unix-based hosts at once. ```bash -knife ssh 'name:*' 'curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash' +knife ssh 'curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash' ``` -## Cookbook-Based Upgrade +Replace: + +- `` with your license ID +- `` with a [node search query](/chef_search/) + +## Cookbook-based upgrade -The [chef_client_updater](https://supermarket.chef.io/cookbooks/chef_client_updater) cookbook can be used to install or upgrade Chef Infra Client package on a node. +Use the [chef_client_updater cookbook](https://supermarket.chef.io/cookbooks/chef_client_updater) to install or upgrade Chef Infra Client on a node. From c344867787d8c613ec8e5d340a4bec4beca80358 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Wed, 21 Aug 2024 16:18:55 -0400 Subject: [PATCH 18/25] Update other docs with install script changes Signed-off-by: Ian Maddaus --- .../docs-chef-io/content/inspec/install.md | 16 +++++++++++++--- content/download/commercial.md | 4 ++++ go.mod | 2 +- go.sum | 4 ++-- 4 files changed, 20 insertions(+), 6 deletions(-) diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 17d1ed7b6e..583680107c 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -21,8 +21,10 @@ To see which platforms and platform versions Chef InSpec is supported on, see th You can install Chef InSpec using a curl script. +{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} + ```bash -curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec +curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` ## Windows @@ -37,9 +39,13 @@ then double-click on the `.msi` file to launch the installer and follow the prom You can install Chef InSpec using the following Powershell script. ```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project inspec +. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -project inspec ``` +Replace `` with your license ID. + +For more information about the install script, see the [Chef Install Script documentation](/chef_install_script/). + Once you have installed Chef InSpec, run `inspec version` to verify that the installation was successful. @@ -50,9 +56,13 @@ was successful. The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux: ```bash -curl https://omnitruck.chef.io/install.sh | sudo bash -s -- -P inspec +curl https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` +Replace `` with your license ID. + +For more information about the install script, see the [Chef Install Script documentation](/chef_install_script/). + If you prefer, you can use a package manager to install Chef InSpec. Once you downloaded the latest [Chef InSpec package](https://www.chef.io/downloads) relevant to your Linux-based platform, use the command for the respective package diff --git a/content/download/commercial.md b/content/download/commercial.md index e32d109916..2420b79941 100644 --- a/content/download/commercial.md +++ b/content/download/commercial.md @@ -12,6 +12,10 @@ gh_repo = "chef-web-docs" Commercial customers can use Chef's Commercial API to download Chef software packages and view software package metadata. +## Install script + +You can also use an install script from the API to download and install Chef packages. See the [Chef install script documentation](/chef_install_script/) for more information. + ## License You must use a license ID to download packages and review metadata with this API. diff --git a/go.mod b/go.mod index 733f3caba0..c7dc134194 100644 --- a/go.mod +++ b/go.mod @@ -20,7 +20,7 @@ require ( github.com/inspec/inspec-azure/docs-chef-io v0.0.0-20240122032234-c1394fc25525 // indirect github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd // indirect github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502 // indirect - github.com/inspec/inspec/docs-chef-io v0.0.0-20240725161417-9e8c62dc0c3f // indirect + github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9 // indirect github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30 // indirect github.com/swiftype/swiftype-search-jquery v1.1.0 // indirect github.com/twitter/hogan.js v3.0.2+incompatible // indirect diff --git a/go.sum b/go.sum index b99f9f9362..79f839534b 100644 --- a/go.sum +++ b/go.sum @@ -32,8 +32,8 @@ github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd/go.mod h1:Q4E7QBY4b7HDE2psfGT9jqvnLq1yfg5e9KWK4VTtI/M= github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502 h1:l3NT3O2TWWbp1XTeolWRNreLWoWornD4S8+h9uIVIc0= github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502/go.mod h1:JwjkNHKgELWxc9esXuK3ELEGL371pK496OKrK+te3Lk= -github.com/inspec/inspec/docs-chef-io v0.0.0-20240725161417-9e8c62dc0c3f h1:fYKOoUx0n7VTPDHF9aWh3W++5XrI6YfhqSDuZFbWZuo= -github.com/inspec/inspec/docs-chef-io v0.0.0-20240725161417-9e8c62dc0c3f/go.mod h1:k41HVhnK+v9/X2qCX+axYBM6eME3kFeatloWoMLxXQU= +github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9 h1:Suce6OvVbhpSSVvmSDNQ8oYlzl3BfcPSAsrMLygVWdU= +github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9/go.mod h1:k41HVhnK+v9/X2qCX+axYBM6eME3kFeatloWoMLxXQU= github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30 h1:dhqLFBINtD1rMwwd5s9INu4BkciCvQUd+r+CWUYWIB4= github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30/go.mod h1:qnxTyatkwE84LvoaQLPaLB4h5M3n6Q2z+SB/96DcAK8= github.com/swiftype/swiftype-search-jquery v1.1.0 h1:VRYyWPQtf3Vl3B5W2xQJuFVoUBlBFGQ4tOTu94b8mNU= From 99e8ce853a56f256aea9060a7952de37d923694e Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Fri, 23 Aug 2024 16:36:06 -0400 Subject: [PATCH 19/25] Reorganization Signed-off-by: Ian Maddaus --- content/chef_install_script.md | 10 +++++----- content/platforms.md | 4 ++-- content/reusable/md/release_channels.md | 2 +- content/versions.md | 6 +++--- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/content/chef_install_script.md b/content/chef_install_script.md index f0d4f0949d..21dd589f2c 100644 --- a/content/chef_install_script.md +++ b/content/chef_install_script.md @@ -1,16 +1,16 @@ +++ -title = "Chef Software Install Script" +title = "Chef Software install script" draft = false gh_repo = "chef-web-docs" -aliases = ["/install_omnibus.html", "/install_omnibus/", "/chef_install_script/"] +aliases = ["/install_omnibus.html", "/install_omnibus/"] product = ["automate", "client", "server", "habitat", "inspec", "supermarket", "workstation"] [menu] [menu.overview] - title = "Install Script" + title = "Install script" identifier = "overview/packages_&_platforms/Install Script" parent = "overview/packages_&_platforms" - weight = 40 + weight = 30 +++ You can use the Chef Software install script to install @@ -176,7 +176,7 @@ In addition to the default install behavior, the Chef Software install script su the form x.y.z, where x, y, and z are decimal numbers that are used to represent major (x), minor (y), and patch (z) versions. A two-part version (x.y) is also allowed. For more information about - application versioning, see . + application versioning, see [semver.org](https://semver.org/). ## Release channels diff --git a/content/platforms.md b/content/platforms.md index 1360bd17a3..ef801aebd9 100644 --- a/content/platforms.md +++ b/content/platforms.md @@ -1,5 +1,5 @@ +++ -title = "Platforms" +title = "Supported platforms" draft = false gh_repo = "chef-web-docs" aliases = ["/platforms.html", "/supported_platforms.html"] @@ -7,7 +7,7 @@ product = ["automate", "client", "server", "habitat", "inspec", "workstation"] [menu] [menu.overview] - title = "Platforms" + title = "Supported platforms" identifier = "overview/packages_&_platforms/platforms.md Platforms" parent = "overview/packages_&_platforms" weight = 20 diff --git a/content/reusable/md/release_channels.md b/content/reusable/md/release_channels.md index 6c9efd0a2c..ed3da0fa65 100644 --- a/content/reusable/md/release_channels.md +++ b/content/reusable/md/release_channels.md @@ -5,4 +5,4 @@ Chef releases packages from the following release channels: | `stable` | A build from this channel is an "official" release that has passed full user acceptance testing. Artifacts in this channel are retained indefinitely. | | `current`| A build from this channel is an "integration" build that has passed full testing, but has not been officially released. Artifacts in this channel are retained for 30 days and then removed automatically. | -Chef recommends using the stable channel when installing any of these products on production systems. +Use the stable channel when installing Chef products on production systems. diff --git a/content/versions.md b/content/versions.md index 93c8b31d80..a658d9a3e3 100644 --- a/content/versions.md +++ b/content/versions.md @@ -1,5 +1,5 @@ +++ -title = "Supported Versions" +title = "Supported versions" draft = false gh_repo = "chef-web-docs" aliases = ["/versions.html"] @@ -7,10 +7,10 @@ product = ["automate", "client", "server", "habitat", "inspec", "supermarket", " [menu] [menu.overview] - title = "Supported Versions" + title = "Supported versions" identifier = "overview/packages_&_platforms/versions.md Supported Versions" parent = "overview/packages_&_platforms" - weight = 30 + weight = 10 +++ This section lists the free and commercial Chef products and versions we From 27e4475d066bd0161d4055a3c8f42cee2dafe8b8 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 26 Aug 2024 17:56:30 +0530 Subject: [PATCH 20/25] added the correct flags Signed-off-by: vviveksharma --- content/chef_install_script.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/chef_install_script.md b/content/chef_install_script.md index 21dd589f2c..012292fa85 100644 --- a/content/chef_install_script.md +++ b/content/chef_install_script.md @@ -43,10 +43,10 @@ Use the Chef install script to install packages on UNIX, Linux, and macOS system Replace `` with your license ID. -- Use the `-p` option to specify a Chef software application to install: +- Use the `-P` option to specify a Chef software application to install: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -p + curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P ``` Replace: @@ -95,10 +95,10 @@ Use the Chef install script to install packages on UNIX, Linux, and macOS system curl -L https://chefdownload-community.chef.io/install.sh | sudo bash ``` -- Use the `-p` option to specify a Chef application to install: +- Use the `-P` option to specify a Chef application to install: ```bash - curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -p + curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -s -- -P ``` Replace `` with the application you want to install From e1d2d669fdbddc5d8870a7f97ea573c9e361376e Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Mon, 26 Aug 2024 14:16:04 -0400 Subject: [PATCH 21/25] Add more updates to inspec docs Signed-off-by: Ian Maddaus --- .../inspec/inspec/docs-chef-io/content/inspec/install.md | 6 ++++-- go.mod | 2 +- go.sum | 4 ++-- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 583680107c..9a9224aafe 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -21,12 +21,14 @@ To see which platforms and platform versions Chef InSpec is supported on, see th You can install Chef InSpec using a curl script. -{{< note >}}Please follow steps mentioned in this document [Chef Software Install Script](/install_omnibus/). Please replace `` with your licenseId.{{< /note >}} - ```bash curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` +Replace `` with your license ID. + +For more information about the install script, see the [Chef Install Script documentation](/chef_install_script/). + ## Windows ### Installer diff --git a/go.mod b/go.mod index c7dc134194..06239c182e 100644 --- a/go.mod +++ b/go.mod @@ -20,7 +20,7 @@ require ( github.com/inspec/inspec-azure/docs-chef-io v0.0.0-20240122032234-c1394fc25525 // indirect github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd // indirect github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502 // indirect - github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9 // indirect + github.com/inspec/inspec/docs-chef-io v0.0.0-20240826082411-e34d735e7a5f // indirect github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30 // indirect github.com/swiftype/swiftype-search-jquery v1.1.0 // indirect github.com/twitter/hogan.js v3.0.2+incompatible // indirect diff --git a/go.sum b/go.sum index 79f839534b..760f8cf94b 100644 --- a/go.sum +++ b/go.sum @@ -32,8 +32,8 @@ github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd github.com/inspec/inspec-habitat/docs-chef-io v0.0.0-20220218210405-bfd542da49fd/go.mod h1:Q4E7QBY4b7HDE2psfGT9jqvnLq1yfg5e9KWK4VTtI/M= github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502 h1:l3NT3O2TWWbp1XTeolWRNreLWoWornD4S8+h9uIVIc0= github.com/inspec/inspec-k8s/docs-chef-io v0.0.0-20240122032042-421355eaf502/go.mod h1:JwjkNHKgELWxc9esXuK3ELEGL371pK496OKrK+te3Lk= -github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9 h1:Suce6OvVbhpSSVvmSDNQ8oYlzl3BfcPSAsrMLygVWdU= -github.com/inspec/inspec/docs-chef-io v0.0.0-20240820101400-312d42a6c6d9/go.mod h1:k41HVhnK+v9/X2qCX+axYBM6eME3kFeatloWoMLxXQU= +github.com/inspec/inspec/docs-chef-io v0.0.0-20240826082411-e34d735e7a5f h1:UTHOiIMiMOKdbwMTLAeMfB//tiHQQSxpb01NMZP8ilo= +github.com/inspec/inspec/docs-chef-io v0.0.0-20240826082411-e34d735e7a5f/go.mod h1:k41HVhnK+v9/X2qCX+axYBM6eME3kFeatloWoMLxXQU= github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30 h1:dhqLFBINtD1rMwwd5s9INu4BkciCvQUd+r+CWUYWIB4= github.com/swiftype/swiftype-autocomplete-jquery v0.0.0-20190222215504-a90008d64b30/go.mod h1:qnxTyatkwE84LvoaQLPaLB4h5M3n6Q2z+SB/96DcAK8= github.com/swiftype/swiftype-search-jquery v1.1.0 h1:VRYyWPQtf3Vl3B5W2xQJuFVoUBlBFGQ4tOTu94b8mNU= From adc73ba78342b46bf20ec550bd1920849252f4e9 Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Mon, 9 Sep 2024 14:45:06 +0530 Subject: [PATCH 22/25] updated the production url spellings Signed-off-by: vviveksharma --- .../docs-chef-io/content/inspec/install.md | 6 ++-- content/chef_install_script.md | 12 ++++---- content/download/commercial.md | 28 +++++++++---------- content/upgrade_client.md | 10 +++---- 4 files changed, 28 insertions(+), 28 deletions(-) diff --git a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md index 9a9224aafe..e191330991 100644 --- a/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md +++ b/_vendor/github.com/inspec/inspec/docs-chef-io/content/inspec/install.md @@ -22,7 +22,7 @@ To see which platforms and platform versions Chef InSpec is supported on, see th You can install Chef InSpec using a curl script. ```bash -curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` Replace `` with your license ID. @@ -41,7 +41,7 @@ then double-click on the `.msi` file to launch the installer and follow the prom You can install Chef InSpec using the following Powershell script. ```powershell -. { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -project inspec +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project inspec ``` Replace `` with your license ID. @@ -58,7 +58,7 @@ was successful. The following curl script will install Chef InSpec for Ubuntu and Red Hat Enterprise Linux: ```bash -curl https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec +curl https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P inspec ``` Replace `` with your license ID. diff --git a/content/chef_install_script.md b/content/chef_install_script.md index 012292fa85..1880ee8f53 100644 --- a/content/chef_install_script.md +++ b/content/chef_install_script.md @@ -38,7 +38,7 @@ Use the Chef install script to install packages on UNIX, Linux, and macOS system - By default the script installs the latest version of Chef Infra Client: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash ``` Replace `` with your license ID. @@ -46,7 +46,7 @@ Use the Chef install script to install packages on UNIX, Linux, and macOS system - Use the `-P` option to specify a Chef software application to install: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P ``` Replace: @@ -63,7 +63,7 @@ On Windows systems, you can install Chef software using the Powershell install s - By default the script installs the latest version of Chef Infra Client: ```powershell - . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install + . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install ``` Replace `` with your license ID. @@ -71,7 +71,7 @@ On Windows systems, you can install Chef software using the Powershell install s - Use the `-project` option to specify a Chef software application to install: ```powershell - . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -project + . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project ``` Replace: @@ -189,7 +189,7 @@ The following examples show how to use the Chef Software install script. - Use the `-v` option to install Chef Infra Client 15.8.23 on Unix, Linux, or macOS hosts: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 ``` Replace `` with your license ID. @@ -197,7 +197,7 @@ The following examples show how to use the Chef Software install script. - To install the latest version of Chef Workstation on Windows from the `current` channel: ```powershell - . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation + . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation ``` Replace `` with your license ID. diff --git a/content/download/commercial.md b/content/download/commercial.md index 2420b79941..19edbcd217 100644 --- a/content/download/commercial.md +++ b/content/download/commercial.md @@ -46,7 +46,7 @@ The `architectures` endpoint returns a valid list of architecture that Chef prod Any of these architectures can be used in the `m` [query string](#parameters) value in various endpoints below. ```plain -https://chefdownload-commerical.chef.io/architectures +https://chefdownload-commercial.chef.io/architectures ``` ### platforms @@ -54,7 +54,7 @@ https://chefdownload-commerical.chef.io/architectures The `platforms` endpoint returns a list of valid platform keys along with full friendly names. Any of these platform keys can be used in the `p` [query string](#parameters) value in various endpoints below. ```plain -https://chefdownload-commerical.chef.io/platforms +https://chefdownload-commercial.chef.io/platforms ``` ### products @@ -62,13 +62,13 @@ https://chefdownload-commerical.chef.io/platforms The `products` endpoint returns a list of valid product keys. In the following endpoints, you can replace the `` string with a product key in the response of this endpoint. ```plain -https://chefdownload-commerical.chef.io/products +https://chefdownload-commercial.chef.io/products ``` Use `eol=true` to return EOL products. ```plain -https://chefdownload-commerical.chef.io/products?eol=true +https://chefdownload-commercial.chef.io/products?eol=true ``` ### packages @@ -78,13 +78,13 @@ Use `packages` to get a full list of all packages for a particular release chann By default, it returns packages for the latest version. ```plain -https://chefdownload-commerical.chef.io///packages?license_id= +https://chefdownload-commercial.chef.io///packages?license_id= ``` You can specify a version number with the `v` query string to get packages for a particular product version. ```plain -https://chefdownload-commerical.chef.io///packages?v=&license_id= +https://chefdownload-commercial.chef.io///packages?v=&license_id= ``` ### versions/all @@ -92,7 +92,7 @@ https://chefdownload-commerical.chef.io///packages?v=//versions/all?license_id= +https://chefdownload-commercial.chef.io///versions/all?license_id= ``` ### versions/latest @@ -100,7 +100,7 @@ https://chefdownload-commerical.chef.io///versions/all?license Use `versions/latest` to return the latest version of a product from a particular release channel. ```plain -https://chefdownload-commerical.chef.io///versions/latest?license_id= +https://chefdownload-commercial.chef.io///versions/latest?license_id= ``` ### metadata @@ -108,7 +108,7 @@ https://chefdownload-commerical.chef.io///versions/latest?lice The `metadata` endpoint returns data about a particular package of a Chef product. ```plain -https://chefdownload-commerical.chef.io///metadata?p=&pv=&m=&v=&license_id= +https://chefdownload-commercial.chef.io///metadata?p=&pv=&m=&v=&license_id= ``` ### download @@ -116,7 +116,7 @@ https://chefdownload-commerical.chef.io///metadata?p=//download?p=&pv=&m=&v=&license_id= +https://chefdownload-commercial.chef.io///download?p=&pv=&m=&v=&license_id= ``` ## Parameters @@ -198,7 +198,7 @@ See the [supported versions]({{< relref "versions" >}}) documentation for inform To get the latest supported build of Chef Infra Client for Ubuntu 20.04, enter the following: ```sh -https://chefdownload-commerical.chef.io/stable/chef/metadata?p=ubuntu&pv=20.04&m=x86_64&license_id= +https://chefdownload-commercial.chef.io/stable/chef/metadata?p=ubuntu&pv=20.04&m=x86_64&license_id= ``` which returns something like: @@ -206,7 +206,7 @@ which returns something like: ```json sha1 "8e8ae315d4695f9c95efc0a1437d2d453f7ab116" sha256 "86f14ae08237b4e24201436ecb83c08c29b68aed1d6ede0953a1b4547a920e36" -url "https://chefdownload-commerical.chef.io/stable/chef/download?license_id=&m=x86_64&p=ubuntu&pv=20.04" +url "https://chefdownload-commercial.chef.io/stable/chef/download?license_id=&m=x86_64&p=ubuntu&pv=20.04" version "18.2.7" ``` @@ -215,11 +215,11 @@ version "18.2.7" To use cURL to download a package directly, enter the following: ```bash -curl -LOJ 'https://chefdownload-commerical.chef.io///download?p=&pv=&m=&license_id=' +curl -LOJ 'https://chefdownload-commercial.chef.io///download?p=&pv=&m=&license_id=' ``` To use GNU Wget to download a package directly, enter the following: ```bash -wget --content-disposition https://chefdownload-commerical.chef.io///download?p=&pv=&m=&license_id= +wget --content-disposition https://chefdownload-commercial.chef.io///download?p=&pv=&m=&license_id= ``` diff --git a/content/upgrade_client.md b/content/upgrade_client.md index db174f0077..b8d0bc48b1 100644 --- a/content/upgrade_client.md +++ b/content/upgrade_client.md @@ -29,7 +29,7 @@ Use the [Chef install script](/chef_install_script/) to upgrade to the latest ve - On Linux, macOS, and Unix-based hosts: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash ``` Replace `` with your license ID. @@ -37,7 +37,7 @@ Use the [Chef install script](/chef_install_script/) to upgrade to the latest ve - On Windows hosts: ```powershell - . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install + . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install ``` Replace `` with your license ID. @@ -49,7 +49,7 @@ You can install a specific version of Chef Infra Client using the [Chef install - Use the `-v` option to install a specific version on Linux, macOS, and Unix-based hosts. For example: ```bash - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 17.9.26 ``` Replace `` with your license ID. @@ -57,7 +57,7 @@ You can install a specific version of Chef Infra Client using the [Chef install - Use the `-version` option to install a specific version on Windows hosts. For example: ```powershell - . { iwr -useb https://chefdownload-commerical.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 + . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -version 17.9.26 ``` Replace `` with your license ID. @@ -67,7 +67,7 @@ You can install a specific version of Chef Infra Client using the [Chef install You can use the [`knife ssh` command](/workstation/knife_ssh/) in Chef Workstation to execute the install script on multiple Linux, macOS, and Unix-based hosts at once. ```bash -knife ssh 'curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash' +knife ssh 'curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash' ``` Replace: From 6b356441a122bfa64ac7e013bc8a9c74e4285b3f Mon Sep 17 00:00:00 2001 From: vviveksharma Date: Wed, 11 Sep 2024 22:16:59 +0530 Subject: [PATCH 23/25] rebased the branch Signed-off-by: vviveksharma --- .../chef/chef-server/docs-chef-io/content/server/upgrades.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md index ce96f31e88..9ea7f451a9 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/upgrades.md @@ -206,7 +206,7 @@ The following External PostgreSQL upgrade steps are provided as a courtesy only. apt-get update apt install ruby apt install make - curl -L https://chefdownload-commerical.chef.io/install.sh?license_id= | sudo bash -s -- -P chef-workstation + curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P chef-workstation export PATH=$PATH:/root/.chef-workstation/gem/ruby/2.6.0/bin apt-get -y install gcc postgresql libpq-dev /opt/chef-workstation/embedded/bin/gem install knife-ec-backup -- --with-pg-config=/opt/opscode/embedded/postgresql/9.6/bin/pg_config From 2db17e6b165c6c87b44e9640c2060f8328167eb3 Mon Sep 17 00:00:00 2001 From: sandhi Date: Thu, 12 Sep 2024 21:28:29 +0530 Subject: [PATCH 24/25] URL typo fixes Signed-off-by: sandhi --- content/download/commercial.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/content/download/commercial.md b/content/download/commercial.md index 253494f90f..436a54a992 100644 --- a/content/download/commercial.md +++ b/content/download/commercial.md @@ -40,7 +40,7 @@ The `architectures` endpoint returns a valid list of architecture that Chef prod Any of these architectures can be used in the `m` [query string](#parameters) value in various endpoints below. ```plain -https://chefdownload-commerical.chef.io/architectures +https://chefdownload-commercial.chef.io/architectures ``` ### platforms @@ -48,7 +48,7 @@ https://chefdownload-commerical.chef.io/architectures The `platforms` endpoint returns a list of valid platform keys along with full friendly names. Any of these platform keys can be used in the `p` [query string](#parameters) value in various endpoints below. ```plain -https://chefdownload-commerical.chef.io/platforms +https://chefdownload-commercial.chef.io/platforms ``` ### products @@ -56,13 +56,13 @@ https://chefdownload-commerical.chef.io/platforms The `products` endpoint returns a list of valid product keys. In the following endpoints, you can replace the `` string with a product key in the response of this endpoint. ```plain -https://chefdownload-commerical.chef.io/products +https://chefdownload-commercial.chef.io/products ``` Use `eol=true` to return EOL products. ```plain -https://chefdownload-commerical.chef.io/products?eol=true +https://chefdownload-commercial.chef.io/products?eol=true ``` ### packages @@ -72,13 +72,13 @@ Use `packages` to get a full list of all packages for a particular release chann By default, it returns packages for the latest version. ```plain -https://chefdownload-commerical.chef.io///packages?license_id= +https://chefdownload-commercial.chef.io///packages?license_id= ``` You can specify a version number with the `v` query string to get packages for a particular product version. ```plain -https://chefdownload-commerical.chef.io///packages?v=&license_id= +https://chefdownload-commercial.chef.io///packages?v=&license_id= ``` ### versions/all @@ -86,7 +86,7 @@ https://chefdownload-commerical.chef.io///packages?v=//versions/all?license_id= +https://chefdownload-commercial.chef.io///versions/all?license_id= ``` ### versions/latest @@ -94,7 +94,7 @@ https://chefdownload-commerical.chef.io///versions/all?license Use `versions/latest` to return the latest version of a product from a particular release channel. ```plain -https://chefdownload-commerical.chef.io///versions/latest?license_id= +https://chefdownload-commercial.chef.io///versions/latest?license_id= ``` ### metadata @@ -102,7 +102,7 @@ https://chefdownload-commerical.chef.io///versions/latest?lice The `metadata` endpoint returns data about a particular package of a Chef product. ```plain -https://chefdownload-commerical.chef.io///metadata?p=&pv=&m=&v=&license_id= +https://chefdownload-commercial.chef.io///metadata?p=&pv=&m=&v=&license_id= ``` ### download @@ -110,7 +110,7 @@ https://chefdownload-commerical.chef.io///metadata?p=//download?p=&pv=&m=&v=&license_id= +https://chefdownload-commercial.chef.io///download?p=&pv=&m=&v=&license_id= ``` ## Parameters @@ -187,7 +187,7 @@ This is a list of currently supported products that you can install with this AP To get the latest supported build of Chef Infra Client for Ubuntu 20.04, enter the following: ```plain -https://chefdownload-commerical.chef.io/stable/chef/metadata?p=ubuntu&pv=20.04&m=x86_64&license_id= +https://chefdownload-commercial.chef.io/stable/chef/metadata?p=ubuntu&pv=20.04&m=x86_64&license_id= ``` which will return something like: @@ -195,7 +195,7 @@ which will return something like: ```json sha1 "8e8ae315d4695f9c95efc0a1437d2d453f7ab116" sha256 "86f14ae08237b4e24201436ecb83c08c29b68aed1d6ede0953a1b4547a920e36" -url "https://chefdownload-commerical.chef.io/stable/chef/download?license_id=&m=x86_64&p=ubuntu&pv=20.04" +url "https://chefdownload-commercial.chef.io/stable/chef/download?license_id=&m=x86_64&p=ubuntu&pv=20.04" version "18.2.7" ``` @@ -204,11 +204,11 @@ version "18.2.7" To use cURL to download a package directly, enter the following: ```bash -curl -LOJ 'https://chefdownload-commerical.chef.io///download?p=&pv=&m=&license_id=' +curl -LOJ 'https://chefdownload-commercial.chef.io///download?p=&pv=&m=&license_id=' ``` To use GNU Wget to download a package directly, enter the following: ```bash -wget --content-disposition https://chefdownload-commerical.chef.io///download?p=&pv=&m=&license_id= +wget --content-disposition https://chefdownload-commercial.chef.io///download?p=&pv=&m=&license_id= ``` From cd4584444c569e3c7801bf14dc1a2af739961969 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Thu, 19 Sep 2024 15:21:59 -0400 Subject: [PATCH 25/25] Minor changes Signed-off-by: Ian Maddaus --- content/chef_install_script.md | 112 ++++++++++++++++----------------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/content/chef_install_script.md b/content/chef_install_script.md index 1880ee8f53..55b60d8bc7 100644 --- a/content/chef_install_script.md +++ b/content/chef_install_script.md @@ -18,10 +18,10 @@ any Chef software---including Chef Infra Client, Chef Infra Server, and Chef InS This script does the following: -- detects the platform, version, and architecture of the machine on which the installer is being executed -- fetches the appropriate package, for the requested product and version -- validates the package content by comparing SHA-256 checksums -- installs the package +- Detects the platform, version, and architecture of the machine on which the installer is being executed. +- Fetches the appropriate package, for the requested product and version. +- Validates the package content by comparing SHA-256 checksums. +- Installs the package. ## Install using the Commercial API @@ -35,24 +35,24 @@ You must have a license ID to use the install script from the Chef Commercial AP Use the Chef install script to install packages on UNIX, Linux, and macOS systems: -- By default the script installs the latest version of Chef Infra Client: +By default the script installs the latest version of Chef Infra Client: - ```bash - curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash - ``` +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash +``` - Replace `` with your license ID. +Replace `` with your license ID. -- Use the `-P` option to specify a Chef software application to install: +Use the `-P` option to specify a Chef software application to install: - ```bash - curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P - ``` +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -P +``` - Replace: +Replace: - - `` with your license ID - - `` with the application you want to install +- `` with your license ID +- `` with the application you want to install For additional script install options, see the [script options](#script-options). @@ -60,24 +60,24 @@ For additional script install options, see the [script options](#script-options) On Windows systems, you can install Chef software using the Powershell install script. -- By default the script installs the latest version of Chef Infra Client: +By default the script installs the latest version of Chef Infra Client: - ```powershell - . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install - ``` +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install +``` - Replace `` with your license ID. +Replace `` with your license ID. -- Use the `-project` option to specify a Chef software application to install: +Use the `-project` option to specify a Chef software application to install: - ```powershell - . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project - ``` +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project +``` - Replace: +Replace: - - `` with your license ID - - `` with the application you want to install +- `` with your license ID +- `` with the application you want to install For additional script install options, see the [script options](#script-options). @@ -87,21 +87,21 @@ Community users can use the install script from the [Chef Community API](/downlo ### UNIX, Linux, and macOS -Use the Chef install script to install packages on UNIX, Linux, and macOS systems: +Use the Chef install script to install packages on UNIX, Linux, and macOS systems. -- By default the script installs the latest available version of Chef Infra Client: +By default the script installs the latest available version of Chef Infra Client: - ```bash - curl -L https://chefdownload-community.chef.io/install.sh | sudo bash - ``` +```bash +curl -L https://chefdownload-community.chef.io/install.sh | sudo bash +``` -- Use the `-P` option to specify a Chef application to install: +Use the `-P` option to specify a Chef application to install: - ```bash - curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -s -- -P - ``` +```bash +curl -L https://chefdownload-community.chef.io/install.sh | sudo bash -s -- -P +``` - Replace `` with the application you want to install +Replace `` with the application you want to install. For additional script install options, see the [script options](#script-options). @@ -109,17 +109,17 @@ For additional script install options, see the [script options](#script-options) On Windows systems, you can install Chef software using the Powershell install script. -- By default the script installs the latest available version of Chef Infra Client: +By default the script installs the latest available version of Chef Infra Client: - ```powershell - . { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install - ``` +```powershell +. { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install +``` -- Use the `-project` option to specify a Chef application to install: +Use the `-project` option to specify a Chef application to install: - ```powershell - . { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install -project - ``` +```powershell +. { iwr -useb https://chefdownload-community.chef.io/install.ps1 } | iex; install -project +``` For additional script install options, see the [script options](#script-options). @@ -186,18 +186,18 @@ In addition to the default install behavior, the Chef Software install script su The following examples show how to use the Chef Software install script. -- Use the `-v` option to install Chef Infra Client 15.8.23 on Unix, Linux, or macOS hosts: +Use the `-v` option to install Chef Infra Client 15.8.23 on Unix, Linux, or macOS hosts: - ```bash - curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 - ``` +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -s -- -v 15.8.23 +``` - Replace `` with your license ID. +Replace `` with your license ID. -- To install the latest version of Chef Workstation on Windows from the `current` channel: +To install the latest version of Chef Workstation on Windows from the `current` channel: - ```powershell - . { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation - ``` +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -channel current -project chef-workstation +``` - Replace `` with your license ID. +Replace `` with your license ID.