Hello everyone - with the release of Microsoft Dynamics GP 2018 R2, you will want to think about the steps you will have to take when upgrading Web Client.

One thing to take into consideration when upgrading the Web Client is that, you will want to verify whether you are in a single or multi-server environment. If you are running in a single server environment, you will be upgrading the Session Central Service and Session Service on one server. If you are running a multi-server environment, you will want to be sure that you are installing the update on the Session Central Server/Web Server; the same goes for the Session Service/Session Host server. Also, if you are running multiple Session Service Servers, make sure that you are upgrading all of them so that they are the same Web Client version.

You are going to notice that there is still to install Web Client and Web Components in the GP 2018 R2 install media. For all intents and purposes, they will do the same thing.

Please note that you will have the option to install/upgrade Service Based Architecture (SBA). This part of the installation is not covered in this particular article, but be aware that these options will be there. If you are not using SBA, you can right click on Service Based Architecture and SBA Session Manager and select ‘Not Available’.

You can find instructions on how to upgrade a single server environment and a multi-server environment in the Documentation\Manuals directory on the GP media.  Please note that there are special instructions if you happen to be running Tenant Services.  You would want to refer to the Install and Administration Guide.

Tenant Services Documentation: You can find the Tenant Services upgrade documentation on the install media inside Documentation\Manuals. The file is called TSInstallAdminGuide. Be sure you go in and Edit the Path information in the Tenant Manager Snap-In after you have upgraded your GP Client on the Session Host Machine(s).

Installing the Web Client upgrade

Make sure to verify that the desktop client is working properly before you continue with the Microsoft Dynamics GP Web Client upgrade process; resolve any issues, and make sure that all of the users have signed of the system before proceeding.

  1. From the Microsoft Dynamics GP installation media, double-click the Setup.exe file to open the Microsoft Dynamics GP installation window.
  2. Click Web Components and then click Install.
  3. Select to upgrade your existing Web Client installation.
  4. The installation wizard will default with the selections from the installation being upgraded. You can change settings as needed. The screenshot below is missing the Web Client Session Manager as it is below the Tenant Manager option. You can also install that feature if you choose to do so. You can install the Service Based Architecture components at this point.  
  5. When the installation is complete, you will be prompt to run the Dynamics GP Web Components Configuration Wizard. You can also access this from the Start menu.
  6. At the Welcome screen, click Next.
  7. Click Exit.
  8. The Microsoft Dynamics GP Web Client Help installer will be started. Click Install to complete the help installation process.
  9. Click Finish to close the installer.

Issue Starting Session Service after uprade: There has been instance when a repair was needed to be run after the upgrade process complete before Session Service can start correctly

Updating the online help

If a web client upgrade has updated help content, you should be prompt to install the updates at the end of Web Client install. You can also use the following procedure to install the updated help content.

  1. Open the Programs and Features control panel.
  2. Select Microsoft Dynamics GP Web Client Help, and then click Change.
  3. Click Remove to remove the existing web client help. The process may take a few minutes.
  4. Click Finish.
  5. Start the installer that is located on the install media (AdProd\WebComponents\Help) for the updated help content. The installer has the following name: Microsoft_DynamicsGP16_GPWebClientHelp.msi.
  6. At the Welcome screen, click Install. The installation process may take a few minutes.
  7. Click Finish.

Client machine update steps

To ensure that the updated Microsoft Dynamics GP web client is working properly, you should clear the browser cache. This helps to ensure that the updated Application and help files are being used for Web Client.

You should verify that the desktop client is working properly before you continue with the Microsoft Dynamics GP Web Client upgrade process. Resolve any issues before you continue.