Title
Create new category
Edit page index title
Edit category
Edit link
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.
xxxxxxxxxx./download.sh v-5.6.0-xxxx./install.sh v-5.6.0-xxxxRun Pre-Checks
xxxxxxxxxx/opt/pf9/airctl/airctl migrate-pre-checks --config /opt/pf9/airctl/conf/airctl-config.yamlBackup Management Server
xxxxxxxxxx/opt/pf9/airctl/airctl backup --config /opt/pf9/airctl/conf/airctl-config.yamlEnsure that the backup generated has the mongo and mysql data.
Stop and delete Management Server
xxxxxxxxxx/opt/pf9/airctl/airctl stop --config /opt/pf9/airctl/conf/airctl-config.yamlxxxxxxxxxx/opt/pf9/airctl/airctl unconfigure-du --config /opt/pf9/airctl/conf/airctl-config.yamlUpdate Airctl config to use new Management Server values
Specifically, the following fields need to be set in````/opt/pf9/airctl/conf/airctl-config.yaml:``
xxxxxxxxxxinstallDriver: DDU kubeCfgPath: /etc/nodelet/airctl-mgmt/certs/admin.kubeconfigbootstrapCfgPath: /etc/nodelet/airctl-mgmt/airctl-mgmt.yamlsvcDeploymentTimeout: 600storageProvider: hostpath-provisionerexternalIP: <external-ip>privateRegistryType: DUThe 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
xxxxxxxxxxyum remove docker-ce containerdInstall libcgroup-tools
xxxxxxxxxxyum install libcgroup-toolsDeploy nodelet cluster
xxxxxxxxxx/opt/pf9/airctl/airctl advanced-ddu create-mgmt --config /opt/pf9/airctl/conf/airctl-config.yamlInitialize airctl
xxxxxxxxxx/opt/pf9/airctl/airctl init --config /opt/pf9/airctl/conf/airctl-config.yamlDeploy Management Cluster
xxxxxxxxxx/opt/pf9/airctl/airctl start --config /opt/pf9/airctl/conf/airctl-config.yamlWait 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.
xxxxxxxxxx[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status------------- deployment details ---------------fqdn: airctl-1.pf9.localnetcluster: airctl-1.pf9.localnettask state: ready-------- region service status ----------task state: readydesired services: 42ready services: 42Migrate Management Server data to Management Cluster
xxxxxxxxxx/opt/pf9/airctl/airctl migrate --backup-file <tar.gz-of-cdu-backup> --config /opt/pf9/airctl/conf/airctl-config.yamlSame version upgrade of Management Server
xxxxxxxxxx/opt/pf9/airctl/airctl upgrade --config /opt/pf9/airctl/conf/airctl-config.yamlWait 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.
xxxxxxxxxx[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status------------- deployment details ---------------fqdn: airctl-1.pf9.localnetcluster: airctl-1.pf9.localnettask state: ready-------- region service status ----------task state: readydesired services: 42ready services: 42Configure PMK hosts to work with Management Cluster
/opt/pf9/airctl/airctl configure-hosts --reset-pf9-managed-docker-conf --skip-docker-img-import --config /opt/pf9/airctl/conf/airctl-config.yamlUpgrade PMK hosts to new components of Management Cluster
xxxxxxxxxx/opt/pf9/airctl/airctl upgrade-hosts --config /opt/pf9/airctl/conf/airctl-config.yamlWait for Task State to report Ready again
xxxxxxxxxx[centos@airctl-host ~]$ /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml status------------- deployment details ---------------fqdn: airctl-1.pf9.localnetcluster: airctl-1.pf9.localnettask state: ready-------- region service status ----------task state: readydesired services: 42ready services: 42Migrate previous clusters to run on Management Cluster
xxxxxxxxxx/opt/pf9/airctl/airctl migrate-clusters --config /opt/pf9/airctl/conf/airctl-config.yamlPush Docker images to Management Cluster docker registry
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