In some cases, uploading large files over HTTP is not possible. In such cases, you can update the firmware using SSH.
|
Caution:
One Identity recommends that you update the firmware by using the One Identity Safeguard for Privileged Sessions (SPS) web interface (for more information, see Upgrading One Identity Safeguard for Privileged Sessions (SPS)). Update the SPS firmware using SSH only if you cannot update it using the web interface. Consider that updating the firmware using SSH may not be supported in later versions of SPS. |
Prerequisites
-
Remote SSH access to SPS must be enabled. For details, see Enabling SSH access to the One Identity Safeguard for Privileged Sessions (SPS) host.
To update the firmware using SSH
-
Download the firmware file to your computer.
-
Log in to SPS remotely using SSH, and select Shells > Core shell from the console menu.
-
Copy the firmware to the SPS host (for example, into the /root/ directory).
If you are copying the firmware to SPS using SCP and you issue the copy command on the client side and not within the core firmware, the root directory of the core firmware is: /mnt/firmware/root
-
Install the firmware: /opt/nnx-scb/bin/firmwarectl install <path-to-firmware>
This command installs the firmware into the first empty slot, and returns the value of the slot where the firmware has been installed.
-
Check if you can upgrade to the new firmware, and resolve any errors before you continue: /opt/nnx-scb/bin/firmwarectl precheck <slot-number-of-the-firmware>
Caution: If any error occurs, do not proceed with the next step. Instead, cancel the update and contact our Support Team.
In the returned values, "exitcode": 0 means that the precheck has finished without any errors. The "exitcode": 1 return value means that errors have occurred, and the contents of "output": [] gives you a clue as to what is causing the problem.
-
Activate the new firmware: /opt/nnx-scb/bin/firmwarectl activate <slot-number-of-the-firmware>
Using the /opt/nnx-scb/bin/firmwarectl list command, you can check whether activation has been successful. In the returned values, look for your slot number and the value of "active":. If activated successfully, the value is true. For example:
... "slot": 3, "precheck": true, "active": true, "boot_link": "mnt/boot-firmware/slot3", "core_link": "mnt/firmware/slot3", "branch": "5.6", "version": "5.6.0a", "current": false, ...
-
Reboot SPS: xcbclient self xcb_do_reboot
-
If the upgrade is successful, delete any unused firmware: /opt/nnx-scb/bin/firmwarectl delete <slot-number-of-unused-firmware>
-
As you do not need it anymore, delete the firmware file you uploaded to SPS: rm -fv /root/<firmware-file-you-uploaded>