Link Search Menu Expand Document

Manually Upgrading Certdog


To upgrade to a new version of Certdog you may

  • Simply uninstall the old and install the new version
    • This will not retain any settings - you will end up with a new, blank installation of the later version
    • This may be useful if you are building your configurations using automation and also do not need to retain any existing data (existing certificates)
    • This may also be the best option for test instances when you just want to dispose of the old versions
  • Perform an in-place upgrade
    • This option overwrites the existing installation with the new files but retains all of the data and settings


Option 1: Uninstall the old and Install the new version

Follow the guide here to uninstall your existing installation

If you wish to retain the data, in case of future use, follow the guide here to backup

Follow the guide here to install the new version


Option 2: In Place Upgrade

Overview

Essentially, we will backup the current installation then replace the following file and folder:

[certdog installation]\tomcat\webapps\certdog#api.war
[certdog installation]\tomcat\webapps\certdog#ui

With those from the new version’s zip


STEP 1 - Stop Certdog

On Windows, open the services snapin and stop Krestfield Certdog Service

(On other OS’s, either stop Tomcat or use the stop-certdog or stop-tomcat scripts)

On Windows, open the services snapin and stop Krestfield Certdog Database

(On other OS’s, stop mongo using the command line option db.shutdownServer()or service options service mongod stop)


STEP 2 - Backup

Backup the following folder:

[certdog installation]\tomcat\webapps

Also backup the database by following the guide here


STEP 3 - Delete Existing Files

From your existing installation, navigate to:

[certdog installation]\tomcat\webapps

It should look like this

File Structure

Delete the following folders

.\certdog#api
.\certdog#ui

And delete the following file

certdog#api.war


STEP - 4

Unzip the new version’s media, navigate to this unzipped location here:

[new media location]\certdog\tomcat\webapps\

Copy the following folder:

.\certdog#ui

And the following file:

certdog#api.war

To your current installation here:

[certdog installation]\tomcat\webapps


STEP - 5

Start Certdog


Verification and Rollback

Attempt to login as per normal to Certdog

Confirm the version as follows:

From the menu select Settings then choosing the Settings sub menu

The System Information should display:

  • UI Version
  • API Version

Verify these are as expected


If a rollback is required, perform the following:

  • Stop Certdog

  • Replace the following folder:

[certdog installation]\tomcat\webapps
  • With the version backed up

  • Restore the database as per the guide here

  • Start Certdog