In some cases, uploading large files over HTTP is not possible. In such cases, you can update the firmware using SSH.
|
Caution:
The recommended way to update the firmware is using the One Identity Safeguard for Privileged Sessions (SPS) web interface (see Upgrading One Identity Safeguard for Privileged Sessions (SPS)). Update the SPS firmware using SSH is only if you cannot update the firmware using the web interface. Note that updating using SSH may be removed from 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/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 continuing: /opt/scb/bin/firmwarectl precheck <slot-number-of-the-firmware>
In the returned values, "exitcode": 0 means that the precheck has finished without any errors. "exitcode": 1 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/scb/bin/firmwarectl activate <slot-number-of-the-firmware>
Using the /opt/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":, it should say 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/scb/bin/firmwarectl delete <slot-number-of-unused-firmware>
-
Delete the firmware file you uploaded to SPS, it is not needed anymore: rm -fv /root/<firmware-file-you-uploaded>