Deploy a Microsoft Dynamics AX Retail Online Store
Customization on a Single Server
Storefront solution can customize the online store. Users can change the solution, package it into a solution, and then deploy it by using a deployment script. This topic describes how to build a package, change the deployment setting, and deploy it.
To change the oob-topology.xml file, do the following:
1. Log on to the server that hosts Microsoft Dynamics AX retail online store.
2. Locate the directory where the oob-topology and oob-settings files are stored. By default, they are stored at this location: C:\Program Files (x86)\Microsoft Dynamics AX\60\Retail Online Channel\tools. 3. Open the oob-topology.xml file in Notepad and make sure that the
highlighted settings are correct.
Note: For more information about how to deploy the online store on a single server, refer to the MSDN article that is located at http://technet.microsoft.com/EN- US/library/jj991927.aspx.
The ”Web Application Setting” image displays how to change the specific settings in the .xml file to control deployment options.
Settings for the Storefront Solution where you can specify the WSP location
FIGURE 7.5: STOREFRONT SOLUTION SETTING
Deploy-FarmSolutions.ps1
When you run this script, it usually performs the following actions on the server: Deploys the new SharePoint solution package.
Starts features.
Executes post-deployment custom scripts (deploy mode). These steps depend on the values that were set in the oob-topology.xml file. When you re-execute, the scripts change the steps.
Execute Deploy-FarmSolutions.ps1
Follow these steps to execute this script.1. On the server where you want to execute the script, open a command prompt as an administrator.
2. Locate the directory where the oob-topology and oob-settings files are stored. By default, they are stored at the following location: C:\Program Files (x86)\Microsoft Dynamics AX\60\Retail Online Channel\tools
3. Execute the following command:
powershell .\Deploy-FarmSolutions.ps1 oob-topology.xml oob- settings.xml
When the system finishes the operation, you can verify the deployment.
Verify Deployment
If all deployment scripts are completed without errors, use this section to help verify the online store deployment.
Note: For more information about how to configure the development environment and to deploy the online store, refer to the MSDN article that is
Customization
located at http://technet.microsoft.com/EN-US/library/jj991927.aspx . Verify that the Connector Service is running
After a successful deployment, the Dynamics AX Publishing Connector Service is running in SharePoint Central Administration. At this point, the service displays the error “No channel configuration could be found in the database.” This means that the channel has not been configured in Microsoft Dynamics AX yet. You must configure the channel in Microsoft Dynamics AX.
To verify that the DynamicsAX Publishing Connector service is running, do the following:
1. In SharePoint Central Administration under System Settings, click Manage services on server.
2. Verify that the Dynamics AX Publishing Connector service is running. 3. In SharePoint Central Administration, click Monitoring, and then click
Job Status.
4. Verify that you see jobs (SharePoint Timers jobs for the following web applications) listed for the C1 Application for Retail Store Front – Internalandthe Out of box Store front – Public.
Verify that site collections exist and can be browsed
After a successful deployment, you can view the Retail online store web applications and site collections in SharePoint Central Administration. If you specified different URLs for your web applications, you must adjust the URLS by doing the following:
1. In SharePoint Central Administration, click Application Management, and then click View all site collections. 2. On the C1 Application for Retail Store Front – Internal web
application, copy the following URL:
http://ServerName:40001/sites/RetailProductCatalog
3. Paste the URL into a browser. Verify that the Welcome to your product catalog site is displayed.
4. In SharePoint Central Administration, click the Web application drop- down list, and then click Change web application.
5. Click Out of box Store front – Public web application. 6. In the URL section, verify that you see the following URLs:
o http:// ax2012r2a:40002/sites/RetailPublishingPortal o http:// ax2012r2a:40002
7. Copy and paste each URL into a browser. Verify that you see the Contoso electronic superstore website and the Contoso electronic
superstore sign-in site. If the sign-in site displays a certificate warning, click Continue to this web site. This warning appears if you used a self-signed certificate.
Verify that you can create and sign-in with a new forms-based user account You should be able to register a new user account and log on from the public URL. To complete the sign-up process, verify SQL Server connectivity, SSL port settings, and SSL certificate bindings, do the following:
1. Paste the public URL into a browser, and then press Enter. See the following example:
http://ax2012r2a:40002/sites/RetailPublishingPortal 2. Click Register a new account.
3. Enter an email address and a strong password in the required fields, and then click Createaccount.
4. Browse to the public portal site again
(http://ax2012r2a:40002/sites/RetailPublishingPortal).
5. Click Sign In, and then enter the information for the account that you just created. The system logs you onto the Contoso electronics site as a registered user.
Verify that you can browse the public URL
If you registered a domain, you should be able to surf the web address for your site. For example, you should be able to browse
http://www.<your_domain>.com/sites/RetailPublishingPortal. If you have not yet registered the domain, then you must create a host file entry and disable proxy settings in your browser (if applicable) before you try to surf the web address.