Skip to main content

SSRPM - Upgrade Guide - Knowledgebase / SSRPM - Tools4ever NW Support

SSRPM - Upgrade Guide

Authors list

Summary

Upgrading SSRPM is usually straightforward and low risk.  This KB will cover some basic steps that should be performed when upgrading SSRPM and help you recover in case any issues arise.

Upgrade Steps

While upgrading SSRPM is usually a next-next-next type of install, there are some steps you should perform beforehand to make sure you're covered in case something goes wrong.

  1. Export the encryption key used by SSRPM.  

    1. This is needed in case you need to reinstall the SSRPM service on the existing, or a new server.
    2. This can be done within the SSRPM Admin Console - Service Management menu - Configure... - Encryption tab.  Press the Export Key button, and save the file somewhere it can be backed up (either on the current server, or a seperate file server).
  2. Backup the DB

    1. If you are using the local Microsoft Jet (Access) DB, you can simply stop the service and make a copy of the DB file.

      1. Default location:  c:\program files (x86)\tools4ever\ssrpm\service\DataBase\SSRPMDataBase.mdb
    2. If you are using a SQL instance to host the SSRPM DB, you can use your prefered SQL backup solution, or backup the DB using SQL Server Management Studio.
  3. Install the new version of SSRPM from the executable.

    1. Normally this is done on the server hosting the SSRPM Service.
    2. This is a simple Next-Next-Next.  Adjust the default options as needed for your environment.
  4. Open the SSRPM Admin Console.  You should be prompted to upgrade the service.  Let the upgrade finish.
  5. Update the SSRPM DB

    1. In the SSRPM Admin Console, go to the Service Management menu, Configure..., Database tab, Database Maintenance, and click the Upgrade Database.
    2. This ensures any updates that were included with the new version to the DB get applied to your DB.
  6. Copy the website from the Admin Console installation folder to your webserver, then update the configuration files and re-apply any customizations you have done.

    1. Default install folder:  C:\Program Files (x86)\Tools4ever\ssrpm\Admin Console\Examples\
    2. If you were using the 'Legacy' ASP web site, it is advised to switch over to the updated ASPX site.  The new site does require at least or newer IIS 7.0 and .NET 4.5.

      1. Legacy Site:  ..\Examples\Web Interface
      2. Modern Site:  ..\Examples\Client Web Interface
    3. Please refer to the Web Interface Guide for more information on deploying and configuring the web sites.

      1. https://www.tools4ever.com/resources/?category=productmanual&products=SSRPM
  7. Deploy the updated COM object to your WebServer.

    1. This is as simple as copying the COM folder to the web server and running the two Register batch files from an elevated (admin) command prompt.
  8. Deploy the updated Admin Console to any other computers that have it.  These might include other support personel or local workstations.
  9. Deploy the updated Client Software to your workstations.

    1. This can also be found in the Admin Console folder where you installed SSRPM.
    2. File name:  SsrpmUserClientSoftware.msi
    3. Deploy the updated software using your prefered method of software deployment (GPO, SSCM, etc)
    4. More information can be found in the GPO Distribution Guide, available as part of the installed SSRPM Admin Console:
      1. Default Path:  C:\Program Files (x86)\Tools4ever\SSRPM\Admin Console\Documentation

That's it!  If you follow these steps, you should have a successful SSRPM upgrade.  If anything goes wrong, you can re-install your previous version of the SSRPM software, restore the DB, and import the encryption keys, and you should be back where you started.  You can then reach out to Tools4Ever for additional support to help figure out what went wrong.