Airctl Reference
Airctl
Airctl is Platform9's On-Prem, air gapped Kubernetes orchestrator that comprises a useful command-line utility and related functions that manages the lifecycle of the DDU in the Platform9 management plane. Additionally, it also contains auxiliary functions like:
- DNS management: A straightforward way to ensure all the other nodes can reach the temp management plane when it starts.
- Image management: Populating the image cache onto various nodes to avoid image fetching when the management plane is not running. This setup includes the docker images as well as RPM packages.
- State management: starts the management plane (creates and configures it first if necessary)
- Platform9 uses a mysql database. Airctl would help with the backup of that data. However, since we are only looking at a three-node cluster, the amount of backup data would be minimal.
- Config File: config files describe the state of the cluster that the user wants to create and contain the pointers (ip addresses) for Kubernetes nodes and their corresponding credentials.
- Other CLI utilities to help with backup and recovery of the ‘state'.
Airctl CLI Options
x
$ /opt/pf9/airctl/airctlUsage Syntax: airctl [command]Available Commands: advanced-du advanced command for the du configuration advanced-hosts advanced command for the hosts configuration backup backs up the the management plane's state to a tar.gz file configure-hosts configure the hosts configure-localhost configures the local host's qemu hook and /etc/hosts file (requires sudo) configure-sso configure sso gen-support-bundle generate support bundle get-creds displays the admin username (email) and initial generated password get-du-version displays the DU's release version help Help about any command host-status reports the statuses of all hosts restore restores the management plane from a backup rollback attempts to rollback a failed management plane upgrade operation start starts the management plane (creates and configures it first if necessary) status reports the status of the management plane stop stops the management plane if it is running unconfigure-du delete the management plane's configuration state upgrade upgrades a new management plane VM using specified disk upgrade-hosts upgrade Platform9 agent on all hostsFlags: --config string config file (default is $HOME/airctl-config.yaml) -h, --help help for airctl --verbose print verbose logs to the console -v, --version version for airctlUse "airctl [command] --help" for more information about a command.Host Configuration Options
Here is an outline of the different options which can be passed using the configure-hosts flag.
$ /opt/pf9/airctl/airctl configure-hosts --configError: flag needs an argument: --configUsage Syntax: airctl configure-hosts [flags]Flags: -h, --help help for configure-hosts --skip-docker-img-import skip import the docker images on each hosts --skip-docker-install skip docker install on each hosts --skip-image-renaming skip image renaming to point to the privateRegistryBase, for e.g gcr.io/hyperkube will become <privateRegistryBase>/hyperkube --skip-yum-repo-install skip yum repo installation, default to falseGlobal Flags: --config string config file (default is $HOME/airctl-config.yaml) --verbose print verbose logs to the consoleExplanation of each Skip Flag:--skip-docker-img-import: By default, the cache of docker images required to stand up the cluster are copied over to the hosts to pre-warm the local docker cache. This option skips that step; the host will now rely on the local registry to serve these images.--skip-docker-install: By default, airctl installs docker as a part of the host configuration. With this option set, airctl skips that step and expects the host to come with its own docker installed. Note: Passing this option also skips installation of the docker images--skip-image-renaming: If the airctl-config.yaml has private registry turned on, i.e, has the privateRegistryType field set to anything but none, the host configuration step will automatically rename images to point to the local registry instead of its upstream versions. Pass this option to continue copying over upstream versions of the images to the hosts. Note: This option is meaningless if the --skip-docker-img-import option is passed--skip-yum-repo-install: Pass this option to prevent airctl from installing the local yum repos for pf9-hostagent and other associated packages. Instead, the host is expected to pick these packages up from an external yum repo.Was this page helpful?