Thursday, January 3, 2013

Dynamics GP 2013/2015/2016 - How to Install the Web Client - Web Components, Web Services

https://community.dynamics.com/gp/b/dynamicsgpthoughts/archive/2016/12/07/dynamics-gp-2015r2-web-client-installation-steps

  • Pre-Requisites
    • Remote Credentials to the machine where the WebClient server will be installed
    • Remote Credentials to the SQL server and GP servers
    • Access to the GP install media
    • Access to the OS install media
    • Domain Administrator access
    • SA access to SQL
    • An administrative service account to be used for any windows services required
    • A WebclientAdmin AD group
    • A WebClientUsers AD group
  • On the Server
    • Enable Web Client in Add\Remove Programs>GP Modules
    • Login to GP and setup a default printer under named printers
    • Create WebClientUser group, assign all admin accounts
    • Create WebClientAdmin group, assign all admin accounts
    • Refer to the documentation for a list of Windows Features to add as prerequisites
      • A lot of them are not ticked by default
      • http://www.microsoft.com/en-us/download/details.aspx?id=34672
        • Windows Server 2008 R2
          • Select the role services to install. The following items must be marked:
            • In Common HTTP Features:
              • Static Content
              • Default Document
            • In Application Development:
              • ASP.NET
            • In Security:
              • Windows Authentication
          • Windows Server 2008 - Does not recognize ASP.net 4.5
            • Download and install dot net 4.5
            • Open a Command Prompt with Administrative permissions and type the following and then hit Return:
            • cd C:\Windows\Microsoft.NET\Framework64\v4.0.30319\
            • Then type the following and hit Return:
            • aspnet_regiis –i
            • If this does not work, manually browse ot the location, create a shortcut to aspnet_regiis and add the -i flag then run it manually
        • Windows Server 2012
          • Open the Server Manager.
          • Click Manage >> Add Roles and Features.
          • In the Add Roles and Features Wizard, click Next.
          • Choose Role-based or feature-based installation, and then click Next.
          • Select your server from the server pool, and then click Next.
          • Mark Web Server (IIS) and then click Next.
          • Select the features to install. Be sure that you mark ASP.NET 4.5. 
          • In the WCF Services group under .NET Framework 4.5 Features, be sure that you have marked HTTP Activation.
          • Click Next.
          • The screen for the Web Server Role (IIS) is displayed. Click Next.
          • Select the role services to install for the web server. The following items must be marked:
            • In Common HTTP Features:
              • Static Content
              • Default Document
            • In Security:
              • Windows Authentication
            • In Application Development:
              • ASP.NET 4.5
        • Click Install
        • After the installation is complete, click Close.
    • Install GP 2013/2015/2016
      • Install Web Client Runtime in the list of GP modules during install to enable the Web Client functionality
    • Launch Dynamics, Run GP 2013, log in normally
    • Create Self Signed Certificate (Use the external public address, not the internal private address)
    • DO NOT USE THE DEFAULT SITE
    • Export Certificate and store in install folder
      • Run>MMC>add snap-in>Certificates>Local Computer
      • Personal>Certificates>Select Certificate>Right Click>All Tasks>Export
      • Include Private Key>PFX>Enter Password

    • Setup Website on IIS
      • Create name as GP
      • Select a content directory
      • Open IIS manager, right click on sites, add site
      • Select Binding Type: https
      • Leave host name blank
      • Enter a specific user to connect as
    • Create binding, Assign certificate to website
      • Ensure you are using an unused port
    • Click on Website>SSL Settings>Tick Require SSL
    • Run the Web Client Installer from install menu
    • Run C:\Program Files\Microsoft Dynamics\GP Web Components\GPweb\DynamicsGPTrustedApp.msi
    • Navigate to site
    • Management console
      • https://yourserver:443/WebManagementConsole/
    • It will prompt to install silverlight, install it
    • Even if it doesn't, you HAVE to install this, go get it
    • Install all gp customizations
    • Point to shared dictionary
  • Related Errors
    • An Unexpected error occurred
      • Restart all the GP Web Services
      • Disable the enhanced Security for IE, or else you will get anti-forgery cookie errors in the event viewer that prevent you from logging in to the web client
        • You can confirm this by logging in with Firefox with no issues
    • The Page you requested could not be found
      • Install silverlight
    • Certificate Errors
      • Go back and recreate the certificate, then run the GP Web Client install to repair the installation and use the new certificate
      • Click on the certificate error and install the certificate to the Trusted Certification Authorities folder
    • Asynccallbackexception
      • Install the certificate on the client machine you are connecting from
    • If you get any errors connecting, review the following
      • Open all ports for internally and externally for the web Client, session Service and Runtime Service (48650,48651,48652)
      • Ensure you installed all the Windows Features outlined in the doc
      • Ensure you installed the Web Client module in the GP install (Not required on client if no GP installed)
      • Ensure you have access to download and install silverlight
      • If you get an error saying the certificate is for a different site, make sure you're using the full address of the computer yourserver.yourdomain.com
      • Unexpected error : check to ensure the gp session central service has started correctly, reboot
    • An error occurred while initializing communication with the server.
      • Run C:\Program Files\Microsoft Dynamics\GP Web Components\GPweb\DynamicsGPTrustedApp.msi
    • If you are trying to uninstall a component, and you are getting error messages, try this tool

  • Upgrading to GP 2015 R2 Web Client
    • I was unable to get the upgrade to work correctly
    • Instead, I had to uninstall the old web client
    • Delete the databases manually
    • Delete the Website manually
    • Reinstall the new Web Client

No comments:

Post a Comment