Resource Page for Enterprise Portal and Role Centers in Microsoft Dynamics AX 2009

Top Downloads

• System Requirements for Microsoft Dynamics AX 2009
• Hot Fixes Released for Microsoft Dynamics AX 2009
• Configure a traditional perimeter network for Enterprise Portal
• How to make an existing Enterprise Portal site SSL enabled
• SSRS and SSAS Integration for Microsoft Dynamics AX 2009

Critical Hotfixes

There are several known issues that have been resolved with Service Pack 1 and Hotfix Rollups (RUs). It is highly recommended that you apply Service Pack 1 for Microsoft Dynamics AX and the latest RU for Microsoft Dynamics AX 2009.

The latest Hotfix Rollup for Microsoft Dynamics AX is available on Partner/Customer Source under Support > Knowledge Base.

Hint: Enter “hotfix rollup available for AX 2009” into the ‘Search for’ field of the Knowledge Base search page.

Featured Videos

• NLB Deployment of Enterprise Portal Setup webcast: Stream or Download (WMV-13 MB)
• Enterprise Portal Deployment Webinar
• “How Do I” Videos – Dynamics AX on MSDN
• Microsoft Dynamics AX 2009 Enterprise Portal Installation Webinar

Related Resources

• Enterprise Portal for Microsoft Dynamics AX 2009 on TechNet
• Enterprise Portal for Microsoft Dynamics AX 2009 on MSDN
• Microsoft Dynamics AX Enterprise Portal Blog
• Enterprise Portal information on NA Dynamics AX Support Blog
• Enterprise Portal information on EMEA Dynamics AX Support Blog
• Enterprise Portal for Microsoft Dynamics on Community Forums

Common Problems & Solutions

Issue

The setup fails to deploy the Microsoft Dynamics AX site template if not licensed for EN-US.

In the DynamicsSetup.txt file, you find the following error:

Creating new Enterprise Portal Site with following the parameters:\n URL: http://server/sites/DynamicsAX\n Title: Enterprise Portal Site\n LCID: 1033\n OwnerLogin: domain\user Administration Web Service URL: http://server:44901/_layouts/ep/WSSAdmin.asmx Error: The site /sites/DynamicsAX could not be created. The following exception occured: File or arguments not valid for site template 'AXSITEDEF#0'..

An error occured while Setup was creating a new site. Exception of type 'Microsoft.SharePoint.SoapServer.SoapServerException' was thrown.

File or arguments not valid for site template 'AXSITEDEF#0'
Exception of type 'Microsoft.SharePoint.SoapServer.SoapServerException' was thrown.

Solution

This issue is solved by applying the hotfix available in KB 960048.

Note: If the Enterprise Portal installation still fails with the same error after applying KB 960048, recompile the SysEpDeployment class on a computer where the Microsoft Dynamics AX Client and the .NET Business Connector are both installed.

Issue

The setup fails if the .NET Business Connector is not installed on the Microsoft Dynamics AX client computer in which the initialization checklist is run.

If the .NET Business Connector is not installed on the Microsoft Dynamics AX client when the initialization checklist is run, the SysDevelopmentProxy class does not get compiled. If SysDevelopmentProxy class is not compiled, then setup fails to install Enterprise Portal.

In the DynamicsSetup.txt file, you find the following error:
In SysEPDeployment::clrGenerateProxies... Error executing code: SysDevelopmentProxy (object) has no valid runable code in method 'generate'.

Solution

This issue is solved by applying the hotfix available in KB 971185.

Additionally, there is the following workaround:

1. Manually compile the SysDevelopmentProxy class:
   • Start the Microsoft Dynamics AX 2009 Client on a computer where the .NET Business Connector is also installed.
   • Open the AOT window.
   • Expand the Classes node.
   • Locate the SysDevelopmentProxy class.
   • Right-click at the class, and then choose Compile from the context menu.
2. If the manual compile does not work, then rebuild the axapd.aoi and then repeat the manual compile. br>

Issue

The setup fails when the installer uses the NETBIOS domain name instead of the fully qualified domain name

In the DynamicsSetup.txt file, you find the following error:

Entering method UpdateBusinessConnectorProxyAccount
An error has occured while Setup was establishing a connection through Business Connector.
Error: Dynamics Adapter CallStaticClassMethod failed.
Leaving method UpdateBusinessConnectorProxyAccount

The Microsoft Dynamics AX installer reads the .NET Business Connector Proxy account from the System Service Accounts form and truncates the fully qualified domain name (FQDN), to the NETBIOS name. If NETBIOS is not configured on the domain the then the Business Connector Proxy account will not be authenticated and the installer will fail.

Solution

Blank out the Business Connector Proxy account in the System Service Accounts form. Run the installer again and you will be allowed to enter in the fully qualified domain name (FQDN)

Note: A similar issue can occur if the Business Connector account stored in the Microsoft Dynamics AX database is using the NETBIOS name and the application pool is using the fully qualified name or vise versa. Make both accounts match using format stored in the Microsoft Dynamics AX database.

Issue

The setup fails and the IIS worker process crashes if AMO is not installed.

In the DynamicsSetup.txt file, you find the following error:br>
An Existing Connection was forcibly closed by remote host

Solution

The IIS/EP server requires AMO objects to be installed. Install the AMO objects and run setup again.

Refer to the Install prerequisites for Enterprise Portal and Role Centers page on TechNet for SQL specific version downloads of the SQL Server Analysis Management Objects (AMO)

Issue

Opening Manage Deployments form generates error when using the 64bit version of WSS

If you have Windows SharePoint Services(WSS) and the .NET Business Connector installed as 64bit versions, you cannot use the 32bit Microsoft Dynamics AX Client to deploy or update Enterprise Portal sites.

When you try to open the Manage Deployments form you receive the following error message:

Manage Deployment cannot be run because Enterprise Portal is not deployed on this computer.

Solution

Microsoft Dynamics AX 2009 Service Pack 1 has a new command line utility, AxUpdatePortal.exe, that gets installed in the C:\Program Files\Microsoft Dynamics AX\50\Setup folder that serves this purpose. More information on this utility is available at http://msdn.microsoft.com/en-us/library/dd261467.aspx

You can execute the utility with the following command line parameters to update all local Enterprise Portal sites:

AxUpdatePortal.exe -updateWebSites -iisreset

Note: On Windows Server 2008 make sure you run AxUpdatePortal.exe from an elevated command prompt. To open an elevated command prompt, click Start, right-click Command Prompt, and then click Run as administrator. More information available on these blogs:

MSDN (public)
Dynamics AX Partner Forum (login required)

Please be aware that there is a hotfix KB974767, which will check if you are running AXUpdatePortal in admin mode.

Issue

401 Error on a web site that has Host Headers configured

When .NET Framework 3.5 Service Pack 1 is installed and the IIS web site has a Host Header configured, the following error occurs:

The Web site http://server/sites/Dynamics AX was not created correctly.
The remote server returned an error: (401) Unauthorized.
System.Net.WebException
at
System.Net.HttpWebRequest.GetResponse() at Microsoft.Dynamics.Framework.Portal.Deployment.EPFeatureReceiver.CreateAxSitesAndPages(SPWeb site)
at Microsoft.Dynamics.Framework.Portal.Deployment.EPFeatureReceiver.ProvisionAxSite(SPWeb site)

Solution

The release of .NET Framework 3.5 Service Pack 1 introduced changes to NTLM authentication for HTTPWebRequest. More information on this change is available at http://msdn.microsoft.com/en-us/library/cc982052.aspx The changes in .NET Framework 3.5 Service Pack 1 include a loopback check security feature that is designed to help prevent reflection attacks on your computer. Therefore, authentication fails if the FQDN or the custom host header that you use does not match the local computer name.

The changes in .NET Framework 3.5 Service Pack 1makes it necessary to configure the BackConnectionHostNames registry to match the Host Header name on the IIS web site. Adding a registry value tells Windows that the Host Name used in the request is a valid alternate name for the local computer. Refer to one of the Related Articles for detailed steps for editing the BackConnectionHostNames registry key. After making the change in the Registry, reboot the server and repeat Enterprise Portal install.

Related Information:

• KB 896861 - You receive error 401.1 when you browse a Web site that uses Integrated Authentication and is hosted on IIS 5.1 or IIS 6
• KB 956158 - You receive an error message when you use SQL Server 2008 Reporting Services: "HTTP 401.1 - Unauthorized: Logon Failed"
• NLB Deployment of Enterprise Portal Setup: Stream or Download (WMV - 13 MB)

Issue

Microsoft Dynamics AX 2009 was only supported with WSS 3.0 SP2, we now support SharePoint 2010 by Appling KB 2278963

Solution

See Compatibility Result for Microsoft SharePoint 2010 - August 2010

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

Troubleshooting Tips

1. NET Business Connector session could not be found.
   
   Possible reasons for this issue:
   • The .NET Business Connector is not installed
   • The wrong version of the .NET Business Connector is installed
   • The .NET Business Connector non-interactive configuration is wrong
   • The application pool does not match the .NET Business Connector account stored in the Microsoft Dynamics AX database (See issue above)
   • In some environments the application pool must match the FQDN, which is stored in the Microsoft Dynamics AX database. (i.e… local.net\BCProxy vs. local\BCProxy )
   • You may need to blank out the .NET Business Connector in the AX database and enter the account in the Microsoft Dynamics AX 2009 installer.
   • The proxy classes are not compiled in the Microsoft Dynamics AX 2009 client on a machine where the .NET Business Connector is installed (see sysdevelopmentProxy issue above).
   • Missing Business Connector or EP Framework license keys.
2. The 404 error generally means the site creation did not complete successfully.
   
   Possible reasons for this issue:
   • The application pool is not using the .NET Business Connector proxy account
   • The user who is creating the site does not have the proper permission in Microsoft Dynamics AX
   • The user with being given administrator privileges on the web site being created (in the create site UI) does not have permission in the proper permissions in Microsoft Dynamics AX. The Microsoft Dynamics AX user account should be logged into the server and not only logged into SharePoint Central Admin webpage.
   • The Master page for Microsoft Dynamics AX is not available in the site definition (C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\SiteTemplates\AXSITEDEF\defaultax.master).

Still having problems...

If you are experiencing issues downloading the install file or documentation on CustomerSource/PartnerSource, please contact ITMBSSUP@microsoft.com

1. Ask the community of users like yourself through the Microsoft Dynamics AX Community here.
2. For Technical support questions, contact your partner, or if enrolled in a support plan directly with Microsoft, you can enter a new support request to Microsoft Dynamics Technical Support from CustomerSource or PartnerSource under Support >> New Support Request
3. You can also contact Microsoft Dynamics Technical Support by phone using these links for country specific phone numbers:
   Partners – Global Support Contacts (requires PartnerSource login)
   Customers – Global Support Contacts (requires CustomerSource login)

Acronyms used in this article

• EP – Enterprise Portal
• WSS – Windows SharePoint Services
• MOSS – Microsoft Office SharePoint Services
• SP – Service Pack
• RU – Hotfix Rollup
• NLB – Network Load Balancing
• SSRS – Microsoft SQL Server Reporting Services
• SSAS – Microsoft SQL Server Analysis Services (sometimes referred as OLAP)
• AMO – Analysis Management Objects (part of Microsoft SQL Server)
• BC – Business Connector