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

Bash
    
 
pf9ctl check-node [flags]
Copy

All Available Commands and Flags

Bash
    
​x
 
pf9ctl check-node --helpCheck 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
Copy

Command Examples

Check Local Node

Bash
    
 
pf9ctl check-node2021-02-22T08:03:41.6565Z INFO  Loading config...​​Removal of existing CLI : PASSExisting Installation Check : PASSSudoCheck : PASSCPUCheck : PASSDiskCheck : FAILMemoryCheck : PASSPortCheck : PASSNode not ready. See /root/pf9/log/pf9ctl-20210222.log or use --verbose for logs
Copy

Check Remote Node

Bash
    
 
pf9ctl check-node -i 10.128.242.250 -u ubuntu2021-02-22T08:06:40.5506Z INFO  Loading config...Enter Password:​Removal of existing CLI : PASSExisting Installation Check : FAILSudoCheck : PASSCPUCheck : PASSDiskCheck : PASSMemoryCheck : PASSPortCheck : PASSNode not ready. See /root/pf9/log/pf9ctl-20210222.log or use --verbose for logs
Copy

Last updated on Jan 23, 2026

Was this page helpful?