Contents
Backup support
The backup mechanisms and tools vary from vendor to vendor. Below is a brief description of the supported IMPORT backup formats and methods for each
Alcatel/Lucent OmniPCX
The standard tab format from an Alcatel OmniPCX appears as follows:-
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live Alcatel -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.txt”
Asterisk/FreePBX (and derivatives)
First of all, obtain a backup through the web portal for the Asterisk/FreePBX by selecting the top menu, then click “Admin” and select “Backup & Restore”
Select “Add Backup”
Under “Add Backup” Give the backup a name and a description.
Under “Storage” click the drop-down menu and select the file storage location you can access (create one if none are shown)
Click “Submit” in the lower right corner of the page. Doing so will return you to the “Backup & Restore” page.
Running the backup
On the “Backup” tab of the “Backup & Restore” page click the “play” icon under the “Actions” heading.
You will be presented with a scrolling log of the backup in real time. Depending on the size and complexity of your PBX this may take some time.
When your backup is complete, a blue banner stating “Your backup has finished” will briefly appear. If you happen to miss this banner look for a line stating “Finished saving to selected filestore locations” in the log.
Select “Close” on the log display
Downloading the Backup
On the “Backup & Restore” page select the “Restore” tab and click the “Download” icon in the “Actions” field of the “Restore from local cache” block.
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live Alcatel -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.tar.gz”
Cisco CUCM
The Cisco CUCM decoder utilises the “BATS backup” capability of the CUCM. To obtain and import a BATS backup, follow these steps.
Login to the Cisco Unified Administration
Login into the “Cisco Unified CM Administration” portal from a Web Browser, note: Firefox is recommended for older Cisco CUCM’s due to HTML compatibility issues on other browsers.
Creating the backup
Select the “Export” function from “Bulk Administration” in the top menu
Enter a suitable name for the backup and press “Submit”
You should see the following message appear in the status panel
Check Scheduler
Go to the Scheduler to ensure that the backup job in progress
If the job says “Hold”, activate it by ticking the checkbox and clicking on “Activate Selected”
If the job appears to get stuck on “Pending”, us the “Cisco Unified Serviceability” interface and ensure that the AXL, BPS and TAPS services are all activated (Note: this requires Admin access)
When completed, the status will change
Downloading the backup
Select “Upload/Download” files in the “Bulk Administration” menu.
Enter the prefix you entered in 2.2 and click on “Find”
Select the backup and click on “Download Selected”
Finally, save the file on your local system to use as an import to UCentric Voice Audit.
Cisco backups performed from the standard web portal for the Cisco CUCM. This generates a .tar file. You can import this into UCentric the Universal Decoder, through the site manager in the web portal or from the command line using
Audit.exe Live CISCO -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.tar”
CUCM CDR Data
If you want to capture actual usage of the CUCM, you can also capture the CDR data at the same time and UCentric will process this when combined with a BATS backup.
Login to the Cisco Unified Serviceability
Login into the “Cisco Unified Serviceability” portal from a Web Browser, note: Firefox is recommended for older Cisco CUCM’s due to HTML compatibility issues on other browsers.
Then select “CDR Analysis and Reporting” from the “Tools” menu.
This will open a new window, select “Export CDR/CMR” from the “CDR” menu
Select the date range (ideally more than 3 months) and click “Export to File”
This will then display the following:-
Right-click and save both files then click on “Close”
Cisco CME (Call Manager Express)
For call manager express you can use the CME GUI and select “Administration -> Save Router Config”
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live CME -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.txt”
Avaya - IP Office
Perform a backup as described here: https://pbxbook.com/ipoffice/iposcimp.html
Login to IP Office Manager
Click on File ➤ Import/Export ➤ Export...
Select the Check Box for All of the configuration, and click OK.
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live IP Office -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.txt”
Microsoft Teams, Lync/Skype for Business
At present this is a semi-automated task that requires domain-admin privileges.
Please contact support@mit-tech.co.uk for more details.
Avaya BCM
The Notel/Avaya BCM audit can be imported from either an Excel config file that looks like this:-
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live BCM -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.xls”
Siemens/Unify HiPath / HiCom
Siemens/Unify HiPath’s can be audited from what is called a “Regen” or “LastLoad” file. Both are .txt files and look something like this:-
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live HiPath -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.txt”
Unify OpenScape OSV
OSV can be imported from a ZIP file that contains .cfg and .csv files for the OSV configuration. It needs at a minimum:-
uc_users.csv UC Users
mediatrix.csv Mediatrix Servers
????_bgl_????.txt Main location devices
DLS-export.csv SIP + Keys
mlhg_??????.csv Hunt groups
export_all.txt Main configuration file
In addition the .cfg files for each gateway will enable UCentric to accurately audit the entire solution.
Then import the zip file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live OSV -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.zip”
MiCollab / MiCC / MiVoice Connect
Backups are achieved through importing standard ‘backups’ downloaded through the MiVoice Connect, MiCollab and MiCC application web portals.
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live MiVB -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.tar”
Audit.exe Live MiCC -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.tar”
Audit.exe Live MiCollab -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.tar”
Mitel 3300 / Legacy MiVB
Backups are achieved through manually exporting the following forms manually, and exporting them from the Mitel Application portal to a CSV file (one for each section) – then zipping them up into a single file for processing
System Options System Capacity Users and Services Configuration Feature Access Codes System Speed Calls Personal Ring Groups Hunt Groups Ring Groups Pickup Groups Paging Groups Call Forwarding Profile DND | Default Account Codes Independent Account Codes System Account Codes Inward Dialling Modification Outward Dialling Modification Trunk Attributes ICP/PBX Network Elements IP/XNET Trunk Groups All IP Telephones Hardware Modules Hardware Compute Cards System IP Properties Network Elements | ACD Agents IDs ACD Agent Skill Groups ACD Express Groups ACD paths ACD Path interflow dialling lists ACD Remote Agent Subgroups Default CESID L2 to CESID CESID Assignment | ARS Call Progress Tone Detection ARS Digit Modification ARS Maximum Dialled Digits ARS Routes ARS Route Lists ARS Route Plans ARS Digits Dialled ARS Leading Digits ARS Node Identities Analog Trunks + Trunk Groups Digital Trunks DID Ranges for CPN Substitution |
Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live MiVB2 -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.zip”
BroadWorks (Broadsoft)
Cisco Broadworks can be audited via two methods. These are.
Using a tool called EMU if the customer has access which can then produce a (Broadsoft) JSON backup. Then import the file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live EMU -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.json”
A direct connection to BroadSoft using the OCI-P protocol. This relies on the customer providing the URL to the XSP server and a group admin and password for each account that requires auditing.
OpenScape Business (OSBiz )
OSBiz can be imported from a standard OSBiz XML input/export file.
It should appear in this form:
<?xml version="1.0" encoding="UTF-8"?>
<osbiz>
<general>
<xml_file_version>1.0</xml_file_version>
<system_type>OSBiz S</system_type>
<system_mode>UC Suite</system_mode>
<system_in_network>false</system_in_network>
</general>
<basic>
<gateway>
<customer_name>Test In House</customer_name>
<contract_number/>
<system_name>Test</system_name>
<gateway_location/>
<contact_address/>
<system_country>United Kingdom</system_country>
<brand>OpenScape Business</brand>
<international_prefix>00</international_prefix>
<national_prefix>0</national_prefix>
<country_code>44</country_code>
<local_area_code/>
<pabx_number/>
<node_id>0</node_id>
<continuous_tone>true</continuous_tone>
</gateway>
Then import the zip file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live OSBiz -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.xml”
NEAX
NEC NEAX systems can be imported from a Standard XLSX backup that has the following tabs:-
You can import the XLSX file into UCentric from within the site manager, Zero-Touch SPA or using the following command line:
Audit.exe Live NEC -S 123 -d 127.0.0.1 -f “relative\path\to\myfile.xlsx”
Call flows
The following PABX vendors exports also include ‘Call Flows’ – This details where a DID/DDI call originating from the public network is routed to an IVR, Hunt Group or ACD call path.
At present this is supported for:-
Mitel MiVC, Mitel MiVB, Avaya CM and Skype for Business
These call flows are included within the Excel Bulk Loader and High-Level Word documents.