Upgrading Tomcat

You will only need to perform this step when instructed to by Krestfield support. If unsure, contact us here: support@krestfield.com

Steps

Step 1

Download the upgrade script from here, unzip and copy the .ps1 file to the following folder: .\certdog\install

E.g.

c:\certdog\install\upgrade-tomcat.ps1

Step 2

Open a PowerShell window as Administrator, navigate to .\certdog\install and run:

.\upgrade-tomcat.ps1

The latest Tomcat version will be downloaded and installed:

PS C:\WINDOWS\system32> cd C:\certdog\install\                                                                                                                                     PS C:\certdog\install> .\upgrade-tomcat.ps1                                                                                                                                         Stopping Certdog service...
Downloading tomcat...Please wait (this may take several minutes)
Checking hash...
Hash verified OK
tomcat downloaded OK
Unzipping...
tomcat unzipped OK

Backing up current Tomcat installation to C:\certdog\install\..\tomcat.bak.20260505-1552 ...
Moving new Tomcat installation into place...
Copying configuration...
Copying webapps...
Starting Certdog service...

Tomcat upgrade complete.
A backup of the previous Tomcat installation is located at: C:\certdog\install\..\tomcat.bak.20260421-1252

Note that the previous Tomcat version is backed up to a timestamped folder mentioned in the output.

If you do not have an internet connection from this server, the script will report the following:

An error occurred during the download of tomcat. You can try again or manually download

To manually install the files:
  Download the zip file from here: https://krestfield.s3.dualstack.eu-west-2.amazonaws.com/certdog/components/tomcat.zip
  Unzip the downloaded file to here: C:\Program Files\Krestfield\certdog\bin\..\tomcat.new
  Then continue with the setup

Manually download the zip from the location given from a system that has an internet connection and copy to this server

Create a new folder called tomcat.new within the certdog installation, so you have a folder like this .\certdog\tomcat.new and unzip the file here. This should result in a file structure like this:

.\certdog\tomcat.new\tomcat
						.\bin
						.\conf
						.\crlwebapps
						...

Re-run the script as before. This time is should report:

New Tomcat files already downloaded
Continue using Tomcat files found at tomcat.new (y/n)? : y

And continue with the upgrade

Rollback

If any errors do occur then the upgrade may be rolled back. To do this, stop the certdog service. Delete the .\certdog\tomcat folder. Note the backup location that was output from the script e.g.

C:\certdog\install\..\tomcat.bak.20260421-1252

Note that in this example, this relates to: C:\certdog\tomcat.bak.20260421-1252

Rename to .\certdog\tomcat e.g.

C:\certdog\tomcat.bak.20260421-1252 --> C:\certdog\tomcat

Start the certdog service.

Cleanup

When satisfied that the installation is all working correctly you may delete the backup of the old Tomcat files.

Locate the backup location e.g.

C:\certdog\tomcat.bak.20260421-1252

and delete