{}

Our Brands

Search FAQs

How do I update my Smart-UPS firmware using the command line interface of my Network Management Card?

Issue:

Because the Firmware Upgrade Wizard is the most universal and preferred method of updating, we recommend using the APC Firmware Upgrade Wizard whenever possible. The APC Firmware Upgrade Wizard guides you through the update process and provides a consistent update experience. The Firmware Upgrade Wizard is available in FA279197. Instructions are being provided here for users that are unable use the Firmware Upgrade Wizard and wish to update their Smart-UPS Firmware using command line tools and an APC Network Management Card (NMC). For those who wish to update their Smart-UPS Firmware using the NMC’s web interface, see FA170679.


Product Line:

Smart-UPS models with the prefixes SMT, SMX, SRT, SRTL, XU, and XP with a SmartSlot or Embedded NMC.


Environment:
  • Command line terminal emulator and file transfer tools
  • Supported UPS model listed above
  • UPS Network Management Card 2 (AP9630, AP9630CH, AP9631, AP9631CH, or embedded NMC2) with SUMX application firmware v6.4.0 or higher
  • UPS Network Management Card 3 (AP9640, AP9641, AP9643, or embedded NMC3) with SU application firmware 1.0 or higher
  • Correct firmware file for the particular UPS available at the end of this document.

Resolution:

Follow the steps below to determine your current NMC type and firmware revision, select the proper UPS firmware image, and update the UPS firmware via the Network Management Card’s Command Line Interface (CLI).

Step 1 - Using an SSH client of your choice, connect to the IP address of the Network Management Card.
Note: If required, Open SSH can be added using Windows Manage Optional Features.
Example of using Windows Command Prompt to connect via SSH:
ssh -c aes256-cbc apc@10.0.0.1
Notes:
  1. This SSH command is for OpenSSH. The command may differ depending on the SSH tool used.
  2. The username may be different that the “apc” username used in this example.
Using the web interface of the NMC, navigate to the “SSH Host Key” in the “Console” found in the “Network” section of the “Configuration” menu. Verify and take note of the SSH Key.
IMG
Compare the SSH key to the RSA fingerprint displayed in the command line terminal window. To display the fingerprint in the same format as shown in the NMC web interface, the <-o FingerPrintHash=md5> argument can be used. Example:
ssh -c aes256-cbc -o FingerPrintHash=md5 apc@10.0.0.1
IMG

Notes:
  • Telnet can be used if enabled, but it is not recommended due to lack of encryption, and the examples shown here are just for reference.
  • Example of using Windows Command Prompt to connect via Telnet: From a computer that has access to the network on which the NMC is installed, at a command prompt, type telnet and the IP address for the NMC (for example, telnet 10.216.253.128, when the NMC uses the default Telnet port of 23), and press ENTER.
  • This example works for command prompt based Telnet clients. The commands may differ for different Telnet clients. If the NMC uses a non-default port number (from 5000 to 32768), you must include a colon or a space, depending on your Telnet client, between the IP address (or DNS name) and the port number. (These are commands for general usage: some clients don’t allow you to specify the port as an argument and some types of Linux might want extra commands).
IMG
Enter the user name and password.
IMG

Step 2 - Check if you have a Network Management Card 2 running Smart-UPS / Matrix Application, or a Network Management Card 3 running Smart-UPS Application and ensure there are no active alarms reported.
Use the <about> command to display the Network Management Card application module:

Network Management Card 2 installed in a Smart-UPS uses “sumx” Application Module:
IMG
Network Management Card 3 installed in a Smart-UPS uses “su” Application Module:
IMG
Use the <alarmcount> command to ensure there are no active alarms:
IMG

Step 3 - If using Network Management Card 3, go to Step 4.
If using Network Management Card 2: Verify the firmware revision of your Network Management Card. The firmware must be v.6.4.0 or higher, but we recommend you always run the latest available NMC firmware. To update the firmware of your Network Management Card, refer to FA156047.
Use the <about> command to display the Network Management Card firmware version:
IMG

Step 4 – Identify the correct UPS Firmware file.
  • Download and unzip the Firmware file available at the end of this document. Save the folder on a local drive.
  • Use the <upsabout> command.
  • Identify the "ID" number to select the proper firmware file for your UPS.
    • For example, for a UPS with ID 1024 the proper filename will be SRTL1024UPS_xx-x.enc
IMG
The "ID" is a unique identifier for the hardware platform of your UPS. You need to use the "ID" number to make sure to select the correct firmware file. A particular UPS model may have different "ID" numbers depending on when it was manufactured, or its current firmware version. Always check the "ID" number of the UPS before starting the update, and ensure you use a firmware file with the compatible ID. If the incorrect file is used, the update will be refused, and will need to be restarted using the correct firmware file.

Use the table below to determine the correct firmware file. Some of the following firmware files are not attached to this FAQ document. Always check the product page on apc.com for the latest firmware file. Example:

download from web
UPS
Series
UPS
ID
Firmware FileLatest
Firmware
Version
Release
Notes
Firmware
Update with
Output On
Available
Crypto-
graphycally
Signed
Firmware
Update
via NMC
Firmware
File
Availability
SCL1048SCL1048UPS_16-5.encUPS 16.5YesYesEnabledThis FAQ
SMC1005SMC1005UPS_15-1.encUPS 15.1NoNoConfigurableThis FAQ
SMT17SMT17UPS_07-1.encUPS 07.1NoNoEnabledThis FAQ
SMT18SMT18UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMT20SMTSMX20UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMT1015SMT1015UPS_17-2.encUPS 17.2YesYesConfigurableThis FAQ
SMT1027SMT1027UPS_17-2.encUPS 17.2YesYesConfigurableThis FAQ
SMT1031SMTSMX1031UPS_15-5.encUPS 15.5YesYesConfigurableThis FAQ
SMT1039SMT1039UPS_15-5.encUPS 15.5NoYesConfigurableThis FAQ
SMT1040SMT1040UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMT1041SMT1041UPS_15-0.encUPS 15.0NoNoDisabledThis FAQ
SMT1050SMTSMX1050UPS_16-5.encUPS 16.5YesYesConfigurableThis FAQ
SMT1059SMT1059UPS_16-5.encUPS 16.5YesYesConfigurableThis FAQ
SMT1060SMT1060UPS_02-0.encUPS 02.0YesYesConfigurableThis FAQ
SMTL1026SMTL1026UPS_15-5.encUPS 15.5YesYesConfigurableThis FAQ
SMTL1047SMTL1047UPS_16-5.encUPS 16.5YesYesConfigurableThis FAQ
SMTL1064SMTL1064UPS_01-8.encUPS 01.8YesYesConfigurableThis FAQ
SMX20SMTSMX20UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMX23SMX23UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMX1003SMX1003UPS_15-0.encUPS 15.0NoNoConfigurableThis FAQ
SMX1031SMTSMX1031UPS_15-5.encUPS 15.5NoYesConfigurableThis FAQ
SMX1050SMTSMX1050UPS_16-5.encUPS 16.5NoYesConfigurableThis FAQ
SRT1001*SRT1001UPS_02-9.encUPS 02.9NoNoEnabledThis FAQ
SRT1002SRT1002UPS_15-1.encUPS 15.1NoNoDisabledThis FAQ
SRT1010SRT1010UPS_15-5.encUPS 15.5From UPS 07.9YesEnabledThis FAQ
SRT1013SRT1013UPS_15-1.encUPS 15.1NoNoDisabledThis FAQ
SRT1014SRT1014UPS_15-1.encUPS 15.1NoNoDisabledThis FAQ
SRT1019SRT1019UPS_15-5.encUPS 15.5From UPS 07.1YesEnabledThis FAQ
SRT1020SRT1020UPS_15-8.encUPS 15.8YesYesEnabledThis FAQ
SRT1021SRT1021UPS_15-6.encUPS 15.6NoYesEnabledThis FAQ
SRT1024SRTSRTL1024UPS_15-5.encUPS 15.5From UPS 00.4YesEnabledThis FAQ
SRT1025SRTXU1025UPS_15-5.encUPS 15.5From UPS 07.3YesEnabledThis FAQ
SRT1043SRTXU1043UPS_16-5.encUPS 16.5From UPS 16.5YesEnabledThis FAQ
SRT1044SRT1044UPS_16-9.encUPS 16.9YesYesEnabledThis FAQ
SRT1045SRT1045UPS_16-6.encUPS 16.6NoYesEnabledThis FAQ
SRT1046SRTSRTL1046UPS_16-5.encUPS 16.5From UPS 16.5YesEnabledThis FAQ
SRTL1024SRTSRTL1024UPS_15-5.encUPS 15.5From UPS 00.4YesEnabledThis FAQ
SRTL1034SRTL1034UPS_06-3.encUPS 06.3YesYesEnabledse.com
SRTL1035SRTL1035UPS_06-3.encUPS 06.3YesYesEnabledse.com
SRTL1046SRTSRTL1046UPS_16-5.encUPS 16.5From UPS 16.5YesEnabledThis FAQ
SRTL1062SRTL1062UPS_4-3.encUPS 04.3YesYesEnabledse.com
SRTL1063SRTL1063UPS_4-3.encUPS 04.3YesYesEnabledse.com
SRTL1226SRTL1226UPS_3-3.encUPS 03.3NoYesEnabledThis FAQ
SRTL1227SRTL1227UPS_1-1.encUPS 01.1NoYesEnabledThis FAQ
SRYL1225SRYL1225UPS_13-3.encUPS 13.3NoYesEnabledThis FAQ
XP1016XP1016UPS_15-0.encUPS 15.0NoNoEnabledThis FAQ
XU1017XU1017UPS_15-6.encUPS 15.6From UPS 01.4YesDisabledThis FAQ
XU1025SRTXU1025UPS_15-5.encUPS 15.5From UPS 07.6YesEnabledThis FAQ
XU1033XU1033UPS_15-6.encUPS 15.6From UPS 00.3YesDisabledThis FAQ
XU1043SRTXU1043UPS_16-5.encUPS 16.5From UPS 16.5YesEnabledThis FAQ
XU1057XU1057UPS_16-5.encUPS 16.5YesYesEnabledThis FAQ
XU1058XU1058UPS_16-6.encUPS 16.6YesYesEnabledThis FAQ


Notes:
  1. *For SRT UPS models with ID of 1001, the UPS firmware must be updated in two steps. First update the UPS firmware using SRT1001UPS_02-9.enc. This will change the UPS ID to 1013. Once the update to UPS 02.9 is completed, perform the firmware update again using SRT1013UPS_15-0.enc
  2. It is not recommended to perform a firmware downgrade to a lower firmware version.
  3. In rare situations, the UPS firmware update may not install automatically after the firmware file was transferred to the UPS. Refer to FAQ000258690 to complete the UPS firmware update.
  4. For more information about enabling or disabling firmware updates via the NMC for the UPS models that support this feature, refer to FAQ00024438.
  5. Once firmware updates via the NMC have been disabled, attempts to update the UPS firmware using the NMC will be refused:
  6. For SRYL (Smart UPS Modular Ultra), if upgrading from 13.2 or greater you may put the UPS into Manual Bypass. See Set the UPS to Manual Bypass Mode section in the Smart UPS Modular Ultra Manual.
UPS FW update refused

Step 5 – The majority of UPS models support firmware update with output on. Refer to the above table, and if you have a UPS that supports firmware update with output on, go to Step 6.

NOTE: For UPS devices that require the UPS output to be off before initiating the update, ensure that network access is not dependent on the UPS for power, when updating via the Network Management Card.

If network access is dependent on the UPS for power, refer to FA279197 for instructions on updating the UPS firmware using the Firmware Upgrade Wizard.

If network access is not dependent on the UPS for power, ensure the attached load is correctly shut down before proceeding with turning off the UPS output.

Use the <ups -c off> command to turn off the UPS output, then use the <detstatus -ss> command to verify the UPS output status:
IMG

Step 6

Via SCP:

Use the <bye> command to disconnect from the SSH or Telnet session:
IMG
Copy the UPS firmware file to the NMC using the following command:
<scp -c aes256-cbc “filepath\filename” apc@10.0.0.1:/tmp/filename>
NOTE: This SSH command is for OpenSSH. The command may differ depending on the SSH tool used. In this example, the file will be copied to the “tmp” folder on the NMC.
IMG


Via FTP:

FTP may be disabled by default on the NMC, and must be enabled before continuing.
Use the <ftp -S enable> command to enable FTP and use the <reboot> command followed by <YES> to reboot the NMC and apply the changes.
IMG
Use the <bye> command to disconnect from the SSH or Telnet session:
IMG
Using an FTP client of your choice, FTP the UPS firmware file onto the “tmp” folder on the NMC.
Here’s an example of loading a UPS firmware file onto the “tmp” folder on the NMC using Windows Command Prompt:
ftp <NMC Network Address Here>
User (<NMC Network Address>:(none)): NMC Username
Password: NMC Password
ftp> bin
ftp> hash
ftp> cd tmp
ftp> put “<Path to UPS Firmware File>”
ftp> quit
IMG

Step 7 - Reconnect to the NMC, and use the <cd /tmp> command followed by the <dir> command to verify that the file has been copied to the “tmp” folder on the NMC:
IMG
Initiate the UPS Firmware Update using the <upsfwupdate -install -file “/tmp/filename” command:
IMG
Use the <upsfwupdate -status> command to check the status of the UPS Firmware Update:
IMG
The update may take several minutes. Once the <upsfwupdate -status> command returns “Status: No firmware update is in progress”, the UPS firmware update is completed.
IMG
Verify that the new UPS firmware version is shown using the <upsabout> command:
IMG
If the update does not complete, or if any errors are displayed, ensure that the conditions in Step 2 are met. Try updating the UPS firmware with the UPS output turned off. If no alarms are shown, try updating the UPS firmware using the Firmware Upgrade Wizard, which can be found in FA279197 .
Step 8 – If the UPS output was turned off in Step 5, the UPS output should now be turned back on.
Use the <ups -c on> command to turn the UPS output back on.
IMG
The attached load can now be turned on.

For any issues encountered during the update process or any additional questions, please contact APC Tech Support.

APC USA

Attachment(s)

Firmware Files.zipFirmware Files.zip [48.58 MB]
SRTL1227UPS_01-1.zipSRTL1227UPS_01-1.zip [8.78 MB]
SRYL1225UPS_13-3.zipSRYL1225UPS_13-3.zip [3.97 MB]
SRTL1226UPS_03-3.zipSRTL1226UPS_03-3.zip [8.6 MB]
Explore more
Range:
Smart-UPS On-LineSmart-UPSSmart-UPS Ultra
Explore more
Range:
Smart-UPS On-LineSmart-UPSSmart-UPS Ultra
Users group

Discuss this topic with experts

Visit our Community for first-hand insights from experts and peers on this topic and more.