Resolving some issues you may experience when creating an AX 2009 Role Center and Enterprise Portal Site using SharePoint Server/Foundation 2010 after installing Microsoft Dynamics AX 2009 SP1 hotfix 2278963


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
Comments (8)

  1. Laura says:

    I need to get the latest version of the Hotfix.    How do I go about doing that?      Have tried to update my ticket and cannot do that.

    Laura Galbraith

    ———————

    Browse to the KB url https://mbs.microsoft.com/knowledgebase/KBDisplay.aspx?scid=kb;en-US;2278963 and log in using your PartnerSource credentials. Then at the top of the article click on the link to request the hotfix.

    –Anup Shah

  2. josepancho says:

    I am experiencing the problem as you have highlighted in issue number 1 above. However in trying to apply the resolution when I go the folder (c:windowsassembly) I am not able to copy or paste to the folder (I am logged in as Administrator with full control). I also notice that the file Microsoft.Dynamics.Framework.Deployment.Portal.dll asembly Does NOT exists. I wanted to copy this file to the folder but I only have read access and when I try to change it by clicking on properties the security tab is not present to allow for changes to be made to the folder. I am using Windows 2008 R2. Can you help me here please?

    —————

    You shouldn't really need to put the assembly in the GAC. On a new install the assembly does not exist by default. It's more likely that the required patched assemblies are missing from the setup folders. Please double-check  that you copied the 3 files that come in the hotfix under the "setup assemblies" folder into the appropriate folders as follows:

    1.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).

    NOTE: Because all later Microsoft Dynamics AX installations must be performed from this folder, make sure that all users who will install Microsoft Dynamics AX 2009 can access this folder.

    2. Copy the Microsoft.Dynamics.Framework.Deployment.Portal.dll and Microsoft.Dynamics.Framework.Portal.dll files from the "Setup Assemblies" directory of the hotfix package 2278963 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]MsiComponents32Program FilesMicrosoft Dynamics AX50ClientBin
     [SharedFolder]MsiComponents64Program Files (x86)Microsoft Dynamics AX50ClientBin

    3.Copy the Microsoft.Dynamics.Framework.Deployment.Portal.dll from the "Setup Assemblies" directory of the hotfix package 2278963 and paste them into the following locations by replacing the existing Microsoft.Dynamics.Framework.Deployment.Portal.dll file:

     [SharedFolder]MsiComponents64Program FilesMicrosoft Dynamics AX50Setup
     [SharedFolder]MsiComponents32Program FilesMicrosoft Dynamics AX50Setup

    4.Copy the AxSetup.exe file from the "Setup Assemblies" directory of the hotfix package 2278963 and paste the file into the following location by replacing the existing AxSetup.exe file:
     
     [SharedFolder]Support

    5. Assuming you have followed through the rest of the "Deployment of Microsoft SharePoint 2010 with Microsoft Dynamics AX 2009 SP1.docx", running setup.exe from the [SharedFolder] should allow you to workaround issue 1.

    By default in Wondows 2008/R2, browsing to a folder is not done in an elevated priviledge mode. Consider using the .net framework tool like gacutil.exe to install the assembly from an elevated cmd prompt.

    –Anup Shah

  3. josepancho says:

    Thanks – After much fighting, recompiling and restarting of the operating system and tweeking of Sharepoint I was able to get EP to install.

  4. James Jackson says:

    I have run through the steps by coping the portal dlls to the cd installation folder. I am still having problems with the prerequisite window stating that i need .net 2.0 and sharepoint services 3.0.

    Now I am using Windows 2008 R2, sharepoint 2010 (created a site successfully)

     

    —————————————–

    Hello James, have a look at the comment I posted on 22nd October and re-verify the paths. There is also one more reason I cam across in detecting SPS 2010, see http://blogs.msdn.com/b/emeadaxsupport/archive/2010/12/07/unable-to-deploy-ax-2009-enterprise-portal-on-sharepoint-2010-even-after-patching-setup-files-with-hotfix-2278963.aspx

    –Anup

  5. James Jackson says:

    Thanks Anup, it was infact the registry entry that was missing.

  6. Pedro Vong says:

    Hi Anup,

    I'm having the same problem as Issue #3. Unfortunately, your recommended solution involves a circular reference, i.e. the title of this article is in reference to install/deployment issues *after* applying hotfix 2278963. Which we have done.

    Is there anything else that needs to be done to resolve this?

    The client is running Dynamics AX 2009 SP1 Rollup 6.

    Thanks,

    Pedro

  7. Eugene says:

    Even after installing the hotfix 2278963, EP install fails with error message ""specified method is not supported". No more details available in the log, the only MS article I came across suggests installing the hotfix 2278963. which is there already. Don't know what to do 🙁

  8. Hello Eugene

    There were two version of hotfix 2278963 at the time I wrote the article. The old fix produce the effect in Issue #3. If you have just downloaded the hotfix and re-applied the application hotfix than, in order to apply the fix you need to create a new web site and deploy EP extensions to it by running AX 2009 Setup (The setup files must contain the patched DLL's from 2278963 "Setup Assemblies" folder)it.

    Alternatively see blogs.msdn.com/…/you-get-a-script-error-when-viewing-role-centers-deployed-on-sharepoint-2010-in-a-microsoft-dynamics-ax-2009-client.aspx, and download the application hotfix the article mentions and create a new web site, again by using the patch AX 2009 setup.

    If the issue persists than looks like there is some issue that is stopping the new EP web parts stored in the AOT from being copied over to your SharePoint server during AX setup. So troubleshoot the issue from that angle.

    HTH

    –Anup

Skip to main content