Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions content/automate/airgapped_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` 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 </path/to/airgap-install-bundle>
curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/latest.aib?license_id=<LICENSE_ID>" -o </path/to/airgap-install-bundle>
```

Replace `<LICENSE_ID>` with your commercial license ID.

Download the bundle of a specific version using:

```shell
curl https://packages.chef.io/airgap_bundle/current/automate/<version>.aib -o </path/to/airgap-install-bundle>
curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/<version>.aib?license_id=<LICENSE_ID>" -o </path/to/airgap-install-bundle>
```

Replace `<LICENSE_ID>` with your commercial license ID and `<version>` 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
Expand Down
3 changes: 2 additions & 1 deletion content/automate/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,8 @@ Then run `chef-automate config patch </path/to/your-file.toml>` 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`
Expand Down
7 changes: 4 additions & 3 deletions content/automate/get_started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<LICENSE_ID>` in the script with your commercial license ID before running.

```ruby
cat > Vagrantfile <<'EOH'
Expand All @@ -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=<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}/"
Expand Down
9 changes: 5 additions & 4 deletions content/automate/ha_aws_deploy_steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<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=<LICENSE_ID>\" -o automate.aib
"
```

Replace `<LICENSE_ID>` 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.
Expand Down
9 changes: 5 additions & 4 deletions content/automate/ha_aws_managed_deploy_steps.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<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=<LICENSE_ID>\" -o automate.aib
"
```

Replace `<LICENSE_ID>` 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.
Expand Down
4 changes: 3 additions & 1 deletion content/automate/ha_chef_backend_to_automate_ha.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate
```
Replace `<LICENSE_ID>` with your commercial license ID.
6. Create an airgap bundle using the command
```sh
Expand Down
2 changes: 1 addition & 1 deletion content/automate/ha_common.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<YOUR_LICENSE_ID>" -O hab-x86_64-linux.tar.gz`. Replace `<YOUR_LICENSE_ID>` with your commercial license ID.

1. Install hab package in your internet environment by executing the following commands that generate the _netcat package_:

Expand Down
4 changes: 3 additions & 1 deletion content/automate/ha_node_bootstrapping.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -O chef-workstation_21.7.524-1_amd64.deb
```

Replace `<LICENSE_ID>` with your commercial license ID.

- To install the same:

```bash
Expand Down
9 changes: 5 additions & 4 deletions content/automate/ha_on_premises_deployment_procedure.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<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=<LICENSE_ID>\" -o automate.aib
"
```

Replace `<LICENSE_ID>` with your commercial license ID.

{{< note >}}

In case `/usr/bin` isn't there then check for `/bin` directory
Expand Down
12 changes: 9 additions & 3 deletions content/automate/ha_upgrade_introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o /usr/bin/chef-automate && chmod +x /usr/bin/chef-automate
```

Replace `<LICENSE_ID>` 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=<LICENSE_ID>" -o latest.aib
```

Replace `<LICENSE_ID>` with your commercial license ID.

To download a specific version, run:

```bash
curl https://packages.chef.io/airgap_bundle/current/automate/<version>.aib -o automate-<version>.aib
curl "https://chefdownload-commercial.chef.io/airgap_bundle/current/automate/<version>.aib?license_id=<LICENSE_ID>" -o automate-<version>.aib
```

Replace `<LICENSE_ID>` with your commercial license ID and `<version>` 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 >}}
Expand Down
4 changes: 3 additions & 1 deletion content/automate/infra_server.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` 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.
Expand Down
4 changes: 3 additions & 1 deletion content/automate/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

## Create Default Configuration

Create a `config.toml` file with default values for your Chef Automate installation:
Expand Down
20 changes: 15 additions & 5 deletions content/automate/major_upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

1. Create a bundle for version 20220329091442.

```sh
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Create an Airgap Installation Bundle (AIB):

```sh
Expand All @@ -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=<LICENSE_ID>" -o automate-3.0.49.aib
```

Replace `<LICENSE_ID>` 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
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Create an Airgap Installation Bundle (AIB):

```sh
Expand All @@ -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=<LICENSE_ID>" -o automate-3.0.49.aib
```

Replace `<LICENSE_ID>` 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
Expand Down
34 changes: 25 additions & 9 deletions content/automate/major_upgrade_4.x.md
Original file line number Diff line number Diff line change
Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

## Upgrade to Version 3.0.49

Check your current version:
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Start a major version upgrade:

```sh
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Start major version upgrade:

```sh
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Create an Airgap Installation Bundle (AIB).

```sh
Expand All @@ -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=<LICENSE_ID>" -o automate-4.x.y.aib
```

Replace `<LICENSE_ID>` 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
Expand Down Expand Up @@ -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=<LICENSE_ID>" -o chef-automate && chmod +x chef-automate
```

Replace `<LICENSE_ID>` with your commercial license ID.

2. Create an Airgap Installation Bundle (AIB):

```sh
Expand All @@ -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=<LICENSE_ID>" -o automate-4.x.y.aib
```

Replace `<LICENSE_ID>` 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
Expand Down Expand Up @@ -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=<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=<LICENSE_ID>" -o automate-latest.aib
```

Replace `<LICENSE_ID>` with your commercial license ID.

After downloading, run the upgrade command with airgapped bundle option:

```sh
Expand Down
Loading
Loading