Anup Shah Support Engineer Microsoft Customer Services and Support. 14/February/2011. (Draft) Team Blog: http://blogs.msdn.com/emeadaxsupport/



Similar documents
Microsoft Corporation. Project Server 2010 Installation Guide

1 Operating System Support for Exchange Server 2013

Step-By-Step Guide to Deploying Lync Server 2010 Enterprise Edition

Windows SharePoint Services Installation Guide

Project Server hardware and software requirements

Microsoft Dynamics AX 2009 Installation Guide. Microsoft Corporation Published: November 2009

SharePoint Server Quick Start Guide for Single Server Farms

HOWTO: Installation of Microsoft Office SharePoint Server 2007

Microsoft Dynamics AX 2012 Installation Guide. Microsoft Corporation Published: April 2011 This content is preliminary and is subject to change.

Secret Server Installation Windows 8 / 8.1 and Windows Server 2012 / R2

Microsoft Dynamics GP. Workflow Installation Guide Release 10.0

MICROSOFT EXCHANGE SERVER 2013 INSTALLATION

Building a SharePoint 2010 Virtual Machine

User Guide. Installing and Configuring SharePoint Saifullah Shafiq

Team Foundation Server 2013 Installation Guide

Password Reset Server Installation Guide Windows 8 / 8.1 Windows Server 2012 / R2

Chapter 3 Installing Foundation 2013 onto Windows Server

How to move a SharePoint Server bit environment to a 64-bit environment on Windows Server 2008.

Secret Server Installation Windows Server 2008 R2

Microsoft Dynamics GP Release

SharePoint Server for Business Intelligence

Installation and Upgrade Guide

Metalogix Replicator. Quick Start Guide. Publication Date: May 14, 2015

HarePoint Password Change Manual

Team Foundation Server 2010, Visual Studio Ultimate 2010, Team Build 2010, & Lab Management Beta 2 Installation Guide

PROJECTIONS SUITE. Database Setup Utility (and Prerequisites) Installation and General Instructions. v0.9 draft prepared by David Weinstein

Installing Skype for Business Server 2015

11/23/2015 Step by Step Guide for. Exchange Server MS Messaging Solution. Md Shaifullah Mozide Palash OVIWIN

Secret Server Installation Windows Server 2012

Customizing Remote Desktop Web Access by Using Windows SharePoint Services Stepby-Step

BUILDER 3.0 Installation Guide with Microsoft SQL Server 2005 Express Edition January 2008

Microsoft Project Server Integration with SharePoint 2010

Portions of this product were created using LEADTOOLS LEAD Technologies, Inc. ALL RIGHTS RESERVED.

Web Sites, Virtual Machines, Service Management Portal and Service Management API Beta Installation Guide

InformationNOW Upgrading to Microsoft SQL Server 2008

EMC SourceOne for Microsoft SharePoint Storage Management Version 7.1

How To Install Powerpoint 6 On A Windows Server With A Powerpoint 2.5 (Powerpoint) And Powerpoint On A Microsoft Powerpoint 4.5 Powerpoint (Powerpoints) And A Powerpoints 2

SHAREPOINT 2013 IN INFRASTRUCTURE AS A SERVICE

Outlook Web Access (OWA) WS-Federation SSO with A10 Thunder Series

Microsoft Business Intelligence 2012 Single Server Install Guide

Quick Install Guide. Lumension Endpoint Management and Security Suite 7.1

Active Directory Management. Agent Deployment Guide

DameWare Server. Administrator Guide

NSi Mobile Installation Guide. Version 6.2

Metalogix SharePoint Backup. Advanced Installation Guide. Publication Date: August 24, 2015

Team Foundation Server 2012 Installation Guide

IIS, FTP Server and Windows

AIMS Installation and Licensing Guide

Table of Contents. CHAPTER 1 About This Guide CHAPTER 2 Introduction CHAPTER 3 Database Backup and Restoration... 15

Citrix EdgeSight for NetScaler Rapid Deployment Guide

ControlPoint. Advanced Installation Guide. Publication Date: January 12, Metalogix International GmbH., All Rights Reserved.

Migrating MSDE to Microsoft SQL 2008 R2 Express

Security and Kerberos Authentication with K2 Servers

File Share Navigator Online 1

Workflow Conductor for SharePoint 2010

Table of Contents Introduction... 2 Azure ADSync Requirements/Prerequisites:... 2 Software Requirements... 2 Hardware Requirements...

Universal Management Service 2015

Management Reporter Integration Guide for Microsoft Dynamics AX

How do I EVOLVE to Best Practice Software?

Configuring a SQL Server Reporting Services scale-out deployment to run on a Network Load Balancing cluster

INSTALLATION GUIDE Datapolis Process System v

Secure Messaging Server Console... 2

Installation Guide. Genesis Edition for SharePoint AgilePoint BPMS v5.0 R2 SP1 Genesis for SharePoint 2010

NovaBACKUP xsp Version 15.0 Upgrade Guide

Road2Master Microsoft Exchange Server 2013 Major changes with Exchange Server 2013 PART 2. Ashwin Venugopal

MSSQL quick start guide

Installation Guide v3.0

Defender Token Deployment System Quick Start Guide

4cast Client Specification and Installation

Upgrade Guide BES12. Version 12.1

SharePoint Password Change & Expiration 3.0 User Guide

Portions of this product were created using LEADTOOLS LEAD Technologies, Inc. ALL RIGHTS RESERVED.

Installing Autodesk Vault Server 2012 on Small Business Server 2008

Dell One Identity Cloud Access Manager Installation Guide

Getting started with Microsoft SharePoint Server 2010

White Paper. Fabasoft Folio Thin Client Support. Fabasoft Folio 2015 Update Rollup 2

R i o L i n x s u p p o r r i o l i n x. c o m 3 / 5 /

Sophos for Microsoft SharePoint startup guide

This How To guide will take you through configuring Network Load Balancing and deploying MOSS 2007 in SharePoint Farm.

Cloud Services ADM. Agent Deployment Guide

Workflow approval via

Update and Installation Guide for Microsoft Management Reporter 2.0 Feature Pack 1

How to Scale out SharePoint Server 2007 from a single server farm to a 3 server farm with Microsoft Network Load Balancing on the Web servers.

SplendidCRM Deployment Guide

Microsoft Dynamics GP Web Services Installation and Administration Guide

Appendix E. Captioning Manager system requirements. Installing the Captioning Manager

Setup and configuration for Intelicode. SQL Server Express

System Administration Training Guide. S100 Installation and Site Management

Kaspersky Lab Mobile Device Management Deployment Guide

c360 Portal Installation Guide

Enterprise Vault Installing and Configuring

Bosch ReadykeyPRO Unlimited Installation Guide, product version 6.5. This guide is item number DOC , revision 2.029, May 2012.

NTP Software File Reporter Analysis Server

Veritas Cluster Server Database Agent for Microsoft SQL Configuration Guide

SQL Server Business Intelligence

Thinspace deskcloud. Quick Start Guide

Perceptive Connector for Microsoft Dynamics AX

Pearl Echo Installation Checklist

Setting Up a Unisphere Management Station for the VNX Series P/N Revision A01 January 5, 2010

INSTALL AND CONFIGURATION GUIDE. Atlas 5.1 for Microsoft Dynamics AX

Transcription:

Installing & Configuring SharePoint Foundation 2010 on Windows Server 2008 R2 in Preparation to Host Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal Feature Anup Shah Support Engineer Microsoft Customer Services and Support Team Blog: http://blogs.msdn.com/emeadaxsupport/ 14/February/2011 (Draft) This document is for illustration purposes only. Microsoft disclaims all warranties and conditions with regard to use of the programming example for other purposes. Microsoft shall not, at any time, be liable for any special, direct, indirect or consequential damages, whether in an action of contract, negligence or other action arising out of or in connection with the use or performance of the programming example. Nothing herein should be construed as constituting any kind of warranty. See terms at http://www.microsoft.com/info/cpyright.htm 1

Table of Contents Installing & Configuring SharePoint Foundation 2010 on Windows Server 2008 R2 in Preparation to Host Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal Feature... 1 Summary:... 3 Topology:... 3 Software Installation Summary:... 3 Detailed installation steps for Configuring SharePoint to host Dynamics AX Enterprise Portal Server... 3 Step 1: Download and Install the pre-requisites for SharePoint 2010 and Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal... 4 Step 2: Download, Install and Configure SharePoint Foundation 2010... 6 Step 3: Patching Microsoft Dynamics AX 2009 Setup files with hotfix KB2278963... 17 Step 4: Installing AX 2009 Kernel and Application updates that add compatibility support for Microsoft SharePoint 2010... 18 Step 5: Deploying Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal... 20 List of Known Issues and Resolutions:... 26 Appendix A Configuring Application Pool User Account... 27 Appendix B Unable to detect the correct version of SharePoint... 32 Appendix C List of Application Pools created by SharePoint Foundation 2010... 35 2

Summary: The following document details my user experience of installing and configuring Microsoft SharePoint Foundation 2010, in preparation to deploy Microsoft Dynamics AX Role Centers and Enterprise Portal (RC+EP) feature. Topology: I have the following server topology - One Active Directory Server One Server hosting AX 2009 AOS and SQL Server 2008 SP1 + CU9 One Server that will host SharePoint Foundation 2010, and will be host for AX 2009 Role Centers and Enterprise Portal All 3 Servers are running Windows Server 2008 R2 Enterprise Edition Software Installation Summary: AOS Server The AOS server hosts the contoso demo database, and is running AX 2009 SP1 + RU4 (AX Kernel and Application build 5.0.1500.2116) SQL Server It is recommended that you run SQL Server 2008 R2 Database Engine to host the SharePoint 2010 database. However at the time I created this document I was running SQL Server 2008 SP1 + CU9 (10.0.2789) Database Engine. Enterprise Portal Server Running SharePoint Foundation 2010, with Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal feature installed Detailed installation steps for Configuring SharePoint to host Dynamics AX Enterprise Portal Server I have a Windows 2008 R2 Enterprise Edition server installed with no Roles or Features deployed. It is a member of the same Active Directory Domain as my SQL and AOS servers. I am logged in as a Local Admin user account which is also my AX Admin user account, and the user account has the following rights and privileges as described in: Administrative and service accounts required for initial deployment (SharePoint Foundation 2010) : http://technet.microsoft.com/en-us/library/ee662519.aspx I prepared my Windows 2008 R2 server by following the guide on TechNet on how to Deploy a single server with SQL Server (SharePoint Foundation 2010) - http://technet.microsoft.com/en-us/library/cc287960.aspx. You must read the guide and the following step by no means replace what the guide suggests. 3

Step 1: Download and Install the pre-requisites for SharePoint 2010 and Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal When you run the SharePoint Foundation 2010 setup, on the splash screen there is an option to Install Software Pre-Requisites and running this would check if you have all the required software and windows roles and if not it will set them up and download and install any missing pre-requisites software from the internet. I however took the option of manually installing all the pre-requisites to highlight what is required. A summary of the steps I took to setup my server following the minimum requirements for the following environments Database server in a farm and Front-end Web servers and application servers in a farm : (1) Enabled the Application and Web Server (IIS) roles and.net Framework 3.5.1 and PowerShell Integrated Scripting Environment Features by running the following command in an elevated cmd prompt NOTE: The following needs to be run as one single command line, and it is truncated for presentation only ServermanagerCMD -install Web-Server Web-Common-Http Web-Static-Content Web-Default-Doc Web-Dir- Browsing Web-Http-Errors Web-App-Dev Web-Asp-Net Web-Net-Ext Web-ISAPI-Ext Web-ISAPI-Filter Web- Health Web-Http-Logging Web-Log-Libraries Web-Request-Monitor Web-Http-Tracing Web-Security Web- Basic-Auth Web-Windows-Auth Web-Filtering Web-Digest-Auth Web-Performance Web-Stat-Compression Web- Dyn-Compression Web-Mgmt-Tools Web-Mgmt-Console Web-Mgmt-Compat Web-Metabase Web-WMI Web-Lgcy- Scripting Web-Lgcy-Mgmt-Console Web-Windows-Auth NET-Framework-Core WAS WAS-Process-Model WAS-NET- Environment WAS-Config-APIs Application-Server AS-Web-Support AS-TCP-Port-Sharing AS-WAS-Support AS- HTTP-Activation AS-TCP-Activation AS-Named-Pipes AS-Net-Framework PowerShell-ISE -logpath %TEMP%\IISInstall.log (2) Downloaded and installed the following fixes and applications (NOTE: The Windows fixes listed below are for Windows Server 2008 R2 ONLY. Refer to Hardware and software requirements for SharePoint 2010 for links to fixes for Windows Server 2008 x64 - http://technet.microsoft.com/en-us/library/cc288751.aspx): Microsoft Sync Framework Runtime v1.0 (x64): http://go.microsoft.com/fwlink/?linkid=141237 Microsoft Office 2010 Filter Pack (64bit) aka Microsoft Filter Pack 2.0: http://go.microsoft.com/fwlink/?linkid=191851 4

Microsoft Chart Controls for the Microsoft.NET Framework 3.5: http://go.microsoft.com/fwlink/?linkid=141512 ADO.NET Data Services Update for.net Framework 3.5 SP1 (x64): http://go.microsoft.com/fwlink/?linkid=163524 A hotfix for the.net Framework 3.5 SP1 that provides a method to support token authentication without transport security or message encryption in WCF (x64): http://go.microsoft.com/fwlink/?linkid=166231 Windows Identity Foundation (WIF) x64: http://go.microsoft.com/fwlink/?linkid=166363 KB979917 - QFE for SharePoint issues - Perf Counter fix & User Impersonation (x64): http://go.microsoft.com/fwlink/?linkid=192577 (3) Downloaded and installed the following SQL components from the Microsoft SQL Server 2008 Feature Pack, April 2009 web page: SQL Server 2008 Native Client (x64): http://download.microsoft.com/download/a/d/0/ad021ef1-9cbc- 4D11-AB51-6A65019D4706/sqlncli.msi Microsoft ADOMD.NET (x64): http://download.microsoft.com/download/a/d/0/ad021ef1-9cbc-4d11- AB51-6A65019D4706/SQLSERVER2008_ASADOMD10.msi Microsoft Analysis Management Objects (x64) (This is required component for installing the AX 2009 Role Centers and Enterprise Portal Feature): http://download.microsoft.com/download/a/d/0/ad021ef1-9cbc- 4D11-AB51-6A65019D4706/SQLSERVER2008_ASAMO10.msi 5

Step 2: Download, Install and Configure SharePoint Foundation 2010 NOTE: I am logged in as a Local Admin user account which is also my AX Admin user account, and the user confirms to the requirements detailed at http://technet.microsoft.com/en-us/library/ee662519.aspx I downloaded SharePoint Foundation 2010 from http://go.microsoft.com/fwlink/?linkid=197422 and ran it and selected the option Install SharePoint Foundation from the initial splash screen. Read and accepted the Licence terms and clicked Continue Clicked on option Server Farm 6

In the Server Type form selected option Complete and clicked on Install Now button: After the install left the check box selected to run the configuration wizard, and clicked Close: 7

On the Welcome to SharePoint Products page, clicked Next: In the dialog box that notifies you that some services might need to be restarted during configuration, clicked Yes: 8

On the Connect to a server farm page, clicked Create a new server farm, and then clicked Next: On the Specify Configuration Database Settings page I specified the SQL Server that I m using that will host my SharePoint databases; specified the Configuration Database name; and specified my domain username of the server farm account, and clicked Next: 9

NOTE: The server farm account is used to create and access your configuration database. It also acts as the application pool identity account for the SharePoint Central Administration application pool, and it is the account under which the Microsoft SharePoint Foundation Workflow Timer service runs. The SharePoint Products Configuration Wizard adds this account to the SQL Server Login accounts, the SQL Server dbcreator server role, and the SQL Server securityadmin server role. The user account that you specify as the service account must be a domain user account, but it does not need to be a member of any specific security group on your front-end Web servers or your database servers. Although in my example I am have used an administrator account on this test systems, it is strongly recommended that you follow the principle of least privilege and specify a user account that is not a member of the Administrators group on your front-end Web servers or your database servers. On the Specify Farm Security Settings page, specified type a passphrase, and then clicked Next: NOTE: Although a passphrase is similar to a password, it is usually longer to enhance security. It is used to encrypt credentials of accounts that are registered in Microsoft SharePoint Foundation; for example, the Microsoft SharePoint Foundation system account that you provide when you run the SharePoint Products Configuration Wizard. Ensure that you remember the passphrase, because you must use it each time you add a server to the farm. Ensure that the passphrase meets the following criteria: o Contains at least eight characters o Contains at least three of the following four character groups: o English uppercase characters (from A through Z) o English lowercase characters (from a through z) o Numerals (from 0 through 9) o Nonalphabetic characters (such as!, $, #, %) 10

On the Configure SharePoint Central Administration Web Application page, I specified a port number I want to use for my SharePoint Central Administration Web application and Clicked NTLM authentication provider, and clicked Next: On the Completing the SharePoint Products Configuration Wizard page, I reviewed my configuration settings and clicked Next 11

The configuration wizard now starts configuring SharePoint, and my configuration completed successfully and I clicked on Finish: NOTE: If the SharePoint Products Configuration Wizard fails, check the PSCDiagnostics log files, which are located on the drive on which SharePoint Foundation is installed, in the %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS folder. Setup is now complete and it will launch a web page to run the Farm Configuration Wizard. (To manually run the Farm Configuration Wizard, On the SharePoint Central Administration Web site, on the Configuration Wizards page, click Launch the Farm Configuration Wizard). I got prompted for user credentials when the wizard launches in Internet Explorer, I entered my credentials and added the web server to the Local Intranet sites in IE Security zones. Instructions for how to configure IE settings are provided at http://technet.microsoft.com/en-us/library/cc287960.aspx On the Help Make SharePoint Better page, I clicked one of the options and then clicked OK. On the Configure your SharePoint farm page, I clicked Start the Wizard button to walk me through the settings using this wizard 12

THIS IS AN IMPORTANT STEP IF YOU PLAN TO USE THE EXISTING SHAREPOINT WEB SITE IT CREATES FOR HOSTING RC+EP. In the Service Account section, I created a new service account that is the.net business connector service account as defined in AX, and deselected the two services as I don t want to use them, and clicked Next: 13

On the Create Site Collection page, I selected options to create a test Team site just as a way to ensure that SharePoint can host a site successfully, and clicked OK. This creates a web site on port 80 and a site collection in the web site: 14

My site creation completes successfully, and I clicked Finish: 15

To test the site, ran Internet Explorer and browsed to the URL http://as03/sites/test, and it launched my test site successfully: Run the IIS Manager to see the web site and application pools created to host the new web site on port 80: I can use the SharePoint 80 web site now to host my AX 2009 Role Centers and Enterprise Portal, as it is already configured with the correct application pool account. NOTE: See Appendix A on how to change the application pool account using SharePoint 2010 Central Administration. 16

Step 3: Patching Microsoft Dynamics AX 2009 Setup files with hotfix KB2278963 Next I downloaded the hotfix KB2278963 and requested hotfix KB2483518 from Microsoft support and extracted its contents (at time of writing hotfix KB2483518 was not available on Partnersource). Then I followed through the document Deployment of Microsoft SharePoint 2010 with Microsoft Dynamics AX 2009 SP1.docx that ship with the hotfix. The following is a summary of the steps I followed. This by no means replaces the document that ships as that contains other vital information like what the supported scenarios are etc. The following steps also encompass using fix KB2483518. (1) Extracted the hotfix KB2278963 to D:\2278963 folder on the EP server. Verified that the file version of the 3 files in the Setup Assemblies folder ("D:\2278963\Setup Assemblies") is v5.0.1500.3192 (2) Copied my Microsoft Dynamics AX 2009 RTM setup files from the DVD to a folder on my D: drive, under D:\AX2009 (3) Patched the setup files with files from the hotfix. Copied the Microsoft.Dynamics.Framework.Deployment.Portal.dll and Microsoft.Dynamics.Framework.Portal.dll files from the Setup Assemblies folder ("D:\2278963\Setup Assemblies") and pasted them into the AX 2009 setup folder in the following locations and replaced the existing files: D:\AX2009\Msi\Components32\Program Files\Microsoft Dynamics AX\50\Client\Bin D:\AX2009\Msi\Components64\Program Files (x86)\microsoft Dynamics AX\50\Client\Bin (4) Copied the Microsoft.Dynamics.Framework.Deployment.Portal.dll from the Setup Assemblies folder ("D:\2278963\Setup Assemblies") and pasted them into the following locations and replaced the existing files: D:\AX2009\Msi\Components32\Program Files\Microsoft Dynamics AX\50\Setup D:\AX2009\Msi\Components64\Program Files\Microsoft Dynamics AX\50\Setup (5) Copied the AxSetup.exe file from the Setup Assemblies folder ("D:\2278963\Setup Assemblies") and pasted it to the following location by replacing the existing files: D:\AX2009\Support 17

Step 4: Installing AX 2009 Kernel and Application updates that add compatibility support for Microsoft SharePoint 2010 (6) We need AX 2009 Kernel Build 5.0.1500.3191 or later deployed on all servers to add compatibility with SharePoint 2010. The Kernel hotfix that ships with KB2278963 is at build 5.0.1500.3191. IMPORTANT NOTES: a. If you have however installed the Kernel Rollup Hotfix AX 2009 SP1 Hotfix Rollup 6 and above then you don t need to install this kernel update from KB2278963 (Rollup 6 already contains the update and the kernel build for RU6 is 5.0.1500.3781) b. Ensure you install the same kernel build running on the AOS server on to the Enterprise Portal Server (and other servers running AX components and your AX clients) c. Kernel hotfixes ARE cumulative (Application hotfixes aren t) (7) I Installed the Kernel hotfix 2278963 on all my AX servers by running axupdate.exe from the Kernel folder of the hotfix (D:\2278963\Kernel). (8) We also need to install AX 2009 Application Hotfix which adds compatibility support for Enterprise Portal running on SharePoint 2010. We can deploy the application hotfix that comes bundled with KB2278963, however that application hotfix has now been superseded by KB2483518 which also addresses an issue as detailed at http://blogs.msdn.com/b/emeadaxsupport/archive/2011/01/04/you-get-a-script-error-whenviewing-role-centers-deployed-on-sharepoint-2010-in-a-microsoft-dynamics-ax-2009-client.aspx (9) I Installed the Application hotfix 2483518 by running axupdate.exe from the Application folder of the hotfix (D:\2483518). (10) Verify the Kernel and Application Build on the AOS server a. Application hotfix 2483518 is a standalone hotfix and internally versioned at 5.0.1500.4150 b. However, if you look at the AX Help -> About Microsoft Dynamics AX window it will NOT display this application version as it s a standalone version. Only Service Packs and Hotfix Rollup Application fixes are displayed in the About box. It will however display the current Kernel version as in use by 18

the AX client. This is what s displayed from the AX client that I ran from my AOS server: c. Check the AOT -> Classes -> SysManifestHotfix class to see if the application hotfix got deployed. Here is what my class looks like: d. NOTE: See Appendix B for what errors you may get if the correct Kernel and Application hotfixes are not installed 19

Step 5: Deploying Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal Now that my AX 2009 setup files are patched and I have installed the kernel and application hotfix 2278963, next I ran setup.exe from the patched setup folder and deployed Role Centers and Enterprise Portal (1) Before running setup.exe, I compiled the SysEPDeployment and SysDevelopmentProxy Classes from my AOS server which also has the.net Business Connector installed (This class needs to be compiled from a system that has the.net business connector installed see this link) (2) Ran D:\AX2009\setup.exe, and followed through initial setup screens and selected custom installation type: 20

(3) Selected Role Centers and Enterprise Portal and.net Business Connector from Select Components form and clicked Next: (4) Clicked Install prerequisites software button: 21

(5) Once the pre-requisites were installed clicked Next: (6) Left the default install folders selected, and clicked Next: 22

(7) Selected the.net Business Connector display language, and clicked Next: (8) Specified my AOS servername and the TCP port it is listening on and hit Next: 23

(9) Specified my.net Business Connector proxy username password, and hit Next: (10) Selected the SharePoint web site in which I want to create the Enterprise Portal site collection, and hit Next (The selected web site s application pool user account already runs as the.net business connector proxy user account): 24

(11) In the Ready to Install page, left the default selection and hit Next: (12) Then waited for the deployment to complete: 25

(13) Received a deployment success (14) Verified in the Web Sites form that the web site is registered. Ran AX Client on the AOS server and opened up AX -> Administration -> Setup -> Internet -> Enterprise Portal -> Web Sites (15) Installed the Kernel hotfix 2278963 on all EP server and ran IISRESET.EXE, to recycle the IIS services. (16) Browsed the Enterprise Portal Site to verify that I can launch it without any errors (17) Followed through the rest of the post installation tasks of Configuring Enterprise Portal and maintaining Role Centers as detailed at http://technet.microsoft.com/en-us/library/dd362037.aspx (Set up Enterprise Portal and Role Centers) List of Known Issues and Resolutions: For a list of other well-known issues and resolutions when hosting or deploying Microsoft Dynamics AX 2009 Role Centers and Enterprise Portal see - http://blogs.msdn.com/b/emeadaxsupport/archive/tags/enterprise+portal/sps2010/ 26

Appendix A Configuring Application Pool User Account The following is a sample demonstration describing how to change the Application Pool user account that is currently in use by the SharePoint 80 web site to use the FABRIKAM\AXBCProxy User account: The following steps can be used to change the service account used by the application pool account mapped to any SharePoint Web site from the server hosting the SharePoint Central Administration web site: NOTE: It is recommended that you secure the SharePoint Central Administration web site first using encryption technologies like SSL/TLS, as credentials will be sent in clear text (see http://technet.microsoft.com/enus/library/cc261875.aspx for more info) (1) Run SharePoint 2010 Central Administration (2) Click on Security on the left-hand bar, and it displays the following page: 27

(3) Under General Security click on Configure managed accounts and it should displays all the managed accounts you have setup: 28

(4) Click on the link Register Managed Account to add a new domain user account to be used as your managed application pool account: Click on OK and the new account will be listed: 29

(5) Change the SharePoint 80 Web site to use the new managed account. Click on Security on the left-hand bar and then under General Security click on Configure service accounts. It should then display the following form: (6) From the Select one drop-down box, select the Web Application Pool - Sharepoint - 80 and under Select an account for this component, select your new user account. In my case I selected the FABRIKAM\AXBCproxy user account: and clicked OK 30

(7) Read and then click OK on the following message that is displayed: Wait for the change to apply, and if successful, the Security form will be shown again: (8) Check in IIS Manager that the new account is setup: (9) Open up an elevated cmd prompt an run IISRESET /noforce on all your servers in the Farm. 31

Appendix B Unable to detect the correct version of SharePoint ISSUE: You have patched your Microsoft Dynamics AX 2009 RTM setup files with files from hotfix KB2278963. You have successfully installed SharePoint 2010 and can create SharePoint web sites and site collections. However when you try to deploy Role Centers and Enterprise Portal by running setup.exe from your patched setup folder, you get an error in the DynamicsSetupLog.txt and Application Event log stating that you haven t got Windows SharePoint Services installed: DynamicsSetupLog.txt: Dynamics Adapter CreateAxaptaObject failed. Microsoft.Dynamics.Framework.BusinessConnector.Session.Exceptions.XppSessionException at Microsoft.Dynamics.Framework.BusinessConnector.Session.DynamicsSession.HandleException(String message, Exception exception, HandleExceptionCallback callback) at Microsoft.Dynamics.Framework.BusinessConnector.Session.DynamicsAdapter.CreateAxaptaObject(String classname) at Microsoft.Dynamics.Framework.BusinessConnector.Proxy.ProxyObjectBase..ctor(IAxaptaAdapter axaptaadapter, ProxyClassName classname) at Microsoft.Dynamics.Framework.BusinessConnector.Proxy.SysEPDeployment..ctor(IAxaptaAdapter axaptaadapter) at Microsoft.Dynamics.Framework.Deployment.Portal.EPDeployment.DeployEnterprisePortal(String virtualserverurl) Enterprise Portal cannot be deployed because Windows SharePoint Services is not installed on this computer. Microsoft.Dynamics.BusinessConnectorNet.XppException at Microsoft.Dynamics.BusinessConnectorNet.Axapta.CreateAxaptaObject(String classname, Object[] paramlist) at Microsoft.Dynamics.Framework.BusinessConnector.Session.DynamicsAdapter.CreateAxaptaObject(String classname) An error occurred during setup of Role Centers and Enterprise Portal. Reason: Dynamics Adapter CreateAxaptaObject failed. Application event log entries: Log Name: Application Source: Dynamics.NET Business Connector 5.0 Event ID: 110 Task Category: None Level: Warning Keywords: Classic User: N/A Description: Microsoft Dynamics AX Business Connector Session 17. An X++ exception has occurred. Enterprise Portal cannot be deployed because Windows SharePoint Services is not installed on this computer. ------------------------ and.. 32

Log Name: Application Source: Microsoft.Dynamics.Framework.BusinessConnector Event ID: 3000 Task Category: None Level: Warning Keywords: Classic User: N/A Description: Dynamics Adapter CreateAxaptaObject failed. Enterprise Portal cannot be deployed because Windows SharePoint Services is not installed on this computer. Microsoft.Dynamics.BusinessConnectorNet.XppException at Microsoft.Dynamics.BusinessConnectorNet.Axapta.CreateAxaptaObject(String classname, Object[] paramlist) at Microsoft.Dynamics.Framework.BusinessConnector.Session.DynamicsAdapter.CreateAxaptaObject(String classname) RESOLUTION: This error can occur for two reasons (1) a. Ensure the AX 2009 Setup files are patched correctly with the updated assembly files that ship in the "Setup Assemblies" folder inside hotfix KB2278963 (i).copy all the files of the Microsoft Dynamics AX 2009 DVD to a shared network folder (we will refer to this as [SharedFolder] later on). (ii). Extract hotfix KB2278963 to an empty folder. The Extracted fix should contain the following folder structure: (iii). Copy the Microsoft.Dynamics.Framework.Deployment.Portal.dll and Microsoft.Dynamics.Framework.Portal.dll files from the "Setup Assemblies" folder in hotfix KB2278963 and paste them into the following locations by replacing the existing Microsoft.Dynamics.Framework.Deployment.Portal.dll and Microsoft.Dynamics.Framework.Portal.dll files: [SharedFolder]\Msi\Components32\Program Files\Microsoft Dynamics AX\50\Client\Bin [SharedFolder]\Msi\Components64\Program Files (x86)\microsoft Dynamics AX\50\Client\Bin (iv).copy the Microsoft.Dynamics.Framework.Deployment.Portal.dll from the "Setup Assemblies" folder and paste them into the following locations by replacing the existing Microsoft.Dynamics.Framework.Deployment.Portal.dll file: [SharedFolder]\Msi\Components64\Program Files\Microsoft Dynamics AX\50\Setup [SharedFolder]\Msi\Components32\Program Files\Microsoft Dynamics AX\50\Setup 33

(iv).copy the AxSetup.exe file from the "Setup Assemblies" folder and paste the file into the following location by replacing the existing AxSetup.exe file: [SharedFolder]\Support b. As a minimum install Application and Kernel hotfix 2278963 and/or install AX 2009 SP1 Hotfix Rollup 6 Kernel and Application hotfix to add support for SharePoint 2010. (2) The AXSETUP.EXE is in charge of checking all the pre-reqs. It determines the SharePoint version by looking for the Version registry key for SharePoint. If it cannot find the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\14.0\Version then it will raise a similar error. Verify that the key exists, with a version number value of at least 14.0.0.4762 See http://blogs.msdn.com/b/emeadaxsupport/archive/2010/12/07/unable-to-deploy-ax-2009-enterpriseportal-on-sharepoint-2010-even-after-patching-setup-files-with-hotfix-2278963.aspx for more details. 34

Appendix C List of Application Pools created by SharePoint Foundation 2010 35

This document is for illustration purposes only. Microsoft disclaims all warranties and conditions with regard to use of the programming example for other purposes. Microsoft shall not, at any time, be liable for any special, direct, indirect or consequential damages, whether in an action of contract, negligence or other action arising out of or in connection with the use or performance of the programming example. Nothing herein should be construed as constituting any kind of warranty. See terms at http://www.microsoft.com/info/cpyright.htm 36