{}

Search FAQs

{"searchBar":{"inputPlaceholder":"Search by keyword or ask a question","searchBtn":"Search","error":"Please enter a keyword to search"}}

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 file FirmwareFiles_v4.3.1.zip 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 paticular 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:

Note: it is not recommended to perform a firmware downgrade to a lower firmware version.
IDUPS PrefixLatest Firmware ReleasedFirmware Version After UpdateFirmware Update with Output On AvailableFirmware Update via the NMC
17SMTSMT17UPS_07-1_Le.encUPS 07.1NoEnabled
18SMTSMT18UPS_15-0.encUPS 15.0NoConfigurable, disabled by default
20SMTSMTSMX20UPS_15-0.encUPS 15.0NoConfigurable, disabled by default
1015SMTSMT1015UPS_04-6.encUPS 04.6YesDisabled
1031SMTSMTSMX1031UPS_15-0.encUPS 15.0YesDisabled
1040SMTSMT1040UPS_15-0.encUPS 15.0NoConfigurable, disabled by default
1041SMTSMT1041UPS_15-0.encUPS 15.0NoDisabled
1026SMTLSMTL1026UPS_15-0.encUPS 15.0YesDisabled
20SMXSMTSMX20UPS_10-2.encUPS 10.2NoConfigurable, disabled by default
23SMXSMX23UPS_15-0.encUPS 15.0NoConfigurable, disabled by default
1003SMXSMX1003UPS_15-0.encUPS 15.0NoConfigurable, disabled by default
1031SMXSMTSMX1031UPS_15-0.encUPS 15.0NoDisabled
1001*SRTSRT1001UPS_02-9.encUPS 02.9NoEnabled
1002SRTSRT1002UPS_15-0.encUPS 15.0NoDisabled
1010SRTSRT1010UPS_15-1.encUPS 15.1Yes, from UPS 07.9Disabled
1013SRTSRT1013UPS_15-0.encUPS 15.0NoDisabled
1014SRTSRT1014UPS_15-0.encUPS 15.0NoDisabled
1019SRTSRT1019UPS_15-1.encUPS 15.1Yes, from UPS 07.1Disabled
1020SRTSRT1020UPS_15-0.encUPS 15.0NoDisabled
1021SRTSRT1021UPS_15-0.encUPS 15.0NoDisabled
1025SRTSRTXU1025UPS_15-1.encUPS 15.1Yes, from UPS 07.3Disabled
1024SRTLSRTL1024UPS_15-3.encUPS 15.3Yes, from UPS 00.4Disabled
1034SRTLSRTL1034UPS_05-0.encUPS 05.0YesEnabled
1035SRTLSRTL1035UPS_05-0.encUPS 05.0YesEnabled
1016XP1K9NN42RCCXP1016UPS_15-0.enc UPS 15.0NoEnabled
1017XU1K3LLXXRCCXU1017UPS_15-0.encUPS 15.0Yes, from UPS 01.4Disabled
1025XU1K0JJXXRX-JP
XU750JJXXRX-JP
SRTXU1025UPS_15-1.encUPS 15.1Yes, from UPS 07.3Disabled
1033XU2K0LLXXRCCXU1033UPS_15-0.encUPS 15.30Yes, from UPS 0.03 Disabled


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. For more information about enabling or disabling firmware updates via the NMC for the UPS models that support this feature, refer to FAQ00024438.
  3. Once firmware updates via the NMC have been disabled, attempts to update the UPS firmware using the NMC will be refused:
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.

Attachment(s)

Did this answer your question?

Explore more
Explore more
Users group

Discuss this topic with experts

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