When you install a Cisco UE module, problems might occur in downloading the software package. These problems might be caused by network connectivity or package issues. This section discusses some common problems that might occur during software installation of Cisco UE and ways to troubleshoot them.
Network Connectivity Issues
If the Cisco UE module is unable to establish contact with the FTP server where the software load resides, the error shown in Example 19-13 occurs when you attempt to install the software.
Example 19-13. Installation Failed
cueinstaller#>software install package url ftp://username:firstname.lastname@example.org/ cue-vm.18.104.22.168.pkg RAMDisk mounted Connecting to host... curl: (7) Connect failed ERROR: Host did not respond. Please check the host ip and try again. RAMDisk unmounted
First ensure that the IP address of the FTP server is correct. Verify all the parameters given in the install command. If you are sure these are all correct, verify the IP connectivity from the Cisco UE module to the router. Reboot the Cisco UE module, as shown in Example 19-14, and press *** at the first prompt. This action takes you to the bootloader prompt.
Example 19-14. Checking IP Connectivity Between Cisco UE and the FTP Server
cueinstaller#>reboot WARNING: This will reboot the Service Engine! Do you wish to continue (y,n) [n] y
The bootloader has a ping command, as shown in Example 19-15.
Example 19-15. Checking IP Connectivity from the Bootloader
ServicesEngine boot-loader> ping 22.214.171.124 Sending 5, 32 byte ICMP Echos to 126.96.36.199: ..... Success rate is 0% (0/5) ServicesEngine boot-loader> ping 188.8.131.52 Sending 5, 32 byte ICMP Echos to 184.108.40.206: !!!!! Success rate is 100% (5/5)
If the Cisco UE system cannot ping the FTP server, you might have the wrong configuration of IP parameters in the bootloader. Example 19-16 shows how to check the bootloader configuration. If you see anything wrong, you can use the bootloader config command to make modifications.
Example 19-16. Checking the Bootloader Configuration
ServicesEngine boot-loader>show config IP addr: 220.127.116.11 Netmask: 255.255.0.0 TFTP server : 18.104.22.168 GW IP addr: 22.214.171.124 Default boot: disk Bootloader Version: 1.0.17 Default Helper-file: cue-installer.1.1.1 Default BIOS: primary Default bootloader: primary Default cpu throttle: 50%
Another reason why the ping command might not be successful is the routing configuration on the Cisco IOS router. With an ip unnumbered configuration for the service-engine interface, you can verify the routing as follows:
Example 19-17. Verifying Routing Table Information for Cisco UE Connectivity
router#show ip route Codes: C - connected, S - static, R - RIP, M - mobile, B - BGP D - EIGRP, EX - EIGRP external, O - OSPF, IA - OSPF inter area N1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2 E1 - OSPF external type 1, E2 - OSPF external type 2 i - IS-IS, su - IS-IS summary, L1 - IS-IS level-1, L2 - IS-IS level-2 ia - IS-IS inter area, * - candidate default, U - per-user static route o - ODR, P - periodic downloaded static route Gateway of last resort is 126.96.36.199 to network 0.0.0.0 188.8.131.52/8 is variably subnetted, 2 subnets, 2 masks C 184.108.40.206/16 is directly connected, FastEthernet0/0 S 220.127.116.11/32 is directly connected, Service-Engine1/0 18.104.22.168/24 is subnetted, 1 subnets S 22.214.171.124 [1/0] via 126.96.36.199 10.0.0.0/24 is subnetted, 1 subnets C 10.10.10.0 is directly connected, FastEthernet0/1 188.8.131.52/24 is subnetted, 1 subnets S 184.108.40.206 [1/0] via 220.127.116.11 S* 0.0.0.0/0 [1/0] via 18.104.22.168
When the show ip route command is executed, a host route similar to the one highlighted in Example 19-17 should be displayed (where 22.214.171.124 is the IP address of your Cisco UE module and Service-Engine 1/0 is the Cisco UE module seated in NM slot 1 of the router). If such a route does not show in your routing table, use the following command to add it:
router(config)#ip route 126.96.36.199 255.255.255.255 Service-Engine 1/0
Software Package Issues
Sometimes a problem might occur in downloading the software, such as if binary mode was not used in the FTP command. This causes a problem when installing the software, such as the error shown in Example 19-18.
Example 19-18. Failed Installation Caused by Corrupted Files
cueinstaller#>software install package ftp://username:email@example.com/pkg/ cue-vm.188.8.131.52.pkg RAMDisk mounted Connecting to host... % Total % Received % Xferd Average Speed Time Curr. Dload Upload Total Current Left Speed 100 92785 100 92785 0 0 221k 0 0:00:00 0:00:00 0:00:00 2623k RAMDisk unmounted ERROR:: Security Header Validation Failed.
The error shown in Example 19-19 indicates that not all the files needed for installation are present on the FTP server.
Example 19-19. Failed Installation Caused by a Missing File
cueinstaller#>software install package ftp ://username :firstname.lastname@example.org/ cue-vm.1.1.1pkg Created RAMDisk. File System Type = reiser RAMDisk mounted Connecting to host... % Total % Received % Xferd Average Speed Time Curr. Dload Upload Total Current Left Speed 100 92811 100 92811 0 0 361k 0 0:00:00 0:00:00 0:00:00 8822k Core File List is Signed Retrieving cue-vm.1.1.1.manifest from 184.108.40.206 Retrieve manifest from server failed. RAMDisk unmounted Connecting to host... curl: (19) cue-vm.1.1.1.manifest: No such file or directory ERROR: The requested file does not exist on host. Please check the package name and try again.
To recover from these software package installation errors, again download the software to the FTP server. Ensure that three types of files are present on the FTP server:
Along with the available software image packages, a bootloader package is available. All Cisco UE software versions have a minimum bootloader version requirement. The manifest does not check that the minimum bootloader version is present in the system. Refer to the Cisco UE documentation to identify the bootloader version that is compatible with the Cisco UE software version you're trying to install. The exact files that comprise the installation might also vary from release to release. The examples in this section pertain to Cisco UE 1.1.1.
Troubleshooting Cisco UE Startup
Part I: Cisco IP Communications Express Overview
Introducing Cisco IPC Express
Building a Cisco IPC Express Network
Cisco IPC Express Architecture Overview
Part II: Feature Operation and Applications
Cisco IP Phone Options
Cisco CME Call Processing Features
Cisco CME PSTN Connectivity Options
Connecting Multiple Cisco CMEs with VoIP
Integrating Cisco CME with Cisco CallManager
Cisco IPC Express Automated Attendant Options
Cisco IPC Express Integrated Voice Mail
Cisco CME External Voice Mail Options
Additional External Applications with Cisco CME
Part III: Administration and Management
Cisco IPC Express General Administration and Initial System Setup
Configuring and Managing Cisco IPC Express Systems
Cisco IPC Express System Configuration Example
Part IV: Maintenance and Troubleshooting
Troubleshooting Basic Cisco IPC Express Features
Troubleshooting Advanced Cisco CME Features
Troubleshooting Cisco CME Network Integration
Troubleshooting Cisco UE System Features
Troubleshooting Cisco UE Automated Attendant
Troubleshooting Cisco UE Integrated Voice Mail Features
Part V: Appendixes
Appendix A. Cisco IPC Express Features, Releases, and Ordering Information
Appendix B. Sample Cisco UE AA Scripts
Appendix C. Cisco Unity Express Database Schema