Upgrading OneSpan Authentication Server

  • Updated on Mar 6, 2026
  • Published on Jan 14, 2026
  • 1 minute(s) read
Prev Next

Before you begin

Ensure that you successfully completed and verified the required pre-upgrade tasks and settings (see Pre-upgrade tasks and considerations), in particular that:

  • You are logged on using a user account with sufficient administrative privileges on the machine to run the upgrade.

Upgrading OneSpan Authentication Server

To upgrade OneSpan Authentication Server

  1. Open a terminal window.

    Ensure that the terminal window resolution is at least 80x24. Otherwise the Configuration Wizard cannot start automatically after the installation or upgrade.

  2. If required, log in as root using the hyphen option (su -).

    This ensures you load the root profile, not the default profile.

  3. Run ./upgrade.sh from the Installation CD.

  4. If required, specify the user account that the OneSpan Authentication Server daemon should run as, by default vasco-ias.

    If you specify a user that does not exist, the upgrade script will automatically create that user.

  5. If required, specify the user account that the Message Delivery Component daemon should run as, by default vasco-mdc.

    If you specify a user that does not exist, the upgrade script will automatically create that user.

  6. Confirm that the script will stop any OneSpan Authentication Server daemons and upgrade your system.

  7. If required, install install any missing dependencies.

    The script is designed to install as many dependencies as possible. However, due to license and other restrictions, not all required standard packages are shipped with the OneSpan Authentication Server setup. Any required dependency that is not already installed and cannot be installed by the script automatically, is listed and you are prompted to install it now.

    1. Open a separate terminal window.

    2. Install the required packages according to your Linux distribution.

    3. Return to the terminal window where the OneSpan Authentication Server script is running and press Enter.

    The upgrade script upgrades all required components.

Next steps

When the required components have been upgraded, the Configuration Wizard is started to complete the upgrade configuration (see Configuring OneSpan Authentication Server (upgrade)).