Administration
Setting up a CUCM connection
Connect a CUCM cluster via AXL, enter the voicemail server, change or switch off the connection.
In EasyUC: EasyUC Cisco → Administration → CUCM & Provisioning → CUCM Connections
Images come from the EasyUC lab. Names and example values provide orientation. A different interface language is indicated beside the relevant image.
What it is for
A CUCM connection describes how EasyUC reaches a Cisco Unified Communications Manager: address of the publisher, AXL user, AXL version and, optionally, the voicemail server (Cisco Unity Connection). Each connection stands for one CUCM cluster. All work in the EasyUC Cisco area runs through the connection selected in the header.
From the address entered, EasyUC itself derives the addresses for AXL, the real-time service (RIS), Extension Mobility and the log collection. On saving, EasyUC signs in to the CUCM via AXL, reads the CUCM version and counts end users and phones. If a voicemail server is entered, its sign-in is checked as well.
Through Actions on a connection you reach all further settings of this cluster, for example naming rules, CDR, CUCM backup and CUCM change log. These entries have their own chapters.
Prerequisites
- Sign-in as an administrator (
ROLE_APP_ADMIN). Creating and changing connections is not assigned to any other role. - License with the
cucmmodule. The Voicemail area in the form and most entries under Actions appear only if the license includes provisioning (provisioning). - An application user in the CUCM with AXL access. For the node cards on the dashboard, it additionally needs serviceability permissions, for example through the group “Standard CCM Server Monitoring”.
- The CUCM publisher can be reached via HTTPS from the EasyUC appliance.
- For voicemail: user, password and address of the Unity Connection server, and the voicemail number.
- During initial setup, only one connection can be created. Further ones follow once the setup wizard has been completed.
Step by step: creating a connection
Step by step: updating a connection
Step by step: disabling or enabling a connection
Fields and options
| Field / action | Meaning and use |
|---|---|
| Alias | Name of the connection in the header and in lists. Required, must be unique. |
| AXL Version | Version of the AXL interface: 15.0, 14.0, 12.5, 12.0 or 11.5. Required. After saving, the list shows the version reported by the CUCM. |
| AXL User / AXL Password | Application user of the CUCM for AXL. Required. EasyUC checks the sign-in on saving. |
| AXL URL | Address of the publisher as a host name or IP address, optionally with port and https://. Required. EasyUC stores only protocol, host and port and appends the paths of the CUCM services itself. |
| Device Type | Defines what the connection works with: Phones, Device Profiles (device profiles for Extension Mobility) or Phones and Device Profiles. Default: Phones and Device Profiles. |
| Interne Durchwahl (Ziffern) (internal extension, digits) | 0 = disabled (default). With 2 to 10 digits, EasyUC also shows forwarders to the internal extension for E.164 numbers. Use only if these extensions are unique within the CUCM cluster. The value 1 is not allowed: “Bitte 0 oder eine Länge von 2 bis 10 eingeben.” (please enter 0 or a length of 2 to 10). |
| Can a user log in to multiple devices? | Visible only for the device types with Device Profiles. Default: off. |
| Device Activation Service Enabled? | Default: on. If the option is set, EasyUC offers the selection for automatic registration when desk phones are created (for example when copying or moving users and in automatic provisioning). |
| Location Type | Normal: locations are assigned through number ranges (default). Custom Enduser Attribute: locations are assigned through a custom end-user attribute of the CUCM. Selectable only on creation. |
| Enduser Custom Attribute | Only for location type Custom Enduser Attribute. EasyUC reads the attributes defined in the CUCM. Required for this location type. |
| Ranges | Only for location type Custom Enduser Attribute. With Add you create further ranges, with rm you delete one. From and To are required and may contain only digits, optionally with a leading +. A range may comprise at most 1,000,000 numbers. |
| Check for Translation Pattern/Route Pattern | Option per number range. Default: off. |
| Use for automatically insert | Option per number range. The range is used for automatic number assignment. Default: on. |
| Use a shorter Range for automatically insert? | Visible only if automatic insertion is active. Displays a second From/To pair that further restricts the automatically assigned numbers. |
| Voicemail (switch) | Switches the voicemail integration of the connection on or off. Visible only with a provisioning license. When it is switched off in Update Connection, EasyUC removes the user, password, URL and settings of the voicemail server from the connection. |
| Voicemail User / Voicemail Password / Voicemail URL | Access to the Unity Connection server. Required as soon as the switch is on. The same notation applies to the URL as to the AXL URL. |
| Voicemail Number | Number of the voicemail system (voicemail pilot). |
| Voicemail Profile on Line | Only in Update Connection. Selection of a voicemail profile from the CUCM. |
| Voicemail server have LDAP configured? | Must match the directory integration of the Unity Connection server. Default on creation: on. |
| Enable Voicemail Mailbox | “The EasyUC User will be able to see the Enduser Voicemail Messages” Default: off. |
| Enable Anonymous Messages | “The EasyUC user will not be able to see voicemail message information such as caller ID or caller number” Default: off. |
Columns of the list
| Field / action | Meaning and use |
|---|---|
| Alias | Name of the connection with the enabled or disabled badge. For location type Custom Enduser Attribute, additionally the attribute and number ranges; with the Teams integration switched on, MS Teams Prefix and MS Teams Strip. |
| CUCM | Host of the AXL address, CUCM version (v. …) and the counters endusers, endusers phones and phones. For enabled connections also CUCM License: when you hover over it, License Requirements by Type appears with the columns Type and Current Usage; the last row states the time of the last update. |
| Voicemail | Host of the voicemail server, or a red cross if no voicemail server is connected. |
| Ph. Security / Dir URI / Ph. Control / CDR | Tick or cross per function. With CDR switched on, the logs link opens the CDR logs of the connection. |
| MoH Nodes | Selected MoH nodes or All. |
| CURRI | Info icon with the address of the global CURRI service for this connection. |
| Enduser Site | Status of the end-user site: enabled, Only CFA, request, phonebook and the three voicemail areas. |
| Actions | Actions button with the menu of the connection. |
Checking the result and narrowing down errors
- After saving, the CUCM column shows the version read and the counters. If values are shown there, the AXL sign-in works.
- “Could not connect to CUCM server or username/password do not match”: the CUCM rejects the AXL sign-in or does not respond to AXL. Check the user, password, AXL version and the AXL role of the user.
- “Could not connect to host”: the address cannot be reached from the appliance. Check the host name, port, DNS and firewall.
- “This value should not be blank.” below a field: fill in the required field. With voicemail switched on, the user, password and URL of the voicemail server are required as well.
- “You cannot have all connections disabled”: the last enabled connection cannot be disabled.
- “You can add just one connection during install”: during initial setup, only one connection is possible.
- If an entry is missing under Actions, the connection is disabled or the license does not include provisioning.
- After a certificate change on the CUCM, queries fail until the new certificate has been accepted. See the chapter “Reviewing and accepting a CUCM certificate”.