Skip to main content

CallManager Express GUI Software Installation & Configuration - Part 2

This article covers the installation of Cisco's CallManager Express on Cisco routers. Here you'll find the necessary installation commands, files to download, router's HTTP server configuration commands along side with the commands to activate the web CME interface and access it via a web browser.

Installing the CallManager Express GUI Files

As mentioned in our previous article CallManager Express GUI Software Installation & Configuration - Part 1, we'll be installing the file containing the basic CallManager GUI files. This is a common practice over the full version as free space on the system's flash is often a problem.

The 40MB .tar file (cme-basic-7.1.0.1.tar) should just about it on a system with a 128MB flash that already contains the Cisco IOS on it. While this file can be viewed using Winzip, it is intended to be extracted directly on to your CallManager platform using the CLI interface.

Using the necessary commands, the cme-full-7.1.0.1.tar file is extracted directly on to the device's flash memory. This means you must ensure you have enough free space on your router or UC500 flash, otherwise the extraction process will fail.

To extract the file, launch a TFTP server and ensure the file is accessible by the tftp server, then follow the below command:

R1# archive tar /xtract tftp://10.0.0.10/cme-basic-7.1.0.1.tar flash:
Loading cme-basic-7.1.0.1.tar from 10.0.0.10 (via FastEthernet0/0): !
extracting APPS-1.2.1.SBN (2593969 bytes)!!!!!!!!!!
extracting apps11.8-4-1-23.sbn (2925555 bytes)!!!!!!!!!!!

The 'archive tar /xtract' command tells the router or UC500 to load the .tar file from our tftp server and extract it directly on to the router's flash. In total, our example had 132 files of which only 18 are the essential GUI files.

Opening the .tar file using Winzip and locating the files with the path 'gui\' will reveal the GUI related files:

In the worst-case scenario, if there is limited space on the CallManager Express flash memory, simply extract the files with the 'gui\' path and upload them individually in the root directory of your flash memory.

Once uploaded on the router's flash, next step is to enable the router's http server, configure the authentication method, so that the router uses its local user accounts for authentication, and finally create a local user account with privilege 15 access and lower the file privilege level required for file operations. The file privilege command is necessary, otherwise we might experience telephony_service_server_get_action url:/ccme.html errors without any web page loading:

R1(config)# ip http server
R1(config)# ip http authentication local
R1(config)# username firewall privilege 15 secret mysecret
R1(config)# file privilege 0

Alternatively, for increased security, it is possible to specify a user that will only be used for the CallManager Express GUI interface. This user will not have any other type of access to the CCME router as it is not considered a 'local account':

R1# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
R1(config)# telephony-service
R1(config-telephony)# web admin system secret 0 mysecret

When entering the password or secret, type 0 reflects a non-encrypted password where as type 5 reflects an encrypted password.

We are now ready to access the Cisco CallManager Express GUI Interface using the following URL: http://10.0.0.1/ccme.html. This example assumes that the CallManager Express system is on IP address 10.0.0.1.

When typing the URL in our web browser, the system will request for a username and password. We enter the credentials accordingly and are presented with the CallManager Express homepage:

tk-cisco-ccme-gui-p2-2

From here, we are able to configure basic system parameters, ip phone devices, create and assign extensions, receive basic call reports and much more.

The scope of this article will cover as much as the basic system parameter since the rest will be covered in future articles.

The begin setting up the basic system parameters, select 'Configure > System Parameters'. This will load the system parameter page where a number of options are available:

tk-cisco-ccme-gui-p2-3

The most important parameters are outlined below:

  • Administrator's Login Account - create or reset new CCME GUI accounts.
  • Date and Time Format - The date/time format displayed on the IP Phones.
  • IP Phone URLs - The urls IP Phones must use in order to obtain access to advanced features such as XML services or Internet.
  • Max. Number of IP Phones - The maximum number of IP Phones allowed to register to our CCME system. This number cannot be more than the max. number of phones supported by the system.
  • System Message - The message or company name displayed on all IP Phones.
  • System Time - Allows the setting of year, month, day and time. If this option is not available, it will be necessary to enter the 'time-webedit' command under the 'Telephony-service' section using the CLI prompt.
  • Timeout - The number of seconds between interdigit timeout (how long the system will wait as a user is entering a phone number, before timing out), ringing and busy timeout.
  • Transfer Patterns. The pattern of destination phone number(s) allowed for transferring calls to external numbers. e.g to allow an incoming to call to be transferred to an external mobile (by placing another call), the mobile's number or pattern must be entered here, otherwise the system won't permit it.
  • MOH File - Music-On-Hold file. This is the music file played when a caller is placed on-hold. The file is sampled at 8Khz, mono, 8bit and saved using .wav A/mu-Law format.

As the parameters are set, the data entered are translated into CLI commands and placed under the 'Telephony-service' section of the router's or UC's configuration.

Below is the 'Telephony-service' configuration from a working CCME system. Notice that there are a lot more commands entered than available from the web interface, however it is fairly easy to locate the ones covered with the GUI interface. In-depth analysis and configuration of the telephony-service will be covered on another article:

R1# sh run | sec telephony-service
telephony-service
video
maximum bit-rate 300
max-ephones 30
max-dn 100
ip source-address 10.0.0.1 port 2000
auto assign 1 to 100
service phone videoCapability 1
timeouts interdigit 4
system message Firewall.cx
url services http://10.0.0.4/
network-locale GB
load 7914 S00104000100
load 7906 SCCP11.8-2-2SR1S
load 7911 SCCP11.8-2-2SR1S
load 7921 CP7921G-1.1.1
load 7931 SCCP31.8-2-2SR1S
load 7941 SCCP41.8-3-3S
load 7942 SCCP42.8-3-2S
load 7945 SCCP45.8-3-2S
load 7962 SCCP42.8-3-2S
load 7965 SCCP45.8-3-2S
load 7975 SCCP75.8-3-2S
time-zone 24
time-format 24
date-format dd-mm-yy
voicemail 88
max-conferences 8 gain -6
moh flash:north-gate.wav
multicast moh 239.10.16.4 port 2000
web admin system name admin secret 5 tLhc4.7jdhwlZp96HjC.
dn-webedit
time-webedit
transfer-system full-consult
transfer-pattern 4.
transfer-pattern 6948......
after-hours pstn-prefix 4 4
night-service code *1234
create cnf-files version-stamp Jan 01 2002 00:00:00

 Once complete, Cisco CallManager Express is ready to accept new IP phones and extensions.

As a last note, we should warn that Mozzila Firefox seems to have issues handing the javascript the GUI interface uses. This is especially evident when trying to assign extensions to physical IP phone buttons.

If you are using Mozzila Firefox and stumble into problems with the GUI interface, try switching to Internet Explorer - amazingly as it might sound, no problems have been encountered with it so far!

Summary

This article covered the Cisco CallManager Express GUI interface and how it relates to different IOS versions. We examined the CCME version contained in each IOS and where to obtain the necessary files.

We also saw the information contained in each CallManager Express specification page, how to select and download the appropriate CCME GUI files and what they contain.

Closing, we showed how to install the Cisco CallManager Express GUI files onto a Cisco router or UC500 series platform and provided the necessary commands required to get the GUI working. Basic system parameters were also covered, giving a view of the available options for Cisco CallManager Express.

  • Hits: 101515

CallManager Express GUI Software Installation & Configuration - Part 1

cisco-ccme-gui-part-1-1Cisco CallManager Express, also known as CME or CCME, runs on both Cisco ISR Routers and UC500 platform, including UC520, UC540 and UC560.

CallManager Express's PBX functionality is built into the IOS that runs on all the above devices. When the router or UC500 series device loads the IOS, the administrator is able to start configuring VoIP services as required.

One of the most common questions regarding CallManager Express configuration is what methods are available to actually configure the product?

Depending on the platform, there are currently up to three different ways to configure CallManager Express, . If CallManager Express is running on a ISR router (2800, 3800, 2900 & 3900 series routers) users, have the GUI Web and Command Line Interface (CLI) at their disposal, where as users on the UC500 platform have also got the Cisco Configuration Assistance (CCA) tool - an application that installs and runs on a workstation and guides you through a step-by-step menu to easily setup your VoIP PBX.

The common methods amongst the two platforms (ISR & UC500) is the Cisco CallManager Express Graphical User Interface and CLI interface. This article will explain how to install and configure the Cisco CallManager Express GUI but also cover the most important configuration options offered by it.

Matching IOS & GUI Files

Engineers who have dealt with Cisco CallManager Express will have noticed that its version changes depending on the IOS version. As noted in our Cisco CallManager Express introduction page (INSERT LINK), the CallManager Express service is embedded inside the Cisco IOS. The newer IOS, the newer CallManager Express version you get.

Remember that up to IOS version 12.4.26, only the following IOS's have the CallManager Express capabilities embedded:

- SP Services
- Adv. IP Services
- Adv. Enterprise Services

As of the latest major IOS Version, 12.5.x, Cisco has replaced all previous IOS's with one-universal IOS that has all previous IOS version features (12.4), but requires you to purchase the correct activation key to enable the additional services you need.

For example, VoIP Services such as CallManager Express are covered under the Unified Communications (UC) license. Purchasing and installing the UC activation license, will enable these features.

The table below illustrates the Cisco IOS releases, CallManager Express versioning and CallManager Express GUI version that should be used or installed on the device (router or UC500):

Cisco IOS Release
Cisco Unified CME Version
Cisco Unified CME GUI Version
Specifications Link
15.2(2)T 9.0 9.0.0.0 CME 9.0 Link
15.1(4)T
8.6
8.6.0.0
CME 8.6 Link
15.1(3)T
8.5
8.5.0.0
CME 8.5 Link
15.1(2)T
8.1
8.1.0.0
CME 8.1 Link
15.1(1)T
8.0
8.0.0.0
CME 8.0 Link
15.0(1) XA
8.0
8.0.0.0
CME 8.0 Link
15.0(1) M
7.1
7.1.1.0
CME 7.1 Link
12.4(24)T
7.1
7.1.0.0
CME 7.1 Link
12.4(22)T
7.0(1)
7.0.0.1
CME 7.0 Link
12.4(20)T
7.0
7.0.0.0
CME 7.0 Link
12.4(15)XZ
4.3
4.3.0.0
CME 4.3 Link
12.4(11)XW9
4.2
4.2.0.4
CME 4.2 Link
12.4(15)T
4.1
4.1.0.2
CME 4.1 Link
12.4(11)T
4.0(2)
4.0.3.1
CME 4.0(2) Link
12.4(9)T
4.0(0)
4.0.0.1
CME 4.0 Link
12.4(6)T
3.4
3.4.0.1
CME 3.4 Link

It is evident that there is a wide range of version to select from and as a general thumb of rule, the latest is the best option.

From experience, most version are stable enough for a production environment, however version 12.4.22T is an extremely buggy IOS version, especially when VPN tunnels are involved. It's best to try and avoid it.

As soon as the IOS version running on the router is identified, you'll need to download and install the necessary CME software and phone firmware files from the Cisco Software Download center.

For example, assume IOS version 12.4.24 (SP Services, Adv. IP services or Adv.Enterprise version) is installed on the router, according to the above table, it contains CME version 7.1 and will therefore require the relavent GUI files.

Note: You can also download the CCME GUI Interface files directly from Firewall.cx. For more information, visit our CCME GUI Download article.

To obtain and install these files, follow the relevant link on the column named 'Specifications Link'. This will load Cisco's page where you'll be able to find all necessary files for the CME version you require.

The Specifications Link page includes a wealth of information, that includes:

  • Supported Cisco IP Phones
  • Necessary firmware version for each IP Phone supported
  • Supported platform. E.g Cisco 1861, 2801, 2811, 2911 e.t.c
  • Supported devices per platform. E.g Cisco 1861 will support up to 12 IP Phones with CME version 7.1
  • Dram & Flash Memory requirements for the specific CME version
  • Compatible Voice Products. E.g Unity Express, VG224 and more

The Specifications Link page is extremely important as it can help you examine if you meet the requirements and save you a lot of time and trouble. It is strongly suggested the whole page is read, so the information contained is clearly understood.

When ready, click on the 'Cisco Software Download' link as shown below, to proceed with the download of the CME GUI files:

tk-cisco-ccme-gui-p1-1

This link will take you directly to the Cisco download area. Bare in mind that this will require a CCO account and possibly an account with permissions to download this software, otherwise no access will be provided.

As shown, the download area contains files for all CME versions, but the system will take you directly to the one selected, for our example, version 7.1.

If there's a small difference in the version e.g 7.1.0.1 instead of 7.1.0.0, it doesn't really matter as its more likely to contain small bug fixes and shouldn't create any problems.

tk-cisco-ccme-gui-p1-2

Notice that there are two similar files from which you can select. One named 'basic' and the other 'full'. The difference between each other is purely the amount of files included.

Here's the description for the 'Full Download':

CME 7.1 Full System Files for IOS 12.4(24)T releases. Includes MOH, Ringtones, 7970/71/75 Backgrounds, the following phone loads (7906/11, 7921/25, 7931, 7937, 7941/61, 7942/62, 7945/65, 7970/71, 7975) and updated GUI files for 12.4(24)T

And the 'Basic Download':

CME 7.1 basic system files for IOS 12.4(24)T releases, includes Basic Phone Loads (7906/11, 7921, 7937, 7941/61, 7942/62) with updated GUI for 12.4(24)T

Since the difference between the two is only 30Mb, it is suggested to always download the full version, regardless if required or not. It can be stored away just in case it is needed in the future. For this example, we will download both files, but install the one containing the basic system files.

To continue reading about the installation process of the Cisco CallManager Express GUI, please continue to Part 2 of our guide.



  • Hits: 199195