CUCM changes: updating names after user changes

Purpose

In EasyUC, device and line names are built from the user data, for example from first name, last name and department. If this data changes later in the CUCM, for instance after a marriage or a change of department through LDAP synchronization, the names on the phone and the line are no longer correct.

With this feature, EasyUC brings the names up to date. The background job app:cucm:changes queries the CUCM for changed end users through the AXL change notification (default: every five minutes). On the first run, EasyUC only records the current inventory. A task is created for every user changed after that. The background job run-task processes them (default: every eleven minutes): EasyUC reads the current state of the user from the CUCM and sets the names of the user's phones, device profiles and lines according to the rules under Device Naming and Line Naming.

On request, EasyUC sends an e-mail with the processed users after every run. The tasks are listed under Reporting → Automatisierung & Änderungen → Name Changes Tasks (the menu group Automatisierung & Änderungen, “automation and changes”, has a German label in the interface). This dialog is not the CUCM change log. That is a separate entry in the same menu.

Prerequisites

• License with the cucm module and the provisioning feature. Without provisioning, the entry is missing from the Actions menu.
• EasyUC account with the ROLE_APP_ADMIN role. Only administrators see the Administration menu.
• The CUCM connection has been created and enabled. For a disabled connection, Actions shows only Enable Connection.
• The naming rules under Device Naming and Line Naming have been checked. The names are set according to them.
• The background jobs app:cucm:changes and run-task are active under Administration → System & Operations → Background Jobs.
• For e-mails: SMTP delivery is set up.
• For checking the tasks: ROLE_APP_VIEW_NAME_CHANGE_TASK_PAGE role.

Step by step

1. In the header, select the EasyUC Cisco workspace.
2. In the menu, open Administration → CUCM & Provisioning → CUCM Connections. The Manage CUCM Connections page lists all connections.
3. In the row of the connection you want, click Actions. The Menu popover opens.
4. Click CUCM Changes. The CUCM end-user changes dialog opens.
5. Switch on Enable. The Send Emails area appears.
6. If EasyUC is to report processed name changes, switch on the switch in the Send Emails area.
7. Under Add email addresses (type an e-mail address and press enter), type an address and press Enter. Repeat this for every recipient.
8. Click Save (top right or at the bottom of the dialog). The dialog closes and EasyUC shows a success message (“Success”). Cancel closes the dialog without changes.
9. As a test, change the department of a test user with a phone in the CUCM. After about a quarter of an hour, open Reporting → Automatisierung & Änderungen → Name Changes Tasks and check the task and the names in the CUCM.

Fields and options

Check the result and narrow down errors

• Success: A task for the changed user appears under Name Changes Tasks. Display name, alerting name and description in the CUCM show the new values.
• Message “Please add at least one e-mail address”: Delivery is switched on, but no recipient has been entered.
• No task is created: Under Background Jobs, check whether app:cucm:changes is running and wait for the next run. Directly after it is switched on, EasyUC only records the current inventory.
• A task ends without success: The user has been deleted in the CUCM in the meantime. The task states the reason in the log.
• No e-mail arrives: Check SMTP delivery. The tasks are processed even without e-mail.