/ iox

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.

What Are The Possible Root Causes of IOx Not Running?
Share this