The ADSS Server upgrade process is quick and easy if the correct steps are followed. The database and other configuration files are automatically upgraded as part of the process. Your ADSS Server may be installed as a stand-alone installation or as a load-balanced system so separate instructions are provided for both of them.

Download the new version of ADSS Server software from http://www.ascertia.com/account/downloads.aspx and extract the zip to the ADSS Server target system(s). 

Upgrade a stand-alone ADSS Server

  1. Close the web browser to kill any active session for ADSS Server Console, this step is important otherwise operator may face issues in accessing the ADSS Server Console after upgrade.  
  2. Stop the existing ADSS Server services (Core, Console and Service) from Windows services panel / UNIX daemons.
  3. If ADSS Server is installed with:
    • PostgreSQL database then restart the PostgreSQL database server.
    • AzureSQL database then Click Here for special instructions.
  1. Take the backup of the ADSS Server database and installation directory because important data exists in both.
  2. If you are performing upgrade from an ADSS Server version older than 4.8.4, then follow these special instructions:
    • Go to location: [Existing-ADSS-Serve-Installation-Directory]. Copy jdk1.6.0.29 or jdk1.7.0_25 and apache-tomact-6.0.29 or apache-tomcat-7.0.42 folders and create a copy of them each.
    • Rename the copied folders with following directories:
      • jdk1.6.0.29 - copy or jdk1.7.0_25 - copy  --> jdk 
      • apache-tomact-6.0.29 - copy or apache-tomcat-7.0.42 - copy  --> tomcat
  1. Go to [New-ADSS-Server-Installation-Dir]/setup directory and run the install.bat (Windows) or install.sh (UNIX) using right permissions to launch the installation wizard. On Windows right click on install.bat and choose Run as administrator. While on UNIX OS run the install.sh as root user.
  2. Select the option I want to upgrade an existing ADSS Server instance to the latest version on the ADSS Server Installation Typescreen of the Installation Wizard.
  3. In this step, installer allows you to take backup of Master Key components each encrypted with password provided by the administrator. It is recommended that each key component must be protected with different password.
  4. On the next screen browse and select the root path of the existing/old version ADSS Server directory (e.g. C:/ADSS-Server/v4.x). 
  5. If you wish to apply a new commercial license file for ADSS Server then browse and select the relevant file otherwise the existing license configured in the old installation directory is used.
  6. A summary of the old and new installation directories is displayed, if this is correct click the Next button to proceed with upgrade process.
  7. Click the Next button and follow the wizard to complete the ADSS Server upgrade process. 
  8. Go to location: [New-ADSS-Server-Installation-Directory]/util/bin and run the update_service_stats.bat (Windows) orupdate_service_stats.sh (UNIX) using administrator/root user permissions to generate the stats for the existing transaction logs data.
  9. Confirm the wizard mentioned in point 10 has started the ADSS Server Windows services or Unix daemons using Windows admin services or on Unix use the daemon status command.

If you had changed the ADSS Server keystore password in your old installation of ADSS Server then click here for instructions to retain your password in the upgraded ADSS Server.



Upgrade a load-balanced ADSS Server system

  1. Identify the primary server instance - where the ADSS core instance is actively running - this can be identified via the ADSS Server admin console Global Settings > High Availability.
  2. Stop all ADSS Server Windows services or, on Unix systems, all daemons on all servers.
  3. Follow steps 1 to 13 mentioned in section Upgrade a stand-alone ADSS Server for the Primary ADSS Server instance.
  4. For all the Secondary ADSS Server instances:
    • Follow steps 1 to 6 mentioned in section Upgrade a stand-alone ADSS Server - the installer recognises that the database has already been upgraded in step 3.
    • Provide the Master key components (exported from Primary ADSS Server during step 3) one by one along with the password 
    • Follow the steps 8 to 13 mentioned in section Upgrade a stand-alone ADSS Server


More detailed information is provided in the ADSS Server Installation Guide.pdf included within the ADSS Server software download package in the /docs directory. It is also recommended to go through the detailed installation guide before upgrading the production systems.


If there are large number of transactions (e.g. 500K+) then it is recommended to archive the older transactions to remove them from the database. If this is not done, the time spent updating the database schema might be extended.


If [ADSS Server Installation Directory]/console/algorithm.properties file was updated on the previous version of the ADSS Server, it is responsibility of the administrators to manually update it after upgrading to the latest version.



See also

Starting & Stopping ADSS Server

Accessing the ADSS Server Console
Adding an Operator to ADSS Server
Managing Backups
Managing Disk Space
Upgrading ADSS Server
Checking PKCS11 HSM Functionality
Trace Logs Export Utility