InstallationPrepare GP EnvironmentInstall Service Based Architecture (SBA)

Prepare GP Environment

Open 'Prepare GP Environment' wizard to see more information.

Install Service Based Architecture (SBA)

 NOTE

Skip this article, if Service Based Architecture (SBA) is already installed. If Microsoft Dynamics GP is installed, but SBA is not there yet, you can follow this article to install and configure SBA.

Installation of Service Based Architecture and other Microsoft Dynamics GP components can vary based on different scenarios and your requirements. Below is the basic installation manual. For detailed instructions, read the official Microsoft Dynamics GP installation manual.

Service Based Architecture (SBA) was introduced in Microsoft Dynamics GP 2015 RTM. It provides a REST Web service which exposes Microsoft Dynamics GP business logic as service operations. A Sana web store connects to and communicates with Microsoft Dynamics GP through the Web service.

 NOTE

Sana for Microsoft Dynamics GP requires two separate Web services for Beta and Live environments. One Web service must be used to connect to the beta / test database and another one to the production database of Microsoft Dynamics GP. It is recommended to set up beta and live Web services on different servers.


Prerequisites

To install the Service Based Architecture, you will need:

  • Microsoft Dynamics GP Setup utility
  • Internet Information Services (IIS) Manager
  • SSL certificate. Microsoft Dynamics GP Web service is running over HTTPS. Configuring the Web service to use SSL is a part of the standard Service Based Architecture installation. To secure data communications between Sana and Microsoft Dynamics GP using SSL, the server which hosts the Microsoft Dynamics GP Web service must support TLS 1.2.

Add the SBA feature to the Microsoft Dynamics GP client

Step 1: In the Control Panel, open Programs and Features.

Step 2: Select Microsoft Dynamics GP and click Change.

 

Step 3: Click Add/Remove Features.

Step 4: In the list of available features, set Service Based Architecture to Run from My Computer and click Next.

Step 5: Enter the service account details which will be used for the SBA service, by completing the fields Domain, User Name and Password.

Step 6: Click Next, and then click Install to begin installation. When the installation is finished, click Exit.

Install SBA Web Components

Step 1: Run the Microsoft Dynamics GP setup utility, and under Additional Products, click Web Components.

Step 2: Accept the terms of the License Agreement, and click Next.

Step 3: In this example, we will install only the Web Components required for SBA. To do this, select Custom.

Step 4: In the list of available features, set Service Based Architecture to Run from My Computer. Check and confirm the Install Location, and click Next.

Step 5: Set up Web Components Database settings.

          5.1 Enter the Server Name. You must enter the full SQL Server instance name of the server which stores the database.

          5.2 Enter the Database name. If you already have the database, you can use it.

          5.3 Select the authentication method. If you are using SQL Authentication, enter Login ID and Password. Click Next.

Step 6: SBA is maintained via the Web Management Console. Thus, you must specify the active directory group, the users of which will have access to the Web Management Console. Enter the active directory group in the Web Management Console Users field. Click Next.

Step 7: In this example, we will not deploy a multi-tenant environment, thus we will skip tenant configuration and proceed to the next step.

Step 8: Set up Web Management Console.

          8.1 Select the Web Site where the Web Management Console will be installed. The installation will create an application in the web site in the IIS Manager.

          8.2 Enter the domain account and user credentials which will be used as the application pool identity for the Microsoft Dynamics GP Web Application. Click Next.

Step 9: The Web Components connect to the Microsoft Dynamics GP database using the SQL Server login. Thus, enter the SQL Server Login Name and Password. Click Next.

You will be asked to re-enter the password.

Step 10: Set up the GP Service.

          10.1 Enter the port on which the GP Service should run.

          10.2 The GP Service is running over HTTPS. Thus, the SSL certificate must be already installed. Select the SSL certificate.

          10.3 Enter the domain account and user credentials that will be used as the service account for the GP Service. Click Next.

Step 11: Set up the Dexterity Service Control service. For the Dexterity Service Control service you must set up the same settings as for the GP Service, except the port number.

          11.1 Enter the port on which the Dexterity Service Control service should run.

          11.2 The Dexterity Service Control service is running over HTTPS. Thus, the SSL certificate must be already installed. Select the SSL certificate.

          11.3 Enter the domain account and user credentials that will be used as the service account for the Dexterity Service Control service. Click Next.

Step 12: Click Install to begin installation. When the installation is finished, click Exit. The Microsoft Dynamics GP Web Components Configuration Wizard will automatically launch. Click Next to proceed.

 

Step 13: Select the authentication method that should be used to connect to the SQL Server which hosts the Web Components database. If you are using SQL Authentication, enter Login ID and Password.

Step 14: Click Next and complete configuration of SBA and Web Management Console.

InstallationPrepare GP EnvironmentInstall Service Based Architecture (SBA)