How can I upgrade my On-Prem Account?

 
Updated November 13, 2025
PDF
Is this helpful? Feedback

    Introduction

    This document outlines the steps to upgrade an On-Prem Account. 

    Video

    The purpose of this content is to share information for educational and/or informational use. You may choose to watch the video or read the content below-both provide the same material, so feel free to engage with whichever format you prefer.


    Prerequisites 

    Before you start, ensure that you have the following: 

    • A Cisco Smart Account 
    • A valid CCO User ID and Password that has access to the Smart Account or Virtual Account. 
    • Admin Access to SSM On-Prem
    note-icon

    Note: Please DO NOT perform these actions yourself if you are an internal Cisco resource outside of the Licensing Support team.

    Steps

    Ensure you upgrade to the latest version for improved features, essential fixes, and security vulnerability resolutions.

    Follow the steps below to upgrade:

    Step 1: Navigate to: software.cisco.com/download/home

    Step 2: In the Select a Product field, enter Cloud and Systems Management -> Select Network Automation and Management -> Smart Software Manager -> Smart Software Manager On-Prem.

    Step 3: On the left-hand column under Latest Release, select one of the options as per your requirement.

    Step 4: Select Smart Software Manager On-Prem Release (Version) Upgrade

    (E.g. - File name: eSSM_OnPrem-9-202407_Upgrade.zip), and then click the Download Icon located on the right side of the screen.

    Step 5: When the download is complete, navigate to the directory where the zip file resides, right-click the file, and select Unzip image.

    Step 6: Using Linux ‘ssh’ command, connect to the On-Prem server as admin:

    ssh admin@<your ip address>

    Step 7: Start the On-Prem Console using this command: onprem-console.

    Step 8: In the On-Prem Console, use the copy command shown in these two examples.

    note-icon

    Note: You can only use the On-Prem copy command when you are in the On-Prem console itself. The On-Prem copy command copies files from a remote host to your local On-Prem machine and only works with the SCP protocol.

    • copy <your username>@<your remote host.com>:/path/SSM_On-Prem-9-202407_Upgrade.sh patches:
    • copy <your username>@<your remote host.com>:/path/SSM_On Prem-9-202407_Upgrade.sh.sha256 patches:

    Here is a specific example of the copy command:

    copy user@domain.com:/path/SSM_On-Prem_9-202407_Upgrade.sh patches:

    For more information about the copy command, see the Cisco Smart Software Manager On-Prem Console Reference Guide that you will get with Upgrade Zip File.

    Step 9: After the copy command, use this upgrade command: upgrade patches:SSM_On-Prem-9-202407_Upgrade.sh

    You are required to have an existing corresponding signature file.

    Step 10: After the system has completed the upgrade (approximately 5–15 minutes), you are notified that the process is complete.

    Step 11: After the SSM upgrade is complete, perform a synchronization on the system.

    To perform this action, click: How can I perform a synchronization within an On-Prem deployment, in License Central (LC)?

    note-icon

    Note:

    • It is highly recommended that, before performing an upgrade, you have a backup of your database (if you are using a VM). (See Cisco Smart Software Manager On-Prem User Guide Appendix 1: Manually Backing Up and Restoring SSM On-Prem).
    • After performing an upgrade, the browser pages might not reflect the latest changes. Clear your browser's cache so that your browser pages are up-to-date.

    Troubleshooting

    If you experience an issue with this process that you cannot address, please open a case at  Support Case Manager (SCM) using software licensing option.

    For feedback on the content of this document, please submit here.

    For External Customer / Partner Use Only: These instructions are provided to help customers / partners perform the following action themselves to resolve the issue. If the customer / partner runs into issues following the instructions, please have them open a case with licensing support (https://www.cisco.com/go/scm) To help resolve.