Troubleshooting: Networking¶

No IPv4 available¶

Symptom: NO_IPV4. No free address exists in a pool reachable from the location. Add a pool or expand the CIDR.

Empty pool¶

Symptom: IP_POOL_EMPTY. A specific pool is exhausted. Diagnostics name the pool.

Duplicate IP¶

Symptom: IP_DUPLICATE_ASSIGNMENT (CRITICAL). Two canonical addresses collide. This is never auto-reassigned; resolve it manually.

Network mapping missing¶

Symptom: NETWORK_MAPPING_MISSING. The bridge is no longer active in the last provider asset sync. Re-run the asset sync and confirm the bridge exists.

Private network locality¶

Symptom: PRIVATE_NETWORK_LOCALITY. A private network is local to the host, so the instance cannot move across hosts without a shared network.

Firewall rule limit¶

Symptom: FIREWALL_RULE_LIMIT_REACHED. Remove unused rules before adding more.

Reverse DNS¶

If a customer's rDNS request stays pending, check the pool's rdns_driver and the admin rDNS queue. Approve, complete or reject the request.

Commands¶

php artisan pterocloud:ipam:audit
php artisan pterocloud:network:inspect <instance_uuid>
php artisan pterocloud:network:dry-run <instance_uuid>
php artisan pterocloud:ip:inspect <address>

Diagnostics never ping random internet hosts; only structural state is checked.

Networking
IPAM
PC-NET-### / PC-IPAM-### in the error reference