What Are The Possible Root Causes of IOx Not Running?

No Guest-OS Registered with Host

Symptoms

Just installed a new IOS or IOx image and the Guest-OS will not register.

sh iox host list
No hosts registered
Remedy
Reinstall IOx. Sometimes it is necessary to install IOx twice. See How Do I Install A New IOx Image?

IOx Will Not Boot

Symptoms
Just installed a new IOS or IOx image and the Guest-OS will not register. Check the IOx console from the IOS command prompt:
telnet 192.168.2.1 2070
The console may be showing "no boot devices found". Check IOS version
sh version
sh platform guest-os

Verify that the IOS version and IOx version are compatible. For instance, IOx Version-1.1.0.4 is compatible with IOS 15.5 and higher. However, IOx Version 1.2.4.2 requires IOS 15.6 or higher.

Root Cause

An old IOS version is being used with a new IOx version.

Remedy

Upgrade to the latest IOS. Uninstall IOx. Install the latest IOx version.

guest-os 1 image uninstall
guest-os 1 image install flash:/ir800-ioxvm.1.2.4.2.bin verify
Note: verify must be specified otherwise the installation may fail.

IOx Isn't Getting an IP Address from DHCP

Symptoms
ping 192.168.2.2 fails
ssh -l root 192.168.2.2 fails
sh ip dhcp pool - Leased addresses: 0
Root Cause

All IP Addresses in DHCP Pool have been excluded.

Remedy

Check existing exclusions:

sh run | sec ip dhcp excluded
...
ip dhcp excluded-address 192.168.2.1 192.168.2.254
...

Replace the offending exclusion

conf t
no ip dhcp excluded-address 192.168.2.1 192.168.2.254
ip dhcp excluded-address 192.168.2.3 192.168.2.254

Note: You will need to remove this exclusion and change the exclusion list to allow IP addresses for PaaS containers. For instance, to allow IOx to get address 192.168.2.2 and the PaaS to get address 192.168.2.10, use these exclusions:

conf t
no ip dhcp excluded-address 192.168.2.3 192.168.2.254
ip dhcp excluded-address 192.168.2.3 192.168.2.9
ip dhcp excluded-address 192.168.2.11 192.168.2.254

The resulting DHCP exclusions should be:

IR809-DM-IOX#sh run | sec ip dhcp excluded-address 192.168.2
ip dhcp excluded-address 192.168.2.1
ip dhcp excluded-address 192.168.2.3 192.168.2.9
ip dhcp excluded-address 192.168.2.11 192.168.2.254

Clear IP leases:

clear ip dhcp pool GuestOS-pool binding *

Should show leases: 0.

Restart IOx to force it to get a DHCP address:

guest-os 1 restart

Look for Heartbeat messages, etc. ping 192.168.2.2 should work.

Cannot SSH into IOx

Symptoms
ssh -l root 192.168.2.2    - fails
or
ssh -l root 192.168.2.2
Password: xxxx             - fails

If you are on the console or have logging enabled for your IOS session, you will see this:

IR809-DHCP#ssh -l root 192.168.2.2
[Connection to 192.168.2.2 aborted: error status 0]
IR809-DHCP#
*Dec 14 16:08:55.597: %SSH-3-AUTH_METH_ERR: Server does not support password or keyboard-interactive authentication
Root Cause
SSH is not running or root password is not set.
Remedy
sshd must be running an it requires the login to have a password. Enable SSH and set the password for root. Enter these commands:
IR809-DM-IOX#iox host exec enablessh IR809-DM-IOX-GOS-1
ssh enabled successfully.

IR809-DM-IOX#iox host exec "resetpw cisco" IR809-DM-IOX-GOS-1
Password reset successfully.