For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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

Run Pre-Checks

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

Backup Management Server

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

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

Stop and delete Management Server

/opt/pf9/airctl/airctl stop --config /opt/pf9/airctl/conf/airctl-config.yaml
/opt/pf9/airctl/airctl unconfigure-du --config /opt/pf9/airctl/conf/airctl-config.yaml

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 %}

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 %}

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

Install libcgroup-tools

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

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

Deploy nodelet cluster

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

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

Initialize airctl

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

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

Deploy Management Cluster

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

{% 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 %}

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

Migrate Management Server data to Management Cluster

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

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

Same version upgrade of Management Server

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

{% 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 %}

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

Configure PMK hosts to work with Management Cluster

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

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

Upgrade PMK hosts to new components of Management Cluster

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

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

Wait for Task State to report Ready again

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

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

Migrate previous clusters to run on Management Cluster

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

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

Push Docker images to Management Cluster docker registry

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

Last updated

Was this helpful?