Release Notes for StarOS™ Software Version, Release 2025.04.gh1

Available Languages

Download Options

  • PDF
    (477.5 KB)
    View with Adobe Reader on a variety of devices
Updated:November 7, 2025

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Available Languages

Download Options

  • PDF
    (477.5 KB)
    View with Adobe Reader on a variety of devices
Updated:November 7, 2025
 

 

StarOS™ Software, Release 2025.04.gh1. 3

New software features. 4

Changes in behavior 5

Resolved issues. 6

Open issues. 9

Known issues. 9

Compatibility. 11

Supported software packages. 12

Related resources. 14

Legal information. 16


 

StarOS™ Software, Release 2025.04.gh1

This Release Notes identifies changes and issues that are related to the Control and User Plane Separation (CUPS) software release.

Qualified products and platforms

Table 1.             Products and platforms qualified in this release

Component

Qualified?

Products

CUPS

Yes

MME

Yes

ePDG

Yes

P-GW

Yes

SAEGW

Yes

SGSN

Yes

Platforms

ASR 5500

No

VPC-DI

Yes

VPC-SI

Yes

Release lifecycle milestones

The following table provides EoL milestones for Cisco StarOS software:

Table 2.             EoL milestone information for StarOS™ Software, Release 2025.04.gh1

Milestone

Date

First Customer Ship (FCS)

07-Nov-2025

End of Life (EoL)

07-Nov-2025

End of Software Maintenance (EoSM)

08-May-2027

End of Vulnerability and Security Support (EoVSS)

08-May-2027

Last Date of Support (LDoS)

31-May-2028

 

New software features

There are no new software features introduced in this release.

Changes in behavior

There are no behavior changes introduced in this release.

Resolved issues

This table lists the resolved issues in this specific software release.

Note: This software release may contain bug fixes first introduced in other releases. To see additional information, click the bug ID to access the Cisco Bug Search Tool. To search for a documented Cisco product issue, type in the browser: <bug number> site:cisco.com.

Table 3.        Resolved issues for StarOS™ Software, Release 2025.04.gh1

 Bug ID

Description

Product Found

CSCwr10359

Sessmgr crash at function egtpc_handle_user_sap_event

cups-cp

CSCwq30875

Session manager recovery status instability

cups-cp

CSCwq56872

GY SU-URR are not associated with existing URR when the Online Charging System (OCS) is in a Server Unreachable (SU) state

cups-cp

CSCwr44639

lpool_ip_validation_failed after SRP switchover on CP

cups-cp

CSCwq57920

Addition of a trap after the state of the peer user plane changes from configured to not configured or vice versa.

cups-cp

CSCwq31050

sessmgr reload after ECS configuration modification

cups-cp

CSCwo94253

3GPP-Reporting-Reason VALIDITY_TIME in the CCR-U after GY RAR

cups-cp

CSCwq22329

Lack of P-CSCF address in EGTP_CREATE_SESSION_RESPONSE in case of VoWiFi

cups-cp

CSCwr30828

UP passes the traffic despite 4012 from OCS

cups-cp

CSCwq79531

Emergency call failed due to missing location information in CCR-U

cups-cp

CSCwq96280

Assertion failure at sess/egtp/egtpc/egtpc_evt_handler_func.c:800

cups-cp

CSCwm50323

[CUPS CP] Call reject with lpool-ip-validation-failed with No Chunks to allocate from this pool

cups-cp

CSCwq56869

Periodic updates not being sent when 'diameter send-ccri session-start' is configured and when FUI with terminate is received in CCA-I

cups-cp

CSCwq94647

CUPS - UE not reachable from network after CSFB

cups-cp

CSCwp20248

CP is not sending Delete session request to UP incase of GTPU Path Failure

cups-cp

CSCwr12949

Sessmgr crash at function egtpc_handle_modify_bearer_rsp_evt in CUPS-CP

cups-cp

CSCwo33578

Unexpected session disconnection

cups-cp

CSCwr15845

Gy session out of SU reports huge volume threshold in SxModify

cups-cp

CSCwq68820

[SMU-FAPI: init_hash_req_record() error logs are triggered after UP Upgrade

cups-up

CSCwq24253

Observed Additional IE: RAT Type in SX Modification Request Message

cups-up

CSCwp26591

sessmgr crash on UP - shm_uplane_remove_rule_line_dns_snooping_list

cups-up

CSCwq31100

Packet drop detected in FUI Scenarios

cups-up

CSCwp91767

Abnormal CC-Total-Octets values after UP reload

cups-up

CSCwo82799

CUPS UP UL/DL packets dropping

cups-up

CSCwr40180

Sessmgr restarts after SRP switchover

cups-up

Open issues

This table lists the open issues in this specific software release.

Note: This software release may contain open bugs first identified in other releases. To see additional information, click the bug ID to access the Cisco Bug Search Tool. To search for a documented Cisco product issue, type in the browser: <bug number> site:cisco.com.

Table 4.        Open issues for StarOS™ Software, Release 2025.04.gh1

Bug ID

Description

Product Found

CSCwr87117

Wrong Time Quota observed in second SX_SESSION_MODIFICATION_REQUEST when new quota with RAR Trigger

cups-cp

Known issues

This section describes the known issue that may occur during the upgrade of the StarOS image.

Install and Upgrade Notes

This Release Note does not contain general installation and upgrade instructions. Refer to the existing installation documentation for specific installation and upgrade considerations.

When upgrading the StarOS image from a previous version to the latest version, issues may arise if there is a problem with the Cisco SSH/SSL upgrade. To avoid such issues, ensure that the boot file for Service Function (SF) cards is properly synchronized.

To synchronize the boot file for all the Service Function (SF) VPC-DI non-management cards, use the following CLI command:

[local] host_name# system synchronize boot

This ensures that the changes in boot file are identically maintained across the SF cards.

Note: Execute the system synchronize boot command before reloading for version upgrade from any version earlier than 21.28.mh14 to version 21.28.mh14 or versions higher than 21.28.mh14.

Upgrade the confd version

This section explains upgrading third-party software. Upgrade the confd software to ensure system compatibility and performance.

Note: During July 2025.03.0 release, confd is upgraded to 8.1.16.2 version.

Prerequisites:

●     Ensureyouhaveappropriatepermissionstoperformthisupgrade.

●     Backupallnecessarydataandconfigurationstoavoidpermanentlossduringfiledeletion.

    Perform these steps to upgrade the confd version on the system.

1.     Enter the debug shell using debug shell command.

2.     Navigate to the confd directory.

3.     Run the command:cd /mnt/hd-raid/meta/confd/ to access the directory.

4.     Remove existing files with the command; rm -rf *

All files and subdirectories are deleted, preparing the system for a fresh installation. To preserve data across the Method of Procedure, users with ConfD configured must contact their Cisco representative.

Method of Procedure (MOP): Upgrade/Downgrade Between Non-Hermes and Hermes Builds

CSCwr80301: HD-RAID Not Ready During Upgrade from Non-Hermes to Hermes

Issue: When upgrading from a non-Hermes (202x.0x.gx) to a Hermes (202x.0x.ghx) build on both Virtualized Packet Core—Distributed Instance (VPC-DI) and Virtualized Packet Core—Single Instance (VPC-SI) platforms, the HD-RAID may not come up as expected.

Workaround: To avoid this hd-raid failure, follow the steps below during the upgrade and downgrade (for example, from 2025.03.g0 to 2025.04.gh0):

1.     Pre-requisite: Back up all files stored in /hd-raid before upgrading from the .mx to .mhx build.

     Note: All data in /hd-raid will be lost during recovery.

2.     Before the upgrade: On the .mx build, run the hd raid clear command.

3.     Reboot and upgrade: Reboot the node to upgrade to the .mhx build.

4.     Perform the CF card migration in case of VPC-DI or Reload the chassis on VPC-SI. Wait for the HD-RAID to recover.

Note: It is recommended to use this Method of Procedure (MOP) for both upgrading and downgrading between Hermes and Non-Hermes StarOS builds.

 

Compatibility

This section provides compatibility information about the StarOS package version, and the hardware and software requirements for the CUPS software release.

Compatible StarOS package version

Table 5.             Release package version information, Release 2025.04.gh1

StarOS packages

Version

Build number

StarOS package

2025.04.gh1

21.28.mh32.99253

Compatible software and hardware components

This table lists only the verified basic software and hardware versions. For more information on the verified software versions for the products qualified in this release contact the Cisco account representative.  

Table 6.             Compatibility software and hardware information, Release 2025.04.gh1

Product

Version

ADC P2P Plugin

2.74.gh0.2727

RCM

20251015-055230Z

Note: Use this link to download the RCM package associated with the software

ESC

6.0.0.54

CVIM

5.0.4

Host OS

Ubuntu 22.04 / RHEL 8.4

RedHat OpenStack

RHOSP 16.2

E810C NIC Version

Driver version: ice 1.12.6

Firmware: 4.20 0x80018f67 0.387.18

CIMC

4.0 (4)

NED Package

ncs-6.1.11.2-nso-mob-fp-3.5.2

-ad74d4f-2024-10-18T1052/ncs-6.1.11.2

-nso-mob-fp-3.5.2-ad74d4f-2024-10- 18T1052.tar.gz

NSO

nso-mob-fp-3.5.2

SMI/CNDP

2025.04.1.16

Supported software packages

This section provides information about the release packages associated with Control, and User Plane Separation (CUPS) software.

Table 7.             Software packages for Release 2025.04.gh1

Software package

Description

NSO

nso-mob-fp-3.5.2-2025.04.gh1.zip

Contains the signed NSO software image, the signature file, a verification script, the x509 certificate, and a README file containing information on how to use the script to validate the certificate.

VPC companion package

 

companion-vpc-2025.04.gh1.zip

Contains numerous files pertaining to this version of the VPC including SNMP MIBs, RADIUS dictionaries, ORBEM clients. These files pertain to both VPC-DI and VPC-SI, and for trusted and non-trusted build variants.

VPC-DI

qvpc-di-2025.04.gh1.bin.zip

Contains the VPC-DI binary software image that is used to replace a previously deployed image on the flash disk in existing installations.

qvpc-di_T-2025.04.gh1.bin.zip

Contains the trusted VPC-DI binary software image that is used to replace a previously deployed image on the flash disk in existing installations.

qvpc-di-2025.04.gh1.iso.zip

Contains the VPC-DI ISO used for new deployments; a new virtual machine is manually created and configured to boot from a CD image.

qvpc-di_T-2025.04.gh1.iso.zip

Contains the trusted VPC-DI ISO used for new deployments, a new virtual machine is manually created and configured to boot from a CD image.

qvpc-di-template-vmware-2025.04.gh1.zip

Contains the VPC-DI binary software image that is used to on-board the software directly into VMware.

qvpc-di-template-vmware_T-2025.04.gh1.zip

Contains the trusted VPC-DI binary software image that is used to on- board the software directly into VMware.

qvpc-di-template-libvirt-kvm-2025.04.gh1.zip

Contains the same VPC-DI ISO identified above and additional installation files for using it on KVM.

qvpc-di-template-libvirt-kvm_T-2025.04.gh1.zip

Contains the same trusted VPC-DI ISO identified above and additional installation files for using it on KVM.

qvpc-di-2025.04.gh1.qcow2.zip

Contains the VPC-DI binary software image in a format that can be loaded directly with KVM using an XML definition file, or with OpenStack.

VPC-SI

intelligent_onboarding-2025.02.gh1.zip

Contains the VPC-SI onboarding signature package that is used to replace a previously deployed image on the flash disk in existing installations.

qvpc-si-2025.04.gh1.bin.zip

Contains the VPC-SI binary software image that is used to replace a previously deployed image on the flash disk in existing installations.

qvpc-si-2025.04.gh1.iso.zip

Contains the VPC-SI ISO used for new deployment. A new virtual machine is manually created and configured to boot from a CD image.

qvpc-si-template-vmware-2025.04.gh1.zip

Contains the VPC-SI binary software image that is used to on-board the software directly into VMware.

qvpc-si-template-libvirt-kvm-2025.04.gh1.zip

Contains the same VPC-SI ISO identified above and additional installation files for using it on KVM.

qvpc-si-2025.04.gh1.qcow2.zip

Contains the VPC-SI binary software image in a format that can be loaded directly with KVM using an XML definition file, or with OpenStack.

StarOS product version numbering system

The output of the show version command displays detailed information about the version of StarOS currently running on the ASR 5500 or Cisco Virtualized Packet Core platform.

Starting 2024.01.0 release (January 2024), Cisco is transitioning to a new release versioning scheme. The release version is based on the current year and product. Refer to the figure for more details.

Note:       During the transition phase, some file names will reflect the new versioning whereas others will refer to the 21.28.x- based naming convention. With the next release, StarOS-related packages will be completely migrated to the new versioning scheme.

Figure 1.           Version numbering for FCS, emergency, and maintenance releases

 

P495#yIS1

Note:      For any clarification, contact your Cisco account representative.

Software integrity verification

To verify the integrity of the software image you have from Cisco, you can validate the SHA512 checksum information against the checksum identified by Cisco for the software. Image checksum information is available through Cisco.com Software Download details. Click Linux and then choose the Software Image Release Version.

To find the checksum, hover the mouse pointer over the software image you have downloaded. At the bottom you find the SHA512 checksum, if you do not see the whole checksum, you can expand it by pressing the "..." at the end.

To validate the information, calculate a SHA512 checksum using the information in the table and verify that it matches the one provided on the software download page. To calculate a SHA512 checksum on your local desktop see the table.

Table 8.             Checksum calculations per operating system

Operating system

SHA512 checksum calculation command examples

Microsoft Windows

Open a command line window and type the following command:

> certutil.exe -hashfile <filename>.<extension> SHA512

Apple MAC

Open a terminal window and type the following command:

$ shasum -a 512 filename.extension

Linux

Open a terminal window and type the following command:

$ sha512sum filename.extension

OR

$ shasum -a 512 filename.extension

Note:       filename is the name of the file. extension is the file extension (for example, .zip or .tgz).

If the SHA512 checksum matches, you can be sure that no one has tampered with the software image or the image has not been corrupted during download.

If the SHA512 checksum does not match, we advise you to not attempt upgrading any systems with the corrupted software image. Download the software again and verify the SHA512 checksum again. If there is a constant mismatch, please open a case with the Cisco Technical Assistance Center.

Certificate validation

In 2024.01 and later releases, software images for StarOS, VPC-DI, and VPC-SI, and the companion software packages for StarOS and VPC are signed via x509 certificates. USP ISO images are signed with a GPG key. For more information and instructions on how to validate the certificates, refer to the README file available with the respective software packages.

Related resources

This table provides key resources and links to the support information and essential documentation for StarOS and CUPS products.

Table 9.             Related resources and additional information

Resource

Link

Cisco ASR 5500 documentation

StarOS documentation

Cisco Ultra Packet Core documentation

CUPS documentation

Service request and additional information

Cisco Support

Legal information

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2025 Cisco Systems, Inc. All rights reserved.

Learn more