Chat now with support
Chat with Support

One Identity Safeguard for Privileged Sessions 5.8.0 - Administration Guide

Preface Introduction The concepts of SPS The Welcome Wizard and the first login Basic settings User management and access control Managing SPS
Controlling SPS: reboot, shutdown Managing Safeguard for Privileged Sessions clusters Managing a high availability SPS cluster Upgrading SPS Managing the SPS license Accessing the SPS console Sealed mode Out-of-band management of SPS Managing the certificates used on SPS
General connection settings HTTP-specific settings ICA-specific settings RDP-specific settings SSH-specific settings Telnet-specific settings VMware Horizon View connections VNC-specific settings Indexing audit trails Using the Search (classic) interface Using the Search interface Searching session data on a central node in a cluster Advanced authentication and authorization techniques Reports The SPS RPC API The SPS REST API SPS scenarios Troubleshooting SPS Configuring external devices Using SCP with agent-forwarding Security checklist for configuring SPS Jumplists for in-product help Third-party contributions About us

Firmware update using SSH


In some cases, uploading large files over HTTP is not possible. In such cases, you can update the firmware using SSH. Complete the following steps.


The recommended way to update the firmware is using the SPS web interface (see Upgrading 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.

  1. Download the firmware file to your computer.

  2. Log in to SPS remotely using SSH, and select Shells > Core shell from the console menu.

  3. 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

  4. 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.

  5. 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.

  6. 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,
  7. Reboot SPS: xcbclient self xcb_do_reboot

  8. If the upgrade is successful, delete any unused firmware: /opt/scb/bin/firmwarectl delete <slot-number-of-unused-firmware>

  9. Delete the firmware file you uploaded to SPS, it is not needed anymore: rm -fv /root/<firmware-file-you-uploaded>

Exporting and importing the configuration of SPS using the console


You can export/import the configuration of SPS (for manual archiving, or to migrate it to another SPS unit) from the console using the /opt/scb/bin/ script.


You must run the /opt/scb/bin/ script using the root user.


The configuration of your SPS may contain sensitive information. Make sure you delete any configuration export files that are not needed anymore.

  1. Execute the following command to export the configuration of your SPS:

    /opt/scb/bin/ create --bundle /<my destination folder>/bundle.tar.gz


    • /opt/scb/bin/ The script you execute to export the configuration.

    • create: The option that lets you export a configuration.

    • --bundle: The option used to specify the bundle file.

    • /<my destination folder>/bundle.tar.gz: The path to the file where you wish to export the configuration.

      Replace <my destination folder> with the name of the folder where you wish to store the exported configuration.

  2. Execute the following command to import the configuration of your SPS:

    /opt/scb/bin/ import --bundle /<my destination folder>/bundle.tar.gz


    • /opt/scb/bin/ The script you execute to import the configuration.

    • import: The option that lets you import a configuration.

    • --bundle: The option used to specify the bundle file.

    • /<my destination folder>/bundle.tar.gz: The path to the file from which you wish to import the configuration.

      Replace <my destination folder> with the name of the folder where your configuration export file is stored.

Sealed mode

When sealed mode is enabled, the following settings are automatically applied:

  • SPS cannot be accessed remotely via SSH for maintenance.

  • The root password of SPS cannot be changed in sealed mode.

  • It is not possible to upload or delete plugins in sealed mode.

  • Sealed mode can be disabled only from the local console. For details, see Disabling sealed mode.

To enable sealed mode use one of the following methods:

  • Select the Sealed mode option during the Welcome Wizard.

  • Select Basic Settings > System > Sealed mode > Activate sealed mode on the SPS web interface.

  • Log in to SPS as root using SSH or the local console, and select Sealed mode > Enable from the console menu.

Disabling sealed mode


The event of disabling sealed mode is logged. To disable sealed mode, complete the following steps:

  1. Go to the SPS appliance and access the local console.

  2. Log in as root.

  3. From the console menu, select Sealed mode > Disable

  4. Select Back to Main menu > Logout.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating