HELLO ALL!

With the release of Microsoft Dynamics GP 2013 R2 fast approaching, you will want to think about the steps for upgrading the Web Client. At this point in time you do not have to upgrade the Web Client when you upgrade the Rich Client (Desktop Client) however we do always recommend being on the latest and greatest in regards to these releases since new features are added and previous issues are fixed. 

When upgrading the Web Client, 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’re 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 Session Central Service update on the Session Central Server.  The same goes for the Session Service server.  Also, if you are running multiple Session Service Servers, you will want to be sure that you are upgrading both of them so that they are the same Web Client version.  Please see below for some quick instructions on how to upgrade a single server environment or a multi-server environment.  Please note, there are special instructions if you happen to be running Tenant Services.  You would want to refer to the Install and Administration Guide.

Please check back to this blog in the future for a link to the official upgrade documentation for both Web Client and Tenant Services.

Single machine upgrade

Preparing for the upgrade


Before you perform the upgrade for the Microsoft Dynamics GP web client, you must perform the upgrade for the database and the desktop client components. Use

Microsoft Dynamics GP Utilities to upgrade the system database and the company databases.  Refer to the procedures described in the upgrade documentation for Microsoft

Dynamics GP to complete this process.

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

Be sure that all of the users have signed out of the system before you start the web client upgrade process.

Installing the upgrade


To install an upgrade of the Microsoft Dynamics GP web client in the single machine configuration, complete the following procedure.

  1. Run the WebClient.exe application found in the \AdProd\WebClient\ folder of the Microsoft Dynamics GP 2013 R2 installation media.
  2. When the installation is complete, run the Dynamics GP Web Client

Configuration Wizard. You can access this from the Start menu.

  1. At the Welcome screen, click Next.
  2. Specify the type of authentication you want to use to connect to the SQL Server where the database for the Web Management Console is located. Click Next to continue.
  3. Specify the type of authentication you want to use to connect to the SQL Server where the database for the Session Central Service is located. Click Next to continue.
  4. Review the configuration actions that will be performed. Click Next to continue.
  5. Click Exit.

Updating the online help
 
If a web client upgrade has updated help content, 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 for the updated help content. The installer has the following name: Microsoft_DynamicsGP12_GPWebClientHelp.msi.
  6. At the Welcome screen, click Install. The installation process may take a few minutes.
  7. Click Finish.

Client machine update steps 

  1. To ensure that the updated Microsoft Dynamics GP web client is working properly, you should perform the following steps on each of the client machines that access the web client.
  2. Clear the Internet Explorer browser cache. This helps to ensure that the updated application and help files are being used for the web client.
  3. To clear the browser cache, open Internet Explorer. In the Tools menu, choose
  4. Internet options. In the Browsing history group, click Delete.
  5. In the Delete Browsing History window, be sure to remove the temporary
  6. Internet files. Click Delete.
  7. After the browser cache has been cleared, click OK.
  8. In Internet Explorer, go to the Microsoft Dynamics GP web client site. Sign in to the web client.
  9. If you watch closely, you should see a new Silverlight application is downloaded for the Microsoft Dynamics GP web client.
  10. Look in the lower-right corner to verify the trust level for the web client. If you see the icon indicating that the web client is running in sandboxed mode, you have an additional step to perform.

The Silverlight application included with the updated web client may have been signed with a security certificate that is not available on the client machine. To get this certificate, you must run the DynamicsGPTrustedApp.msi that is included with the updated web client code.   Otherwise, you would want to provide a link to this document here.

 

Scale out upgrade

Preparing for the upgrade

The first step to performing the upgrade for a scale out installation is to upgrade for the database and the desktop client components for Microsoft Dynamics GP. Use

Dynamics GP Utilities to upgrade the system database and the company databases.

Refer to the procedures described in the upgrade documentation for Microsoft

Dynamics GP to complete this process.

You should verify that at least one desktop client installation is working properly before you continue with the Microsoft Dynamics GP web client upgrade. Resolve any issues before you continue.

Be sure that all of the users have signed out of the system before you start the web client upgrade process.

If you are using Tenant Services with your Microsoft Dynamics GP web client installation, you must apply the update to Tenant Services before you update the web client components.

Refer to the Tenant Services Installation and Administration Guide for information about updating Tenant Services.

Updating the web site and Session Central Service
 
To install the upgrade for the web site and the Session Central Service, complete the following procedure.

  1. Log in to the machine that is running the web site and the Session Central

Service for the Microsoft Dynamics GP web client installation.

  1. Run the WebClient.exe application found in the \AdProd\WebClient\ folder of the Microsoft Dynamics GP 2013 R2 installation media. The upgrade actions for the web site and the Session Central Service will be performed. If the Web

Management Console components are installed on this machine, they will be updated as well.

  1. When the installation is complete, run the Dynamics GP Web Client

Configuration Wizard. You can access this from the Start menu.

  1. At the Welcome screen, click Next.
  2. Specify the type of authentication you want to use to connect to the SQL Server where the database for the Web Management Console is located. Click Next to continue.
  3. Specify the type of authentication you want to use to connect to the SQL Server where the database for the Session Central Service is located. Click Next to continue.
  4. Review the configuration actions that will be performed. Click Next to continue.
  5. Click Exit.

Updating session host machines
 
To install the upgrade for each session host machine in the scale out installation, complete the following procedure.

  1. Log in to the session host machine.
  2. If you haven’t already done so, perform the update for the Microsoft Dynamics

GP desktop client components. Be sure that the desktop client on the session host machine is working properly before you continue this upgrade procedure.

  1. Run the WebClient.exe application found in the \AdProd\WebClient\ folder of the Microsoft Dynamics GP 2013 R2 installation media. The upgrade actions for the Session Service and the Runtime Service will be performed.
  2. When the installation is complete, run the Dynamics GP Web Client

Configuration Wizard. You can access this from the Start menu.

  1. At the Welcome screen, click Next.
  2. Specify the type of authentication you want to use to connect to the SQL Server where the database for the Session Central Service is located. Click Next to continue.
  3. Review the configuration actions that will be performed. Click Next to continue.
  4. Click Exit.

Updating the online help
 
If a web client upgrade has updated help content, use the following procedure to install the updated help content for the scale out installation. This procedure assumes that the help is installed in the default location, which is the same server that is hosting the web site.

  1. Log in to the machine that is running the web site for the Microsoft Dynamics

GP web client installation.

  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 for the updated help content. The installer has the following name: Microsoft_DynamicsGP12_GPWebClientHelp.msi.
  6. At the Welcome screen, click Install. The installation process may take a few minutes.
  7. Click Finish.

Verifying the services
 
When all of the components of the web client installation have been updated, verify

that the services are working correctly.

  • On the machine that is hosting the web site for the web client installation, verify
    that the Session Central Service is running.
  • On each session host machine, verify that the Session Service is running.
  • In the Session Management snap-in for the Web Management Console, all of
    the session host machines should be listed. Be sure that each machine is set to
    allow new web client sessions.

At this point, you can allow users to sign in to the Microsoft Dynamics GP Web Client

 

Thank You!

Ross