# Migrating from LTS1 to LTS2

With LTS2, it is necessary to migrate existing management server environments running on VMs to be able to run as a management cluster. The following steps walk through that process.

### **Download and Install new Airctl packages.**

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

```bash
./download.sh v-5.6.0-xxxx
./install.sh v-5.6.0-xxxx
```

{% endtab %}
{% endtabs %}

### **Run Pre-Checks**

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

```bash
/opt/pf9/airctl/airctl migrate-pre-checks --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

**Backup Management Server**

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

```bash
/opt/pf9/airctl/airctl backup --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

Ensure that the backup generated has the mongo and mysql data.

### **Stop and delete** **Management Server**

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

```bash
/opt/pf9/airctl/airctl stop --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

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

```bash
/opt/pf9/airctl/airctl unconfigure-du --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

**Update Airctl config to use new** **Management Server** **values**

Specifically, the following fields need to be set in\*\*\`\`\`\`/opt/pf9/airctl/conf/airctl-config.yaml:\`\`\*\*

{% tabs %} {% tab language="yaml" title="YAML" %} {% code %}

```yaml
installDriver: DDU

kubeCfgPath: /etc/nodelet/airctl-mgmt/certs/admin.kubeconfig
bootstrapCfgPath: /etc/nodelet/airctl-mgmt/airctl-mgmt.yaml
svcDeploymentTimeout: 600
storageProvider: hostpath-provisioner
externalIP: <external-ip>
privateRegistryType: DU
```

{% endcode %} {% endtab %} {% endtabs %}

The externalIP needs to be a VIP on the same L2 network as the nodelet host(s), but different from the nodelet host's IP.

### **Nodelet Prerequisites**

Uninstall docker

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
yum remove docker-ce containerd
```

{% endcode %} {% endtab %} {% endtabs %}

Install libcgroup-tools

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
yum install libcgroup-tools
```

{% endcode %} {% endtab %} {% endtabs %}

**Deploy nodelet cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl advanced-ddu create-mgmt --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Initialize airctl**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl init --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Deploy** **Management Cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl start --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

Wait for **Management Cluster** services to be up

The `airctl status` command reports the state of the Management Server. Wait until the status command reports the task state as `ready`.

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status
------------- deployment details ---------------
fqdn:                airctl-1.pf9.localnet
cluster:             airctl-1.pf9.localnet
task state:          ready
-------- region service status ----------
task state:        ready
desired services:  42
ready services:    42
```

{% endcode %} {% endtab %} {% endtabs %}

**Migrate** **Management Server** **data to** **Management Cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl migrate --backup-file <tar.gz-of-cdu-backup> --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Same version upgrade of** **Management Server**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl upgrade --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Wait for** **Management Server** **services to be up**

The `airctl status` command reports the state of the Management Server. Wait until the status command reports the task state as `ready`.

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status
------------- deployment details ---------------
fqdn:                airctl-1.pf9.localnet
cluster:             airctl-1.pf9.localnet
task state:          ready
-------- region service status ----------
task state:        ready
desired services:  42
ready services:    42
```

{% endcode %} {% endtab %} {% endtabs %}

**Configure PMK hosts to work with** **Management Cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl configure-hosts --reset-pf9-managed-docker-conf --skip-docker-img-import --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Upgrade PMK hosts to new components of** **Management Cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl upgrade-hosts --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Wait for Task State to report Ready again**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status
------------- deployment details ---------------
fqdn:                airctl-1.pf9.localnet
cluster:             airctl-1.pf9.localnet
task state:          ready
-------- region service status ----------
task state:        ready
desired services:  42
ready services:    42
```

{% endcode %} {% endtab %} {% endtabs %}

**Migrate previous clusters to run on** **Management Cluster**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
/opt/pf9/airctl/airctl migrate-clusters --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endcode %} {% endtab %} {% endtabs %}

**Push Docker images to** **Management Cluster** **docker registry**

{% tabs %} {% tab language="bash" title="Bash" %} {% code %}

```bash
sudo /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml advanced-du push-images --img-tar /opt/pf9/airctl/imgs/docker-imgs-<airctl-release-version>.tar.gz
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform9.com/self-managed-cloud-platform/5.9/sso-configuration/migrating-from-lts1-to-lts2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.