Home > Product Upgrade Guides > How to verify and upgrade to the latest version of Messageware EPG 2019, Messageware EPG 2016 and Messageware EPG 2013

How to verify and upgrade to the latest version of Messageware EPG 2019, Messageware EPG 2016 and Messageware EPG 2013

This article applies to the following products:

Messageware EPG 2019

Messageware EPG 2016

Messageware EPG 2013

 

 

SUMMARY

 

This article includes steps on how to verify the EPG version installed and upgrade paths based on the software that’s being planned to update on the Exchange server environment.

 

The upgrade scenarios can include:

  • Apply an Exchange Cumulative Update (CU) but EPG version remains unchanged
  • Apply an EPG upgrade only but CU version remains unchanged
  • Apply both CU and EPG updates

 

Note: Please be aware of the following items prior to applying a CU and/or EPG update.

  • EPG updates only apply to versions 3.1 or higher (3.0 and lower must contact Messageware Support prior to start)
  • The SQL session, database, and user account details that EPG uses to connect to the SQL server are required
  • The Exchange server must be restarted following a CU installation.  This step will finalize any pending Exchange updates and place the server in a clean state
  • The World Wide Web Publishing Service will need to be stopped/started during the EPG upgrade process
    •  Recommend to stop the service manually in Windows Service at the required stages

 

A more comprehensive installation and administration guide is available and can be found in the Messageware customer portal found in the following section.

 

IDENTIFY VERSION

 

The steps below will cover how to identify the EPG version that is currently installed in the server.

 

  • Open a Remote Desktop Connection into the server where EPG is installed (Typically on CAS/Front-End servers)
  • Navigate to Programs and Features, either from the Start button or Control Panel
  • Locate all Messageware EPG components installed on the server
  • The version of the software is listed under the Version column
  • Please consult the “Messageware – Microsoft CU Compatibility Matrix” to determine the matching Microsoft / Messageware version.

 

IDENTIFY DEPLOYMENT

 

Identify which deployment matches your current configuration and locate the servers where the EPG components are installed

 

  • Exchange server only

All EPG components (EPG, Web Management, Monitor) are installed in Exchange CAS/Front-End server

 

  • Exchange and Application servers

The EPG component installed in Exchange CAS/Front-End server, Web Management and Monitor are installed in Application Server

 

UPGRADE OPTIONS

 

Identify the upgrade path which best matches your upgrade plan.

 

Perform an Exchange Cumulative Update only, EPG version remains unchanged

 

Perform an EPG upgrade only, CU version remains unchanged

 

Apply both CU and EPG updates

 

Note: Please consider the following preparation prior to starting the upgrade

  • Single-role (CAS / Front-End) Exchange server should temporarily divert user logon traffic to an alternate Exchange server from the organization’s load balancer
  • Multi-role (Front-End / Mailbox) Exchange server should be placed in maintenance mode in addition to user logon traffic being temporarily diverted to an alternate Front-End Exchange server from the organization’s load balancer

 

Follow the suggested instructions outlined as it applies to your upgrade plan.

 

Upgrade Option 1

Perform an Exchange Cumulative Update only, EPG version remains unchanged

 

Load Balancer and Exchange Consideration

  • Perform the necessary load balancer configuration changes as needed
  • Place the Exchange server in maintenance mode
    • Requirement for multi-role servers
  • Reboot Exchange server to finalize any pending system changes and to place the server in a clean state prior to applying the updated CU

 

Obtain EPG Zip Package

  • You may use a previously downloaded EPG zip package or download a matching EPG version by connecting to the Messageware Customer Portal
    • Note: See Identify Version section to assist with EPG version identification and CU compatibility matrix
  • Save zip and extract to a temporary location

 

Uninstall EPG Component(s)

  • On Exchange server where EPG component is installed
  • Launch Programs and Features within Windows
    • Navigate to Control Panel \ All Control Panel Items \ Programs and Features
    • Take note of all EPG software installed
  • Select Messageware EPG (year) and Uninstall
    • The World Wide Web Publishing Service will be stopped/started during the uninstall portion of this component only

 

Exchange CU Installation

  • Verify OWA login connectivity from your client’s browser and connect directly to the Exchange server URL (ex. https://servername/owa)
  • Perform the Cumulative Update on Exchange server
  • When the CU update has completed, reboot the Exchange server

 

Re-install EPG Component(s)

  • Verify OWA login connectivity from your client’s browser and connect directly to the Exchange server URL (ex. https://servername/owa)
  • Navigate to the zip extracted location and install software in the following order with elevated administrative permissions

Exchange

  • Messageware EPG (year)
    • The World Wide Web Publishing Service will be stopped/started during the install portion of this component only

 

Verify OWA with EPG Functionality

 

Return Exchange Server to Production Duty

  • Place the Exchange server out of Maintenance Mode
  • Re-instate the Exchange server back to rotation in load balancer

 

Upgrade Option 2

Perform an EPG upgrade only, CU version remains unchanged

The EPG upgrade typically consists of updating the database, reports and front-end applications related to EPG

 

Load Balancer and Exchange Consideration

  • Perform the necessary load balancer configuration changes as needed
  • Place the Exchange server in maintenance mode
    •  Requirement for multi-role servers
  • Reboot Exchange server to finalize any pending system changes to place the server in a clean state

 

Obtain EPG Zip Package

  • You may use a previously downloaded EPG zip package or download a matching EPG version by connecting to the Messageware Customer Portal
    • Note: See Identify Version section to assist with EPG version identification and CU compatibility matrix
  • Save zip and extract to a temporary location

 

Uninstall EPG Component(s)

SQL

  • On the SQL Server where the EPG reports are deployed
  • Connect to the SQL Server Reporting Services URL (ex. http://sqlserver/Reports)
    • Take note of the AD object (typically a server) under Security from the EPG Reports folder
  • From the temporary folder, navigate to Report_setup folder and launch the report_installer.exe with elevated administrator permission
    • When the connection to SSRS has been established, click Uninstall

 

Exchange/Application

  • On Exchange server where EPG component is installed
  • Launch Programs and Features within Windows
    • Navigate to Control Panel \ All Control Panel Items \ Programs and Features
  • Uninstall Messageware EPG (year)
    • The World Wide Web Publishing Service will be stopped/started during the uninstall portion of this component only
  • Uninstall EPG Monitor and EPG Web Management where is found installed on Exchange or Application server
    • Take note of the mailbox account assigned to EPG Monitor or EPG Service if EPG Alerts was assigned to run in Service mode

 

Install EPG Component(s)

  • Verify OWA login connectivity from your client’s browser and connect directly to the Exchange server URL (ex. https://servername/owa)
  • Navigate to the zip extracted location and install software in the following order with elevated administrative permissions

SQL

  • From the Database_install folder
    • Launch the db_setup_cs.exe with elevated administrator permission
    • Enter the required fields to connect to the EPG instance/database
    • The utility will detect the current EPG database version and suggest the available update. 
      • Example: EPG Database will upgrade from 3.3.0.1 by this Db installer running Configuration_UG_EPG_3301_3400.xml to 3.4.0.0
    • Click the Upgrade Database button
  • From the Report_setup folder
    • Launch the report_installer.exe with elevated administrator permission
    • Enter the required fields to connect to the EPG instance/database
    • Click the Deploy button

 

Exchange/Application

  • Messageware EPG (year)
    • The World Wide Web Publishing Service will be stopped/started during the install portion of this component only
  • Messageware EPG Web Management
    • Match as previously installed in Exchange or Application server
  • Messageware EPG Monitor
    • Match as previously installed in Exchange or Application server
    • Add the mailbox account if previously assigned to the EPG Monitor Service. Restart service to apply the change.

 

Verify OWA with EPG Functionality

 

Return Exchange Server to Production Duty

  • Place the Exchange server out of Maintenance Mode
  • Re-instate the Exchange server back to rotation in load balancer

 

Upgrade Option 3

Apply both CU and EPG updates

The EPG upgrade typically consists of updating the database, reports and front-end applications related to EPG

 

Load Balancer and Exchange Consideration

  • Perform the necessary load balancer configuration changes as needed
  • Place the Exchange server in maintenance mode
    • Requirement for multi-role servers
  • Reboot Exchange server to finalize any pending system changes and to place the server in a clean state prior to applying the updated CU

 

Obtain EPG Zip Package

  • You may use a previously downloaded EPG zip package or download a matching EPG version by connecting to the Messageware Customer Portal
    • Note: See Identify Version section to assist with EPG version identification and CU compatibility matrix
  • Save zip and extract to a temporary location

 

Uninstall EPG Component(s)

SQL

  • On the SQL Server where the EPG reports are deployed
  • Connect to the SQL Server Reporting Services URL (example: http://sqlserver/Reports)
    • Take note of the AD object (typically a server) under Security from the EPG Reports folder
  • From the temporary folder, navigate to Report_setup folder and launch the report_installer.exe with elevated administrator permission
    • When the connection to SSRS has been established, click Uninstall

 

Exchange/Application

  • On Exchange server where EPG component is installed
  • Launch Programs and Features within Windows
    • Navigate to Control Panel \ All Control Panel Items \ Programs and Features
  • Uninstall Messageware EPG (year)
    • The World Wide Web Publishing Service will be stopped/started during the uninstall portion of this component only
  • Uninstall EPG Monitor and EPG Web Management where found installed on Exchange or Application server
    • Take note of the mailbox account assigned to EPG Monitor or EPG Service if EPG Alerts was assigned to run in Service mode

 

Exchange CU Installation

  • Verify OWA login connectivity from your client’s browser and connect directly to the Exchange server URL (ex. https://servername/owa)
  • Perform the Cumulative Update on Exchange server
  • When the CU update has completed, reboot the Exchange server

 

Install EPG Component(s)

Exchange/Application

  • Verify OWA login connectivity from your client’s browser and connect directly to the Exchange server URL (ex. https://servername/owa)
  • Navigate to the zip extracted location and install software in the following order with elevated administrative permissions

SQL

  • From the Database_install folder
    • Launch the db_setup_cs.exe with elevated administrator permission
    • Enter the required fields to connect to the EPG instance/database
    • The utility will detect the current EPG database version and suggest update. 
      • Example: EPG Database will upgrade from 3.3.0.1 by this Db installer running Configuration_UG_EPG_3301_3400.xml to 3.4.0.0
    • Click the Upgrade Database button
  • From the Report_setup folder
    • Launch the report_installer.exe with elevated administrator permission
    • Enter the required fields to connect to the EPG instance/database
    • Click the Deploy button

 

Exchange/Application

  • Messageware EPG (year)
    • The World Wide Web Publishing Service will be stopped/started during the install portion of this component only
  • Messageware EPG Web Management
    • Match as previously installed in Exchange or Application server
  • Messageware EPG Monitor
    • Match as previously installed in Exchange or Application server
    • Add the mailbox account if previously assigned to the EPG Monitor Service. Restart service to apply the change.

 

Verify OWA with EPG Functionality

 

Return Exchange Server to Production Duty

  • Place the Exchange server out of Maintenance Mode
  • Re-instate the Exchange server back to rotation in load balancer