Citrix SD-WAN Orchestrator for On-premises 12.3

Release Notes for SD-WAN Orchestrator for On-premises 12.3 Release

This release notes document describes the enhancements and changes, fixed and known issues that exist for the Citrix SD-WAN Orchestrator for On-premises release Build 12.3.

Note

This release notes document does not include security related fixes. For a list of security related fixes and advisories, see the Citrix security bulletin.

What’s New

The enhancements and changes that are available in Build 12.3.

Miscellaneous

Purge settings

Citrix SD-WAN Orchestrator for On-premises enables you to clear historical data older than the purge statistics interval days (30 days by default). When the data is cleared, the historical data older than the selected number of days is removed and is no longer available. The purging process happens sometime around 12:48 AM daily based on the time zone set on your SD-WAN appliance.

[ SDW-20402 ]

Zero-touch Deployment Interface

You can enable a Zero Touch Deployment (ZTD) interface on Citrix SD-WAN Orchestrator for On-premises. The ZTD Interface that is secured by two-way authentication provides a secure communication interface for SD-WAN appliances and Citrix SD-WAN Orchestrator for On-premises.

[ SDW-19152 ]

Virtual path settings for the link

You can customize bandwidths for virtual paths and dynamic virtual paths associated with a WAN link. This feature is useful when some sites display performance degradation signs due to bandwidth issues.

[ SDW-9760 ]

SD-WAN Orchestrator

Syslog server settings

Citrix SD-WAN Orchestrator for On-premises supports the configuration of Syslog server settings for SD-WAN appliances. By enabling Syslog settings, you can send system alerts and event details of the SD-WAN appliances to an external syslog server.

[ SDW-13990 ]

Fixed Issues

The issues that are addressed in Build 12.3.

Miscellaneous

Under certain conditions, the SD-WAN appliance fails to communicate with Citrix SD-WAN Orchestrator for On-premises over In-band management when In-band management is enabled and the Out-of-band management is plugged in.

[ SDWANHELP-2368 ]

The UI incorrectly displays an error when the dynamic virtual paths value is set to more than 8, although the maximum allowed limit is 32. This issue is observed on VPXL and 4100 SE appliances.

[ SDWANHELP-2354 ]

The Software Version drop-down list under Partial Site Upgrade settings shows all the supported software versions instead of showing only those versions that are published under Infrastructure > Orchestrator Administration > Software Images > Appliance.

If a software version listed in Partial Site Upgrade is not available for publish under Infrastructure > Orchestrator Administration > Software Images > Appliance, then Partial Site Upgrade cannot be performed for that release.

[ SDW-20992 ]

Known Issues

The issues that exist in release 12.3.

Configuration and Management

On a newly imported Citrix SD-WAN Orchestrator for On-premises instance, staging gets stuck in the Preparing package state. This issue occurs when the staging process is initiated shortly after creating a new virtual machine.

Workaround: Retry the staging process.

[ SDW-20863 ]

Miscellaneous

Citrix SD-WAN Orchestrator for On-premises running VMware ESXi 13 fails to reboot and goes into a bad state.

Workaround: Use VMware ESXi version 9.

[ SDWANHELP-2182 ]

In some scenarios, after deploying Cloud Direct for the sites and pushing the configurations (Stage and activate), the Cloud Direct service does not come up.

Workaround: Enable Cloud Direct service manually for each site.

[ SDW-22493 ]

The Staging process fails intermittently when users perform a partial site upgrade. The UI displays the error message Staging failure due to exception.

Workaround: Retry the staging process.

[ SDW-22398 ]

The software version previously selected on the Deployment > Settings > Partial Site Upgrade > Software Version page of the UI is not being retained when the users come back to this page.

Workaround: Select the partial site upgrade software version manually for each site by clicking navigating to Deployment > Select Sites.

[ SDW-22374 ]

Sometimes, the UI displays an error after a configuration of management interface settings is performed. However, the configuration is successful and a refresh is required for the updated settings to appear on the UI.

[ SDW-22139 ]

Users are unable to delete the Citrix SD-WAN Orchestrator for On-premises tar.gz image file uploaded on the Infrastructure > Orchestrator Administration > Software Images page of the UI. The error message displayed is Error occurred while deleting the software package.

Workaround: Upload a new software package. The previously uploaded file gets automatically deleted.

[ SDW-22137 ]

On the Configuration > Network Config Home page of the UI, the Orchestrator connectivity status for a secondary SD-WAN appliance appears online immediately after the configuration file is uploaded. However, the correct status is displayed after the configuration is saved for the site.

[ SDW-20913 ]

In a provider managed setup, the announcements added by the provider administrators are not getting displayed to customers at their login.

[ SDW-18491 ]

When the database backup of an appliance is restored on another appliance having the same release of Citrix SD-WAN Orchestrator for On-premises, the user details are not restored. On the restored appliance, if you create a user with the same user name as in the backed-up database, the following error is displayed:

User has a role already assigned.

Workaround: Create a user with a different user name that did not exist on the backed-up database.

[ SDW-15984 ]

Platform and systems

In the Citrix SD-WAN 210 appliance, if you remove the add-on license, the services get disabled.

Workaround: Remove the firewall policy having security profile, stage, and activate the changes to convert the appliance to standard edition.

[ SDW-18031 ]

Release Notes for SD-WAN Orchestrator for On-premises 12.3 Release