Install DIGIPASS Gateway using Linux installation scripts

You can install DIGIPASS Gateway using a Linux installation script that automatically installs and configures the setup package provided for the respective distribution. The setup packages install an embedded Apache Tomcat web server to deploy the DIGIPASS Gateway web service.

If you want to just deploy the DIGIPASS Gateway web service to an existing web server, you can deploy the respective web application file instead (see Deploy DIGIPASS Gateway using web application files).

Before you begin

  • Ensure that the default port used by DIGIPASS Gateway is not used by another daemon or program, i.e. port 11080 (see Configure your firewall).

  • DIGIPASS Gateway cannot be installed if the fully qualified domain name (FQDN) of the server starts with a number, e.g. 001234-MYHOST. In that case, the setup will issue an error when it attempts to generate a self-signed certificate for the Apache Tomcat web server. Ensure that the FQDN meets this requirement.

Install DIGIPASS Gateway on Linux

To install DIGIPASS Gateway on Linux

  1. Open a terminal and navigate to the location of the installation script.

  2. Run the DIGIPASS Gateway installation script.

    sudo ./install_dpgateway.sh

    The installation script will guide you through the installation.

  3. Use Space to scroll through the license agreement and type yes to accept it.

    The DIGIPASS Gateway package is being installed. An embedded Apache Tomcat web server is installed and the DIGIPASS Gateway web service is deployed to it.

    If OneSpan Authentication Server has already been installed on the same machine, DIGIPASS Gateway is configured to use the local OneSpan Authentication Server instance automatically. Otherwise, DIGIPASS Gateway remains unconfigured and you need to configure it later manually (see Additional tasks).

Upgrade DIGIPASS Gateway

When DIGIPASS Gateway is already installed and you run the install scripts for the new version of the DIGIPASS Gateway package, the product is upgraded automatically once the installation process is completed. The existing configuration settings of the product are preserved.

Supported upgrade path

The current supported upgrade path is from version 5.7 or 5.8 to version 5.9.0 on the supported operating systems.

Additional considerations

  • The embedded Apache Tomcat web server runs on a dedicated embedded Java Runtime Environment (JRE) automatically installed by the setup package.
  • The embedded Apache Tomcat web server is automatically configured to secure connections to the DIGIPASS Gateway web service via TLS v1.2. A TLS certificate and a random password are generated for that purpose.
  • To use a different TLS certificate or to configure SSL/TLS certificates for Apache Tomcat, you need to import the certificate file manually to the keystore after you configured the certificate.

Additional tasks

If OneSpan Authentication Server has not already been installed on the same machine during the DIGIPASS Gateway setup, you need to configure the DIGIPASS Gateway web service accordingly using the OneSpan Web Configuration Tool (see Configure DIGIPASS Gateway).

Next steps

If required, verify and perform any post-installation task necessary to complete the installation (see Post-installation tasks and considerations).