# Cluster Creation Using the Airctl

1. Take a backup of the 5.6 management plane by following the [backup guide](https://github.com/platform9/pcd-docs-gitbook/blob/main/PEC/backup-guide/README.md).
2. Destroy the older`1.21` based nodelet cluster using the following commands.

{% tabs %}
{% tab title="Bash" %}

```bash
airctl stop
airctl unconfigure-du --force 
airctl advanced-ddu delete-mgmt
```

{% endtab %}
{% endtabs %}

3. Ensure the older`/etc/nodelet/airctl-mgmt/certs` directory is cleaned up.
4. Download newer `5.9` based artifacts using the download script. Run the `install.sh` script to extract and place the artifacts under `/opt/pf9/airctl` directory.

{% tabs %}
{% tab title="Bash" %}

```bash
bash install.sh v-5.9.0-2847602
```

{% endtab %}
{% endtabs %}

5. Ensure that the management cluster host has configuration of at least 8vCPU, 32GB memory and 250GB disk.
6. Install the pre-requisite `container-selinux` package if not installed.
7. Update the config files as suggested below and deploy the new`1.25` based nodelet management cluster by running the following command.

{% tabs %}
{% tab title="Bash" %}

```bash
airctl advanced-ddu create-mgmt
```

{% endtab %}
{% endtabs %}

Ensure that the `airctl-config.yaml` file is updated to have the new airctl build number.

In the `nodelet-bootstrap.yaml` file ensure that `systemImages` param is set to use newer LTS3 kubedu and nodelet image tar files. And the userImages section points to previous version of kubedu image tars.

Also add `isAirgapped: true` in `nodelet-bootstrap.yaml` if it is offline mode. A snippet of the `nodelet-bootstrap.yaml` is shown below.

{% tabs %}
{% tab title="YAML" %}

```yaml
isAirgapped: true
systemImages:
- /opt/pf9/airctl/imgs/kubedu-imgs-v-5.9.0-2847602.tar.gz
- /opt/pf9/airctl/imgs/nodelet-imgs-v-5.9.0-2847602.tar.gz
userImages:
- /home/centos/patch2/kubedu-imgs-v-5.6.7-2624593.tar.gz
- /home/centos/patch4/kubedu-imgs-v-5.6.7-2658688.tar.gz
```

{% endtab %}
{% endtabs %}

8. Run the restore command by following the [restore guide](https://github.com/platform9/pcd-docs-gitbook/blob/main/PEC/restore-guide/README.md) for `5.6` management plane on top of `1.25` nodelet cluster.
9. Ensure that the DU is in ready state by running the following command and waiting for it to be ready.

{% tabs %}
{% tab title="Bash" %}

```bash
airctl status
```

{% endtab %}
{% endtabs %}

After restore, we should be able to login to UI and view the existing workload clusters.

{% hint style="warning" %}
**Consul Issue:**

After restore, errors seen in the consul pod saying 'ACL not found', which are harmless and can be ignored.

So, we are currently skipping the consul upgrade in the upgrade step and installing the upgraded consul in the restore process itself.
{% endhint %}
