Release Notes for VOSS Automate 24.2 Patch Bundle 1#

Release Overview#

These are the official release notes for:

  • Product: VOSS Automate

  • Release Version: 24.2-PB1

Release Details#

Delta Platform

Release : 24.2.1

Build Number : 5041

Platform Version : 24.2.1-1738842866

Release Date: February 7, 2025

Supported Upgrade Paths:

  • MOP for 24.2-PB1 Install:

    • 24.2.x =>

Application Compatibility

Refer to the Compatibility Matrix for all app compatibility and browser support.

Ensure that the hardware version of each of your virtual machines (VMs) is at least version 11, compatible with ESXi 6.0 and up, and that your host CPU supports AVX (Advanced Vector Extensions).

A cluster check command in the Automate pre-upgrade steps checks for AVX support. To ensure that AVX support is added to the VMs, you’ll need to upgrade the compatibility of the VM in vCenter.

Highlights#

Release 24.2-PB1 contains the following highlights and enhancements:

Number Range Management, new “Unchanged” Status Setting#

Previously, it was not possible to bulk modify editable text fields on range numbers in status “Used”, “Used-Utility” or “Available”. This release introduces workflow enhancements to support setting a number’s status to “Unchanged”, so that you can update fields on numbers with any status, without changing the original number status.

Cisco VG410 Gateway Support#

Automate 24.2-PB1 includes support for Cisco VG410 Gateway, a new analog gateway added to a recent version of CUCM. You’ll now be able to choose the VG410 product when adding an analog gateway in the Admin Portal.

See also the release notes for this feature, which will require a post-upgrade re-import of the GatewayType Automate device model to support VG410.

Convert Inactive CUCM LDAP Users to Local CUCM Users on Sync#

It is now possible to configure Automate, via the User settings in Global Settings, to automatically convert inactive CUCM LDAP users to “Local” CUCM users when syncing in data from CUCM (bottom-up LDAP sync) to VOSS Automate. This prevents CUCM from deleting those users and their services in its scheduled garbage collection. Previously, you could only do this manually via the “Convert to Local CUCM user” tool.

Small Enhancements and Bug Fixes#

In addition to the new features and enhancements in this release, we’ve added several small enhancements and performance improvements, included a number of bug fixes, and implemented a number of usability improvements in the Admin Portal. You can find further details, including links to the relevant topics, at What’s New by Feature.

Upgrade Overview#

Important Information#

Before upgrading:

  • Inspect the Release and Upgrade Notes of all releases in your upgrade path. These documents may contain additional upgrade information. All documentation for previous releases, including Release and Upgrade Notes, are available from the VOSS Automate Documentation website.

  • When installing 24.2.PB1-Delta-Bundle-patch.script, database index migration on large scale systems may take a significant amount of time. For details, refer to the Method of Procedure (MOP) for 24.2-PB1 Installation.

  • Microsoft customers: Ensure that you have the latest version of Windows PowerShell installed. For details, refer to Run PowerShell proxy server setup script in the Automate Core Feature Guide.

Upgrade Notes#

There are a number of changes in a new release that could relate to exposing new features or capabilities in the system. The default, out-of-the box system would expose these. However, on a system where the configuration around the user experience has been applied, this might mean some changes to configured menus, display policies, and so on to expose the new features in your setup.

Where relevant, we have included this information with the feature information to assist in planning for configuration changes as part of the upgrades. This setup could vary.

Note

From Automate release 24.1 onwards, language packs are available from https://voss.portalshape.com at Downloads > VOSS Automate > Language Packs

Issues containing upgrade notes in this release:

  • EKB-22004: Add support for Cisco VG410 Gateway

  • EKB-22837: MC950880: Add paging support for Microsoft Get-CsPhoneNumberAssignment commandlet

  • EKB-23060: Emergency location ops tool errors

Features: Summary#

Automate Admin GUI#

  • EKB-22804: Add support for Table widget field renderers.

Automate Core#

  • EKB-23023: Enable “move” operation on data/File.

  • EKB-22855: Convert inactive CUCM LDAP users to Local CUCM users on sync.

  • EKB-22354: Move Webex license audit calling_pro check to device/spark/User.

  • EKB-22004: Add support for Cisco VG410 Gateway.

  • EKB-21856: Multiple voicemail service single customer in Webex Dedicated Instance.

  • EKB-21770: Support for GCC High and DOD flags in Microsoft Graph and PowerShell connection.

Automate Templates#

  • EKB-23094: Create sample CFT “Default Webex Teams Calling Template with extra Settings”.

  • EKB-22837: MC950880: Add paging support for Microsoft Get-CsPhoneNumberAssignment commandlet.

  • EKB-22612: Add Webex Contact Centre connection parameters.

  • EKB-22376: Microsoft user staging schedule changes.

Features: Detail#

Automate Admin GUI#

  • EKB-22804: Add support for Table widget field renderers. This enhancement adds configuration options to Insights tables to allow for the styling of cell text and background colors as well as font size and weight.

Automate Core#

  • EKB-23023: Enable “move” operation on data/File. This enhancement adds support for “Move” and “Clone” operations on the data/File model.

  • EKB-22855: Convert inactive CUCM LDAP users to Local CUCM users on sync. This enhancement adds a new setting to allow inactive LDAP-synchronized CUCM users, which would normally be deleted automatically by the CUCM, to be converted into CUCM Local Users during a data sync of CUCM.

    If the setting is disabled (default), users that have been in the “Inactive LDAP Synchronized User” status for more than 24 hours are deleted automatically by the CUCM. These users and their services are then deleted from Automate on the next CUCM data sync.

    If the setting is enabled, users that have changed their status to “Inactive LDAP Synchronized User” will be converted to “Enabled Local Users” on the next CUCM data sync. Note that the data sync of the CUCM must occur within 24 hours of the users becoming inactive, otherwise, CUCM will still delete them.

  • EKB-22354: Move Webex license audit calling_pro check to device/spark/User. This enhancement now checks the “calling_pro” field on the Webex user instead of the config model instance. If the “calling_pro” field is populated and set to “True”, the user is considered to be licensed.

  • EKB-22004: Add support for Cisco VG410 Gateway. Adds support for configuring the Cisco VG410 Analog Gateway.

    Upgrade Notes - EKB-22004

    After upgrading to this release, you will need to re-import the following model to support this new VG410 Gateway: device/cucm/GatewayType

  • EKB-21856: Multiple voicemail service single customer in Webex Dedicated Instance. This enhancement implements support for multiple voicemail service support for Webex Dedicated Instance.

  • EKB-21770: Support for GCC High and DOD flags in Microsoft Graph and PowerShell connection. This enhancement introduces basic support for alternative Microsoft cloud environments.

Automate Templates#

  • EKB-23094: Create sample CFT “Default Webex Teams Calling Template with extra Settings”. This enhancement introduces a new configuration template, “Default Webex Teams Calling Template with Extra Settings,” for Webex user provisioning, which includes a sample of Webex Calling settings.

  • EKB-22837: MC950880: Add paging support for Microsoft Get-CsPhoneNumberAssignment commandlet. This enhancement adds paging support to the Microsoft Teams PowerShell commandlet, Get-CsPhoneNumberAssignment.

    Upgrade Notes - EKB-22837

    Due to a Microsoft change in January 6, 2025, any request with -Top parameter exceeding 1,000 will result in a “Bad request.” Please ensure that your Get-CsPhoneNumberAssignment requests do not surpass this limit. If the intended operation is to export your numbers, please use:

    https://learn.microsoft.com/en-us/powershell/module/teams/export-csacquiredphonenumber?view=teams-ps

    If you haven't yet installed the patch for EKB-22837 on 24.1-PB2 or 24.2, you will need to execute an import of device/msteamsonline/Number instances for all Microsoft tenants, when upgrading to 24.2-PB1.

  • EKB-22612: Add Webex Contact Centre connection parameters. Adds Webex Contact Centre connection parameters to the Webex Customer configuration page. Webex Contact Centre provisioning support will be added in a future Automate release.

  • EKB-22376: Microsoft user staging schedule changes. This enhancement modifies the default Microsoft user un-staging schedule from 30 minutes to every 4 hours. Additionally, the schedule is now also disabled by default.

Defects Fixed: Detail#

Automate Admin GUI#

  • EKB-23052: Dashboard counter widget text uses Primary Text Colour instead of Panel Text Color from theme. Fixes an issue where the text on Dashboard widgets uses the Primary Text Colour from the theme instead of Panel Text Colour.

  • EKB-22966: Widget link spacing in 24.2 cuts off labels (revert EKB-22211). This fix ensures the links widget text is not cut off.

  • EKB-22159: Accessibility - array plus icon focus, and action button keyboard navigation. Array action icons are now accessible when using keyboard navigation. Improved icon focus highlighting when using keyboard navigation.

  • EKB-22156: Accessibility - transaction logs and JAWS issues. This fix enables the JAWS screen reader to read the Transaction details form.

  • EKB-22155: Accessibility - unsaved changes Alert dialog not being read. Fixes accessibility issues and enhances screen reader support for confirmation dialogs.

  • EKB-22108: SSO redirects on error and uses VOSS default branding instead of selected default branding. This fix modifies the SSO Redirect page to inherit the applied theme and remove the default VOSS branding.

  • EKB-22073: Accessibility error, read-only field not being read by JAWS. This fix allows all read-only fields on forms to be read by JAWs screen reader.

Automate Core#

  • EKB-23362: LDAP data syncs using a MIF still deletes all unmatched users when "Purge Unmatched Records" is disabled. Fixes an issue so that LDAP sync will no longer purge all local cache records when a filter does not match a record on the device.

  • EKB-23103: Allow resource list limit 1 to return a single resource. Fixes an issue with the API where specifying count=true and limit=1 was not returning the single resource as expected.

  • EKB-23060: Emergency location OPS tool errors. This fix updates the device model schema, enabling the emergency operations tool to locate affected Microsoft Teams Number records following re-import.

    Upgrade Notes - EKB-23060

    After an upgrade to any release in which this fix is applied, ensure that msteamsonline/Number is fully re-imported.

  • EKB-23048: CUCM data syncs using a MIF still deletes all unmatched users when “Purge Unmatched Records” is disabled. Fixes an issue so that Call Manager sync will no longer purge all local cache records when a filter does not match a record on the device.

  • EKB-23008: Unable to set MS Teams Dial Out policy. Fixes an issue to allow setting of the Microsoft Teams Dial Out policy.

  • EKB-23007: Microsoft tenant test connection fails intermittently with “Connecting to remote server api.interfaces.records.teams.microsoft.com failed”. This fix adds a retry for the intermittent Microsoft Teams error.

  • EKB-22928: Updating the remote destination number on a Cisco subscriber fails. This fix finds the correct existing destination in a remote destination to be updated with the new destination.

  • EKB-22907: Device change notification alarm. This fix restores the Call Manager change notification collector service’s capability to automatically recover from a broken state.

  • EKB-22788: MSTeamsonline sync error on holiday schedule. Fix sync errors when no instances of Holiday are present in a Microsoft tenant.

  • EKB-22694: User is retained incorrectly when subscriber without Webex is deleted from CUCM and imported. Fixes an issue where a user was incorrectly retained when the subscriber, which did not have Webex Teams, was deleted from CUCM and then imported, and the Global Setting, “Retain a Webex App User when a Subscriber is deleted” was enabled.

  • EKB-22649: Error assigning an audio file to an auto attendant. This fix presents an improved error message from the Call Queue and Auto Attendant models when encountering unsupported .wav files.

  • EKB-22608: Email function “fn.email_html” is corrupting a tar attachment post 24.1 upgrade. Fixes an issue where emails sent using the “fn.email” function were not handling attachments correctly.

  • EKB-22590: Add MS Teams subscriber fails with Error in macro function, ‘fn.generic_device_model_custom_operation’. Fixes an issue by adding a condition to bypass fetching license data if MsolUser is not available in the cache.

  • EKB-22444: Order of data/HierarchyNode is reversed when using a macro query in conjunction with direction. This fix implements sorting of results for queries on Hierarchy Node, when the direction is ascending (up).

  • EKB-22419: Custom theme defined in Admin GUI URL is not retained on logout. This fix modifies the URL to preserve the user’s role theme upon logging out.

  • EKB-22064: Slow response time for relation/NumberInventoryREL. Improves the performance of list views of high scale number inventory instances at lower hierarchies (relation/NumberInventoryREL).

  • EKB-19729: MS Graph sync fails on 502/504 errors from MS cloud. This fix enables the retry of specified actions when 504/502 errors are encountered from the MS Graph API.

Automate Insights API#

  • EKB-23005: Subscriber Service Details does not show Cisco User which only have Extension Mobility. Fixes an issue where Subscribers, which only have Extension Mobility, were not shown on the Subscriber Service Details dashboard.

Automate Platform#

  • EKB-22611: SNMP erroneously reports “ERROR: Disk slow” post 24.1 upgrade. Fixes an issue where SNMP monitoring was incorrectly reporting a disk slow error.

  • EKB-22289: Corporate directory phone services stop working after enabling TLS 1.3. Fixes an issue where the corporate directory was not working after enabling TLS 1.3 in the CLI.

Automate Templates#

  • EKB-23228: Purge Webex User Sync gets stuck in a loop on deleting users. Fixes an issue with Purge Webex User Sync getting stuck in a loop while deleting users.

  • EKB-23044: Microsoft Quick Offboard Subscriber, the new Quick Add Group drop-down does not honor global setting limiting lookup. Fixes an issue where the drop-down on Quick Offboard Subscriber was not using the required global setting, resulting in unrestricted lookups of quick add groups.

  • EKB-22669: Update GUI rule for view/WebexTeamsSubscriberQas to work with function change(EKB-21938_22479). Fixes an issue where the Number drop-down on Webex Quick Add Subscriber was not showing the correct choice of numbers.

  • EKB-22481: Phone button template reverts to default value when opening the end point on the Gateway page. Fixes an issue where the phone button template was reverting to the default value when selecting an analog endpoint on an analog gateway.

  • EKB-22479: The function “fn.get_lines” doesn’t filter properly on vendor or internal_number_type. Fixes an issue where the “get_lines” function was not filtering correctly by vendor.

  • EKB-22416: UserCucmSyncRemove does not delete remote destination profile and remote destinations from cache. Fixes an issue where the remote destination profile and remote destinations remained in the cache after the subscriber was deleted from CUCM and imported.

  • EKB-22302: In Quick Add Subscriber, the console log shows “Error in macro function fn.get_ldap_user”. Fixes an issue where opening the Quick Subscriber form was prematurely triggering a GUI rule, resulting in a macro function error.

  • EKB-22301: Number inventory update for resource accounts incorrect during sync and overbuild. Fixes the issue with the Number inventory updates for resource accounts incorrect during sync and overbuild.

  • EKB-22293: Manage MOH audio source update needs a reset when changing MOH source file. Fixes an issue by resetting the MOH server when the audio source is updated.

  • EKB-22035: Line update is skipped during QAS if Webex is added with no desk phone, so E164 alternate is not set on line. Fixes an issue where the line update is skipped during QAS if Webex is added without a desk phone.

  • EKB-21938: Work number is not updated for a Webex App UCM Calling user. Fixes an issue where the work phone number was failing to update for a Calling in Webex App (Unified CM) user.

  • EKB-21853: Webex subscriber from profile can fail with “use next available number”. Fixes an issue where the “use next available number” feature in Add Subscriber From Profile was selecting non-Webex numbers, resulting in transaction failures.

  • EKB-21806: Webex Calling Settings object should only be displayed if the type is Webex Calling. Fixes an issue where Webex calling settings were displaying incorrectly. Webex calling settings now display only when Webex Calling is selected as the calling behavior. Values in the Calling drop-down were also updated, and the “Third-party SIP URI” option has been removed.

  • EKB-21556: Cannot update a directory number’s “extra” fields using the number range management functionality, when the number has a status of “Used”. This fix introduces a new “Unchanged” option to the Status drop-down in Number Range Management, allowing users to modify multiple number ranges, such as “Available”, “Used”, and “Used-utility”, without encountering errors.

  • EKB-20630: UC Apps Credentials panel - remove all types related to HCMF. This fix removes HCMF-related credential fields from Cisco Call Manager and Cisco Unity Connection forms.

  • EKB-15893: In Quick Add Subscriber, user fields remain read-only when selecting an LDAP user and then clearing the field to fill out a custom user name. Fixes an issue where user fields remain read-only after selecting an LDAP user and then clearing the field to enter a custom user name.