You may have seen the announcement of release of hotfix KB2278963 adding support for SharePoint 2010 (http://blogs.technet.com/b/dynamicsaxse/archive/2010/08/12/new-compatibility-testing-result-august-2010.aspx)  and have requested the fix from Microsoft support. You have successfully deployed SharePoint 2010 and can create a SharePoint website and test site collections successfully. However you may encounter some issues when following the whitepaper contained within the fix to deploy AX 2009 Role Centers and Enterprise Portal. All of the following issues are now resolved by using an updated re-release of the same hotfix (Fix  contains AX 2009 Kernel hotfix Build 5.0.1500.3191, Application hotfix Build 5.0.1500.3560, updated AX 2009 setup files and an updated Whitepaper document).


ISSUE 1:
=======
You have downloaded hotfix  2278963, and followed through the whitepaper, and successfully installed SharePoint 2010 and have a test site created successfully. You have patched your AX2009 installion folders with the hotfix, and installed the Kernel and Application Hotfixes successfully, and are now going to create an EP site using setup.exe. You have selected option install Role Centers and Enterprise Portal, and as soon as you hit next you get the following error displayed:

 

 

The log file displays the following info:

Entering function ReadRegKey
                Reading registry key SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\12.0, property AdminServerLocation
                Registry Key SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\12.0 with Attribute AdminServerLocation has value 
                Leaving function ReadRegKey
                Microsoft Dynamics AX could not find the IIS metabase information for the SharePoint Central Administration page.
               
Entering function ReadRegKey
                Reading registry key SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\12.0, property version
                Registry Key SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\12.0 with Attribute version has value 
                Leaving function ReadRegKey
               
Entering function Microsoft.Dynamics.Framework.Deployment.Portal.IEPDeployment.GetVirtualServerList
                SharePoint is not installed on this computer. Install Windows SharePoint Services version 3.0 or Microsoft Office SharePoint Server 2007 before continuing.
Exception: Microsoft.Dynamics.Framework.Deployment.Portal.EPDeploymentException

Message: SharePoint is not installed on this computer. Install Windows SharePoint Services version 3.0 or Microsoft Office SharePoint Server 2007 before continuing.


Resolution:
Setup is still using the old Microsoft.Dynamics.Framework.Deployment.Portal.dll to detect SharePoint/WSS versions. Copy the Microsoft.Dynamics.Framework.Deployment.Portal.dll (v5.0.1500.3192) from the Setup directory of the hotfix package and paste them into the following locations where your AX 2009 Installation files/share is located by replacing the existing files:  

• [SharedFolder]\CD\Msi\Components64\Program Files\Microsoft Dynamics AX\50\Setup
• [SharedFolder]\CD\Msi\Components32\Program Files\Microsoft Dynamics AX\50\Setup

The re-run AX setup.exe again, to install Role Centers and Enterprise Portal. If you still get the same error, then check the Global Assembly Cache on the server (c:\windows\assembly) and see if Microsoft.Dynamics.Framework.Deployment.Portal.dll asembly exists. If it does try updating it with the version from the setup directory of the hotfix package.

 

ISSUE 2:
=======
When you try and create an EP site you get the following error in the log file even though your application was compiled on a system that has the .net business connector installed:

Dynamics Adapter CreateAxaptaObject failed.

Microsoft.Dynamics.Framework.BusinessConnector.Session.Exceptions.FatalSessionException
   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)

Error executing code: SysEPDeployment (object) has no valid runable code in method 'new'.

 

(C)\Classes\SysEPDeployment\new


Microsoft.Dynamics.BusinessConnectorNet.BusinessConnectorException
   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.

 

Resolution:
Compile the Class SysEPDeployment from a system which has both the AX 2009 Client and .NET Business Connector installed. This requires that you have the x++ license to do so. If you don’t follow through steps 3 – 7 given in the following blog: http://blogs.msdn.com/b/emeadaxsupport/archive/2009/03/12/how-to-install-microsoft-dynamics-ax-2009-role-centers-and-enterprise-portal-successfully-on-your-first-attempt.aspx

 

ISSUE 3:
=======
After successfully creating the EP site, it may not display the main tabs and header section of the web page correctly. See following screenshot:

This means you have still the original application hotfix KB2278963 that was released (Application Build 5.0.1500.3191).


Resolution:

Download hotfix KB2278963 using your partnersource credentials and/or request it through your normal Microsoft Dynamics AX Support channels . This should contain an updated Application fix (v5.0.1500.3560). The updated application fix contains contains updated webparts and an updated setup document (The Kernel hotfix is the same, so you do not need to re-install this again if it is already installed). After installing the Application hotfix and restarting the AOS servers, you will need to recreate the EP site, by re-runningsetup.exe from the patched AX installation files.

NOTE: Running axupdateportal.exe will NOT update the web site and fix the issue you have to recreate the EP web site.


The new web site created should display the web page UI as expected:

 

 

 

 

--author: Anup Shah
--editor: Anup Shah
--date: 16/Sep/2010