Overview

This guide will upgrade a single node from Signserver Enterprise version 5.10.0 to Signserver Enterprise 5.11.2. In this example, the Signserver host will have an IP Address of 54.172.199.193. Please change this IP address to be the IP Address that matches the Signserver node being upgraded.

Download the Signserver Cloud or Virtual Appliance Upgrade file from your customer download folder or obtain a copy from support at support@primekey.com. 

  1. Copy the upgrade package to the Signserver node using the following method:

    1. Using the CLI:
      If using a Mac or Linux based computer use the following command to copy the file to the host (Note: If using AWS, ensure you specify the user as ec2-user with your SSH key and in Azure, specify the user provisioned with your instance)

      scp ~/Downloads/signserver-ee-5.11.2.Final-bin.zip root@54.172.199.193:/tmp
      CODE

  2. SSH to the Signserver VM and login as root

    ssh root@54.172.199.193
    CODE

  3. Change directory to the /opt directory

    cd /opt
    CODE

  4. Unzip the upgrade file to the /opt/ directory

    unzip /tmp/signserver-ee-5.11.2.Final-bin.zip
    CODE

  5. Ensure the file extracted into the /opt/ directory by doing a directory listing

    ls -la
    CODE

  6. Copy the existing config files to the new Signserver install folder overwriting the default files with the existing files.

    /bin/cp -f signserver/conf/*.properties signserver-ee-5.11.2.Final/conf/
    CODE

  7. Stop WIldFly

    systemctl stop wildfly
    CODE

  8. Remove “signserver” symlink

    rm signserver
    CODE

  9. Ensure it asks you to remove symbolic link!

    rm: remove symbolic link ‘signserver’?
    CODE

  10. Create new symbolic link

    ln -s signserver-ee-5.11.2.Final signserver
    CODE
  11. Ensure the symbolic link points to the new Signserver directory.

  12. Change the ownership of the new Signserver files (ensure the trailing "/" in the command below so the permissions of the directory are changed and not the symlink itself).

    chown -R wildfly:wildfly /opt/signserver/
    CODE

  13. Change directory to /opt/signerver

    cd /opt/signserver
    CODE

  14. Deploy Signserver

    ant deploy
    CODE

  15. Restart WildFly

    systemctl start wildfly
    CODE
  16. Access the Signserver Admin Web UI and ensure the new version of Signserver is 5.11.2.Final (or the version you are upgrading to.)