Check-node Command

The check node command evaluates a node to ensure it meets the requirements for Kubernetes cluster creation. The command checks for the following particulars:

Mandatory Checks
- Existing pf9 packages
- Installing missing packages
- Sudo Access Check
- Ports Check
- OS Check
- Existing Kubernetes Cluster Check
- Check execute permissions on /tmp folder
- Disabling swap and removing swap in fstab
Optional Checks
- Removal of existing pf9ctl (Python-Based CLI)
- Resources(CPU, Disk, Memory check)

Syntax Example

pf9ctl check-node [flags]

All Available Commands and Flags

pf9ctl check-node --help

Check if a node satisfies prerequisites to be ready to be added to a Kubernetes cluster. Read more

at https://platform9.com/blog/support/managed-container-cloud-requirements-checklist/

Usage:

pf9ctl check-node [flags]

Flags:

-h, --help help for check-node

-i, --ip strings IP address of host to be prepared

--mfa string MFA token

-p, --password string ssh password for the nodes (use 'single quotes' to pass password)

-s, --ssh-key string ssh key file for connecting to the nodes

-e, --sudo-pass string sudo password for user on remote host

-u, --user string ssh username for the nodes

Global Flags:

--no-prompt disable all user prompts

--verbose print verbose logs

Command Examples

Check Local Node

pf9ctl check-node

2021-02-22T08:03:41.6565Z INFO Loading config...

Removal of existing CLI : PASS

Existing Installation Check : PASS

SudoCheck : PASS

CPUCheck : PASS

DiskCheck : FAIL

MemoryCheck : PASS

PortCheck : PASS

Node not ready. See /root/pf9/log/pf9ctl-20210222.log or use --verbose for logs

Check Remote Node

pf9ctl check-node -i 10.128.242.250 -u ubuntu

2021-02-22T08:06:40.5506Z INFO Loading config...

Enter Password:

Removal of existing CLI : PASS

Existing Installation Check : FAIL

SudoCheck : PASS

CPUCheck : PASS

DiskCheck : PASS

MemoryCheck : PASS

PortCheck : PASS

Node not ready. See /root/pf9/log/pf9ctl-20210222.log or use --verbose for logs

Last updated by Anagha Pamidi on Jan 26, 2026

Was this page helpful?