Cisco UCME / UC500 (AKA Call Manager Express)

These instructions should assist in configuring your Cisco UCME / UC500 to work with TIM Enterprise. If you are not familiar with PBX configuration, please contact your system maintainer.

There are two ways to connect to the Cisco UCME / UC500: RADIUS (RADIUS events are recommended by Cisco) SysLog (Requires SysLog server, not all CDR data received from router)

Cisco UCME / UC500 RADIUS configuration

Configuring your SMDR

Download and configure interface file 3CX.zip

1. Visit Tri-Line's Portal and download the template file, as shown below:

2. Extract the 3CX.zip file to C:\Program Files\Tri-Line\TIM Enterprise\config folder. Zip file should contain CDRTemplate-Socket.xml, 3CX.TDT and 3CX.TDS.

Copy CDRTemplate-Socket.xml to 3CX server

1. Copy CDRTemplate-Socket.xml to the 3CX server into C:\Documents and Settings\All Users\Application Data\3CX\Data\CDRTemplates.
2. Edit CDRTemplate-Socket.xml with the IP address of the machine running TIM Enterprise.
3. Login to your 3CX server and select Settings ? Advanced from the menu.
4. Select CDR output from the Advanced Settings screen.
5. Enable the tick box for Output CDR to Socket (Active - Initiates connection) and click Apply.
6. Under 3CX Phone System, click Service Status and within the Service Name section select 3CX PhoneSystem Call History.
7. Click Restart to load the new XML file.

Configuring TIM Enterprise

Below you will find steps on how to configure TIM Enterprise to listen for SMDR data from your Cisco UCME:

1. Browse to TIM Enterprise as normal and login with your credentials.
2. Click on the Directory tab.
3. Go the the point in the Directory where you need to add the PBX Object and add a PBX with the name 'Cisco UCME'.
4. Left-click on it and select Properties.
5. From the General settings tab select Cisco UCME from the PBX model list.

6. In the Connection tab select Receive FTP transfers from PBX from the Connection method list.
7. In the Username field enter in your username.
8. In the Password field enter in your password.
9. Finally, click on the Save button.

Configuring the FTP connection

You will need to configure your Cisco UCME router to transmit the CDR data using the FTP accounting method.

This method will transmit CDR data files in .CSV format to the FTP server configured within the routers IOS configuration.

The machine that TIM Enterprise is installed on will receive the .CSV files via FTP and process the data.

The steps required are as follows:

1. Login to Cisco router, and type enable followed by the Enter key. (Enter your password if prompted). This will allow you to enter enabled mode and can be confirmed by the command prompt changing to display router name #.
2. Type conf to enter configuration mode. This will be confirmed as a successfully entered because the command line will change to router name (config)#.
3. Type gw-accounting file followed by Enter.
4. Type primary ftp server name / username bob password mypass followed by Enter.

Server name = The DNS name of the server with TIM Enterprise installed or its IP address/ = root of FTP server location.

Bob = FTP username configured within TIM Enterprise.

My pass = The FTP password configured within TIM Enterprise.

5. Type maximum retry-count 3 followed by Enter.
6. Type maximum buffer-size 25 followed by Enter.
7. Type maximum fileclose-timer 60 followed by Enter.
8. Type maximum cdrflush-timer 1 followed by Enter.
9. Type cdr format detailed followed by Enter.
10. Type end followed by Enter.
11. Type wr followed by Enter to save the settings on the routers memory.
12. You may now choose any filename, however the extension of the file is unique and should correspond with the sitecode associated to the Site that has been created in the Directory tab in TIM Enterprise. To find the 'Unique ID', please follow the following steps:
1. Browse to TIM Enterprise as normal and login with your credentials.
2. Click on the Directory tab.
3. Hover the mouse currsor over the Site that you want to log data for. A tooltip will appear that will have the name of the site and in brackets it will show 'Uinque ID :X', X being a numerical value. The numerical value is the actual 'Unique ID' and this is what the file extension should be set to. For example, if you see Unique ID 41392, then your Unique ID is 41392 and you shouls set the extension of the file that is being written to be TIM Enterprise 'Spool' to '41392' e.g. data.1

Cisco UCME SysLog configuration

You will need to configure your Cisco UCME to send the CDR data out using the SysLog accounting method. This method will broadcast messages via UDP. The machine that TIM Enterprise is installed on will need to have a SysLog server installed which can output the information it receives from the Cisco UCME to a file and destination which can be specified to our needs. Kiwi SysLog is a popular SysLog server that has been used for implementation with TIM Enterprise successfully.

Configuring TIM Enterprise

Below you will find steps on how to configure TIM Enterprise to listen for SMDR data from your Cisco UCME:

1. Browse to TIM Enterprise as normal and login with your credentials.
2. Click on the Directory tab.
3. Go the the point in the Directory where you need to add the PBX Object and add a PBX with the name 'Cisco UCME'.
4. Left-click on it and select Properties.
5. From the General settings tab select Cisco UCME from the PBX model list.

6. In the Connection tab select No connection required from the Connection method list.
7. Finally, click on the Save button.

8. When the connection method is set to No connection required this indicates that the SMDR/CDR information is going to be written directly to the TIM Enterprise Spool folder. The application which writes the file will need to be setup so it writes to file to the following location: \program files\tri-line\tim plus\spool\.
9. You may now choose any filename, however the extension of the file is unique and should correspond with the sitecode associated to the Site that has been created in the Directory tab in TIM Enterprise. To find the 'Unique ID', please follow the following steps:
1. Browse to TIM Enterprise as normal and login with your credentials.
2. Click on the Directory tab.
3. Hover the mouse currsor over the Site that you want to log data for. A tooltip will appear that will have the name of the site and in brackets it will show 'Uinque ID :X', X being a numerical value. The numerical value is the actual 'Unique ID' and this is what the file extension should be set to. For example, if you see Unique ID 41392, then your Unique ID is 41392 and you shouls set the extension of the file that is being written to be TIM Enterprise 'Spool' to '41392' e.g. data.1

Configuring the SysLog connection

You will need to configure your Cisco UCME router to transmit the CDR data using the SysLog accounting method.

This method will transmit CDR data files as events to the syslog server configured within the routers IOS configuration.

The machine that is running the syslog server will receive the events and write them to a file, TIM Enterprise will then process the files.

The steps required are as follows:

1. Login to Cisco router, and type enable followed by the Enter key. (Enter your password if prompted). This will allow you to enter enabled mode and can be confirmed by the command prompt changing to display router name #.
2. Type conf to enter configuration mode. This will be confirmed as a successfully entered because the command line will change to router name (config)#.
3. Type wr followed by Enter to save the settings on the routers memory.
4. Download and install Kiwi syslog from http://www.kiwisyslog.com.
5. Configure Kiwi to save received data to the spool folder of TIM Enterprise. Click File and then Setup.
6. Followed by clicking on Log to file.
7. Within the Path and file name of the log file area, change the path to c:\ProgramFiles\Tri-Line\TIM Enterprise\Spool\.X where X is the Site Code number configured within TIM Enterprise. (Pleas see Configuring TIM Enterprise above).

8. Click Apply followed by OK.