From 421881e3bec720c7b867bc3de5b87761c1078c18 Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Thu, 28 May 2026 15:05:38 +0530 Subject: [PATCH 01/12] Update Automate, Infra Server, Manage, and Desktop docs with new download endpoints Replace deprecated packages.chef.io and omnitruck.chef.io with new commercial and community download API endpoints. Signed-off-by: Ritvik Patil --- .../content/server/ctl_chef_server.md | 2 +- .../content/server/install_server_tiered.md | 5 ++-- ...l_chef_server_install_features_download.md | 4 ++-- .../content/desktop/automate_server.md | 13 +++++++++- .../docs-chef-io/content/desktop/nodes.md | 24 +++++++++++++++++-- content/automate/ha_common.md | 2 +- content/automate/node_integrations.md | 2 +- 7 files changed, 41 insertions(+), 11 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md index 3269fcd01c..8845a66169 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md @@ -141,7 +141,7 @@ This subcommand has the following options: : Use to specify the location of a package. This option is not required when packages are downloaded from - . + (commercial users) or (community users). ### Use Downloads diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md index aec8db55e4..af096375df 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md @@ -273,9 +273,8 @@ first downloaded to a local directory, and then installed. **Use Downloads** -The `install` subcommand downloads packages from - by default. For systems that are not behind -a firewall (and have connectivity to ), the +The `install` subcommand downloads packages from the Chef download API by default ( for commercial users or for community users). For systems that are not behind +a firewall (and have connectivity to the Chef download API), the Chef management console package can be installed as described below: Chef Manage diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md index 6bdc669661..2495f25ab9 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md @@ -1,5 +1,5 @@ -The `install` subcommand downloads packages from by default. -For systems that are not behind a firewall (and have connectivity to ), these packages can be installed as described below. +The `install` subcommand downloads packages from the Chef download API by default ( for commercial users or for community users). +For systems that are not behind a firewall (and have connectivity to the Chef download API), these packages can be installed as described below. 1. Install add-ons diff --git a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md index 062724c4cc..6238e2d10a 100644 --- a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md +++ b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md @@ -39,8 +39,19 @@ sysctl -w vm.dirty_expire_centisecs=20000 Download the Chef Automate CLI: +**For commercial license users:** + +```bash +curl -L "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate +chmod +x chef-automate +``` + +Replace `` with your commercial license ID. + +**For community/trial license users:** + ```bash -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate +curl -L "https://chefdownload-community.chef.io/stable/automate/download?p=linux&m=x86_64" -o chef-automate chmod +x chef-automate ``` diff --git a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md index 7597bdf02b..5c58a37fc4 100644 --- a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md +++ b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md @@ -44,16 +44,36 @@ Go to your test node and install the Chef Infra Client from an elevated PowerShe #### On Windows +**For commercial license users:** + +```powershell +. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project chef +``` + +**For community/trial license users:** + ```powershell -. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project chef +. { iwr -useb https://chefdownload-community.chef.io/install.ps1?license_id= } | iex; install -project chef ``` +Replace `` with your license ID. + #### On macOS +**For commercial license users:** + +```bash +curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash +``` + +**For community/trial license users:** + ```bash -sudo bash -c "$(curl -sL https://chef.io/chef/install.sh)" +curl -L https://chefdownload-community.chef.io/install.sh?license_id= | sudo bash ``` +Replace `` with your license ID. + ### Load the client.rb After Chef Infra Client finishes installing, copy the `client.rb` file with the correct data for your node and Chef Infra Server, and place that in `c:\chef`. diff --git a/content/automate/ha_common.md b/content/automate/ha_common.md index b8ea122235..7274650d38 100644 --- a/content/automate/ha_common.md +++ b/content/automate/ha_common.md @@ -319,7 +319,7 @@ This section elaborates the validation procedure that checks the firewall rules Follow these steps to examine the firewall rules are stateful, and ports are open before Chef Automate High Availability (HA) backend cluster deployment in air-gapped environment (means no access to the internet): -1. Download hab, _hab-x86_64-linux.tar.gz_ by executing the command, `sudo wget https://packages.chef.io/files/stable/habitat/latest/hab-x86_64-linux.tar.gz`. +1. Download hab, _hab-x86_64-linux.tar.gz_ by executing the command, `sudo wget "https://chefdownload-commercial.chef.io/stable/habitat/download?p=linux&pv=2.6&m=x86_64&license_id=" -O hab-x86_64-linux.tar.gz`. Replace `` with your commercial license ID. 1. Install hab package in your internet environment by executing the following commands that generate the _netcat package_: diff --git a/content/automate/node_integrations.md b/content/automate/node_integrations.md index 228c48eac1..8e8ac5fcfd 100644 --- a/content/automate/node_integrations.md +++ b/content/automate/node_integrations.md @@ -127,7 +127,7 @@ Chef Automate doesn't run a detect job on the instances; all instances with an S The `ssm` Scan Job: -1. Installs the latest stable InSpec from `packages.chef.io` +1. Installs the latest stable InSpec 1. Executes InSpec locally, providing InSpec with the `fqdn` of Chef Automate and a data collector token, so each instance reports directly back to Chef Automate Your Automate instance must be reachable (open to incoming traffic) from the instances being scanned in order for the SSM scanning to work. You can filter the instances to be scanned by specifying tag key/value matches or regions. From 97b63c42e7d0930c790d3b6849c9f8bd49bc0805 Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Mon, 8 Jun 2026 17:51:29 +0530 Subject: [PATCH 02/12] Revert _vendor file changes - these need to be made in upstream repos (chef-server and desktop-config) --- .../content/server/ctl_chef_server.md | 2 +- .../content/server/install_server_tiered.md | 5 ++-- ...l_chef_server_install_features_download.md | 4 ++-- .../content/desktop/automate_server.md | 13 +--------- .../docs-chef-io/content/desktop/nodes.md | 24 ++----------------- 5 files changed, 9 insertions(+), 39 deletions(-) diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md index 8845a66169..3269fcd01c 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/ctl_chef_server.md @@ -141,7 +141,7 @@ This subcommand has the following options: : Use to specify the location of a package. This option is not required when packages are downloaded from - (commercial users) or (community users). + . ### Use Downloads diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md index af096375df..aec8db55e4 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/install_server_tiered.md @@ -273,8 +273,9 @@ first downloaded to a local directory, and then installed. **Use Downloads** -The `install` subcommand downloads packages from the Chef download API by default ( for commercial users or for community users). For systems that are not behind -a firewall (and have connectivity to the Chef download API), the +The `install` subcommand downloads packages from + by default. For systems that are not behind +a firewall (and have connectivity to ), the Chef management console package can be installed as described below: Chef Manage diff --git a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md index 2495f25ab9..6bdc669661 100644 --- a/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md +++ b/_vendor/github.com/chef/chef-server/docs-chef-io/content/server/reusable/md/ctl_chef_server_install_features_download.md @@ -1,5 +1,5 @@ -The `install` subcommand downloads packages from the Chef download API by default ( for commercial users or for community users). -For systems that are not behind a firewall (and have connectivity to the Chef download API), these packages can be installed as described below. +The `install` subcommand downloads packages from by default. +For systems that are not behind a firewall (and have connectivity to ), these packages can be installed as described below. 1. Install add-ons diff --git a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md index 6238e2d10a..062724c4cc 100644 --- a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md +++ b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/automate_server.md @@ -39,19 +39,8 @@ sysctl -w vm.dirty_expire_centisecs=20000 Download the Chef Automate CLI: -**For commercial license users:** - -```bash -curl -L "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate -chmod +x chef-automate -``` - -Replace `` with your commercial license ID. - -**For community/trial license users:** - ```bash -curl -L "https://chefdownload-community.chef.io/stable/automate/download?p=linux&m=x86_64" -o chef-automate +curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate chmod +x chef-automate ``` diff --git a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md index 5c58a37fc4..7597bdf02b 100644 --- a/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md +++ b/_vendor/github.com/chef/desktop-config/docs-chef-io/content/desktop/nodes.md @@ -44,36 +44,16 @@ Go to your test node and install the Chef Infra Client from an elevated PowerShe #### On Windows -**For commercial license users:** - -```powershell -. { iwr -useb https://chefdownload-commercial.chef.io/install.ps1?license_id= } | iex; install -project chef -``` - -**For community/trial license users:** - ```powershell -. { iwr -useb https://chefdownload-community.chef.io/install.ps1?license_id= } | iex; install -project chef +. { iwr -useb https://omnitruck.chef.io/install.ps1 } | iex; install -project chef ``` -Replace `` with your license ID. - #### On macOS -**For commercial license users:** - -```bash -curl -L https://chefdownload-commercial.chef.io/install.sh?license_id= | sudo bash -``` - -**For community/trial license users:** - ```bash -curl -L https://chefdownload-community.chef.io/install.sh?license_id= | sudo bash +sudo bash -c "$(curl -sL https://chef.io/chef/install.sh)" ``` -Replace `` with your license ID. - ### Load the client.rb After Chef Infra Client finishes installing, copy the `client.rb` file with the correct data for your node and Chef Infra Server, and place that in `c:\chef`. From 0cfe9845209878bd579def371e3855742cc83f2f Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Mon, 8 Jun 2026 17:53:35 +0530 Subject: [PATCH 03/12] Update download URLs to chefdownload-commercial.chef.io in automate docs Replaced packages.chef.io with new commercial download endpoints (with license_id) in 17 automate documentation files. --- content/automate/airgapped_installation.md | 12 +++++-- content/automate/configuration.md | 3 +- content/automate/get_started.md | 7 ++-- content/automate/ha_aws_deploy_steps.md | 9 ++--- .../automate/ha_aws_managed_deploy_steps.md | 9 ++--- .../ha_chef_backend_to_automate_ha.md | 4 ++- content/automate/ha_node_bootstrapping.md | 4 ++- .../ha_on_premises_deployment_procedure.md | 9 ++--- content/automate/ha_upgrade_introduction.md | 12 +++++-- content/automate/infra_server.md | 4 ++- content/automate/install.md | 4 ++- content/automate/major_upgrade.md | 20 ++++++++--- content/automate/major_upgrade_4.x.md | 34 ++++++++++++++----- content/automate/managed_services.md | 4 ++- content/automate/migrate.md | 7 ++-- content/automate/on_prem_builder.md | 4 ++- content/automate/restore.md | 4 ++- 17 files changed, 105 insertions(+), 45 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index 5c950dc73c..9a7566842d 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -29,23 +29,29 @@ To get a trial license for an airgapped host [contact Chef](https://www.chef.io/ Download the Chef Automate command-line tool from the `current` [release channel]({{< relref "install.md#release-channels" >}}). ```shell -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your commercial license ID. + ## Download the Airgap Installation Bundle Download the airgap installation bundles of the latest automate version to an internet-connected machine using: ```shell -curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o +curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o ``` +Replace `` with your commercial license ID. + Download the bundle of a specific version using: ```shell -curl https://packages.chef.io/airgap_bundle/current/automate/.aib -o +curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/.aib?license_id=" -o ``` +Replace `` with your commercial license ID and `` with the desired version. + {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever.{{< /note >}} ## Create an Airgap Installation Bundle diff --git a/content/automate/configuration.md b/content/automate/configuration.md index 8aa081a54d..6ce29a2504 100644 --- a/content/automate/configuration.md +++ b/content/automate/configuration.md @@ -171,7 +171,8 @@ Then run `chef-automate config patch ` to deploy your c Chef Automate must be able to access the following: -* `packages.chef.io` +* `chefdownload-commercial.chef.io` +* `chefdownload-community.chef.io` * `licensing.chef.io` * `raw.githubusercontent.com` * `api.bintray.com` diff --git a/content/automate/get_started.md b/content/automate/get_started.md index b1be994595..89a472c50f 100644 --- a/content/automate/get_started.md +++ b/content/automate/get_started.md @@ -36,7 +36,9 @@ By installing Chef Automate with the Vagrantfile provided below you're automatic ## Create a Vagrantfile -Copy and paste this script into your command line to create the Chef Automate `Vagrantfile`: +Copy and paste this script into your command line to create the Chef Automate `Vagrantfile`. + +**Note:** Replace `` in the script with your commercial license ID before running. ```ruby cat > Vagrantfile <<'EOH' @@ -52,8 +54,7 @@ apt-get clean sysctl -w vm.max_map_count=262144 sysctl -w vm.dirty_expire_centisecs=20000 echo "${CFG_IP} ${CFG_HOSTNAME}" | tee -a /etc/hosts -curl -fsSL https://packages.chef.io/files/current/automate/latest/chef-automate_linux_amd64.zip -o /tmp/chef-automate_linux_amd64.zip -unzip -qod /usr/local/bin /tmp/chef-automate_linux_amd64.zip +curl -fsSL "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/local/bin/chef-automate chmod +x /usr/local/bin/chef-automate chef-automate deploy --accept-terms-and-mlsa echo "Server is up and running. Please log in at https://${CFG_HOSTNAME}/" diff --git a/content/automate/ha_aws_deploy_steps.md b/content/automate/ha_aws_deploy_steps.md index ec52761a66..c46d4aa8fc 100644 --- a/content/automate/ha_aws_deploy_steps.md +++ b/content/automate/ha_aws_deploy_steps.md @@ -42,15 +42,16 @@ Run the following steps on Bastion Host Machine: #Run commands as sudo. sudo -- sh -c " #Download Chef Automate CLI. - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip \ - | gunzip - > chef-automate && chmod +x chef-automate \ - | cp -f chef-automate /usr/bin/chef-automate + curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ + -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate #Download the latest Airgapped Bundle. #To download specific version bundle, example version: 4.2.59 then replace latest.aib with 4.2.59.aib - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate.aib + curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib " ``` + Replace `` with your commercial license ID. + {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. diff --git a/content/automate/ha_aws_managed_deploy_steps.md b/content/automate/ha_aws_managed_deploy_steps.md index 5c559afcf2..440c469418 100644 --- a/content/automate/ha_aws_managed_deploy_steps.md +++ b/content/automate/ha_aws_managed_deploy_steps.md @@ -30,15 +30,16 @@ Follow the steps below to deploy Chef Automate High Availability (HA) on AWS (Am #Run commands as sudo. sudo -- sh -c " #Download Chef Automate CLI. - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip \ - | gunzip - > chef-automate && chmod +x chef-automate \ - | cp -f chef-automate /usr/bin/chef-automate + curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ + -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate #Download the latest Airgapped Bundle. #To download specific version bundle, example version: 4.2.59 then replace latest.aib with 4.2.59.aib - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate.aib + curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib " ``` + Replace `` with your commercial license ID. + {{< note spaces=3 >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. diff --git a/content/automate/ha_chef_backend_to_automate_ha.md b/content/automate/ha_chef_backend_to_automate_ha.md index 9fac698ad9..e737dc7018 100644 --- a/content/automate/ha_chef_backend_to_automate_ha.md +++ b/content/automate/ha_chef_backend_to_automate_ha.md @@ -203,9 +203,11 @@ Where: 5. ssh to bastion machine and download chef-automate CLI and extract the downloaded zip file ```sh - https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate | cp -f chef-automate /usr/bin/chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` + Replace `` with your commercial license ID. + 6. Create an airgap bundle using the command ```sh diff --git a/content/automate/ha_node_bootstrapping.md b/content/automate/ha_node_bootstrapping.md index 7b5337a158..cced5f76fa 100644 --- a/content/automate/ha_node_bootstrapping.md +++ b/content/automate/ha_node_bootstrapping.md @@ -82,9 +82,11 @@ The Chef Infra Client installer puts everything into a unique directory (/opt/ch - Install the latest version of chef Workstation on the ubuntu system. ```bash - wget https://packages.chef.io/files/stable/chef-workstation/21.7.524/ubuntu/20.04/chef-workstation_21.7.524-1_amd64.deb + wget "https://chefdownload-commercial.chef.io/stable/chef-workstation/download?p=ubuntu&pv=20.04&m=x86_64&v=21.7.524&license_id=" -O chef-workstation_21.7.524-1_amd64.deb ``` + Replace `` with your commercial license ID. + - To install the same: ```bash diff --git a/content/automate/ha_on_premises_deployment_procedure.md b/content/automate/ha_on_premises_deployment_procedure.md index 669c436c2b..05e76fc143 100644 --- a/content/automate/ha_on_premises_deployment_procedure.md +++ b/content/automate/ha_on_premises_deployment_procedure.md @@ -48,13 +48,14 @@ Ensure all resources are on existing or cloud infrastructure (`AWS`/`Azure`/`Goo ```bash sudo -- sh -c " - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip \ - | gunzip - > chef-automate && chmod +x chef-automate \ - | cp -f chef-automate /usr/bin/chef-automate - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate.aib + curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ + -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate + curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib " ``` + Replace `` with your commercial license ID. + {{< note >}} In case `/usr/bin` isn't there then check for `/bin` directory diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index c4f909a3a2..c7518f6d24 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -16,23 +16,29 @@ To upgrade Chef Automate HA, follow these steps: 1. Download the latest CLI: ```bash - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate | cp -f chef-automate /usr/bin/chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` + Replace `` with your commercial license ID. + 1. Download the airgap bundle. To download the latest bundle, run: ```bash - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o latest.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o latest.aib ``` + Replace `` with your commercial license ID. + To download a specific version, run: ```bash - curl https://packages.chef.io/airgap_bundle/current/automate/.aib -o automate-.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/.aib?license_id=" -o automate-.aib ``` + Replace `` with your commercial license ID and `` with the desired version. + {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. {{< /note >}} diff --git a/content/automate/infra_server.md b/content/automate/infra_server.md index 30802695f5..be3303a524 100644 --- a/content/automate/infra_server.md +++ b/content/automate/infra_server.md @@ -44,9 +44,11 @@ Before beginning your installation, check the [System Requirements]({{< relref " To download the `chef-automate` command line tool, run the following command in your command line interface: ```shell -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your commercial license ID. + ## Install Chef Automate and Chef Infra Server on the Same Host Use either a command line interface or a configuration file to install Chef Automate and Chef Infra Server on the same host. diff --git a/content/automate/install.md b/content/automate/install.md index 216683c0b5..e94e3ff81e 100644 --- a/content/automate/install.md +++ b/content/automate/install.md @@ -23,9 +23,11 @@ See [Airgapped Installation]({{< relref "airgapped_installation.md" >}}) for ins Download and unzip the Chef Automate command-line tool: ```shell -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your commercial license ID. + ## Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index 7fe878362f..9e5902d55c 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -51,9 +51,11 @@ Please upgrade to latest date pattern version number. 1. On an internet-connected machine, download the latest Chef Automate CLI. ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 1. Create a bundle for version 20220329091442. ```sh @@ -184,9 +186,11 @@ To upgrade to 3.0.x, follow the steps below: 1. Download latest CLI of Chef Automate ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -196,9 +200,11 @@ To upgrade to 3.0.x, follow the steps below: Or you can download it with a curl request. ```sh - curl https://packages.chef.io/airgap_bundle/current/automate/3.0.49.aib -o automate-3.0.49.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/3.0.49.aib?license_id=" -o automate-3.0.49.aib ``` + Replace `` with your commercial license ID. + 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. #### On air-gapped machine running Chef Automate @@ -256,9 +262,11 @@ To upgrade to 3.0.x, follow the steps below: 1. Download latest CLI of Chef Automate ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -268,9 +276,11 @@ To upgrade to 3.0.x, follow the steps below: Or you can download it with a curl request. ```sh - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate-3.0.49.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-3.0.49.aib ``` + Replace `` with your commercial license ID. + 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. #### On air-gapped machine running Chef Automate diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index 32eb488b7b..1085822338 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -49,9 +49,11 @@ For example, if today you are on version _2021201164433_, your upgrade journey s - **Download latest chef-automate cli:** ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + ## Upgrade to Version 3.0.49 Check your current version: @@ -96,9 +98,11 @@ To upgrade Chef Automate from version 3.0.49 to 4.x with embedded Elasticsearch, 1. Download latest chef-automate cli. ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Start a major version upgrade: ```sh @@ -241,9 +245,11 @@ To upgrade Chef Automate with external Elasticsearch from version 3.0.49 to 4.x, 1. Download latest chef-automate cli. ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Start major version upgrade: ```sh @@ -343,9 +349,11 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: 1. Download latest CLI of Chef Automate. ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Create an Airgap Installation Bundle (AIB). ```sh @@ -355,9 +363,11 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: OR we can directly download via curl request ```sh - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate-4.x.y.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-4.x.y.aib ``` + Replace `` with your commercial license ID. + 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. #### On Air-Gapped machine running Chef Automate @@ -516,9 +526,11 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: 1. Download latest CLI of Chef Automate ```sh - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -528,9 +540,11 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: OR we can directly download via curl request ```sh - curl https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate-4.x.y.aib + curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-4.x.y.aib ``` + Replace `` with your commercial license ID. + 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. #### On Air-Gapped machine running Chef Automate @@ -686,11 +700,13 @@ DeploymentServiceCallError: A request to the deployment-service failed: Request To move ahead with the upgrade you can download the latest CLI and Airgapped bundle using the curl command with proxy settings: ```sh -curl -x http://proxy_server:proxy_port --proxy-user username:password -L https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate -curl -x http://proxy_server:proxy_port --proxy-user username:password -L https://packages.chef.io/airgap_bundle/current/automate/latest.aib -o automate-latest.aib +curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-latest.aib ``` +Replace `` with your commercial license ID. + After downloading, run the upgrade command with airgapped bundle option: ```sh diff --git a/content/automate/managed_services.md b/content/automate/managed_services.md index 63c1a9e3bc..cb97f173d8 100644 --- a/content/automate/managed_services.md +++ b/content/automate/managed_services.md @@ -453,9 +453,11 @@ If you are planning to set Chef Automate with External AWS PostgreSQL/OpenSearch Download and unzip the Chef Automate command-line tool: ```shell -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your commercial license ID. + ### Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/migrate.md b/content/automate/migrate.md index f7ad97e3a0..1aaa65ddac 100644 --- a/content/automate/migrate.md +++ b/content/automate/migrate.md @@ -50,9 +50,11 @@ You will need the `chef-automate` command line tool to initiate your upgrade. 1. Download the latest version of the Chef Automate CLI: ```shell - wget https://packages.chef.io/files/current/automate/latest/chef-automate_linux_amd64.zip + wget "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -O chef-automate_linux_amd64.zip ``` + Replace `` with your commercial license ID. + 2. Unzip the package: ```shell @@ -71,7 +73,8 @@ The Chef Automate upgrade process requires connectivity to the internet to insta The standard Chef Automate installation requires current versions for Chrome, Edge, or Firefox browsers. If you filter internet access via proxy or by other means, you must ensure the following domains are accessible: -* `packages.chef.io` +* `chefdownload-commercial.chef.io` +* `chefdownload-community.chef.io` * `licensing.chef.io` * `raw.githubusercontent.com` * `api.bintray.com` diff --git a/content/automate/on_prem_builder.md b/content/automate/on_prem_builder.md index cf853cb572..fcc0bdcc4d 100644 --- a/content/automate/on_prem_builder.md +++ b/content/automate/on_prem_builder.md @@ -74,9 +74,11 @@ Chef Automate and Chef Habitat Builder require: Download and unzip the installer: ```shell -curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate +curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your commercial license ID. + ### Deploy Chef Automate and Chef Habitat Builder On-prem Deploying Chef Habitat Builder with Chef Automate requires a Chef Automate license. diff --git a/content/automate/restore.md b/content/automate/restore.md index 414b2f22db..201d0f4b8f 100644 --- a/content/automate/restore.md +++ b/content/automate/restore.md @@ -21,9 +21,11 @@ Before restoring a Chef Automate installation, see how to [configure your backup 1. On the restore host, download and unzip the Chef Automate command-line tool: ```shell - curl https://packages.chef.io/files/current/latest/chef-automate-cli/chef-automate_linux_amd64.zip | gunzip - > chef-automate && chmod +x chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your commercial license ID. + 1. To restore from **filesystem backups**, Chef Automate requires access to a backup directory containing a timestamp-based directory and an `automate-elasticsearch-data` directory in the [configured location]({{< ref "backup.md#backup-to-a-filesystem" >}}). Ensure access for the backup type used: From a5ce3819591f207af594655d25262e95654e884e Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Mon, 15 Jun 2026 18:06:02 +0530 Subject: [PATCH 04/12] Revert airgap URLs Signed-off-by: Ritvik Patil --- content/automate/airgapped_installation.md | 4 ++-- content/automate/ha_aws_deploy_steps.md | 2 +- content/automate/ha_aws_managed_deploy_steps.md | 2 +- content/automate/ha_on_premises_deployment_procedure.md | 2 +- content/automate/ha_upgrade_introduction.md | 4 ++-- content/automate/major_upgrade.md | 4 ++-- content/automate/major_upgrade_4.x.md | 6 +++--- 7 files changed, 12 insertions(+), 12 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index 9a7566842d..eadc89f26e 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -39,7 +39,7 @@ Replace `` with your commercial license ID. Download the airgap installation bundles of the latest automate version to an internet-connected machine using: ```shell -curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o +curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o ``` Replace `` with your commercial license ID. @@ -47,7 +47,7 @@ Replace `` with your commercial license ID. Download the bundle of a specific version using: ```shell -curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/.aib?license_id=" -o +curl "https://packages.chef.io/airgap_bundle/current/automate/.aib" -o ``` Replace `` with your commercial license ID and `` with the desired version. diff --git a/content/automate/ha_aws_deploy_steps.md b/content/automate/ha_aws_deploy_steps.md index c46d4aa8fc..cd8138f627 100644 --- a/content/automate/ha_aws_deploy_steps.md +++ b/content/automate/ha_aws_deploy_steps.md @@ -46,7 +46,7 @@ Run the following steps on Bastion Host Machine: -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate #Download the latest Airgapped Bundle. #To download specific version bundle, example version: 4.2.59 then replace latest.aib with 4.2.59.aib - curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib + curl \"https://packages.chef.io/airgap_bundle/current/automate/latest.aib\" -o automate.aib " ``` diff --git a/content/automate/ha_aws_managed_deploy_steps.md b/content/automate/ha_aws_managed_deploy_steps.md index 440c469418..fb11cbc448 100644 --- a/content/automate/ha_aws_managed_deploy_steps.md +++ b/content/automate/ha_aws_managed_deploy_steps.md @@ -34,7 +34,7 @@ Follow the steps below to deploy Chef Automate High Availability (HA) on AWS (Am -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate #Download the latest Airgapped Bundle. #To download specific version bundle, example version: 4.2.59 then replace latest.aib with 4.2.59.aib - curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib + curl \"https://packages.chef.io/airgap_bundle/current/automate/latest.aib\" -o automate.aib " ``` diff --git a/content/automate/ha_on_premises_deployment_procedure.md b/content/automate/ha_on_premises_deployment_procedure.md index 05e76fc143..5dfda57a82 100644 --- a/content/automate/ha_on_premises_deployment_procedure.md +++ b/content/automate/ha_on_premises_deployment_procedure.md @@ -50,7 +50,7 @@ Ensure all resources are on existing or cloud infrastructure (`AWS`/`Azure`/`Goo sudo -- sh -c " curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate - curl \"https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=\" -o automate.aib + curl \"https://packages.chef.io/airgap_bundle/current/automate/latest.aib\" -o automate.aib " ``` diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index c7518f6d24..d824bc438a 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -26,7 +26,7 @@ To upgrade Chef Automate HA, follow these steps: To download the latest bundle, run: ```bash - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o latest.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o latest.aib ``` Replace `` with your commercial license ID. @@ -34,7 +34,7 @@ To upgrade Chef Automate HA, follow these steps: To download a specific version, run: ```bash - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/.aib?license_id=" -o automate-.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/.aib" -o automate-.aib ``` Replace `` with your commercial license ID and `` with the desired version. diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index 9e5902d55c..54b3aa0575 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -200,7 +200,7 @@ To upgrade to 3.0.x, follow the steps below: Or you can download it with a curl request. ```sh - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/3.0.49.aib?license_id=" -o automate-3.0.49.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/3.0.49.aib" -o automate-3.0.49.aib ``` Replace `` with your commercial license ID. @@ -276,7 +276,7 @@ To upgrade to 3.0.x, follow the steps below: Or you can download it with a curl request. ```sh - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-3.0.49.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-3.0.49.aib ``` Replace `` with your commercial license ID. diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index 1085822338..0518c377c2 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -363,7 +363,7 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: OR we can directly download via curl request ```sh - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-4.x.y.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` Replace `` with your commercial license ID. @@ -540,7 +540,7 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: OR we can directly download via curl request ```sh - curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-4.x.y.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` Replace `` with your commercial license ID. @@ -702,7 +702,7 @@ To move ahead with the upgrade you can download the latest CLI and Airgapped bun ```sh curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate -curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=" -o automate-latest.aib +curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-latest.aib ``` Replace `` with your commercial license ID. From bc3398c378e09fa4489a6a9a23aab806d9e4cdf8 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Mon, 15 Jun 2026 14:32:11 -0400 Subject: [PATCH 05/12] Edits Signed-off-by: Ian Maddaus --- content/automate/get_started.md | 208 +++++++++--------- .../automate/ha_aws_managed_deploy_steps.md | 44 ++-- .../ha_chef_backend_to_automate_ha.md | 66 +++--- content/automate/ha_common.md | 11 +- content/automate/ha_upgrade_introduction.md | 4 +- 5 files changed, 170 insertions(+), 163 deletions(-) diff --git a/content/automate/get_started.md b/content/automate/get_started.md index 89a472c50f..19b7822534 100644 --- a/content/automate/get_started.md +++ b/content/automate/get_started.md @@ -1,5 +1,5 @@ +++ -title = "Get Started with Chef Automate" +title = "Get started with Chef Automate" weight = 10 draft = false @@ -8,140 +8,136 @@ draft = false [menu] [menu.automate] - title = "Get Started Tutorial" + title = "Get started tutorial" parent = "automate/getting_started" identifier = "automate/getting_started/" weight = 10 +++ -Hello and welcome to Chef Automate! This Quickstart guides you through the initial installation and trial activation. +This quickstart guides you through the initial installation and trial activation. The easiest way to start exploring Chef Automate is to install it on a local virtual machine (VM). -This [Vagrant](https://www.vagrantup.com/) file will help you create your own test environment. +Use this [Vagrant](https://www.vagrantup.com/) file to create your own test environment. ## Prerequisites For this demonstration, you need: -* Administrator (root) access to your system -* A virtualization product such as [VirtualBox](https://www.virtualbox.org/) installed on your system -* [Vagrant](https://www.vagrantup.com/intro/getting-started/) installed on your system -* 8GB RAM, or more, available for the VM - -## Quickstart Overview - -Use the command line script below to create a demonstration instance of Chef Automate. -The script is mostly automated, but it does require a few manual steps. -By installing Chef Automate with the Vagrantfile provided below you're automatically consenting to Chef Software, Inc.'s [Terms of Service](https://www.chef.io/terms-of-service) and [Master License and Services Agreement](https://www.chef.io/online-master-agreement) - -## Create a Vagrantfile - -Copy and paste this script into your command line to create the Chef Automate `Vagrantfile`. - -**Note:** Replace `` in the script with your commercial license ID before running. - -```ruby -cat > Vagrantfile <<'EOH' -CFG_BOX = 'bento/ubuntu-18.04' -CFG_IP = '192.168.33.199' -CFG_HOSTNAME = 'chef-automate.test' - -$deployscript = <<-SCRIPT -export DEBIAN_FRONTEND='noninteractive' -apt-get -qq update -apt-get install -y --no-install-recommends curl unzip -apt-get clean -sysctl -w vm.max_map_count=262144 -sysctl -w vm.dirty_expire_centisecs=20000 -echo "${CFG_IP} ${CFG_HOSTNAME}" | tee -a /etc/hosts -curl -fsSL "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/local/bin/chef-automate -chmod +x /usr/local/bin/chef-automate -chef-automate deploy --accept-terms-and-mlsa -echo "Server is up and running. Please log in at https://${CFG_HOSTNAME}/" -echo 'You may log in using credentials provided below:' -cat /home/vagrant/automate-credentials.toml -SCRIPT - -Vagrant.configure(2) do |config| - class AcceptLicense - def to_s - return 'true' if ENV['ACCEPT_CHEF_TERMS_AND_MLSA'] == 'true' - puts < Vagrantfile <<'EOH' + CFG_BOX = 'bento/ubuntu-18.04' + CFG_IP = '192.168.33.199' + CFG_HOSTNAME = 'chef-automate.test' + + $deployscript = <<-SCRIPT + export DEBIAN_FRONTEND='noninteractive' + apt-get -qq update + apt-get install -y --no-install-recommends curl unzip + apt-get clean + sysctl -w vm.max_map_count=262144 + sysctl -w vm.dirty_expire_centisecs=20000 + echo "${CFG_IP} ${CFG_HOSTNAME}" | tee -a /etc/hosts + curl -fsSL "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/local/bin/chef-automate + chmod +x /usr/local/bin/chef-automate + chef-automate deploy --accept-terms-and-mlsa + echo "Server is up and running. Please log in at https://${CFG_HOSTNAME}/" + echo 'You may log in using credentials provided below:' + cat /home/vagrant/automate-credentials.toml + SCRIPT + + Vagrant.configure(2) do |config| + class AcceptLicense + def to_s + return 'true' if ENV['ACCEPT_CHEF_TERMS_AND_MLSA'] == 'true' + puts < CFG_IP, - 'CFG_HOSTNAME' => CFG_HOSTNAME, - 'ACCEPT_CHEF_TERMS_AND_MLSA' => AcceptLicense.new}, inline: $deployscript -end -EOH -``` + config.vm.synced_folder '.', '/opt/a2-testing', create: true + config.vm.network 'private_network', ip: CFG_IP + config.vm.provision 'shell', env: {'CFG_IP' => CFG_IP, + 'CFG_HOSTNAME' => CFG_HOSTNAME, + 'ACCEPT_CHEF_TERMS_AND_MLSA' => AcceptLicense.new}, inline: $deployscript + end + EOH + ``` -## Add an entry to /etc/hosts + Replace `` in the Vagrantfile with your commercial license ID before you run it. -The example Vagrantfile sets the VM hostname to `chef-automate.test`. The installer uses this hostname as the FQDN that Chef Automate listens on. -For security reasons, you must access Chef Automate with the configured FQDN. -To avoid configuring DNS for your test instance, add an entry to your workstation's `/etc/hosts` file. -Use the following command to append the required entry: +1. Add an entry to `/etc/hosts`. -```bash -echo 192.168.33.199 chef-automate.test | sudo tee -a /etc/hosts -``` + The example Vagrantfile sets the VM hostname to `chef-automate.test`. The installer uses this hostname as the FQDN that Chef Automate listens on. + For security reasons, you must access Chef Automate with the configured FQDN. + To avoid configuring DNS for your test instance, add an entry to your workstation's `/etc/hosts` file. + Use the following command to append the required entry: -## Start the Virtual Machine + ```bash + echo 192.168.33.199 chef-automate.test | sudo tee -a /etc/hosts + ``` -Now that you have the `Vagrantfile` in your current directory, provision a new VM by running: +1. Start the virtual machine by running: -```bash -vagrant up -``` + ```bash + vagrant up + ``` -Downloading the base OS image for the VM takes 1 to 3 minutes the first time you set up Chef Automate. + Downloading the base OS image for the VM takes 1 to 3 minutes the first time you set up Chef Automate. -When the command completes, you can access the Chef Automate by browsing to `https://chef-automate.test/`. + When the command completes, you can access Chef Automate by going to `https://chef-automate.test/`. -You can find login credentials by opening the `automate-credentials.toml`, which the installer has written in your current working directory, or in the output log. + You can find login credentials by opening `automate-credentials.toml`, which the installer writes in your current working directory, or in the output log. -## Start a free 60-day Trial +## Start a free 60-day trial -Retrieving a trial license through Chef Automate requires the Vagrant instance to have internet connectivity (at the time of trial license creation only). +Getting a trial license through Chef Automate requires the Vagrant instance to have internet connectivity when you create the trial license. -1. Sign into Chef Automate at `https://chef-automate.test/` with the credentials in the `automate-credentials.toml` file. -1. Follow the instructions in the welcome screen to get a 60-day trial license by entering your name and email address. +1. Sign in to Chef Automate at `https://chef-automate.test/` with the credentials in the `automate-credentials.toml` file. +1. Follow the instructions on the welcome screen to get a 60-day trial license by entering your name and email address. -## Installing without Vagrant +## Install without Vagrant You can install Chef Automate on any x86_64 Linux instance running CentOS 7.5, RHEL 7.5, or Ubuntu 16.04 with the following minimum system resources: -* 4 CPU -* 16 GB RAM -* 5 GB free disk space +- 4 CPU +- 16 GB RAM +- 5 GB free disk space -Follow the [Installation Guide]({{< relref "install.md" >}}) to install Chef Automate on your own resources. +Follow the [installation guide]({{< relref "install.md" >}}) to install Chef Automate on your own resources. diff --git a/content/automate/ha_aws_managed_deploy_steps.md b/content/automate/ha_aws_managed_deploy_steps.md index fb11cbc448..ac05a97281 100644 --- a/content/automate/ha_aws_managed_deploy_steps.md +++ b/content/automate/ha_aws_managed_deploy_steps.md @@ -10,7 +10,7 @@ draft = false weight = 240 +++ -Follow the steps below to deploy Chef Automate High Availability (HA) on AWS (Amazon Web Services) cloud with Managed AWS Services. Please see the [AWS Deployment Prerequisites](/automate/ha_aws_deployment_prerequisites/) page and move ahead with the following sections of this page. +Follow these steps to deploy Chef Automate High Availability (HA) on AWS (Amazon Web Services) with AWS Managed Services. See the [AWS Deployment Prerequisites](/automate/ha_aws_deployment_prerequisites/) page before you continue. {{< warning >}} @@ -22,31 +22,33 @@ Follow the steps below to deploy Chef Automate High Availability (HA) on AWS (Am {{< /warning >}} -## Run these steps on Bastion Host Machine +## Install the Chef Automate CLI and air-gapped bundle -1. Run the below commands to download the latest Automate CLI and Airgapped Bundle: +1. On the bastion host, install the Chef Automate CLI and the air-gapped bundle: - ```bash - #Run commands as sudo. - sudo -- sh -c " - #Download Chef Automate CLI. - curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ - -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate - #Download the latest Airgapped Bundle. - #To download specific version bundle, example version: 4.2.59 then replace latest.aib with 4.2.59.aib - curl \"https://packages.chef.io/airgap_bundle/current/automate/latest.aib\" -o automate.aib - " - ``` + ```bash + sudo -- sh -c " + # Download Chef Automate CLI. + curl \"https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=\" \ + -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate + + # Download the air-gapped bundle. + curl \"https://packages.chef.io/airgap_bundle/current/automate/.aib\" -o automate.aib + " + ``` - Replace `` with your commercial license ID. + Replace the following values: + + - `` with your commercial license ID. + - `` with the version of the air-gapped bundle you want to install. Use `latest` for the latest version, or specify a version number, for example, `4.2.59`. - {{< note spaces=3 >}} + {{< note >}} - Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. + Chef Automate bundles are available for 365 days after a version is released. Milestone release bundles remain available indefinitely. - {{< /note >}} + {{< /note >}} -## Steps to Generate Config +## Generate the Chef Automate config 1. Generate config with relevant data using the below command: @@ -68,7 +70,7 @@ Follow the steps below to deploy Chef Automate High Availability (HA) on AWS (Am {{< readfile file="content/automate/reusable/md/password_character_warning.md" >}} -## Steps to Provision +## Provision Chef Automate 1. Continue with the deployment after generating the config: @@ -82,7 +84,7 @@ Once the provisioning is successful, **if you have added custom DNS to your conf {{< /note >}} -## Config Verify +## Verify the Chef Automate configuration ### Prerequisites diff --git a/content/automate/ha_chef_backend_to_automate_ha.md b/content/automate/ha_chef_backend_to_automate_ha.md index e737dc7018..e41fcd9f7e 100644 --- a/content/automate/ha_chef_backend_to_automate_ha.md +++ b/content/automate/ha_chef_backend_to_automate_ha.md @@ -184,49 +184,51 @@ Where: bash infra_server_objects_count_collector.sh -S -K /path/to/key -F Filename ``` -## Steps for In-place Migration +## Migrate from Chef Backend to Chef Automate in place -1. [Backup the existing chef server data](/automate/ha_chef_backend_to_automate_ha/##backup-the-existing-chef-infra-server-or-chef-backend-data) -2. ssh to all the backend nodes of chef-backend and run +1. [Back up the existing Chef Infra Server data](/automate/ha_chef_backend_to_automate_ha/##backup-the-existing-chef-infra-server-or-chef-backend-data) +2. SSH to each Chef Backend backend node and run the following command to stop the services: - ```sh - chef-backend-ctl stop + ```bash + chef-backend-ctl stop ``` -3. ssh to all frontend nodes of chef-backend and run +3. SSH to each Chef Backend frontend node and run the following command to stop the services: - ```sh - chef-server-ctl stop + ```bash + chef-server-ctl stop ``` -4. Create one bastion machine under the same network space. -5. ssh to bastion machine and download chef-automate CLI and extract the downloaded zip file +4. Create one bastion host under the same network space. +5. SSH to the bastion host and download the Chef Automate CLI: - ```sh - curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate + ```bash + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` Replace `` with your commercial license ID. -6. Create an airgap bundle using the command +6. Create an air-gapped bundle on the bastion host: - ```sh - ./chef-automate airgap bundle create + ```bash + ./chef-automate airgap bundle create ``` -7. Generate the `config.toml` file using the following command: +7. Generate the `config.toml` file: - ```sh - ./chef-automate init-config-ha existing_infra + ```bash + ./chef-automate init-config-ha existing_infra ``` -8. Edit `config.toml` and add the following: - - Update the `instance_count` - - fqdn : load balance URL, which points to the frontend node. - - keys : ssh username and private keys - - Ensure to provide Chef Backend's frontend server IPs for Automate HA Chef Automate and Chef Infra Server. - - Ensure to provide Chef Backend's backend server IPs for Automate HA PostgreSQL and OpenSearch machines. - - Sample configuration; please modify according to your needs. +8. Edit `config.toml` with the following information: + + - Update the `instance_count` for each component. + - Set `fqdn` to the load balancer URL pointing to the frontend node. + - Set `ssh_user` and `ssh_key_file` for SSH access. + - Provide Chef Backend's frontend server IPs for Automate HA Chef Automate and Chef Infra Server in `automate_private_ips` and `chef_server_private_ips`. + - Provide Chef Backend's backend server IPs for Automate HA PostgreSQL and OpenSearch in `postgresql_private_ips` and `opensearch_private_ips`. + + See the following example configuration below and modify it for your environment: ```sh [architecture.existing_infra] @@ -238,7 +240,7 @@ Where: ssh_port = "22" ssh_key_file = "~/.ssh/mykey.pem" sudo_password = "" - # DON'T MODIFY THE BELOW LINE (backup_mount) + # Don't modify backup_mount backup_mount = "/mnt/automate_backups" # Eg.: backup_config = "object_storage" or "file_system" backup_config = "file_system" @@ -275,15 +277,15 @@ Where: postgresql_private_ips = ["10.0.3.0","10.0.4.0","10.0.5.0"] ``` -9. Deploy using the following command: +9. Deploy Automate HA: - ```sh - ./chef-automate deploy config.toml --airgap-bundle + ```bash + ./chef-automate deploy config.toml --airgap-bundle ``` -10. Clean up the old packages from the chef-backend (like Elasticsearch and PostgreSQL) -11. Once done, [restore data to Chef Automate HA](/automate/ha_chef_backend_to_automate_ha/#restore-data-to-chef-automate-ha) -12. [Validate the data](/automate/ha_chef_backend_to_automate_ha/#steps-to-validate-if-migration-is-successful) +10. [Restore the backup data to Chef Automate HA](/automate/ha_chef_backend_to_automate_ha/#restore-data-to-chef-automate-ha). +11. [Validate the migration](/automate/ha_chef_backend_to_automate_ha/#steps-to-validate-if-migration-is-successful). +12. Remove the old packages from the Chef Backend nodes (Elasticsearch, PostgreSQL, and other Chef Backend components). ## Connect Workstation/Nodes to Automate HA diff --git a/content/automate/ha_common.md b/content/automate/ha_common.md index 7274650d38..e529d3b2d4 100644 --- a/content/automate/ha_common.md +++ b/content/automate/ha_common.md @@ -319,12 +319,19 @@ This section elaborates the validation procedure that checks the firewall rules Follow these steps to examine the firewall rules are stateful, and ports are open before Chef Automate High Availability (HA) backend cluster deployment in air-gapped environment (means no access to the internet): -1. Download hab, _hab-x86_64-linux.tar.gz_ by executing the command, `sudo wget "https://chefdownload-commercial.chef.io/stable/habitat/download?p=linux&pv=2.6&m=x86_64&license_id=" -O hab-x86_64-linux.tar.gz`. Replace `` with your commercial license ID. +1. Download the Chef Habitat CLI: + + ```bash + sudo wget \ + "https://chefdownload-commercial.chef.io/stable/habitat/download?p=linux&pv=2.6&m=x86_64&license_id=" \ + -O /tmp/hab-x86_64-linux.tar.gz + ``` + + Replace `` with your commercial license ID. 1. Install hab package in your internet environment by executing the following commands that generate the _netcat package_: ```bash - sudo tar -xvzf /tmp/hab-x86_64-linux.tar.gz -C /usr/local/bin --strip-components 1 export HAB_LICENSE=accept-no-persist hab pkg install core/netcat -bf diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index d824bc438a..060e20a850 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -34,10 +34,10 @@ To upgrade Chef Automate HA, follow these steps: To download a specific version, run: ```bash - curl "https://packages.chef.io/airgap_bundle/current/automate/.aib" -o automate-.aib + curl "https://packages.chef.io/airgap_bundle/current/automate/.aib" -o automate-.aib ``` - Replace `` with your commercial license ID and `` with the desired version. + Replace `` with your commercial license ID and `` with the desired version. {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. From c95d2b012a1ccf5656cfb5c9e57462b62e77cc87 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Mon, 15 Jun 2026 14:36:26 -0400 Subject: [PATCH 06/12] More fixes Signed-off-by: Ian Maddaus --- content/automate/ha_aws_managed_deploy_steps.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/automate/ha_aws_managed_deploy_steps.md b/content/automate/ha_aws_managed_deploy_steps.md index ac05a97281..b2e7a3a733 100644 --- a/content/automate/ha_aws_managed_deploy_steps.md +++ b/content/automate/ha_aws_managed_deploy_steps.md @@ -24,6 +24,8 @@ Follow these steps to deploy Chef Automate High Availability (HA) on AWS (Amazon ## Install the Chef Automate CLI and air-gapped bundle + + 1. On the bastion host, install the Chef Automate CLI and the air-gapped bundle: ```bash @@ -56,7 +58,7 @@ Follow these steps to deploy Chef Automate High Availability (HA) on AWS (Amazon chef-automate config gen config.toml ``` - To know more about on how to generate config, refer to the [Automate HA Config Generation](/automate/ha_config_gen) page. + For more information, see the [Chef Automate HA config generation documentation](/automate/ha_config_gen). {{< note >}} From 014279e3abbf92ac44fd34e87b2f8d99fdbe6415 Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Tue, 16 Jun 2026 20:03:39 +0530 Subject: [PATCH 07/12] Fix automate links Signed-off-by: Ritvik Patil --- content/automate/airgapped_installation.md | 2 -- content/automate/configuration.md | 1 + content/automate/ha_aws_deploy_steps.md | 1 - content/automate/ha_chef_backend_to_automate_ha.md | 1 - content/automate/ha_node_bootstrapping.md | 1 - content/automate/ha_on_premises_deployment_procedure.md | 1 - content/automate/ha_upgrade_introduction.md | 2 -- content/automate/infra_server.md | 1 - content/automate/install.md | 1 - content/automate/major_upgrade.md | 5 ----- content/automate/major_upgrade_4.x.md | 8 -------- content/automate/managed_services.md | 1 - content/automate/migrate.md | 2 +- content/automate/on_prem_builder.md | 1 - content/automate/restore.md | 1 - 15 files changed, 2 insertions(+), 27 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index eadc89f26e..0b685f1780 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -32,7 +32,6 @@ Download the Chef Automate command-line tool from the `current` [release channel curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` -Replace `` with your commercial license ID. ## Download the Airgap Installation Bundle @@ -42,7 +41,6 @@ Download the airgap installation bundles of the latest automate version to an in curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o ``` -Replace `` with your commercial license ID. Download the bundle of a specific version using: diff --git a/content/automate/configuration.md b/content/automate/configuration.md index 6ce29a2504..92bc617a10 100644 --- a/content/automate/configuration.md +++ b/content/automate/configuration.md @@ -173,6 +173,7 @@ Chef Automate must be able to access the following: * `chefdownload-commercial.chef.io` * `chefdownload-community.chef.io` +* `packages.chef.io` * `licensing.chef.io` * `raw.githubusercontent.com` * `api.bintray.com` diff --git a/content/automate/ha_aws_deploy_steps.md b/content/automate/ha_aws_deploy_steps.md index cd8138f627..38448a53f1 100644 --- a/content/automate/ha_aws_deploy_steps.md +++ b/content/automate/ha_aws_deploy_steps.md @@ -50,7 +50,6 @@ Run the following steps on Bastion Host Machine: " ``` - Replace `` with your commercial license ID. {{< note >}} diff --git a/content/automate/ha_chef_backend_to_automate_ha.md b/content/automate/ha_chef_backend_to_automate_ha.md index e41fcd9f7e..7b83207bbe 100644 --- a/content/automate/ha_chef_backend_to_automate_ha.md +++ b/content/automate/ha_chef_backend_to_automate_ha.md @@ -206,7 +206,6 @@ Where: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` - Replace `` with your commercial license ID. 6. Create an air-gapped bundle on the bastion host: diff --git a/content/automate/ha_node_bootstrapping.md b/content/automate/ha_node_bootstrapping.md index cced5f76fa..b4e749aff5 100644 --- a/content/automate/ha_node_bootstrapping.md +++ b/content/automate/ha_node_bootstrapping.md @@ -85,7 +85,6 @@ The Chef Infra Client installer puts everything into a unique directory (/opt/ch wget "https://chefdownload-commercial.chef.io/stable/chef-workstation/download?p=ubuntu&pv=20.04&m=x86_64&v=21.7.524&license_id=" -O chef-workstation_21.7.524-1_amd64.deb ``` - Replace `` with your commercial license ID. - To install the same: diff --git a/content/automate/ha_on_premises_deployment_procedure.md b/content/automate/ha_on_premises_deployment_procedure.md index 5dfda57a82..71aa53fe77 100644 --- a/content/automate/ha_on_premises_deployment_procedure.md +++ b/content/automate/ha_on_premises_deployment_procedure.md @@ -54,7 +54,6 @@ Ensure all resources are on existing or cloud infrastructure (`AWS`/`Azure`/`Goo " ``` - Replace `` with your commercial license ID. {{< note >}} diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index 060e20a850..173c40e7b9 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -19,7 +19,6 @@ To upgrade Chef Automate HA, follow these steps: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` - Replace `` with your commercial license ID. 1. Download the airgap bundle. @@ -29,7 +28,6 @@ To upgrade Chef Automate HA, follow these steps: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o latest.aib ``` - Replace `` with your commercial license ID. To download a specific version, run: diff --git a/content/automate/infra_server.md b/content/automate/infra_server.md index be3303a524..68a6d66b48 100644 --- a/content/automate/infra_server.md +++ b/content/automate/infra_server.md @@ -47,7 +47,6 @@ To download the `chef-automate` command line tool, run the following command in curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` -Replace `` with your commercial license ID. ## Install Chef Automate and Chef Infra Server on the Same Host diff --git a/content/automate/install.md b/content/automate/install.md index e94e3ff81e..c585f34e77 100644 --- a/content/automate/install.md +++ b/content/automate/install.md @@ -26,7 +26,6 @@ Download and unzip the Chef Automate command-line tool: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` -Replace `` with your commercial license ID. ## Create Default Configuration diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index 54b3aa0575..fcecc650da 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -54,7 +54,6 @@ Please upgrade to latest date pattern version number. curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 1. Create a bundle for version 20220329091442. @@ -189,7 +188,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Create an Airgap Installation Bundle (AIB): @@ -203,7 +201,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/3.0.49.aib" -o automate-3.0.49.aib ``` - Replace `` with your commercial license ID. 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. @@ -265,7 +262,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Create an Airgap Installation Bundle (AIB): @@ -279,7 +275,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-3.0.49.aib ``` - Replace `` with your commercial license ID. 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index 0518c377c2..72c2ba08c3 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -52,7 +52,6 @@ For example, if today you are on version _2021201164433_, your upgrade journey s curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. ## Upgrade to Version 3.0.49 @@ -101,7 +100,6 @@ To upgrade Chef Automate from version 3.0.49 to 4.x with embedded Elasticsearch, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Start a major version upgrade: @@ -248,7 +246,6 @@ To upgrade Chef Automate with external Elasticsearch from version 3.0.49 to 4.x, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Start major version upgrade: @@ -352,7 +349,6 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Create an Airgap Installation Bundle (AIB). @@ -366,7 +362,6 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` - Replace `` with your commercial license ID. 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. @@ -529,7 +524,6 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 2. Create an Airgap Installation Bundle (AIB): @@ -543,7 +537,6 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` - Replace `` with your commercial license ID. 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. @@ -705,7 +698,6 @@ curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https: curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-latest.aib ``` -Replace `` with your commercial license ID. After downloading, run the upgrade command with airgapped bundle option: diff --git a/content/automate/managed_services.md b/content/automate/managed_services.md index cb97f173d8..91bea3fbb1 100644 --- a/content/automate/managed_services.md +++ b/content/automate/managed_services.md @@ -456,7 +456,6 @@ Download and unzip the Chef Automate command-line tool: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` -Replace `` with your commercial license ID. ### Create Default Configuration diff --git a/content/automate/migrate.md b/content/automate/migrate.md index 1aaa65ddac..4196065cbf 100644 --- a/content/automate/migrate.md +++ b/content/automate/migrate.md @@ -53,7 +53,6 @@ You will need the `chef-automate` command line tool to initiate your upgrade. wget "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -O chef-automate_linux_amd64.zip ``` - Replace `` with your commercial license ID. 2. Unzip the package: @@ -75,6 +74,7 @@ If you filter internet access via proxy or by other means, you must ensure the f * `chefdownload-commercial.chef.io` * `chefdownload-community.chef.io` +* `packages.chef.io` * `licensing.chef.io` * `raw.githubusercontent.com` * `api.bintray.com` diff --git a/content/automate/on_prem_builder.md b/content/automate/on_prem_builder.md index fcc0bdcc4d..6b86609886 100644 --- a/content/automate/on_prem_builder.md +++ b/content/automate/on_prem_builder.md @@ -77,7 +77,6 @@ Download and unzip the installer: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` -Replace `` with your commercial license ID. ### Deploy Chef Automate and Chef Habitat Builder On-prem diff --git a/content/automate/restore.md b/content/automate/restore.md index 201d0f4b8f..c6206beaf4 100644 --- a/content/automate/restore.md +++ b/content/automate/restore.md @@ -24,7 +24,6 @@ Before restoring a Chef Automate installation, see how to [configure your backup curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - Replace `` with your commercial license ID. 1. To restore from **filesystem backups**, Chef Automate requires access to a backup directory containing a timestamp-based directory and an `automate-elasticsearch-data` directory in the [configured location]({{< ref "backup.md#backup-to-a-filesystem" >}}). From ccb17563ce4be288d6a84f7aafff6687ddf5e6ce Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Tue, 16 Jun 2026 20:10:38 +0530 Subject: [PATCH 08/12] Remove LICENSE_ID note Signed-off-by: Ritvik Patil --- content/automate/ha_common.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/automate/ha_common.md b/content/automate/ha_common.md index e529d3b2d4..6267eca247 100644 --- a/content/automate/ha_common.md +++ b/content/automate/ha_common.md @@ -327,8 +327,6 @@ Follow these steps to examine the firewall rules are stateful, and ports are ope -O /tmp/hab-x86_64-linux.tar.gz ``` - Replace `` with your commercial license ID. - 1. Install hab package in your internet environment by executing the following commands that generate the _netcat package_: ```bash From 12fabebd0608337fa92766378dcf419075fa0c5e Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Tue, 16 Jun 2026 20:49:56 +0530 Subject: [PATCH 09/12] docs fixes Signed-off-by: Ritvik Patil --- content/automate/airgapped_installation.md | 2 -- content/automate/ha_aws_deploy_steps.md | 1 - content/automate/ha_chef_backend_to_automate_ha.md | 1 - content/automate/ha_node_bootstrapping.md | 1 - .../ha_on_premises_deployment_procedure.md | 1 - content/automate/ha_upgrade_introduction.md | 4 +--- content/automate/infra_server.md | 1 - content/automate/install.md | 3 +-- content/automate/managed_services.md | 2 +- content/automate/migrate.md | 14 ++++---------- content/automate/on_prem_builder.md | 2 +- content/automate/restore.md | 2 +- 12 files changed, 9 insertions(+), 25 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index 0b685f1780..a9ac76b2f1 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -32,7 +32,6 @@ Download the Chef Automate command-line tool from the `current` [release channel curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ## Download the Airgap Installation Bundle Download the airgap installation bundles of the latest automate version to an internet-connected machine using: @@ -41,7 +40,6 @@ Download the airgap installation bundles of the latest automate version to an in curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o ``` - Download the bundle of a specific version using: ```shell diff --git a/content/automate/ha_aws_deploy_steps.md b/content/automate/ha_aws_deploy_steps.md index 38448a53f1..eec9b1061e 100644 --- a/content/automate/ha_aws_deploy_steps.md +++ b/content/automate/ha_aws_deploy_steps.md @@ -50,7 +50,6 @@ Run the following steps on Bastion Host Machine: " ``` - {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever. diff --git a/content/automate/ha_chef_backend_to_automate_ha.md b/content/automate/ha_chef_backend_to_automate_ha.md index 7b83207bbe..80a2bfbccb 100644 --- a/content/automate/ha_chef_backend_to_automate_ha.md +++ b/content/automate/ha_chef_backend_to_automate_ha.md @@ -206,7 +206,6 @@ Where: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` - 6. Create an air-gapped bundle on the bastion host: ```bash diff --git a/content/automate/ha_node_bootstrapping.md b/content/automate/ha_node_bootstrapping.md index b4e749aff5..77a5229838 100644 --- a/content/automate/ha_node_bootstrapping.md +++ b/content/automate/ha_node_bootstrapping.md @@ -85,7 +85,6 @@ The Chef Infra Client installer puts everything into a unique directory (/opt/ch wget "https://chefdownload-commercial.chef.io/stable/chef-workstation/download?p=ubuntu&pv=20.04&m=x86_64&v=21.7.524&license_id=" -O chef-workstation_21.7.524-1_amd64.deb ``` - - To install the same: ```bash diff --git a/content/automate/ha_on_premises_deployment_procedure.md b/content/automate/ha_on_premises_deployment_procedure.md index 71aa53fe77..f5d9796edc 100644 --- a/content/automate/ha_on_premises_deployment_procedure.md +++ b/content/automate/ha_on_premises_deployment_procedure.md @@ -54,7 +54,6 @@ Ensure all resources are on existing or cloud infrastructure (`AWS`/`Azure`/`Goo " ``` - {{< note >}} In case `/usr/bin` isn't there then check for `/bin` directory diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index 173c40e7b9..d96c51c23a 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -16,10 +16,9 @@ To upgrade Chef Automate HA, follow these steps: 1. Download the latest CLI: ```bash - curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate && sudo mv chef-automate /usr/bin/chef-automate ``` - 1. Download the airgap bundle. To download the latest bundle, run: @@ -28,7 +27,6 @@ To upgrade Chef Automate HA, follow these steps: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o latest.aib ``` - To download a specific version, run: ```bash diff --git a/content/automate/infra_server.md b/content/automate/infra_server.md index 68a6d66b48..a087783fdf 100644 --- a/content/automate/infra_server.md +++ b/content/automate/infra_server.md @@ -47,7 +47,6 @@ To download the `chef-automate` command line tool, run the following command in curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ## Install Chef Automate and Chef Infra Server on the Same Host Use either a command line interface or a configuration file to install Chef Automate and Chef Infra Server on the same host. diff --git a/content/automate/install.md b/content/automate/install.md index c585f34e77..61a3f0ef7d 100644 --- a/content/automate/install.md +++ b/content/automate/install.md @@ -20,13 +20,12 @@ See [Airgapped Installation]({{< relref "airgapped_installation.md" >}}) for ins ## Download the Chef Automate Command-Line Tool -Download and unzip the Chef Automate command-line tool: +Download the Chef Automate command-line tool: ```shell curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ## Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/managed_services.md b/content/automate/managed_services.md index 91bea3fbb1..84e9c201bc 100644 --- a/content/automate/managed_services.md +++ b/content/automate/managed_services.md @@ -450,7 +450,7 @@ If you are planning to set Chef Automate with External AWS PostgreSQL/OpenSearch ### Download the Chef Automate Command-Line Tool -Download and unzip the Chef Automate command-line tool: +Download the Chef Automate command-line tool: ```shell curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate diff --git a/content/automate/migrate.md b/content/automate/migrate.md index 4196065cbf..820420f453 100644 --- a/content/automate/migrate.md +++ b/content/automate/migrate.md @@ -50,20 +50,14 @@ You will need the `chef-automate` command line tool to initiate your upgrade. 1. Download the latest version of the Chef Automate CLI: ```shell - wget "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -O chef-automate_linux_amd64.zip + wget "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -O chef-automate + chmod +x chef-automate ``` - -2. Unzip the package: - - ```shell - unzip chef-automate_linux_amd64.zip - ``` - -3. Move the unzipped `chef-automate` binary to `/usr/local/bin`: +2. Move the `chef-automate` binary to `/usr/local/bin`: ```shell - mv chef-automate /usr/local/bin + sudo mv chef-automate /usr/local/bin ``` ### Internet Access diff --git a/content/automate/on_prem_builder.md b/content/automate/on_prem_builder.md index 6b86609886..da8258fd1d 100644 --- a/content/automate/on_prem_builder.md +++ b/content/automate/on_prem_builder.md @@ -71,7 +71,7 @@ Chef Automate and Chef Habitat Builder require: ### Download the Chef Automate Installer -Download and unzip the installer: +Download the installer: ```shell curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate diff --git a/content/automate/restore.md b/content/automate/restore.md index c6206beaf4..7589c0e413 100644 --- a/content/automate/restore.md +++ b/content/automate/restore.md @@ -18,7 +18,7 @@ Before restoring a Chef Automate installation, see how to [configure your backup ## Prerequisites -1. On the restore host, download and unzip the Chef Automate command-line tool: +1. On the restore host, download the Chef Automate command-line tool: ```shell curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate From 6a01510512de7af37144bb090a70fe12daae87dc Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Tue, 16 Jun 2026 21:46:57 +0530 Subject: [PATCH 10/12] docs fixes Signed-off-by: Ritvik Patil --- content/automate/airgapped_installation.md | 2 -- content/automate/major_upgrade.md | 2 -- content/automate/major_upgrade_4.x.md | 7 ------- 3 files changed, 11 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index a9ac76b2f1..a3b7533310 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -46,8 +46,6 @@ Download the bundle of a specific version using: curl "https://packages.chef.io/airgap_bundle/current/automate/.aib" -o ``` -Replace `` with your commercial license ID and `` with the desired version. - {{< note >}} Chef Automate bundles are available for 365 days from the release of a version. However, the milestone release bundles are available for download forever.{{< /note >}} ## Create an Airgap Installation Bundle diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index fcecc650da..3bba9dbf58 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -54,7 +54,6 @@ Please upgrade to latest date pattern version number. curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 1. Create a bundle for version 20220329091442. ```sh @@ -188,7 +187,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Create an Airgap Installation Bundle (AIB): ```sh diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index 72c2ba08c3..d38b76e695 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -52,7 +52,6 @@ For example, if today you are on version _2021201164433_, your upgrade journey s curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ## Upgrade to Version 3.0.49 Check your current version: @@ -100,7 +99,6 @@ To upgrade Chef Automate from version 3.0.49 to 4.x with embedded Elasticsearch, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Start a major version upgrade: ```sh @@ -246,7 +244,6 @@ To upgrade Chef Automate with external Elasticsearch from version 3.0.49 to 4.x, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Start major version upgrade: ```sh @@ -349,7 +346,6 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Create an Airgap Installation Bundle (AIB). ```sh @@ -524,7 +520,6 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -537,7 +532,6 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` - 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. #### On Air-Gapped machine running Chef Automate @@ -698,7 +692,6 @@ curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https: curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-latest.aib ``` - After downloading, run the upgrade command with airgapped bundle option: ```sh From 8c82940680879b15a498f28f77cd3291190e3543 Mon Sep 17 00:00:00 2001 From: Ritvik Patil Date: Tue, 16 Jun 2026 21:57:09 +0530 Subject: [PATCH 11/12] docs fixes Signed-off-by: Ritvik Patil --- content/automate/major_upgrade.md | 3 --- content/automate/major_upgrade_4.x.md | 1 - content/automate/managed_services.md | 1 - content/automate/on_prem_builder.md | 1 - content/automate/restore.md | 1 - 5 files changed, 7 deletions(-) diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index 3bba9dbf58..d00d2db3f4 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -199,7 +199,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/3.0.49.aib" -o automate-3.0.49.aib ``` - 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. #### On air-gapped machine running Chef Automate @@ -260,7 +259,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -273,7 +271,6 @@ To upgrade to 3.0.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-3.0.49.aib ``` - 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate_3.0.x.aib`) to the air-gapped machine running Chef Automate. #### On air-gapped machine running Chef Automate diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index d38b76e695..3f3dca823a 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -358,7 +358,6 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: curl "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-4.x.y.aib ``` - 3. Copy the latest Chef Automate CLI (`chef-automate`) and AIB (`automate-4.x.y.aib`) to the air-gapped machine running Chef Automate. #### On Air-Gapped machine running Chef Automate diff --git a/content/automate/managed_services.md b/content/automate/managed_services.md index 84e9c201bc..f75dc99dda 100644 --- a/content/automate/managed_services.md +++ b/content/automate/managed_services.md @@ -456,7 +456,6 @@ Download the Chef Automate command-line tool: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ### Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/on_prem_builder.md b/content/automate/on_prem_builder.md index da8258fd1d..7121a8c44c 100644 --- a/content/automate/on_prem_builder.md +++ b/content/automate/on_prem_builder.md @@ -77,7 +77,6 @@ Download the installer: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - ### Deploy Chef Automate and Chef Habitat Builder On-prem Deploying Chef Habitat Builder with Chef Automate requires a Chef Automate license. diff --git a/content/automate/restore.md b/content/automate/restore.md index 7589c0e413..c3025a0214 100644 --- a/content/automate/restore.md +++ b/content/automate/restore.md @@ -24,7 +24,6 @@ Before restoring a Chef Automate installation, see how to [configure your backup curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` - 1. To restore from **filesystem backups**, Chef Automate requires access to a backup directory containing a timestamp-based directory and an `automate-elasticsearch-data` directory in the [configured location]({{< ref "backup.md#backup-to-a-filesystem" >}}). Ensure access for the backup type used: From 07f85c04f950243d1ad3715a4f67a27a1b6c6ce8 Mon Sep 17 00:00:00 2001 From: Ian Maddaus Date: Tue, 23 Jun 2026 14:22:24 -0400 Subject: [PATCH 12/12] Editing Signed-off-by: Ian Maddaus --- content/automate/airgapped_installation.md | 2 ++ .../automate/ha_chef_backend_to_automate_ha.md | 2 ++ content/automate/ha_common.md | 2 ++ content/automate/ha_node_bootstrapping.md | 8 +++++--- content/automate/ha_upgrade_introduction.md | 2 ++ content/automate/infra_server.md | 2 ++ content/automate/install.md | 2 ++ content/automate/major_upgrade.md | 6 ++++++ content/automate/major_upgrade_4.x.md | 16 +++++++++++++++- content/automate/managed_services.md | 2 ++ content/automate/migrate.md | 2 ++ content/automate/on_prem_builder.md | 2 ++ content/automate/restore.md | 6 ++++-- 13 files changed, 48 insertions(+), 6 deletions(-) diff --git a/content/automate/airgapped_installation.md b/content/automate/airgapped_installation.md index a3b7533310..5c319736d7 100644 --- a/content/automate/airgapped_installation.md +++ b/content/automate/airgapped_installation.md @@ -32,6 +32,8 @@ Download the Chef Automate command-line tool from the `current` [release channel curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your Progress Chef commercial license ID. + ## Download the Airgap Installation Bundle Download the airgap installation bundles of the latest automate version to an internet-connected machine using: diff --git a/content/automate/ha_chef_backend_to_automate_ha.md b/content/automate/ha_chef_backend_to_automate_ha.md index 80a2bfbccb..f23b222125 100644 --- a/content/automate/ha_chef_backend_to_automate_ha.md +++ b/content/automate/ha_chef_backend_to_automate_ha.md @@ -206,6 +206,8 @@ Where: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 6. Create an air-gapped bundle on the bastion host: ```bash diff --git a/content/automate/ha_common.md b/content/automate/ha_common.md index 6267eca247..d2b0f3074c 100644 --- a/content/automate/ha_common.md +++ b/content/automate/ha_common.md @@ -327,6 +327,8 @@ Follow these steps to examine the firewall rules are stateful, and ports are ope -O /tmp/hab-x86_64-linux.tar.gz ``` + Replace `` with your Progress Chef commercial license ID. + 1. Install hab package in your internet environment by executing the following commands that generate the _netcat package_: ```bash diff --git a/content/automate/ha_node_bootstrapping.md b/content/automate/ha_node_bootstrapping.md index 77a5229838..4c4c940e2a 100644 --- a/content/automate/ha_node_bootstrapping.md +++ b/content/automate/ha_node_bootstrapping.md @@ -81,9 +81,11 @@ The Chef Infra Client installer puts everything into a unique directory (/opt/ch - Install the latest version of chef Workstation on the ubuntu system. - ```bash - wget "https://chefdownload-commercial.chef.io/stable/chef-workstation/download?p=ubuntu&pv=20.04&m=x86_64&v=21.7.524&license_id=" -O chef-workstation_21.7.524-1_amd64.deb - ``` + ```bash + wget "https://chefdownload-commercial.chef.io/stable/chef-workstation/download?p=ubuntu&pv=20.04&m=x86_64&v=21.7.524&license_id=" -O chef-workstation_21.7.524-1_amd64.deb + ``` + + Replace `` with your Progress Chef commercial license ID. - To install the same: diff --git a/content/automate/ha_upgrade_introduction.md b/content/automate/ha_upgrade_introduction.md index d96c51c23a..ef6701e888 100644 --- a/content/automate/ha_upgrade_introduction.md +++ b/content/automate/ha_upgrade_introduction.md @@ -19,6 +19,8 @@ To upgrade Chef Automate HA, follow these steps: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate && sudo mv chef-automate /usr/bin/chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 1. Download the airgap bundle. To download the latest bundle, run: diff --git a/content/automate/infra_server.md b/content/automate/infra_server.md index a087783fdf..fe0914a1ae 100644 --- a/content/automate/infra_server.md +++ b/content/automate/infra_server.md @@ -47,6 +47,8 @@ To download the `chef-automate` command line tool, run the following command in curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your Progress Chef commercial license ID. + ## Install Chef Automate and Chef Infra Server on the Same Host Use either a command line interface or a configuration file to install Chef Automate and Chef Infra Server on the same host. diff --git a/content/automate/install.md b/content/automate/install.md index 61a3f0ef7d..ffd66aeb93 100644 --- a/content/automate/install.md +++ b/content/automate/install.md @@ -26,6 +26,8 @@ Download the Chef Automate command-line tool: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your Progress Chef commercial license ID. + ## Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/major_upgrade.md b/content/automate/major_upgrade.md index d00d2db3f4..cf6480067f 100644 --- a/content/automate/major_upgrade.md +++ b/content/automate/major_upgrade.md @@ -54,6 +54,8 @@ Please upgrade to latest date pattern version number. curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 1. Create a bundle for version 20220329091442. ```sh @@ -187,6 +189,8 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -259,6 +263,8 @@ To upgrade to 3.0.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh diff --git a/content/automate/major_upgrade_4.x.md b/content/automate/major_upgrade_4.x.md index 3f3dca823a..50bcbfffc0 100644 --- a/content/automate/major_upgrade_4.x.md +++ b/content/automate/major_upgrade_4.x.md @@ -52,6 +52,8 @@ For example, if today you are on version _2021201164433_, your upgrade journey s curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + ## Upgrade to Version 3.0.49 Check your current version: @@ -99,6 +101,8 @@ To upgrade Chef Automate from version 3.0.49 to 4.x with embedded Elasticsearch, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Start a major version upgrade: ```sh @@ -244,6 +248,8 @@ To upgrade Chef Automate with external Elasticsearch from version 3.0.49 to 4.x, curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Start major version upgrade: ```sh @@ -346,6 +352,8 @@ To upgrade from version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Create an Airgap Installation Bundle (AIB). ```sh @@ -519,6 +527,8 @@ To upgrade to version 3.0.49 to 4.x, follow the steps below: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Create an Airgap Installation Bundle (AIB): ```sh @@ -683,11 +693,15 @@ If you are using Proxy Settings and have upgraded to a version between 4.0.27 an DeploymentServiceCallError: A request to the deployment-service failed: Request to get upgrade status failed: rpc error: code = Unknown desc = error in getting the versions from current channel: error in invoking the endpoint https://packages.chef.io/manifests/current/automate/versions.json: Get "https://packages.chef.io/manifests/current/automate/versions.json": dial tcp: lookup packages.chef.io on 10.2.72.20:53: read udp 10.1.97.98:59620->10.2.72.20:53: i/o timeout ``` -To move ahead with the upgrade you can download the latest CLI and Airgapped bundle using the curl command with proxy settings: +To move ahead with the upgrade you can download the latest CLI and air-gapped bundle using the curl command with proxy settings: ```sh curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate +``` +Replace `` with your Progress Chef commercial license ID. + +```sh curl -x http://proxy_server:proxy_port --proxy-user username:password -L "https://packages.chef.io/airgap_bundle/current/automate/latest.aib" -o automate-latest.aib ``` diff --git a/content/automate/managed_services.md b/content/automate/managed_services.md index f75dc99dda..22192052cd 100644 --- a/content/automate/managed_services.md +++ b/content/automate/managed_services.md @@ -456,6 +456,8 @@ Download the Chef Automate command-line tool: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your Progress Chef commercial license ID. + ### Create Default Configuration Create a `config.toml` file with default values for your Chef Automate installation: diff --git a/content/automate/migrate.md b/content/automate/migrate.md index 820420f453..4ec78ead95 100644 --- a/content/automate/migrate.md +++ b/content/automate/migrate.md @@ -54,6 +54,8 @@ You will need the `chef-automate` command line tool to initiate your upgrade. chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 2. Move the `chef-automate` binary to `/usr/local/bin`: ```shell diff --git a/content/automate/on_prem_builder.md b/content/automate/on_prem_builder.md index 7121a8c44c..ad6c1d1dc2 100644 --- a/content/automate/on_prem_builder.md +++ b/content/automate/on_prem_builder.md @@ -77,6 +77,8 @@ Download the installer: curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` +Replace `` with your Progress Chef commercial license ID. + ### Deploy Chef Automate and Chef Habitat Builder On-prem Deploying Chef Habitat Builder with Chef Automate requires a Chef Automate license. diff --git a/content/automate/restore.md b/content/automate/restore.md index c3025a0214..deecef5325 100644 --- a/content/automate/restore.md +++ b/content/automate/restore.md @@ -20,10 +20,12 @@ Before restoring a Chef Automate installation, see how to [configure your backup 1. On the restore host, download the Chef Automate command-line tool: - ```shell - curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate + ```shell + curl "https://chefdownload-commercial.chef.io/stable/automate/download?p=linux&m=x86_64&license_id=" -o chef-automate && chmod +x chef-automate ``` + Replace `` with your Progress Chef commercial license ID. + 1. To restore from **filesystem backups**, Chef Automate requires access to a backup directory containing a timestamp-based directory and an `automate-elasticsearch-data` directory in the [configured location]({{< ref "backup.md#backup-to-a-filesystem" >}}). Ensure access for the backup type used: